ZUGFeRD APIZUGFeRD-PDF und Factur-X per REST-API

curl -X POST https://api.invoapi.de/api/v1/generate \
  -H "Authorization: Bearer $INVOAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "zugferd",
    "profile": "en16931",
    "output": "pdf",
    "invoice": {
      "invoice_number": "RE-2026-0042",
      "issue_date": "2026-11-02",
      "due_date": "2026-12-02",
      "currency": "EUR",
      "buyer_reference": "PO-7781",
      "seller": {
        "name": "Muster GmbH", "vat_id": "DE123456789",
        "email": "rechnung@muster.de", "phone": "+49 30 1234567",
        "street": "Musterstraße 1", "postal_code": "10115",
        "city": "Berlin", "country_code": "DE"
      },
      "buyer": {
        "name": "Beispiel GmbH", "email": "kreditoren@beispiel.de",
        "street": "Teststraße 10", "postal_code": "20095",
        "city": "Hamburg", "country_code": "DE"
      },
      "items": [
        { "name": "IT-Beratung", "quantity": 8, "unit": "HUR",
          "unit_price": 120, "vat_rate": 19 }
      ],
      "payment": { "means_code": "58", "iban": "DE02120300000000202051" }
    }
  }'

Die Antwort aus einem echten Aufruf (gekürzt). Das PDF ist rund 50 KB groß und besteht alle drei Prüfungen:

{
  "success": true,
  "format": "zugferd",
  "version": "2.5.2",
  "profile": "en16931",
  "valid": true,
  "totals": { "net": "960.00", "tax": "182.40", "payable": "1142.40", "currency": "EUR" },
  "validation": {
    "status": "valid",
    "rule_sets": [
      "Schematron rules for EN16931 (CII)",
      "PDF/A-3 conformance (veraPDF)",
      "ZUGFeRD / Factur-X profile rules (Mustang)"
    ]
  },
  "document": {
    "filename": "RE-2026-0042.pdf",
    "mime_type": "application/pdf",
    "content_base64": "JVBERi0xLjcK…"
  }
}

Was ist eine ZUGFeRD API?

Eine ZUGFeRD API erzeugt per Programmierschnittstelle ZUGFeRD-Rechnungen: ein PDF/A-3, das für Menschen lesbar ist und zugleich die strukturierten Rechnungsdaten als XML-Datei enthält. Bei invoapi schicken Sie die Rechnungsdaten als JSON und erhalten das fertige, geprüfte ZUGFeRD-PDF zurück.

Ist ZUGFeRD dasselbe wie Factur-X?

Ja, seit ZUGFeRD 2.1 sind beide technisch identisch: Factur-X ist der französische Name desselben deutsch-französischen Standards. Die API erzeugt ZUGFeRD 2.5.2; die eingebettete Datei heißt factur-x.xml. Die ZUGFeRD API ist damit zugleich eine Factur-X API.

Welches ZUGFeRD-Profil soll ich verwenden?

Für Rechnungen an Unternehmen in Deutschland ist das Profil EN 16931 (früher COMFORT) die sichere Wahl und deshalb voreingestellt. EXTENDED brauchen Sie nur für Angaben, die die Norm nicht kennt, XRECHNUNG für Empfänger, die eine XRechnung im PDF erwarten. MINIMUM und BASIC WL erfüllen die Anforderungen an eine E-Rechnung nicht und werden nicht erzeugt.

Ist ein ZUGFeRD-PDF eine gültige E-Rechnung nach der E-Rechnungspflicht?

Ja, wenn das Profil mindestens BASIC ist und die XML-Daten der Norm EN 16931 entsprechen. Maßgeblich sind die XML-Daten, nicht das sichtbare PDF. Die API prüft genau diese Daten mit dem KoSIT-Validator und zusätzlich die PDF/A-3-Konformität mit veraPDF.

Kann ich mein eigenes Rechnungsdesign verwenden?

Ja, innerhalb fester Layouts: Logo, Akzentfarbe, Schrift, Logo-Position, Einleitungs-, Schluss- und Fußzeilentext sowie vier Layouts (standard, bold, split, boxed). Das sichtbare PDF erzeugt die API selbst, damit Bild und XML immer dieselben Zahlen zeigen.

Kann die API eingehende ZUGFeRD-Rechnungen prüfen und auslesen?

Ja. /validate prüft ein ZUGFeRD-PDF vollständig — XML-Regeln, Profil und PDF/A-3 — und /parse liest die eingebetteten Daten als JSON aus, etwa für die automatische Buchung in Ihrem System.

Was kostet die ZUGFeRD API?

Die ersten 100 Rechnungen sind kostenlos, ohne Kreditkarte. Danach ab 24 € im Monat für 500 Rechnungen (zzgl. USt.), monatlich kündbar. PDF und XML kosten gleich viel; jede Rechnung zählt einmal.