Create invoice payable
Creates a new invoice payable document. Supports inline line items via the lineItems field for single-request creation.
Request
- Base URLhttps://light.inc (the document declares no server; this is the origin it was published from)
- Auth
- API key in header Authorization
- or HTTP bearer
Headers
Request body
ID of the vendor.
Invoice total amount in cents.
How the invoice should be processed (skip AI Parse or AI Parse + merge).
⚠️ This enum is not exhaustive; new values may be added in the future.
Type of bill to create. SELF_BILLED creates a self-billed invoice that you issue on the vendor's behalf: it starts as a draft and takes the company entity's next self-billed number when it is submitted or posted, unless invoiceNumber is set. Rejected when processingMode is AI_PARSE_AND_MERGE.
⚠️ This enum is not exhaustive; new values may be added in the future.
ID of the self-billed document template used to render the bill. Must be an active self-billed template assigned to companyEntityId. When omitted on a self-billed bill, the newest active self-billed template of the company entity is used. Rejected when processingMode is AI_PARSE_AND_MERGE.
ID of the company entity.
Invoice number.
Invoice description.
Issue date of the original vendor invoice.
Date the invoice payable is posted to the ledger, which sets its accounting period independently of the issued date. Defaults to the issued date when omitted on creation.
Payment due date of the invoice payable.
Date/time when payment is scheduled or was executed for this invoice payable.
ID of the sender bank account from which this invoice payable will be paid.
Whether invoice line item amounts are entered as tax-inclusive. When true, line item amount is expected to be the gross amount including tax; when false, line item netAmount is expected to be the base amount excluding tax.
Custom FX rate for the ledger's local currency. If not provided, Light uses official ECB rates.
Custom FX rate for the ledger's group currency. If not provided, Light uses official ECB rates.
Example request
{
"currency": "USD"
}Response
default response
External ID of the invoice payable object.
Type of the invoice payable (e.g. vendor invoice or reimbursement).
⚠️ This enum is not exhaustive; new values may be added in the future.
Internal ID of the underlying invoice payable record.
ID of the company this invoice payable belongs to.
Current state of the invoice payable in its lifecycle (from ingestion to payment/completion).
⚠️ This enum is not exhaustive; new values may be added in the future.
High-level reason why processing the invoice payable failed, if any.
⚠️ This enum is not exhaustive; new values may be added in the future.
Approval note associated with the invoice payable (e.g. approver comments).
Reason why the invoice payable was cancelled, if applicable.
Name of the payee for this invoice payable.
Payee IBAN used for payment of this invoice payable.
Payee BBAN (Basic Bank Account Number) used for local payments.
Payee bank BIC/SWIFT code.
Payee bank/branch code used for local payments.
Payee Swedish Bankgiro number, if applicable.
Payee Swedish Plusgiro number, if applicable.
Country of the payee.
⚠️ This enum is not exhaustive; new values may be added in the future.
Street address of the payee.
ZIP/postal code of the payee.
Name of the payee's bank.
Country of the payee's bank.
⚠️ This enum is not exhaustive; new values may be added in the future.
Street address of the payee's bank.
ZIP/postal code of the payee's bank.
City of the payee.
City of the payee's bank.
ID of the vendor entity this invoice payable is linked to, if any.
ID of the company entity this invoice payable is booked under.
Invoice number provided on the vendor invoice.
Total invoice amount in cents, expressed in the invoice currency.
Outstanding invoice balance to be paid in cents, expressed in the invoice currency. 0 means the bill is settled. null means Light derived no balance for it — for instance the bill has no amount yet, its state is CANCELLED, DECLINED or DUPLICATED, or the company does not keep its ledger in Light — so do not read null as fully paid.
Amount paid against the invoice in cents, expressed in the invoice currency. Credit notes and reversed payments are not counted. null means Light derived no balance for the bill, as for outstandingBalance.
Description or memo for the invoice payable.
ID of the sender bank account from which this invoice payable will be paid.
FI (Finnish reference) number associated with this invoice payable, if applicable.
Finnish payment reference (viitenumero or RF Creditor Reference) associated with this invoice payable, if applicable.
Norwegian KID reference associated with this invoice payable, if applicable.
Swiss payment reference (QR-Reference or Creditor Reference/SCOR) associated with this invoice payable, if applicable.
Swedish OCR reference associated with this invoice payable, if applicable.
Override for the reference sent to the bank alongside the payment, used when the invoice number itself exceeds the payment scheme's length limit. Falls back to the invoice number when unset.
Purpose code the paying bank's regulator requires for this payment (e.g. a Norwegian Skatteetaten code for cross-border payments above NOK 100,000). The allowed codes come from the purpose-code requirements endpoint.
Purpose code the receiving bank's regulator requires for this payment (e.g. an RBI code for payments to India). The allowed codes come from the purpose-code requirements endpoint.
Date/time when payment is scheduled or was executed for this invoice payable.
Timestamp when OCR processing for this invoice payable was completed.
Timestamp when this invoice payable was cancelled.
Issue date of the original vendor invoice.
Date the invoice payable is posted to the ledger, which sets its accounting period.
Payment due date of the invoice payable.
Timestamp when the invoice payable record was created.
Timestamp when the invoice payable record was last updated.
ID of the purchase order linked to this invoice payable, if any.
ID of the self-billed document template used to render this invoice payable, if any.
Whether invoice line item amounts are entered as tax-inclusive. When true, line item amount is expected to be the gross amount including tax; when false, line item netAmount is expected to be the base amount excluding tax.
Foreign exchange rate to the ledger's local currency. If null, the system uses its default FX source.
Foreign exchange rate to the ledger's group currency. If null, the system uses its default FX source.
ID of the user who paused payment for this invoice payable, if payment is paused.
Timestamp when payment for this invoice payable was paused, if applicable.
Email address from which the invoice payable was received, if known.
Name of the original document file associated with this invoice payable.
Example response
{
"currency": "USD"
}Changes
No recorded changes to this operation across all 1 revision of this API.