API Reference

Import a customer e-invoice

post
https://app.pennylane.com/api/external/v2/customer_invoices/e_invoices/imports

Import a customer 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 customer 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: customer_invoices:all

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

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

boolean

If true, the invoice will be automatically sent to the PA after parsing.
The send is optimistic: it happens without waiting for schematron validation.
If the invoice is invalid, the PA may reject it later (visible via e_invoicing.status).

invoice_options
object

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

Responses

Updated 3 months ago

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

Updated 3 months ago