Manage invoice lines through their full lifecycle.
List Abandoned Invoice Lines for Invoice Group
Returns all abandoned invoice lines for the specified invoice group (invoice collection/account). Returns an empty response if no abandoned lines are found for the invoice group.
query Parameters
accountguidThe invoice group (invoice collection/account) ID
List Abandoned Invoice Lines for Invoice Group › Responses
Success
customerGUIclientGLNaccountGuidlastAccountStatelastAccountTimestampList Abandoned Lines.
Returns all abandoned invoice lines across all invoice groups (invoice collections/accounts) for the tenant.
query Parameters
pageThe page number to retrieve. Defaults to 1.
sizeThe number of results per page. Defaults to 1,000.
List Abandoned Lines. › Responses
Success
customerGUIclientGLNaccountGuidlastAccountStatelastAccountTimestampList Archived Invoice Lines
Returns archived invoice lines for the specified customer and invoice group (invoice collection/account).
query Parameters
customerguidThe customer ID.
accountguidThe invoice group (invoice collection/account) ID
List Archived Invoice Lines › Responses
Success
customerGUIclientGLNaccountGuidlastAccountStatelastAccountTimestampArchive Invoice Lines
Moves one or more invoice lines from the abandoned collection to the archive collection. After archiving, a report event is triggered for each affected customer.
Archive Invoice Lines › Responses
Invoice lines archived successfully
Add Invoice Line
Adds a new invoice line to the import collection for the specified customer or invoice group.
Either AccountGuid or CustomerIdErp must be provided. For products with SE or PTI line types, an accounting point and contract must be specified.
VAT is calculated automatically based on the product configuration. The billing period defaults to the current month unless explicitly provided.
Add Invoice Line › Request Body
productIdproductElementIdquantitypricedescriptionaccountGuidvatvatCodecustomerIdErpaccountingPointGuidaccountingPointIdcurrencytermStartDatetermEndDatequantityUnitAdd Invoice Line › Responses
OK
Update Imported Invoice Line
Updates a manually created invoice line in the import collection.
Only lines with import type Manually can be updated. VAT and amounts are recalculated based on the updated values and product configuration.
Update Imported Invoice Line › Responses
Invoice line updated
Retrieves uninvoiced invoice lines for the specified customer.
Returns uninvoiced (imported) invoice lines for the specified customer, optionally filtered by the supplied query parameters.
All query fields are optional and are combined using AND logic. When the request body is omitted or empty, every uninvoiced line for the customer is returned.
Filters
AccountingPointId— only lines belonging to the given accounting point.ProductId— only lines for the given product (matched on the product element id).PeriodStart— only lines whoseTermStartDateis on or after this date (inclusive).PeriodEnd— only lines whoseTermEndDateis on or before this date (inclusive).
Returns: a list of InvoiceLineDto objects. An empty list is returned when no lines match the criteria.
path Parameters
customerguidRetrieves uninvoiced invoice lines for the specified customer. › Request Body
productIdaccountingPointIdperiodStartperiodEndRetrieves uninvoiced invoice lines for the specified customer. › Responses
OK
iderpIdlineState0 (Imported), 10 (ErpExporting), 15 (ErpExported), 20 (Distributed), 30 (Sent), -2 (Deleted), -1 (Abandoned).
productIddescriptiontextaccountingPointIdperiodStartperiodEndquantityquantityUnitpriceamountvatAmountvatCodeIdvatRatecurrencyaccountPeriodvendorptiInvoiceNumberlineTypeinvoiceLineType0 (Unknown), 1 (SE), 2 (Pti), 3 (Broadband), 4 (TV), 5 (DistrictHeating), 6 (DistrictCooling), 7 (WasteManagement), 8 (InterestAmount), 9 (Services), 10 (Custom), 11 (Fee), 12 (DownPayment), 13 (ReminderFee), 14 (RestAmount), 15 (Generic), 16 (PrePayment), 17 (ChargingAgreement), 18 (RevenueShare), 1000 (Information).
importType0 (SettlementLines), 1 (PTI), 2 (NetAdmin), 3 (NetAdminWithAP), 4 (ScanVegt), 51 (Manually), 61 (FileImport), 71 (DownPayment), 81 (ErpSystem).
importTimeStampcommentUpdate VAT Code for Imported Invoice Lines
Updates the VAT code for one or more invoice lines in the import collection. All VAT codes in the request must be valid. If any VAT code is invalid, no updates are applied.
Update VAT Code for Imported Invoice Lines › Request Body
lineIdvatCodeIdUpdate VAT Code for Imported Invoice Lines › Responses
VAT codes updated
Download All Imported Invoice Lines
Returns all imported invoice lines for the tenant as a downloadable ZIP file.
query Parameters
pageThe page number to retrieve. Defaults to 1.
sizeThe number of lines per page. Defaults to 50,000.
Download All Imported Invoice Lines › Responses
ZIP file containing imported invoice lines
Add or Update Reminder Fee Line
Adds or updates a reminder fee line on an existing invoice and triggers an invoice resend for distribution.
If a reminder fee line does not already exist on the invoice, a new line is created using the configured reminder fee product. If a line exists, it is updated with the new fee amount. The invoice is then queued for redistribution.
Note: Requests with collector status codes 42502 or 42505 are accepted but ignored without updating the invoice.
Add or Update Reminder Fee Line › Responses
Reminder fee line added or updated
invoiceLineState0 (Imported), 10 (ErpExporting), 15 (ErpExported), 20 (Distributed), 30 (Sent), -2 (Deleted), -1 (Abandoned).
customerGUIaccountingPointIdaccountingPointGuidimportedIdcontractinvoiceGuidprepaymentInvoiceGuidelectricityInvoiceGuidtermStartDatetermEndDatelineTypeinvoiceLineType0 (Unknown), 1 (SE), 2 (Pti), 3 (Broadband), 4 (TV), 5 (DistrictHeating), 6 (DistrictCooling), 7 (WasteManagement), 8 (InterestAmount), 9 (Services), 10 (Custom), 11 (Fee), 12 (DownPayment), 13 (ReminderFee), 14 (RestAmount), 15 (Generic), 16 (PrePayment), 17 (ChargingAgreement), 18 (RevenueShare), 1000 (Information).
descriptionquantityunitPriceInCurrencydiscountvatCodeIdvatCodeIdOverridenvatRateerpVatCodevatAmountuomcurrencyerpIdproductGuidamounttextvendoraccountReferenceaccountGuidReferenceskipInvoiceControlptiInvoiceNumberptiInvoiceNumberCanceledisPrintFeenotReimportabletimeStampimportTimeStampotherPayererpQuantityerpUnitPriceInCurrencyerpAmounterpVatAmountexportGuidptiApInformationaccountGuidimportType0 (SettlementLines), 1 (PTI), 2 (NetAdmin), 3 (NetAdminWithAP), 4 (ScanVegt), 51 (Manually), 61 (FileImport), 71 (DownPayment), 81 (ErpSystem).
correlationLineMatchexternalIntervalexternalIdentityrawAmountrestAmountisPreliminaryprelimPeriodEndprelimPeriodStarthasNotMeteredaccountPeriodremainingTermscommenthasTurnedNegativePrice
