PDF zu XRechnung · ZUGFeRD · EN 16931

PDF-Rechnung zu XRechnung per API

Ein normales PDF hineingeben, einen geprüften EN-16931-Entwurf (XRechnung, UBL) mit Konfidenz je Feld herausbekommen. Dieselbe Seite auf English.

Keine Karte nötig. Das Ergebnis ist immer ein Entwurf, den Sie vor dem Versand prüfen.

Kurz: POST /einvoice/extract liest den Text einer PDF-Rechnung mit KI, ordnet die Felder dem JSON von /einvoice/create zu und erzeugt daraus eine XRechnung, die gegen CEN EN 16931 und die KoSIT-Regeln geprüft wird. Jedes Feld hat einen Konfidenzwert, die Summen werden nachgerechnet, und das Ergebnis ist als draft_for_review markiert.

Was der Endpunkt tut

  • PDF rein, Entwurf raus. XRechnung (UBL), EN 16931 oder Peppol BIS 3 aus einem PDF mit Textebene. Ein ZUGFeRD-/Factur-X-PDF wird nicht neu gelesen, sondern an /einvoice/parse verwiesen.
  • Konfidenz je Feld. Modellwert plus Prüfungen: Wert im PDF-Text, USt-IdNr.-Format, IBAN-Prüfsumme, geratenes Land.
  • Rechenprüfung. Summen werden aus den Positionen nachgerechnet und mit den gedruckten Summen verglichen.
  • Formale Prüfung. Wie bei /einvoice/create: XML-Schema, EN 16931 und KoSIT XRechnung 3.0.2, mit Regel-ID und Korrekturhinweis je Fehler.

Beispiel

$KEY ist Ihr API-Schlüssel. Nutzen Sie nur Test-PDFs mit synthetischen Daten, solange Sie den Endpunkt prüfen.

shell
# Needs an API key. Send a plain PDF invoice (text layer), get a draft back
curl -s -X POST "https://api.wsystem.dev/einvoice/extract?format=xrechnung" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/pdf" \
  --data-binary @invoice.pdf > draft.json

# What to look at first
jq '{status, low: .review.low_confidence, arith: .arithmetic_check.all_match, valid: .validation.valid}' draft.json

# The XML is built only if the amounts add up to the printed totals; check the fields first
jq -r .xml draft.json > INV-2026-001.xml

Aufbau der Antwort, gekürzt, mit ausgedachten synthetischen Werten. Das Beispiel zeigt den wichtigen Fall: Die Beträge ergeben nicht die gedruckten Summen, deshalb ist der Status needs_review_amounts und es wird kein XML erzeugt. Passt alles, ist der Status draft_for_review und die Antwort enthält XML und Prüfergebnis.

{
  "status": "needs_review_amounts",
  "review_required": true,
  "format": "xrechnung",
  "fields": [
    {
      "path": "invoice_number",
      "value": "RE-2026-0815",
      "confidence": 0.98,
      "checks": [
        "found_in_pdf_text"
      ]
    },
    {
      "path": "lines.1.unit_price_net",
      "value": 778,
      "confidence": 0.5,
      "checks": [
        "found_in_pdf_text",
        "totals_mismatch"
      ]
    }
  ],
  "review": {
    "low_confidence": [
      "lines.1.unit_price_net"
    ],
    "blocked": "extracted amounts do not match the printed totals; fix the lines, then POST the invoice JSON to /einvoice/create"
  },
  "arithmetic_check": {
    "all_match": false,
    "rows": [
      {
        "check": "sum of line nets (BT-106/109)",
        "computed": "1556.00",
        "printed": "778.00",
        "match": false
      }
    ]
  },
  "xml": null,
  "disclaimer": "AI-extracted draft for review. Fields can be wrong or missing even when the invoice validates; check every value against the source PDF."
}

Ehrliche Zahlen aus unseren Tests

Wir haben den Extraktor an 20 synthetischen deutschen Rechnungen entwickelt, die uns ein Softwarehersteller gegeben hat, und danach an drei weiteren synthetischen Sätzen mit je 20 Rechnungen getestet, die wir selbst in anderen Layouts, Sprachen und Währungen erzeugt haben. Jedes Feld wurde gegen eine vorab festgelegte Musterlösung geprüft. Frühere Testrunden haben wir genutzt, um den Extraktor zu verbessern; nur der jüngste Satz war ihm vorher unbekannt.

  • Entwicklungssatz (20 Rechnungen): 19 von 20 komplett richtig am Live-Endpunkt (1.112 von 1.113 Feldern, 99,9 %). Die erste Version kam auf 12 von 20.
  • Jüngster ungesehener Test (20 Rechnungen, 14 Sprachen, 8 Währungen, Gutschriften, Absender nur in der Fußzeile): 19 von 20 komplett richtig. Das gilt nach Korrektur von vier Fehlern in unserer Musterlösung (im PDF-Text nachgeprüft); beim ersten Auswerten waren es 15 von 20.
  • Zwei frühere ungesehene Runden ergaben 15 von 20 und 10 von 20. Die Fehler (Vorzeichen bei Gutschriften, vertauschte Verkäufer/Käufer, Einheitencodes, Postleitzahlen) wurden behoben; die späteren Runden zeigen die Wirkung.
  • „Komplett richtig“ heißt: jedes geprüfte Feld stimmt. Alle Rechnungen sind synthetisch, keine echten Kundenrechnungen; mit echten Rechnungen kann die Genauigkeit je Layout abweichen.
  • Die Rechenprüfung sperrt das XML, wenn die Beträge nicht zu den gedruckten Summen passen. Eine formal gültige XRechnung kann trotzdem falsch sein (im ersten Test: Gesamtsumme 1.556,00 statt 778,00).
  • Nur aus den extrahierten Daten waren im ersten Test 0 von 20 als XRechnung gültig, weil Angaben fehlen, die nicht auf dem PDF stehen (z. B. Ansprechpartner des Verkäufers, E-Mail-Adressen, Mandatsreferenz). Mit solchen Stammdaten aus einem Firmenprofil waren es 12 von 20. Rechnen Sie also damit, dass Ihre Software Stammdaten ergänzt. Das Ergebnis bleibt ein Entwurf, den Sie vor dem Versand prüfen.

