Sign in

v1

latestOpenAPI 3.0.12026-07-141671231.8 MB
Supplier Invoices

Import a supplier e-invoice

Import a supplier invoice from an e-invoice file. The file must be a Factur-X PDF, a standalone UBL XML invoice, or a standalone CII XML invoice. Optionally provide invoice_options to pre-fill supplier and line-level data. Invoice line e_invoice_line_id must match Factur-X BT-126 (LineID) or the UBL/CII line identifier.

⚠️ UBL and CII XML support is in alpha. A 201 response confirms the file was accepted and parsed, but invoices imported via standalone UBL or CII XML have two known limitations:

  • The uploaded file is not displayed in the app — no document preview is generated yet for these formats.
  • The invoice is not recognized as an electronic invoice within Pennylane.

Factur-X PDF remains the recommended format for production use.

ℹ️ This endpoint requires the following scope: supplier_invoices:all

post/api/external/v2/supplier_invoices/e_invoices/imports

Response

Supplier e-invoice imported successfully

idinteger required
urlstring required

The URL of the imported supplier e-invoice. This can be used to access the document later.

Example response

{
  "id": 42
}