So funktioniert invoice-api
Rechnungsdaten rein, konforme E-Rechnung raus – und in Gegenrichtung fremde E-Rechnungen lesen und prüfen.
Die Bausteine
Jeder Baustein ist ein Endpunkt. Der Status steht hier in derselben Form wie überall sonst auf der Seite – geplant heißt geplant, und immer mit Datum.
| Baustein | Was er tut | Wann Sie ihn brauchen | Endpunkt | Referenz |
|---|---|---|---|---|
Invoice CreatorLive | Erzeugt aus Ihren Rechnungsdaten die fertige E-Rechnung im Format des Ziellandes. | Immer, wenn Sie eine Rechnung verschicken – das ist der Hauptweg. | POST /api/v1/invoice/{countryCode}/{format}/generate | Referenz |
ValidatorLive | Prüft eine Rechnung gegen die Regeln des Landes (EN 16931, KoSIT, Peppol) und meldet jeden Verstoß mit Regel-ID. | Vor dem Versand, und wenn Sie über Annahme oder Rückweisung einer eingegangenen Rechnung entscheiden. | POST /api/v1/invoice/{countryCode}/validate | Referenz |
ParserLive | Liest eine fremde E-Rechnung – XML oder ZUGFeRD-PDF – in dieselbe JSON-Struktur, die der Creator entgegennimmt. | Beim Rechnungseingang, wenn die Felder in Ihre Buchhaltung sollen. | POST /api/v1/invoice/parse | Referenz |
FormatsLive | Listet auf, welche Länder und Formate verfügbar sind, mit Format-ID und MIME-Typ. | Wenn Ihre Oberfläche die Auswahl selbst aufbauen soll, statt sie fest zu verdrahten. | GET /api/v1/invoice/formats | Referenz |
ConverterLive | Wandelt eine fertige E-Rechnung in ein anderes Format um und meldet, was dabei nicht mitkommt. | Wenn Sie XRechnung haben, Ihr Empfänger aber ZUGFeRD verlangt – oder umgekehrt. | POST /api/v1/invoice/convert | Referenz |
AttachmentsLive | Hängt Dateien in ein bestehendes PDF, ohne dessen PDF/A-3-Konformität zu verlieren. | Wenn Stundenzettel, Lieferschein oder Leistungsnachweis mit der Rechnung reisen sollen. | POST /api/v1/invoice/attachments | Referenz |
VeriFactu QR (ES)Live | Erzeugt den QR-Code nach spanischer VeriFactu-Vorgabe, als URL, PNG oder SVG. | Wenn Sie nach Spanien fakturieren und der Beleg den QR-Code tragen muss. | POST /api/v1/invoice/es/verifactu-qr | Referenz |
VisualizerGeplant Q4/2026 | Rendert eine E-Rechnung als Ansicht für Menschen. | Wenn Sie XML im eigenen Produkt zeigen wollen, ohne selbst ein Layout zu bauen. | POST /api/v1/invoice/render | Referenz |
ArchiveGeplant 2027 | Legt Rechnung und Prüfbericht revisionssicher ab. | Wenn Sie die gesetzliche Aufbewahrung nicht selbst betreiben wollen. | POST /api/v1/invoice/archive | Referenz |
Peppol GatewayGeplant 2027 | Übergibt die Rechnung an das Peppol-Netz und nimmt die Zustellbelege entgegen. | Wenn der Empfänger über Peppol adressiert ist. Bis dahin: Versand per E-Mail oder Portal. | POST /api/v1/peppol/send | Referenz |
Drei typische Wege
Fast jede Integration ist einer dieser drei Wege – oder eine Kombination aus zweien.
Ausgang: Rechnung verschicken
- 1Rechnungsdaten aus Ihrem System als JSON zusammenstellen.
- 2generate aufrufen; Land und Format stehen im Pfad, etwa DE und xrechnung.
- 3Optional attachments: Leistungsnachweis oder Lieferschein in das PDF hängen.
- 4Ergebnis per E-Mail oder Portal an den Empfänger geben.
Eingang: Rechnung lesen und prüfen
- 1Eingegangene Datei – XML oder ZUGFeRD-PDF – an parse geben.
- 2validate liefert den Prüfbericht mit Regel-IDs: die Grundlage für Annahme oder Rückweisung.
- 3Felder aus der Antwort in Ihre Buchhaltung übernehmen.
Umwandeln: Format wechseln
- 1Quelldatei, etwa eine XRechnung, an convert geben.
- 2Zielformat wählen: zugferd, facturx oder xrechnung.
- 3conversionWarnings lesen – dort steht, was das Zielformat nicht kennt.
Was der Service nicht tut
Drei Grenzen, die man vor der Integration kennen sollte – damit niemand an der falschen Stelle sucht.
Kein OCR für gescannte PDFs
parse liest strukturierte Daten: XML oder das eingebettete XML eines ZUGFeRD-PDFs. Ein eingescanntes Papier-PDF enthält keine, und hier wird auch keine geraten.
Kein Peppol-Versand
Der Peppol-Zugang ist geplant für 2027. Bis dahin entsteht hier die Datei, den Transport übernehmen Sie oder Ihr Access Point.
Kein PDF wird zur ZUGFeRD-Rechnung
attachments hängt Dateien in ein PDF, mehr nicht. Eine ZUGFeRD-Rechnung entsteht aus strukturierten Daten über generate oder convert, nicht durch Anhängen.
Attachments API