Getting started and preparing your data
Upload and manage energy invoices
Table of contents
Supported invoice files
Vega accepts original invoice files in PDF or supported XML format. For PDF invoices, use the original digital file supplied by the energy supplier or network operator.
Scanned PDFs and photographs are not currently supported reliably. If you only have paper documents, request the original electronic invoice rather than scanning it.
You can import up to 24 invoice files at one time.
Upload invoices from Chat
This is the quickest method when you want to discuss the imported invoices immediately. Confirm the active workspace before uploading.
- Confirm that the correct account is active.
- Open New Chat or the conversation that should contain the invoice analysis.
- Select the Upload invoice files button beside the message input.
- Choose one or more original invoice files.
- Confirm the selection.
- Keep the conversation open while the progress indicator is visible.
- Wait for the import summary.
- Review Vega’s response before asking follow-up questions.
After upload, the conversation reports the outcome categories that occurred:
- Imported means a new invoice was created.
- Overwritten means Vega replaced an existing invoice record with updated imported content.
- Already existed means an identical or matching invoice was detected and retained.
- Failed means the file could not be imported.
A mixed batch can contain successful and failed files. Read the counts rather than assuming the entire selection had one outcome.
When several invoices are selected, the summary identifies the outcome for the batch and reports individual file failures. Retry a failed file by itself rather than reimporting every successful file.
Upload invoices from an inventory component
When an invoice belongs to a known metering component, first make sure you understand the site and component hierarchy:
- Open Inventory.
- Open the relevant site.
- Open Components and select the utility or metering component.
- Open Invoices.
- Select Add invoices.
- Choose the PDF or XML files.
- Wait for the upload to finish.
- Confirm that the invoices appear in the list.
The Invoices tab appears only for components that support associated invoices.
Review imported invoice details
From a component’s Invoices tab:
- Find the invoice by date, provider, invoice number, or billing period.
- Expand the row to inspect parsed details.
- Check the measurement or supply point, meter number, customer, address, and contract information.
- Review the billing period and consumption totals.
- Review high- and low-tariff quantities where available.
- Check energy, network-fee, contribution, VAT, net, and gross values.
- Use Open invoice to compare the parsed values with the source file.
An imported value should always be traceable to the original invoice. If a critical field is missing or incorrect, treat that invoice as unverified.
Ask useful invoice questions
After a successful import, Vega can use the structured invoice fields for deterministic summaries and comparisons. It can also match an invoice to stored measurements when the component and exact billing period are available. Apply the principles in Ask your first question and try questions such as:
- “Summarize these invoices by billing period, consumption, and gross cost.”
- “Which meter and site does each invoice refer to?”
- “Compare billed consumption with measured consumption for the same complete periods.”
- “Separate energy, network fees, taxes, and other contributions.”
- “Identify duplicate periods, missing months, or unusual cost changes.”
- “Show contracted power by tariff block where available.”
Always name or select the site or meter when the account contains more than one possible match.
For a reconciliation, give Vega the exact invoice or billing period and ask it to state the matched component, measured coverage, billed quantity, measured quantity, and difference. This makes a missing interval or incorrect component match visible before you rely on the result.
Delete an incorrect invoice
- Open the relevant component’s Invoices tab.
- Find the incorrect invoice.
- Select the red Delete invoice button.
- Confirm the deletion.
- Refresh the list and verify that the invoice is gone.
- Upload the correct original file if needed.
Deletion removes the imported invoice record. Keep your source file in your organization’s document system.
Resolve common import problems
The batch is rejected before upload
Select no more than 24 files and try again.
A file fails
Check that:
- it is an original PDF or supported XML invoice,
- the file opens normally outside Vega,
- it is not password-protected,
- it is not a scan or image-only PDF, and
- it contains an energy invoice rather than unrelated correspondence.
Retry the failed file by itself so that the result is easier to diagnose.
Vega says the invoice already exists
Open the component’s invoice list and compare invoice number, provider, and period. Do not upload renamed copies to bypass duplicate detection.
The invoice appears under an unexpected place
Check the supply point, GSRN or measurement identifier, meter number, and address parsed from the invoice. Confirm that Inventory contains the correct site and component. Use the data-readiness checklist and escalate a wrong association rather than using the invoice in a site comparison.
Parsed totals look wrong
Open the source invoice and compare the billing period, total kWh, net amount, VAT, gross amount, and tariff values. Ask Vega to state which extracted fields it used, but rely on the original invoice for verification.
Before reconciling invoices with measurements
The guide Compare invoices with measured consumption covers the full reconciliation workflow. Before starting, confirm that:
- the invoice billing period is known,
- the matching meter is connected,
- measurement coverage includes the complete period,
- units and energy direction agree, and
- partial first or last days are handled consistently.
A difference does not automatically mean that either source is wrong. Billing corrections, estimation, time-zone boundaries, losses, taxes, and different period definitions may require investigation.