Create invoice

Creates a new invoice with an attached file or a file URL. The file will be processed
using OCR to extract invoice data.

Required Fields

  • file or file_url: Either a PDF file upload or a URL pointing to a PDF document

Optional Fields

  • amount_in_cents: The total amount of the invoice in cents
  • reference: Reference number or identifier
  • vat_rate: VAT rate as a percentage (used with amount_in_cents for simple invoices)
  • supplier_id: ID of the supplier/vendor
  • leasing_contract_id: ID of the associated leasing contract
  • asset_id: ID of the associated asset
  • asset_group_id: ID of the associated asset group
  • transaction_configuration_id: ID of the transaction configuration
  • invoice_ventilation_lines_attributes: Array of ventilation lines for multi-VAT invoices

Ventilation Lines

For invoices with multiple VAT rates, use invoice_ventilation_lines_attributes instead of
amount_in_cents/vat_rate. Each line contains:

  • amount_in_cents: Line amount in cents (TTC)
  • vat_rate: VAT rate for this line

OCR Processing

After the invoice is created, an OCR job will be triggered to extract additional
information from the invoice file, such as reference number, dates, and VAT rates.

Validation Process

New invoices are created with 'pending' status and must be validated using the
validate endpoint before they can be processed for payment.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string

Invoice reference number

integer

Invoice amount in cents (for simple invoices)

float

VAT rate percentage (for simple invoices)

date

Date when the invoice was issued

date

Date when the invoice is due

string

ID of the supplier/vendor

string

ID of the associated leasing contract

string

ID of the associated asset

string

ID of the associated asset group

string

ID of the transaction configuration

string
enum

Settlement method overriding the supplier default

Allowed:
string

ID of the agency accounting account to charge

invoice_ventilation_lines_attributes
array of objects

Ventilation lines for multi-VAT invoices

invoice_ventilation_lines_attributes
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json