XRechnung API

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 reference

The 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.

  1. 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 }
      }]
    }
  2. 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.

  3. 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 credits

You 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 API

You 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 viewer

What 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.

See the daily test results

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.