ZUGFeRD / Factur-X

Embed ZUGFeRD invoice into an existing PDF (Base64)

Takes a Base64-encoded PDF and invoice data, converts to PDF/A-3 and embeds a ZUGFeRD/Factur-X XML invoice. Returns the ZUGFeRD PDF as binary.

post/api/zugferd/embed/base64

Request

  • Base URL: https://api.dokmatiq.com
  • URL: https://api.dokmatiq.com/api/zugferd/embed/base64
  • Auth: API key in header X-API-Key

Request body

pdfBase64string required

Base64-encoded PDF

Example request

{
  "invoice": {
    "number": "RE-2026-001",
    "date": "2026-03-25",
    "dueDate": "2026-04-25",
    "currency": "EUR",
    "seller": {
      "name": "Muster GmbH",
      "street": "Musterstraße 1",
      "city": "Berlin",
      "country": "DE",
      "vatId": "DE123456789",
      "email": "info@muster.de",
      "phone": "+49 30 1234567"
    },
    "buyer": {
      "name": "Muster GmbH",
      "street": "Musterstraße 1",
      "city": "Berlin",
      "country": "DE",
      "vatId": "DE123456789",
      "email": "info@muster.de",
      "phone": "+49 30 1234567"
    },
    "items": [
      {
        "description": "Software Development",
        "quantity": 10,
        "unit": "HUR",
        "unitPrice": 150,
        "vatRate": 19
      }
    ],
    "paymentTerms": "Net 30 days",
    "bankAccount": {
      "iban": "DE89370400440532013000",
      "bic": "COBADEFFXXX",
      "accountHolder": "Muster GmbH"
    },
    "referenceNumber": "04011000-12345-67",
    "buyerReference": "04011000-12345-67",
    "sellerTaxNumber": "27/123/12345"
  }
}

Response

ZUGFeRD PDF

Changes

No recorded changes to this operation across all 1 revision of this API.