Fehler-Referenz

Alle Fehler folgen einer einheitlichen JSON-Struktur. Validierungsfehler enthalten außerdem line und path, damit Sie diese direkt in Ihrer UI anzeigen können.

Fehlerobjekt-Struktur

{
  "valid": false,
  "errors": [
    {
      "code": "BR-01",
      "severity": "error",
      "message": "Eine Rechnung muss einen Spezifikationsbezeichner haben.",
      "path": "/Invoice/CustomizationID",
      "line": 3,
      "suggestion": "Fügen Sie <cbc:CustomizationID>urn:cen.eu:en16931...</cbc:CustomizationID> hinzu"
    }
  ]
}

HTTP-Statuscodes

Status	Bedeutung
200	Anfrage verarbeitet. Prüfen Sie das Feld `valid` für die Rechnungsgültigkeit.
400	Fehlerhafte Anfrage (falscher Content-Type, leerer Body, nicht unterstütztes Format).
401	Fehlender oder ungültiger API-Key.
403	Gültiger Schlüssel, aber unzureichender Scope für diesen Endpunkt.
413	Datei überschreitet das 10-MB-Limit.
422	Datei ist parsebar, aber strukturell ungültig.
429	Rate-Limit überschritten. Erneut versuchen nach dem `Retry-After`-Header-Wert (Sekunden).
500	Interner Serverfehler. Erneuter Versuch mit exponentiellem Backoff ist sicher.

Häufige Validierungsfehlercodes

Code	Regel	Beschreibung
BR-01	EN16931	Fehlender CustomizationID (Spezifikationsbezeichner).
BR-02	EN16931	Fehlende Rechnungsnummer.
BR-03	EN16931	Fehlendes Rechnungsdatum.
BR-04	EN16931	Fehlender Rechnungstyp-Code.
BR-10	EN16931	Fehlender Käufername.
BR-11	EN16931	Fehlender Verkäufername.
BR-CO-15	EN16931	Rechnungsgesamt-Mehrwertsteuerbetrag muss der Summe der Steuerunterpositionen entsprechen.
XR-01	XRechnung	Käuferreferenz (Leitweg-ID) ist für öffentliche Auftraggeber erforderlich.
XR-02	XRechnung	Ungültiges Leitweg-ID-Format.
ZF-01	ZUGFeRD	Eingebettetes XML stimmt nicht mit PDF-Metadaten überein.
ZF-02	ZUGFeRD	PDF ist nicht PDF/A-3-konform.