LIlight
v1 - Invoice Receivables

Open invoice

Initiates the process of opening an invoice receivable. This assigns an invoice number, locks the invoice for editing, and optionally sends it via email or submits it to e-invoicing systems. The request body is optional - if not provided, the invoice will be opened with default settings (no email sent, no e-invoice submission).

post/v1/invoice-receivables/{invoiceReceivableId}/open

Request

  • Base URL
    https://light.inc (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header Authorization
    • or HTTP bearer

Path parameters

invoiceReceivableIdstring uuid required

Request body

shouldSendEmailboolean

Whether to send the invoice via email when opening. Defaults to false

shouldSubmitEInvoiceboolean

Whether to submit the invoice to the e-invoicing system (if configured). Defaults to false

Response

Invoice open process initiated successfully. The invoice status will change to OPEN_IN_PROGRESS. You must poll the invoice to check when it changes to OPEN. If the invoice fails to open, the status will change back to DRAFT and the failureContext field will be populated with the error details.

idstring uuid

Unique identifier for the object

companyIdstring uuid

ID of the company

contractIdstring uuid nullable

ID of the contract, if this is invoice is linked to a contract

companyEntityIdstring uuid nullable

ID of the entity

amountinteger

Total invoice amount in smallest denomination, with discounts and tax applied

paymentType'AIRWALLEX' | 'BANK_TRANSFER' | 'DIRECT_DEBIT' | 'STRIPE' nullable

Payment type for the invoice

  • AIRWALLEX - Payment via Airwallex. A payment link will be displayed on the invoice
  • BANK_TRANSFER - Payment via bank transfer. Bank information will be displayed on the invoice
  • DIRECT_DEBIT - Payment via direct debit. A notice that the amount will be collected automatically will be displayed on the invoice
  • STRIPE - Payment via Stripe. A payment link will be sent to the customer

⚠️ This enum is not exhaustive; new values may be added in the future.

payeeBankAccountIdstring uuid nullable

ID of the bank account where money should be sent to

invoiceDatestring date nullable

Date the invoice was issued

effectiveInvoiceDatestring date

The invoice date shown to customers; falls back to the posting date when the invoice date is not set

postingDatestring date

Date the invoice is posted to the ledger (drives GL, VAT and revenue recognition)

dueDatestring date nullable

Date the invoice payment is due

netTermsinteger nullable

Number of days from the invoice date to when the invoice is due. Updating this field will automatically set the invoice due date

customerIdstring uuid nullable

ID of the customer

invoiceTemplateIdstring uuid nullable

ID of the invoice template

invoiceTemplateAdditionalTextstring nullable

Text that will added to the additional text section of the invoice template

invoiceNumberstring nullable

Invoice number. This number is guaranteed to be unique and sequential per entity. By default Light will generate this number when the invoice is opened, but you can provide your own custom number when creating or updating a draft invoice

type'STANDARD' | 'SELF_BILLED'

Who raised the invoice

  • STANDARD - The company raised the invoice
  • SELF_BILLED - The customer issued the invoice on the company's behalf and sent it in

⚠️ This enum is not exhaustive; new values may be added in the future.

state'CREATED' | 'DRAFT' | 'OPEN_IN_PROGRESS' | 'OPEN' | 'PAYMENT_PENDING' | 'PARTIALLY_PAID' | 'PAID' | 'REVERSED' | 'ARCHIVED'

The invoice state

  • CREATED - The invoice document was received and is waiting to be parsed. Next valid state is DRAFT
  • DRAFT - The invoice is in draft and can be modified. Next valid states are OPEN_IN_PROGRESS or ARCHIVED
  • OPEN_IN_PROGRESS - The invoice is being opened. Next valid state is OPEN or DRAFT
  • OPEN - The invoice is open. Next valid states are PAYMENT_PENDING, PARTIALLY_PAID, PAID or ARCHIVED
  • PAYMENT_PENDING - The payment was initiated by Light and is waiting to be collected. Next valid state is PAID
  • PARTIALLY_PAID - The invoice is partially paid. Next valid state is PAID
  • PAID - The invoice is fully paid
  • REVERSED - The invoice was reversed by a credit note and reissued as a new invoice; it is locked and cannot be modified
  • ARCHIVED - The invoice is archived and cannot be modified

⚠️ This enum is not exhaustive; new values may be added in the future.

openedAtstring date-time nullable

Timestamp when the invoice was opened

poNumberstring nullable

Purchase order number

referencestring nullable

Reference number for cross-referencing with procurement and invoicing workflows

paymentReferencestring nullable

Payment reference generated by Light for the customer's bank payment

descriptionstring nullable

Description of the invoice

currencystring
taxEngineName'AVATAX' | 'LIGHT' | 'SPHERE'

Name of the tax engine to be used

  • AVATAX - Avalara AvaTax will be used for tax calculations
  • LIGHT - Light built-in tax engine will be used for tax calculations
  • SPHERE - Sphere tax engine will be used for tax calculations

⚠️ This enum is not exhaustive; new values may be added in the future.

areLinesWithTaxboolean

Whether the invoice line amount is inclusive of tax or not. True means tax is already included in the line amount and will not be added on top, false means tax will be added on top of the line amount

localCurrencyFxRatenumber nullable

Custom foreign exchange rate for the ledger's local currency. If not provided Light uses official ECB rates

groupCurrencyFxRatenumber nullable

Custom foreign exchange rate for the ledger's group currency. If not provided Light uses official ECB rates

createdAtstring date-time

Timestamp when the invoice was created

updatedAtstring date-time

Timestamp when the invoice was last updated

updatedBystring uuid nullable

ID of the user who last updated the invoice

Example response

{
  "currency": "USD"
}

Changes

No recorded changes to this operation across all 1 revision of this API.