Customer & Supplier invoices - Dedicated e-invoice import endpoints

We're introducing two dedicated Factur-X import endpoints in the Company API V2, aligned with the resource-based API design.

New endpoints:

• Import a Customer E-Invoice:
  • POST /api/external/v2/customer_invoices/e_invoices/imports
  • scope: customer_invoices:all
• Import a Supplier E-Invoice:
  • POST /api/external/v2/supplier_invoices/e_invoices/imports
  • scope: supplier_invoices:all

Both endpoints accept:

• file (required) – the Factur-X PDF file
• invoice_options (optional): a JSON payload to pre-fill thirdparty and line-level mapping:
  • customer_id / supplier_id: ID of the thirdparty to associate with the invoice
  • invoice_lines: array of line enrichments, each containing:
    • e_invoice_line_id: the line identifier from the Factur-X document (BT-126 / LineID). Links each entry to the corresponding line in the imported PDF.
    • ledger_account_id: the ledger account (plan item) ID to assign to that line.

Deprecation notice:

The global endpoint POST /api/external/v2/e_invoices/imports is now deprecated and will be removed in a future version. As of today:

• Existing tokens with the e_invoices:all scope will continue to work until the endpoint is removed.
• New tokens can no longer be created with the e_invoices:all scope.

Please migrate to the dedicated endpoints above using the customer_invoices:all or supplier_invoices:all scope.