Validierungs-API-Referenz

Der Validierungsendpunkt prüft XML-Rechnungen gegen den EN 16931-Standard und XRechnung-spezifische Regeln. Er unterstützt UBL 2.1, CII (Cross Industry Invoice) und ZUGFeRD-Profile.

Endpunkt

POST /v1/invoices/validate

Authentifizierung

Übergeben Sie Ihren API-Schlüssel im Authorization-Header:

Authorization: Bearer ps_live_...

Anfrage

Senden Sie die rohe XML-Rechnung als Request-Body mit Content-Type: application/xml.

curl -X POST https://api.postscale.io/v1/invoices/validate \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/xml" \
  -d @invoice.xml

Abfrageparameter

Antwort

Erfolg (200)

{
  "valid": true,
  "format": "xrechnung-ubl",
  "standard": "EN 16931",
  "profile_version": "3.0.2",
  "errors": [],
  "warnings": [
    {
      "rule": "BR-CL-01",
      "path": "/Invoice/InvoiceTypeCode",
      "message": "Invoice type code should use UNTDID 1001 subset",
      "severity": "warning"
    }
  ]
}

Validierung fehlgeschlagen (200)

{
  "valid": false,
  "format": "xrechnung-ubl",
  "standard": "EN 16931",
  "errors": [
    {
      "rule": "BR-02",
      "path": "/Invoice/AccountingSupplierParty/Party/PartyName",
      "message": "An Invoice shall have a Seller name (BT-27)",
      "severity": "error"
    },
    {
      "rule": "BR-DE-01",
      "path": "/Invoice/AccountingSupplierParty/Party/Contact",
      "message": "A German invoice must contain seller contact information",
      "severity": "error"
    }
  ],
  "warnings": []
}

Fehlercodes

Validierungsregeln

Der Validator wendet Regeln in drei Schichten an:

1. EN 16931 Geschäftsregeln (BR-*) — Kernregeln des europäischen E-Invoicing-Standards
2. XRechnung-Regeln (BR-DE-*) — deutschlandspezifische Regeln (Leitweg-ID, Kontaktdaten, Zahlungsbedingungen)
3. Syntaxregeln — UBL 2.1- oder CII D16B-Schemavalidierung

Jeder Fehler enthält die Regel-ID, den XML-Pfad, an dem der Verstoß aufgetreten ist, und eine menschenlesbare Nachricht.

Rate-Limits

Validierungsanfragen sind pro API-Schlüssel ratenbegrenzt: