E-Invoice API
API referenceDocuments

Invoice class to XML. Input must be JSON.

POST
/e-invoice/invoice2XML

Authorization

AuthorizationBearer <token>

Your API key as a bearer token: Authorization: Bearer of_live_…. An of_test_ key reaches the sandbox instead of the live service — same URL, no other change.

In: header

Query Parameters

format*string
profile*string
version*integer
Formatint32

Header Parameters

USERNAME?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/xml

application/xml

application/json

application/json

curl -X POST "https://example.com/e-invoice/invoice2XML?format=fx&profile=EN16931&version=2" \  -H "Content-Type: application/json" \  -d '{    "documentName": "Rechnung",    "documentCode": "380",    "number": "RE-2026-0042",    "currency": "EUR",    "issueDate": "2026-09-25",    "dueDate": "2026-10-09",    "deliveryDate": "2026-09-20",    "referenceNumber": "04011000-12345-67",    "paymentTermDescription": "Zahlbar bis 09.10.2026.",    "paymentReference": "RE-2026-0042",    "sender": {      "name": "Muster GmbH",      "street": "Hauptstraße 12",      "zip": "10115",      "location": "Berlin",      "country": "DE",      "vatID": "DE123456789",      "taxID": "30/123/45678",      "email": "rechnung@muster.example",      "contact": {        "name": "Erika Muster",        "phone": "+49 30 1234560",        "email": "erika@muster.example"      },      "bankDetails": [        {          "iban": "DE02120300000000202051",          "bic": "BYLADEM1001",          "accountName": "Muster GmbH"        }      ]    },    "recipient": {      "name": "Beispiel AG",      "street": "Musterweg 7",      "zip": "80331",      "location": "München",      "country": "DE",      "vatID": "DE987654321"    },    "zfitems": [      {        "id": "1",        "price": 100,        "quantity": 10,        "product": {          "name": "Beratung",          "description": "Workshop, 2 Tage",          "unit": "HUR",          "vatpercent": 19,          "taxCategoryCode": "S",          "sellerAssignedID": "SRV-001"        }      },      {        "id": "2",        "price": 20,        "quantity": 10,        "product": {          "name": "Fachbuch",          "unit": "C62",          "vatpercent": 7,          "taxCategoryCode": "S",          "sellerAssignedID": "BOOK-7"        }      },      {        "id": "3",        "price": 30.5,        "quantity": 2.5,        "product": {          "name": "Material",          "unit": "KGM",          "vatpercent": 19,          "taxCategoryCode": "S"        }      }    ]  }'
"string"