DEV Community

PatrickPi1312
PatrickPi1312

Posted on

XRechnung aus PDF erstellen: Anleitung und API-Beispiel (2026)

Die E-Rechnungs-Pflicht ist da: In Deutschland müssen Unternehmen seit 2025 E-Rechnungen empfangen können, ab 2027/2028 auch ausstellen. In Österreich läuft e-Rechnung über ebInterface und Peppol. Das Problem für viele Betriebe: Die alte Software erzeugt nur ein PDF — verlangt wird aber eine strukturierte XRechnung oder ZUGFeRD. So schließt du die Lücke per API.

Schritt 1: PDF in strukturierte Daten umwandeln

Die Extraction-API liest ein PDF (oder Foto) und gibt Händler, Datum, Beträge und Positionen als JSON zurück:

curl -X POST "https://extract.installateur1210.at/v1/extract" \
  -H "X-API-Key: DEIN_KEY" -F "file=@rechnung.pdf"
Enter fullscreen mode Exit fullscreen mode

Da es KI-gestützt ist: Ergebnis kurz prüfen, bevor du es weiterverwendest.

Schritt 2: Daten in eine gültige XRechnung wandeln

Die geprüften Felder gehen in den Generator — heraus kommt eine EN-16931-konforme XRechnung. Profil wählbar: xrechnung (DE), peppol (EU/Österreich), en16931:

curl -X POST "https://einvoice.installateur1210.at/v1/einvoice/generate?key=demo" \
  -H "Content-Type: application/json" \
  -d '{"invoice_number":"2026-001","issue_date":"2026-07-12","currency":"EUR",
       "seller":"Muster GmbH","seller_country":"AT","seller_vat":"ATU12345678",
       "buyer":"Kunde GmbH","buyer_country":"DE",
       "total_net":100,"tax_amount":20,"total_gross":120,
       "line_items":[{"name":"Leistung","quantity":1,"line_amount":100}]}'
Enter fullscreen mode Exit fullscreen mode

Schritt 3: Amtlich prüfen

Das ist der Teil, den selbstgebaute Lösungen meist auslassen. Prüfe die XRechnung gegen den offiziellen KoSIT-Validator (EN 16931 + XRechnung-Schematron):

curl -X POST "https://einvoice.installateur1210.at/v1/einvoice/validate/official?key=demo" \
  -H "Content-Type: application/xml" --data-binary @rechnung.xml
Enter fullscreen mode Exit fullscreen mode

Du bekommst ein Urteil (ACCEPTABLE/REJECTED) plus die konkret verletzten Geschäftsregeln (BR-CO-15, BR-DE-…).

Fazit

Aus „alte Software macht nur PDF" wird per Pipeline PDF → JSON → XRechnung — für Deutschland, Österreich und EU-weit über Peppol. EU-gehostet, keine Rechnungsdaten gespeichert, kostenloser Demo-Key demo. Beispiele: https://github.com/PatrickPi1312/xrechnung-api-examples

Keine Steuer- oder Rechtsberatung. Welches Format bereitet dir Probleme?

Top comments (0)