API Reference
Start typing to search…

Import a supplier invoice with a file attached

post
https://app.pennylane.com/api/external/v2/supplier_invoices/import

This endpoint allows you to import a supplier invoice with a file attached.

This endpoint requires the following scope: supplier_invoices:all

Query Params
boolean
Defaults to true

If you are already using the X-Use-2026-API-Changes header, you can ignore this parameter.

The Pennylane API is introducing important changes, which will be rolled out in three phases: preview, sunset and cleanup.

For new user, please use this parameter with true value to opt in directly to the new version of the API.

Preview phase: From January 14th to April 7th 2026. Opt in by setting this attribute to true to test and migrate to the new behavior.

Sunset phase: From April 8th to June 30th 2026. The new behavior becomes the default. Set this attribute to false if you need additional time to migrate.

Cleanup phase: Starting July 1st 2026 The old behavior will no longer be available. You must have migrated by this point.

For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions.

Body Params
int64
required

The ID of the supplier invoice file attachment to import

boolean
Defaults to false

This will mark the invoice as incomplete.

int64
required

The ID of the supplier to import the invoice for

date
required

The date of the invoice (ISO 8601)

date
required

Invoice payment deadline (ISO 8601)

string

The invoice number

string
enum
Defaults to EUR
string
required

Invoice currency amount before tax (total value before tax of the invoice in the currency of the invoice)

string
required

Invoice currency amount (total value of the invoice in the currency of the invoice)

string

Invoice amount in euros (total value of the invoice in euros). If the currency is euro, currency_amount and amount are identical.

string
required

Invoice taxable amount (in invoice currency)

string

Invoice taxable amount (in euros). If the currency is euro, currency_tax and tax are identical.

string | null

Custom label for the invoice used on accounting (ledger) entries. If not provided, Pennylane generates a label automatically.

transaction_reference
object

By adding this field you can automatically reconcile the newly imported invoice with a transaction. See documentation about automatic payment matching.

invoice_lines
array of objects
required
length ≥ 1
invoice_lines*
string
deprecated

Invoice line label

This attribute is deprecated and will be removed soon.

string
deprecated

Invoice line description

This attribute is deprecated and will be removed soon.

string
required

Invoice line total amount in the currency of the invoice.

string

Invoice line amount in euros. If the currency is euro, currency_amount and amount are identical.

string
required

Invoice line taxable amount (in euros). If the currency is euro, currency_tax and tax are identical.

string

Total tax amount in currency

int64

The ledger account ID

string
enum
required

Product VAT rate. A 20% VAT in France is FR_200.

imputation_dates
object
ledger_entry_line
object
string

A unique external reference you can provide to track this supplier. If not provided, Pennylane will generate an identifier for you.

Responses

Updated 23 days ago

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