Datenschutz und Grenzen

  • Der PDF-Text wird zur Verarbeitung an OpenAI geschickt (Unterauftragsverarbeiter, siehe DPA und Datenschutz). Nutzen Sie die Funktion nur, wenn Sie das für Ihre Rechnungen dürfen.
  • Keine OCR: gescannte Bilder werden abgelehnt.
  • Keine Zertifizierung und keine Rechts- oder Steuerberatung.

Preis

80 Einheiten pro erfolgreicher Extraktion: 0,157 € im Pro-Plan (49 € für 25.000 Einheiten) und 0,304 € im Starter-Plan (19 € für 5.000 Einheiten). Fehlgeschlagene Extraktionen werden nicht berechnet. Der Gratis-Schlüssel enthält 3 Extraktionen pro Monat zum Testen; danach braucht es einen bezahlten Plan. Platform-Schlüssel verbrauchen 80 der 25.000 Fair-Use-Einheiten des Plans. Preise

Fragen

Ist das Ergebnis eine fertige E-Rechnung?

Nein. Es ist ein Entwurf zur Prüfung. Jede Antwort hat den Status draft_for_review. KI kann Werte falsch lesen oder erfinden, und eine Datei kann die KoSIT- und EN-16931-Regeln bestehen und trotzdem falsche Beträge enthalten. Eine Person sollte Felder mit niedriger Konfidenz mit dem PDF abgleichen, bevor die Rechnung versendet oder gebucht wird.

Was bedeutet der Konfidenzwert?

Jedes extrahierte Feld bekommt einen Wert von 0 bis 1. Er verbindet den Eigenwert des Modells mit festen Prüfungen: Steht der Wert im PDF-Text, hat die USt-IdNr. ein gültiges Format, stimmt die IBAN-Prüfsumme, wurde das Land geraten. Felder unter 0,8 stehen in review.low_confidence. Das ist eine Hilfe zum Priorisieren, keine Garantie.

Was ist die Rechenprüfung?

Die API rechnet Zeilensummen, Netto, USt und Brutto aus den extrahierten Positionen nach und vergleicht sie mit den gedruckten Summen. Eine Abweichung senkt die Konfidenz der betroffenen Zeilenfelder, erscheint in arithmetic_check und setzt den Status auf needs_review_amounts; dann wird kein XML erzeugt. Im ersten Test hat sie 3 der 8 Rechnungen mit einem falschen Feld markiert. Falsche Referenzen oder Codes erkennt sie nicht.

Welche PDFs funktionieren?

PDFs mit Textebene bis 10 MB. Gescannte Bilder haben keine Textebene und liefern 422 no_text_layer; OCR gibt es noch nicht. Ein ZUGFeRD- oder Factur-X-PDF enthält die Daten bereits und wird an /einvoice/parse verwiesen, das das eingebettete XML exakt liest.

Wo wird mein PDF verarbeitet?

Der Text des PDFs wird an OpenAI geschickt, um die Felder zu lesen. OpenAI ist im Auftragsverarbeitungsvertrag als Unterauftragsverarbeiter aufgeführt; senden Sie nur Rechnungen, die Sie so verarbeiten dürfen. Details: /legal/dpa und /privacy.

Was kostet es?

80 Einheiten pro erfolgreicher Extraktion: 0,157 € im Pro-Plan (49 € für 25.000 Einheiten) und 0,304 € im Starter-Plan (19 € für 5.000 Einheiten). Fehlgeschlagene Extraktionen werden nicht berechnet. Der Gratis-Schlüssel enthält 3 Extraktionen pro Monat zum Testen; danach braucht es einen bezahlten Plan. Platform-Schlüssel verbrauchen 80 der 25.000 Fair-Use-Einheiten des Plans. Es braucht einen API-Schlüssel (nicht ohne Schlüssel und nicht über x402).

Weiter

Technische Prüfung, keine Rechts- oder Steuerberatung.