XRechnung-API

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-Referenz

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

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

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

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

Sie empfangen E-Rechnungen

Eine XRechnung oder ZUGFeRD-Datei, die Sie nicht lesen können? Im kostenlosen Viewer als normale Rechnung öffnen.

Viewer öffnen

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