Skip to main content
Need help in this area? See Data Inventory FAQ.
Navigate to Data Inventory > Bills > click any bill to open its detail page. The bill detail page gives you full visibility into a single utility bill’s charges, usage data, line items, and processing history.

Layout

On large screens the page uses a resizable split:
  • Left panel — Bill information, notes, and tabs for usage, charges, connection, and account
  • Right panelDocument preview for the original PDF or image (when available)
On smaller viewports the file panel may be hidden; use Actions > Open file to side or Hide file when a document exists to show or collapse the preview.

Revised bills

Revision linking is per usage row, not whole-bill. When one or more usage rows on a bill point at a newer bill, or when other bills’ usage points at this bill, a banner appears at the top of the page:
  • Amber banner — “Some usage on this bill has been revised. Superseded usage is excluded from analytics.” Appears when this bill has at least one superseded usage row. Superseded rows are shaded amber, and their usage amounts are struck through. Hover over or focus the amount for more context; select it to open the revised bill.
  • Blue banner — “This bill revises usage from N earlier bill(s).” Appears when other bills’ usage rows point at this bill as their revision target.
Use the banner CTAs to view the related bill(s) or Compare documents when there is exactly one counterpart.

Comparing documents

When a single related original or revised bill exists, the document preview (right side on desktop) can show both files. Use Compare documents on the banner (bill detail page) to open a side-by-side view.

Linking revisions

To link superseded usage to a newer bill:
  1. Open the bill detail page (usually the older bill)
  2. Click Actions > Link revision
  3. Choose direction (this bill is revised by another, or this bill revises another)
  4. Select the related bill and the usage rows to supersede
  5. Confirm the link
To remove a link, open the Usage tab on the source bill and use Unlink revision on that usage row. Only that row returns to analytics; other revised rows stay linked.
Revision history under Actions is an audit log of edits to this bill. It is not the same as revision linking.

Tabs

Usage

Usage data records for each meter on the bill. Each record includes the site, billing period, consumption amount, and units. Click Add usage data to create a new entry or click an existing row to edit it. The usage data form supports all commodity types including electricity, gas, water, solar, waste, fuel, and district energy. Demand meter readings (peak demand, demand units, time-of-use periods) are also displayed in this tab when present.

Charges

The Charges tab displays charge details and line items extracted from the bill:
  • Total charges — The top-level total amount
    • Delivery charges — Charges from the local distribution utility
    • Supply charges — Charges from the energy supplier
    • Taxes & fees — Applicable taxes, surcharges, and regulatory fees
Individual line items are listed below with description, amount, and category. Click Add line item to create a new entry. Click any existing row to edit or remove it.

Connection

Displays which connection produced this bill, including the connection name, utility provider, and status. Click the connection name to navigate to its detail page.

Account

Shows the utility account associated with this bill, including the account identifier, site, and utility type. Click through to view the full account detail.

Editing a bill

Sometimes Nectar’s extraction is not perfect, or a bill has unusual charges that need adjustment. You can edit any part of a bill directly from the Usage and Charges tabs. All edits take effect immediately. There is no draft mode — when you click save, the data is live across the platform.

Revision history

Open Actions > Revision history to see a chronological log of all processing events and changes made to this bill:
  • When the bill was first ingested
  • Extraction and processing steps
  • Manual edits by team members (the field that changed, old value, new value, who made it, and when)
  • Status changes and issue resolutions
The revision history supports two view modes — Formatted (a table showing each changed field with its before and after values) and Raw JSON (the underlying data for technical review).
Revision history shows changes from the last 12 months. Older records are archived automatically. If you need access to archived revision data, contact [email protected].

Data quality issues

When Nectar detects a data quality problem on a bill, resolution cards appear above the bill tabs. Each card shows:
  • The issue type (e.g., “Potential duplicate bill detected” or “No usage data”)
  • A severity indicator — red for action-required issues, amber for review-and-verify
  • Guided resolution steps specific to the issue type — for example, comparing duplicate documents, editing inferred data, or dismissing the issue with a note
Once all issues on a bill are resolved, the bill is included in analytics and exports again. You can also manage issues in bulk from the Data Quality > Issues triage inbox, which lets you work through all flagged records in your portfolio. For the full list of issue types and resolution workflows, see Data Quality — Issues and Glossary — Data quality issue.

Actions

  • Flag / Unflag — Use the flag icon beside the bill title to manually flag or unflag a bill.
  • Actions menu — Opens grouped items:
    • NavigateCopy link; Revision history (view all changes made to this bill); when a file exists, Open file to side or Hide file depending on whether the preview is visible
    • ManageAttach document when no document is attached (upload a PDF, PNG, or JPG as supporting evidence); Replace document when a document is already attached (admin only); Link revision to supersede selected usage rows with a newer bill
    • Danger zoneDelete (permanent)
When you attach or replace a document, Nectar checks whether the same file has already been uploaded for another bill. If a duplicate is found, the upload is rejected and you’ll see a message identifying the existing bill. This prevents the same document from being associated with multiple bills.

FAQ

Yes. Use the Charges tab: add, edit, and remove line items there. Changes flow into the charges tree above.
The document preview is available for bills ingested via a connection or file upload. If a bill has no document (for example, a manually entered bill), an info message appears in the preview panel. You can attach one at any time via Actions > Attach document.
Open the Account tab and update the account association. You can also edit the usage data records to reassign them to different meters.
Revision links are per usage row. Superseded usage is excluded from analytics; other usage on the same bill still counts. The newer bill’s usage is what reporting uses for those meters and periods. You can compare documents side by side with Compare documents when a single counterpart bill exists, and unlink individual rows from the Usage table.
Yes. Editing bill data is a normal part of the workflow. Every edit is recorded in the revision history, so you can always see what changed and revert it manually if needed. Changes take effect immediately in analytics and future exports.
There is no automatic undo button, but every edit is recorded in the revision history with the previous value. Open Actions > Revision history to see the full change log. You can then manually change the value back to what it was before.
There are a few common reasons: the PDF may have been hard to read and Nectar couldn’t extract the numbers; the bill may be a summary bill that shows only charges without detailed usage; or the usage data may be on a separate page that wasn’t captured. Check the original document and enter the values manually from the Usage tab if needed.
A summary bill is a consolidated invoice that covers multiple accounts or locations on a single document. These are common with large commercial customers. Summary bills may show only totals without per-meter breakdowns. Nectar does its best to split the data across the correct accounts and meters, but you may need to review and adjust the results.
Open the document preview on the right (on desktop) or via Actions > Open file to side when the preview is hidden. Use Download in the preview toolbar. If the bill was entered manually (not from a PDF), there will be no document to download.