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

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

The supplier invoice file to be imported. Must be a Factur-X PDF, a UBL XML invoice, or a CII XML invoice.

invoice_options
object

Optional JSON payload to enrich the imported supplier invoice. Invoice line e_invoice_line_id must match Factur-X BT-126 (LineID).

Responses

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