Skip to main content
POST
Create a sales invoice

Authorizations

Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Body

application/json
tracking_number
string
required

Parcel tracking number

Example:

"3SABCD1234567"

items
object[]
required

List of invoice line items

currency_code
string
required

ISO 4217 currency code

Example:

"EUR"

tax_rate
number<double>
required

Tax rate percentage (0-99)

Required range: 0 <= x <= 99
Example:

21

company_logo_path
string | null

Optional company logo to include on the invoice. Provide a base64-encoded PNG image string or a public url leading to the company logo image. If not provided a company name will be used to generate a default logo.

force
boolean
default:false

Bypasses the maximum invoice amount validation (5000 EUR). Only use this when strictly necessary, as the validation exists to prevent erroneous invoices.

Response

Invoice generated successfully

file_token
string
required

A token referencing the generated document. Use this token when attaching the document to a ticket (in the attachments array) or when submitting it as part of a requested data response.

preview_url
string
required

Temporary pre-signed URL for previewing or downloading the generated PDF. This URL expires after 72 hours and should not be stored for long-term use.