Create
Creates a ZUGFeRD 2.x hybrid PDF/A-3 from structured JSON. The default (and recommended) profile is EN 16931; a `specificationId` declaring an official Factur-X/ZUGFeRD profile URN selects that profile instead. For the header-only booking-aid profiles (MINIMUM, BASIC WL) the embedded XML carries the profile's header subset while the rendered PDF, which is the legal invoice for those profiles, shows the full line data; line items therefore remain required input. Declaring the XRechnung 3.0 URN selects the XRECHNUNG reference profile (ZUGFeRD 2.2+): the embedded XML is an XRechnung in CII syntax, attached as `xrechnung.xml` and validated against the German CIUS rules, so the XRechnung requirements apply (Leitweg-ID in `buyerReference`, seller contact, electronic addresses).
post/v1/create/zugferd
Request
- Base URL: https://api.invoicexml.com
- URL: https://api.invoicexml.com/v1/create/zugferd
- Auth: none declared
Request body
Example request
{
"invoice": {
"invoiceNumber": "INV-2026-00045",
"issueDate": "2026-05-17",
"currency": "EUR",
"seller": {
"name": "Acme Engineering GmbH",
"vatIdentifier": "DE123456789",
"legalRegistration": "HRB 12345",
"postalAddress": {
"line1": "Hauptstraße 12",
"city": "Berlin",
"postCode": "10115",
"country": "DE"
}
},
"buyer": {
"name": "Globex SAS",
"postalAddress": {
"line1": "15 rue de Rivoli",
"city": "Paris",
"postCode": "75001",
"country": "FR"
}
},
"paymentDetails": {
"paymentAccountIdentifier": "DE89370400440532013000"
},
"lines": [
{
"quantity": 10,
"priceDetails": {
"netPrice": 150
},
"vatInformation": {
"rate": 19
},
"item": {
"name": "Senior consulting"
}
}
]
},
"options": {
"language": "EN",
"brandColor": "#0F766E"
}
}Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.