JSON rein, gültige XRechnung raus.
Ein API-Aufruf macht aus Ihren Rechnungsdaten eine XRechnung 3.0 — oder sagt Ihnen genau, welches Feld zu ändern ist. Jede Ausgabe wird vor der Auslieferung mit den offiziellen KoSIT-Regeln geprüft. 0,05 €–0,12 € pro Rechnung, kein Abo.
API-Key holen, 50 Gratis-Credits API-ReferenzDer Aufruf
Senden Sie die Rechnung als JSON (oder eine vorhandene XML) mit dem Zielformat. Zurück kommt das XRechnung-XML, oder HTTP 422 mit der Liste der nötigen Änderungen, und es wird nichts berechnet.
curl -X POST https://fakturwire.com/v1/convert \
-H "authorization: Bearer $FW_KEY" \
-H "content-type: application/json" \
-d '{
"target": "xrechnung-ubl",
"invoice": {
"number": "RE-2026-100",
"issueDate": "2026-11-02",
"currency": "EUR",
"buyerReference": "04011000-12345-67",
"seller": { "name": "Muster GmbH", … },
"buyer": { "name": "Stadt Köln", … },
"lines": [{ "id": "1", "name": "Beratung", "quantity": 10,
"unitPrice": 100, "vat": { "categoryCode": "S", "rate": 19 } }]
}
}' Node.js-SDK
npm install fakturwire
import { FakturWire } from 'fakturwire';
const fw = new FakturWire(process.env.FW_KEY);
const { xml } = await fw.convert(invoice, 'xrechnung-ubl'); Was mit einer Rechnung passiert
Eine echte Rechnung an eine Behörde, von Ihren Daten bis zur gültigen XRechnung.
-
Sie senden die RechnungAls einfaches JSON aus Ihrer Software, als vorhandene XML oder als PDF.
{ "number": "RE-2026-100", "issueDate": "2026-11-02", "currency": "EUR", "seller": { "name": "Muster GmbH", … }, "buyer": { "name": "Stadt Köln", … }, "lines": [{ "name": "Beratung", "quantity": 10, "unitPrice": 100, "vat": { "categoryCode": "S", "rate": 19 } }] } -
Wir prüfen sie gegen die RegelnJedes Problem kommt mit konkretem Änderungshinweis zurück. Umgewandelt und berechnet wird erst, wenn alles stimmt.
BR-DE-15 BuyerReference (BT-10) is mandatory in XRechnung — for B2G this is the Leitweg-ID.
Leitweg-ID der Behörde ergänzen
+ "buyerReference": + "04011000-12345-67"Gültig. Offizielle KoSIT-Regeln bestanden.
-
Sie erhalten eine gültige E-RechnungXRechnung, Peppol BIS 3.0 oder Factur-X — auch als hybrides PDF/A-3 —, vor der Auslieferung noch einmal mit den offiziellen Regeln geprüft.
<Invoice …> <cbc:CustomizationID> urn:cen.eu:en16931:2017 #compliant#urn:xeinkauf.de :kosit:xrechnung_3.0 </cbc:CustomizationID> <cbc:ID>RE-2026-100</cbc:ID> <cbc:BuyerReference> 04011000-12345-67 </cbc:BuyerReference> … <cbc:PayableAmount currencyID="EUR">1190.00 </cbc:PayableAmount> </Invoice>
Drei Wege zu FakturWire
Kein Entwickler im Team
Anmelden, im Dashboard eine PDF ablegen oder eine XML einfügen, prüfen und die XRechnung herunterladen. Ohne Code.
Mit 50 Gratis-Credits startenSie bauen die Software
Ein POST-Request aus Ihrem Rechnungscode, mit SDKs für Node, PHP, .NET und Python. Fehler sagen genau, was zu ändern ist.
Zur XRechnung-APISie empfangen E-Rechnungen
Eine XRechnung oder ZUGFeRD-Datei, die Sie nicht lesen können? Im kostenlosen Viewer als normale Rechnung öffnen.
Viewer öffnenWas vor der Auslieferung geprüft wird
- Die EN-16931-Geschäftsregeln und die deutschen XRechnung-Regeln (BR-DE), mit Meldungen, die das zu ändernde Feld nennen.
- Das offizielle KoSIT- und CEN-Schematron, dieselben Regeln wie im Referenz-Validator. Unsere Ausgabe besteht es für 186 von 186 offiziellen Beispielrechnungen, täglich neu geprüft.
- Die Rechnung selbst: Positionssummen, Umsatzsteuer je Kategorie und Zahlbetrag, auf den Cent.
Die täglichen Testergebnisse ansehen
Fragen vor der Integration
- Was kostet das?
- Eine Umwandlung kostet 2 Credits: 0,05 € bis 0,12 € pro Rechnung, je nach Paket. Nur prüfen kostet 1 Credit. Eine Umwandlung, die die Regeln nicht besteht, wird nicht berechnet. Neue Konten erhalten 50 Credits gratis, Credits verfallen nie.
- Wird die Ausgabe von Behörden und Unternehmen akzeptiert?
- Jede XRechnung wird vor der Rückgabe mit den offiziellen KoSIT-Regeln geprüft; würde sie scheitern, erhalten Sie die Befunde statt einer Datei. Die XML-Schema-Prüfung (XSD) ist nicht Teil dieser Prüfung.
- Brauche ich eine Leitweg-ID?
- XRechnung verlangt auf jeder Rechnung eine Käuferreferenz (BT-10). Bei Behörden ist das die Leitweg-ID, bei Unternehmen die Referenz, die Ihnen der Käufer nennt, etwa eine Bestellnummer.
- UBL oder CII? Und ZUGFeRD?
- XRechnung kommt als UBL. Mit "pdf": true erhalten Sie zusätzlich ein hybrides PDF/A-3: eine lesbare Rechnungsseite mit eingebetteter XRechnung als CII (ZUGFeRD), oder Factur-X mit dem Ziel facturx-en16931. Jedes PDF wird vor der Rückgabe mit veraPDF geprüft, ohne Aufpreis. Sie können auch Ihr eigenes PDF-Layout senden; wir betten das XML ein.
- Wo werden die Daten verarbeitet?
- Auf Servern in Deutschland (Hetzner). Rechnungen werden im Arbeitsspeicher verarbeitet und nicht gespeichert; ein AVV steht bereit.
- Versenden Sie die Rechnung?
- Nein. Wir erzeugen und prüfen sie. In Deutschland können B2B-Rechnungen per E-Mail gehen; für das Peppol-Netz nutzen Sie einen zertifizierten Access Point.