JSON in, valid XRechnung out.
One API call turns your invoice data into an XRechnung 3.0 document — or tells you exactly which field to fix. Every document is checked with the official KoSIT rules before you get it. €0.05–€0.12 per invoice, no subscription.
Get an API key, 50 free credits API referenceThe call
Send the invoice as JSON (or an XML you already have) with the target format. You get the XRechnung XML back, or HTTP 422 with the list of what to change, and nothing is charged.
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'); What happens to an invoice
One real invoice to a German public-sector buyer, from your data to a valid XRechnung.
-
You send the invoiceAs simple JSON from your software, an XML you already have, or a 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 } }] } -
We check it against the rulesEvery problem comes back with what to change. Nothing is converted, or charged, until it passes.
BR-DE-15 BuyerReference (BT-10) is mandatory in XRechnung — for B2G this is the Leitweg-ID.
Add the buyer’s Leitweg-ID
+ "buyerReference": + "04011000-12345-67"Valid. Official KoSIT rules passed.
-
You get a valid e-invoiceXRechnung, Peppol BIS 3.0 or Factur-X — also as a hybrid PDF/A-3 — checked once more with the official rules before you get it.
<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>
Three ways in
No developer on the team
Sign in, drop a PDF or paste an XML in the dashboard, check it, and download the XRechnung. No code.
Start with 50 free creditsYou build the software
One POST request from your invoicing code, with SDKs for Node, PHP, .NET and Python. Errors tell you exactly what to fix.
See the XRechnung APIYou receive e-invoices
Got an XRechnung or ZUGFeRD file you can’t read? Open it as a normal invoice in the free viewer.
Open the free viewerWhat is checked before you get the file
- EN 16931 business rules and the German XRechnung rules (BR-DE), with messages that name the field to fix.
- The official KoSIT and CEN Schematron, the same rules the German reference validator runs. Our output passes it for 186 of 186 official sample invoices, re-tested daily.
- The arithmetic: line totals, VAT per category and the amount due, to the cent.
Questions before integrating
- What does it cost?
- A conversion costs 2 credits: €0.05 to €0.12 per invoice depending on the pack. Checking alone is 1 credit. A conversion that fails the rules is not charged. New accounts get 50 credits free, and credits never expire.
- Is the output accepted by German authorities and businesses?
- Every XRechnung is checked with the official KoSIT rules before it is returned; if it would fail, you get the findings instead of a file. XML schema (XSD) validation is not part of that check.
- Do I need a Leitweg-ID?
- XRechnung requires a buyer reference (BT-10) on every invoice. For public authorities it is their Leitweg-ID; for businesses it is whatever reference the buyer gives you, such as an order number.
- UBL or CII? And ZUGFeRD?
- XRechnung comes as UBL. Add "pdf": true and you also get a hybrid PDF/A-3: a readable invoice page with the XRechnung embedded as CII (ZUGFeRD), or Factur-X with target facturx-en16931. Every PDF is checked with veraPDF before it is returned, at no extra cost. You can also send your own PDF layout and we embed the XML into it.
- Where is the data processed?
- On servers in Germany (Hetzner). Invoices are processed in memory and not stored; a data processing agreement (DPA) is available.
- Do you send the invoice?
- No. We produce and check it. In Germany B2B invoices can go by e-mail; for the Peppol network use any certified access point.