Titelbild für den Artikel: XRechnung API Anbindung: REST-API, JSON-Mapping, KoSIT-Validierung und Enterprise-Integration
Zurück zum BlogSoftware & Integration

XRechnung API Anbindung: REST-API, JSON-Mapping, KoSIT-Validierung und Enterprise-Integration

So integrieren Sie XRechnung, ZUGFeRD und E-Rechnungen per REST-API: Architektur, JSON-to-XML-Mapping, KoSIT-Validierung für XRechnung, Mustang-Validierung für ZUGFeRD, Fehlerhandling, ERP-Anbindung und Enterprise-Workflows.

RechneX Redaktion20. Februar 202616 Min. Lesezeit

XRechnung API Anbindung: REST-API, JSON-Mapping und KoSIT-Validierung

Viele Entwicklerteams, ERP-Verantwortliche und Softwareanbieter stehen vor derselben Aufgabe: Ein bestehendes ERP-System, CRM, SaaS-Produkt oder ein E-Commerce-Shop soll XRechnung, ZUGFeRD oder allgemein E-Rechnungen erzeugen können, ohne dass der gesamte Rechnungsprozess neu gebaut werden muss.

Der entscheidende Punkt: Eine XRechnung ist nicht einfach eine andere PDF-Ausgabe. Sie ist ein strukturierter XML-Datensatz nach EN 16931 und in Deutschland insbesondere für den Austausch mit öffentlichen Auftraggebern relevant. Seit dem 1. Januar 2025 gilt im deutschen B2B-Bereich zudem die neue E-Rechnungsdefinition: Ein einfaches PDF ist nach Darstellung des Bundesfinanzministeriums keine E-Rechnung mehr, weil es kein strukturiertes elektronisches Format ist. Quelle: BMF FAQ zur obligatorischen E-Rechnung.

Für Unternehmen mit bestehenden Systemen ist deshalb eine saubere XRechnung API Anbindung oft der sinnvollste Weg: Das Quellsystem liefert strukturierte Rechnungsdaten, die API übernimmt Mapping, XML-Erzeugung, Validierung und auf Wunsch auch Versand, Archivschnittstelle oder Fehlerworkflow.

XRechnung oder ZUGFeRD per API anbinden?

RechneX unterstützt Unternehmen nicht nur mit Validator, Viewer und Generator, sondern auch mit Enterprise-Workflows für API-Anbindung, ERP-Integration, Shop-Anbindung, Sonderfälle, E-Mail-Weiterleitung und E-Rechnungsversand.

Direktantwort: Wie funktioniert eine XRechnung API?

Eine moderne XRechnung API nimmt strukturierte Rechnungsdaten entgegen, erzeugt daraus eine XRechnung im passenden XML-Format, validiert die Datei gegen EN 16931 und XRechnung-Regeln und gibt anschließend eine fertige Datei, einen Status oder einen Fehlerbericht zurück.

Typischer Ablauf:

  1. Quellsystem sendet Rechnungsdaten: ERP, CRM, Shopware, WooCommerce, SaaS-Backend oder ein eigenes System übermittelt Rechnungsdaten per REST-API, meistens als JSON.
  2. Mapping-Schicht übersetzt die Daten: Die API ordnet Felder wie Rechnungsnummer, Leistungsdatum, Verkäufer, Käufer, Positionen, Steuern, Zahlungsdaten und Leitweg-ID den passenden EN-16931-Business-Terms und XML-Strukturen zu.
  3. XML-Erzeugung erstellt XRechnung oder ZUGFeRD: Je nach Zielprozess entsteht eine reine XRechnung-XML, eine UBL-/CII-Datei oder ein hybrides ZUGFeRD-PDF mit eingebettetem XML.
  4. Formatgerechte Validierung prüft vor dem Versand: XRechnung wird mit dem KoSIT Validator, ZUGFeRD mit dem Mustang Validator technisch und fachlich geprüft. Fehler werden strukturiert zurückgegeben, bevor die Rechnung an Kunde, Behörde, Portal, Peppol, E-Mail oder Archiv weiterläuft.
  5. Download, Versand oder Archivierung: Erst nach erfolgreicher Validierung wird die E-Rechnung bereitgestellt, versendet oder in einen Freigabeprozess übergeben.
Wenn Sie das Validierungs-Gate nicht selbst entwickeln und betreiben möchten, finden Sie hier die passende Lösung: KoSIT Validator API für XRechnung. Für ZUGFeRD und Factur-X wird der Mustang Validator eingebunden.

Warum eine API sinnvoller ist als hartes XML-Mapping im ERP

Viele Unternehmen starten mit der Idee, die XRechnung direkt im bestehenden ERP-Code zu erzeugen. Das wirkt zunächst naheliegend, führt aber schnell zu Wartungsaufwand. XRechnung, EN 16931, UBL, CII, ZUGFeRD und KoSIT-Regeln haben eigene Datenmodelle, Pflichtfelder, Codelisten, Rundungsregeln und Validierungsartefakte.

Eine API-Schicht trennt diese Komplexität vom Kernsystem. Das ERP bleibt für kaufmännische Daten zuständig. Die E-Rechnungs-API kümmert sich um die technische Ausgabe, Validierung und Weitergabe.

Das ist besonders relevant, wenn mehrere Systeme beteiligt sind:

  • ERP-System für Rechnungsdaten
  • CRM für Kundendaten
  • Shop-System für Bestellungen
  • Buchhaltung oder DATEV-nahe Prozesse für Beleglogik
  • Dokumentenmanagement oder Archiv
  • E-Mail-, Portal- oder Peppol-Versand
  • Freigabeprozesse in Buchhaltung oder Controlling
RechneX ist genau für solche Übergänge interessant: Standardfälle können über Konverter, Generator, Viewer und Validator direkt im Browser abgebildet werden. Komplexe Prozesse wie API-Anbindung, ERP-Mapping, automatische Sonderfall-Erkennung, Batch-Verarbeitung, strukturierte Fehlerlisten oder individuelle Freigaben gehören in den Enterprise-Bereich.

Architektur einer stabilen E-Rechnungs-API

Eine belastbare XRechnung API sollte nicht nur „XML erzeugen“, sondern den gesamten Rechnungsprozess absichern.

SchichtAufgabeBest Practice
Source LayerERP, CRM, Shop oder SaaS-System liefert RechnungsdatenNur fachlich saubere, strukturierte Daten senden
API GatewayAuthentifizierung, Mandantentrennung, Rate Limits, LoggingAPI-Key, OAuth oder signierte Requests nutzen
Mapping LayerJSON-Felder werden auf EN 16931, XRechnung, UBL oder CII gemapptMapping versionieren und nicht fest im UI-Code verstecken
Rules LayerPflichtfelder, Codelisten, Steuerlogik und Rundung prüfenFehler früh erkennen, bevor XML erzeugt wird
Generation LayerXRechnung-XML oder ZUGFeRD-PDF/A-3 erzeugenAusgabeformat pro Empfänger oder Kanal steuern
Validation GateKoSIT-/EN-16931-Prüfung vor Versand, Archivierung oder DownloadKeine ungeprüften Dateien weitergeben
Delivery LayerVersand per E-Mail, Portal, Peppol, API-Rückgabe oder ArchivVersand erst nach erfolgreicher Validierung auslösen
MonitoringFehlerlisten, Status, Retry, SLA und Audit TrailBesonders bei hohen Volumen und Enterprise-Prozessen wichtig

REST-Endpunkte für XRechnung, ZUGFeRD und Validierung

Für eine E-Rechnung API ist ein sauberes Endpunkt-Design wichtiger als ein einzelner großer /generate_invoice-Aufruf. Rechnungen sind fachliche Ressourcen. Deshalb sollte die API auch ressourcenorientiert aufgebaut sein.

Beispiel für sinnvolle Endpunkte

http
POST /api/v1/invoices
GET  /api/v1/invoices/{invoiceId}
GET  /api/v1/invoices/{invoiceId}/status
GET  /api/v1/invoices/{invoiceId}/xml
GET  /api/v1/invoices/{invoiceId}/pdf
GET  /api/v1/invoices/{invoiceId}/validation-report
POST /api/v1/invoices/{invoiceId}/send

Für einfache synchrone Prozesse kann POST /api/v1/invoices direkt eine validierte XRechnung zurückgeben. Bei größeren Volumen, PDF-Konvertierung, Freigabeprozessen oder Versandlogik ist ein asynchroner Ablauf stabiler:

http
POST /api/v1/invoices
202 Accepted
Location: /api/v1/invoices/inv_123/status

Das Quellsystem fragt anschließend den Status ab oder erhält das Ergebnis per Webhook.

JSON-to-XRechnung: Beispiel für einen API-Payload

Eine gute XRechnung API sollte dem Quellsystem kein tiefes XML-Wissen aufzwingen. Stattdessen sendet das ERP oder Shop-System ein klar strukturiertes JSON-Objekt.

json
{
  "invoice": {
    "invoiceNumber": "2026-10045",
    "invoiceDate": "2026-07-03",
    "currency": "EUR",
    "type": "commercial_invoice",
    "buyerReference": "04011000-12345-67",
    "orderReference": "PO-98441",
    "paymentTerms": "Zahlbar innerhalb von 14 Tagen ohne Abzug"
  },
  "seller": {
    "name": "Muster GmbH",
    "street": "Musterstraße 1",
    "zip": "10115",
    "city": "Berlin",
    "country": "DE",
    "vatId": "DE123456789",
    "email": "rechnung@muster-gmbh.de",
    "iban": "DE02120300000000202051",
    "bic": "BYLADEM1001"
  },
  "buyer": {
    "name": "Beispiel AG",
    "street": "Beispielweg 5",
    "zip": "80331",
    "city": "München",
    "country": "DE",
    "vatId": "DE987654321",
    "email": "invoice@beispiel-ag.de"
  },
  "items": [
    {
      "name": "Beratungsleistung Juli 2026",
      "description": "Technische Beratung zur E-Rechnungsintegration",
      "quantity": 10,
      "unitCode": "HUR",
      "netUnitPrice": 120.0,
      "vatRate": 19.0
    }
  ]
}

Die API übersetzt diese Daten anschließend in das passende XML. Bei XRechnung kann die technische Syntax je nach Umsetzung UBL oder CII sein. XRechnung selbst definiert die Art und technische Zusammensetzung der Rechnungsinformationen in einem XML-Datensatz; XStandards Einkauf beschreibt XRechnung als maßgeblichen Standard für elektronische Rechnungen an öffentliche Auftraggeber in Deutschland. Quelle: XStandards Einkauf: XRechnung.

Beispiel: Buyer Reference und Leitweg-ID korrekt mappen

Bei Rechnungen an öffentliche Auftraggeber spielt die Käuferreferenz eine zentrale Rolle. In Deutschland ist dies häufig die Leitweg-ID für B2G. Im JSON kann sie einfach als buyerReference stehen. Im UBL-XML erscheint sie an der passenden Stelle als BuyerReference.

Vereinfachtes Beispiel:

xml

  urn:cen.eu:en16931:2017
  2026-10045
  2026-07-03
  380
  EUR
  04011000-12345-67

Wichtig ist: In der Praxis reicht es nicht, einzelne XML-Tags zu füllen. Die komplette Rechnung muss konsistent sein. Dazu gehören unter anderem Verkäuferdaten, Käuferdaten, Steuersummen, Zahlungsinformationen, Positionen, Einheiten, Beträge, Steuerkategorien und Pflichtangaben.

KoSIT-Validierung als Pflicht-Gate vor dem Versand

Eine XRechnung API ohne Validierung ist riskant. Sie kann zwar eine XML-Datei erzeugen, aber nicht sicherstellen, dass diese Datei vom Empfänger, Portal oder Prozess akzeptiert wird.

Ein gutes Validation Gate prüft unter anderem:

* XML-Struktur und Schema
* EN-16931-Regeln
* XRechnung-spezifische Geschäftsregeln
* Pflichtfelder wie Käuferreferenz, Verkäuferdaten, Zahlungsdaten oder Steuerangaben
* Summen, Rundungen und Steuerbeträge
* Codelisten, Einheiten, Währungen und Länderkennzeichen
* Formatabhängige Anforderungen bei UBL, CII, ZUGFeRD und Factur-X

RechneX bietet dafür sowohl browserbasierte Validierung als auch Enterprise-/API-Prozesse. Der XRechnung Validator prüft XRechnungen im Browser, der ZUGFeRD Validator prüft hybride PDF-Rechnungen. Für Systeme, die Rechnungen nicht manuell prüfen können, ist die KoSIT Validator API für XRechnung sinnvoll; ZUGFeRD wird über Mustang validiert.

Fehlerhandling: fachliche Fehler strukturiert zurückgeben

Eine professionelle E-Rechnungs-API sollte Validierungsfehler nicht als allgemeinen Serverfehler behandeln. Wenn eine Rechnung fachlich fehlerhaft ist, ist das kein 500 Internal Server Error, sondern ein korrigierbarer Datenfehler.

Beispiel für eine strukturierte Fehlerantwort:

json
{
  "status": "validation_failed",
  "invoiceId": "inv_123",
  "format": "xrechnung",
  "syntax": "ubl",
  "errors": [
    {
      "severity": "error",
      "source": "kosit",
      "ruleId": "RULE_ID_FROM_VALIDATION_REPORT",
      "field": "buyerReference",
      "businessTerm": "BT-10",
      "message": "Die Käuferreferenz fehlt oder ist für diesen Empfänger nicht gültig.",
      "hint": "Tragen Sie die Leitweg-ID oder die vom Empfänger geforderte Käuferreferenz ein."
    }
  ]
}

Für die Integration ist wichtig, dass Fehler maschinenlesbar sind. Das Quellsystem sollte erkennen können, ob ein Feld fehlt, eine Codeliste verletzt wurde, ein Betrag nicht aufgeht oder eine Rechnung manuell geprüft werden muss.

Typische Stolpersteine bei XRechnung APIs

ProblemWirkungBesserer API-Ansatz
Fehlende Käuferreferenz oder Leitweg-IDB2G-Rechnung wird abgelehnt oder kann nicht zugeordnet werdenEmpfängerprofile mit Pflichtfeldlogik und Validierung vor Versand
RundungsdifferenzenSummenfehler in EN-16931- oder KoSIT-PrüfungPositions-, Steuer- und Gesamtsummen zentral berechnen und validieren
Freitext statt CodelistenEinheiten, Steuerarten oder Länder werden technisch ungültigAPI-seitige Enums und klare Feldvalidierung
Steuerlogik nicht sauber modelliertReverse Charge, steuerfreie Umsätze oder Kleinunternehmerfälle werden falsch abgebildetSteuerfälle als eigene Logik im Mapping Layer behandeln
PDF-Daten werden ungeprüft übernommenOCR- oder Extraktionsfehler landen in der E-RechnungEditor, Plausibilitätsprüfung oder Freigabeprozess einsetzen
Synchrone Verarbeitung bei hohem VolumenTimeouts und schwer nachvollziehbare FehlerQueue, Status-Endpunkt, Webhooks und Retry-Logik nutzen
Keine VersionierungÄnderungen an XRechnung oder EN 16931 brechen bestehende IntegrationenAPI-Versionen, Mapping-Versionen und Testumgebung bereitstellen
Keine Validierung vor VersandFehlerhafte Rechnungen erreichen Kunden, Behörden oder PortaleKoSIT-Validierung als technisches Gate erzwingen

Sonderfälle: Warum Enterprise-Mapping oft nötig ist

Standardrechnungen lassen sich häufig gut über einen Generator, Konverter oder eine einfache API erzeugen. In echten Unternehmensprozessen treten aber regelmäßig Sonderfälle auf, die sauber gemappt werden müssen.

Typische Beispiele:

* Abschlagsrechnung
* Schlussrechnung
* Teilrechnung
* Gutschrift
* Storno und Korrekturrechnung
* Reverse Charge
* Kleinunternehmerrechnung
* Bauleistung und Bauabschlag
* Selbstfakturierung
* Factoring und Forderungsabtretung
* abweichender Zahlungsempfänger
* mehrere Steuersätze in einer Rechnung
* kundenspezifische Pflichtangaben
* Empfängerregeln für öffentliche Auftraggeber
* E-Mail-Weiterleitung, Portalversand oder Peppol-Prozess

Genau hier liegt der Unterschied zwischen einem einfachen Tarif und einer Enterprise-Integration. Der Pro-Tarif eignet sich für regelmäßige Standardprozesse, manuelle Erstellung, Validierung und Standard-PDF-Konvertierung. Enterprise ist sinnvoll, wenn Rechnungen direkt aus ERP, CRM oder Shop erzeugt werden sollen, wenn Sonderfälle automatisch erkannt werden müssen oder wenn ein Freigabe-, Fehler- und Versandprozess benötigt wird.

Pro oder Enterprise?

Pro passt, wenn Sie regelmäßig Standardrechnungen konvertieren, XRechnungen oder ZUGFeRD-Rechnungen erstellen und Dateien vor dem Versand validieren möchten.

Enterprise passt, wenn API-Anbindung, ERP-Mapping, Shop-Integration, hohe Volumen, automatische Sonderfälle, E-Mail-Weiterleitung, E-Rechnungsversand, SSO, White-Label, SLA oder individuelle Workflows benötigt werden.

Preise und Enterprise-Optionen ansehen

ZUGFeRD API und XRechnung API gemeinsam denken

Viele Unternehmen brauchen nicht nur XRechnung. Im B2B-Alltag ist auch ZUGFeRD relevant, weil es ein hybrides Format ist: ein lesbares PDF mit eingebetteter XML-Datei. Damit lassen sich menschlich lesbare Rechnungsprozesse und strukturierte elektronische Verarbeitung kombinieren.

Eine gute E-Rechnung API sollte deshalb nicht nur eine XRechnung-XML erzeugen können, sondern je nach Empfänger oder Prozess auch ZUGFeRD beziehungsweise Factur-X unterstützen.

Beispiel für eine Formatwahl im API-Payload:

json
{
  "output": {
    "format": "zugferd",
    "profile": "en16931",
    "pdfA": "PDF/A-3B",
    "includeValidationReport": true
  }
}

Für B2G-Empfänger kann XRechnung relevant sein. Für viele B2B-Empfänger kann ZUGFeRD praktischer sein. Entscheidend ist nicht, welches Format technisch schöner wirkt, sondern welches Format der Empfänger akzeptiert und welcher Prozess intern sicher abgebildet werden kann.

API-Sicherheit: Rechnungsdaten sind sensible Geschäftsdaten

Eine E-Rechnung API verarbeitet Zahlungsdaten, Kundendaten, Steuerinformationen und interne Rechnungsdetails. Deshalb gehören Sicherheits- und Datenschutzthemen von Anfang an in die Architektur.

Wichtige Anforderungen:

* verschlüsselte Übertragung per HTTPS
* API-Key, OAuth oder signierte Requests
* Mandantentrennung
* Rollen- und Rechtekonzept
* begrenzte Aufbewahrung temporärer Dateien
* Protokollierung von Status und Fehlern
* AVV für Auftragsverarbeitung, wenn personenbezogene Daten verarbeitet werden
* klare Lösch- und Archivierungslogik
* keine ungeprüfte dauerhafte Speicherung hochgeladener Rechnungen
* Trennung von Test- und Produktivumgebung

RechneX positioniert sich als DSGVO-orientierte Plattform für E-Rechnungen in Deutschland und bietet neben Browser-Tools auch AVV-, Sicherheits- und Enterprise-Prozesse für Unternehmen, die E-Rechnungen regelmäßig oder automatisiert verarbeiten möchten.

Make or Buy: XRechnung API selbst bauen oder anbinden?

Ob Sie eine XRechnung API selbst entwickeln oder einen spezialisierten Dienst wie RechneX anbinden, hängt stark vom Geschäftsmodell ab.

SzenarioEmpfehlung
Sie entwickeln eine Rechnungssoftware als KernproduktEigene tief integrierte E-Rechnungslogik kann sinnvoll sein
Sie betreiben ein ERP, CRM, Shop oder SaaS mit RechnungsfunktionAPI-Anbindung ist meist schneller und wartungsärmer
Sie haben nur einzelne RechnungenBrowser-Generator oder PDF-Konverter reicht häufig aus
Sie haben wiederkehrende StandardrechnungenPro-Tarif mit unbegrenzter Standardnutzung prüfen
Sie haben Sonderfälle, hohe Volumen oder SystemintegrationEnterprise-Workflow mit individuellem Mapping wählen
Sie müssen vor Versand validierenKoSIT Validator API oder automatisches Validation Gate einsetzen

Selbst bauen lohnt sich vor allem, wenn E-Rechnungserzeugung ein Kernbestandteil des eigenen Produkts ist. Für die meisten Unternehmen ist eine API- oder Enterprise-Anbindung wirtschaftlicher, weil Standardpflege, Validierung, Mapping, Fehlerhandling und Formatlogik nicht dauerhaft im eigenen Team gehalten werden müssen.

Praktischer Integrationsplan für Unternehmen

Ein sauberer API-Rollout muss nicht mit einem monatelangen Großprojekt beginnen. Sinnvoll ist ein stufenweiser Ansatz:

1. Rechnungstypen inventarisieren

Sammeln Sie reale Belege aus Ihrem System:

* Standardrechnung
* Gutschrift
* Storno
* Abschlagsrechnung
* Schlussrechnung
* Rechnung mit mehreren Steuersätzen
* Rechnung mit Reverse Charge
* Rechnung an öffentliche Auftraggeber
* Rechnung mit abweichendem Zahlungsempfänger oder Factoring

2. Pflichtfelder und Empfängerregeln klären

Prüfen Sie, welche Empfänger XRechnung, ZUGFeRD oder andere Prozesse erwarten. Für öffentliche Auftraggeber sind Käuferreferenz beziehungsweise Leitweg-ID, Portalvorgaben und Formatregeln besonders wichtig.

3. JSON-Payload definieren

Legen Sie fest, welche Daten Ihr ERP oder Shop an die API liefert. Je klarer die Datenstruktur ist, desto stabiler wird die spätere XML-Erzeugung.

4. Mapping und Validierung testen

Nutzen Sie Testrechnungen und validieren Sie die Ausgabe konsequent. RechneX bietet dafür Browser-Tools wie den XRechnung und ZUGFeRD Validator sowie API-/Enterprise-Optionen.

5. Fehlerworkflow festlegen

Definieren Sie, was bei Fehlern passieren soll:

* automatische Korrektur
* Rückgabe an ERP oder Shop
* Freigabe im Dashboard
* manuelle Prüfung
* Fehlerliste für Buchhaltung oder Support
* erneute Validierung nach Korrektur

6. Versand und Archivierung anbinden

Nach erfolgreicher Validierung kann die Rechnung per E-Mail, Portal, API, Peppol-Prozess oder Archivschnittstelle weiterlaufen. Beachten Sie dabei auch die Anforderungen an Aufbewahrung und Nachvollziehbarkeit. Mehr dazu im Ratgeber zur E-Rechnung Aufbewahrungspflicht und GoBD.

RechneX als API- und Enterprise-Lösung

RechneX ist keine reine Informationsseite und kein reiner Validator. Die Plattform kombiniert mehrere E-Rechnungsfunktionen:

* PDF zu XRechnung konvertieren
* PDF zu ZUGFeRD konvertieren
* XRechnung erstellen
* ZUGFeRD erstellen
* XRechnung und ZUGFeRD validieren
* XRechnung sichtbar machen und prüfen
* KoSIT-Validierung vor dem Download
* Generator für manuelle Sonderfälle
* Batch-Verarbeitung für wiederkehrende Prozesse
* Enterprise-Mapping für komplexe Belegarten
* API-, ERP-, CRM- und Shopsystem-Anbindung
* individuelle Workflows, Freigaben, Fehlerlisten und Versandprozesse

Für einzelne Vorgänge können Sie kostenlos starten oder einzelne E-Rechnungen erstellen. Für regelmäßige Standardprozesse ist der Pro-Tarif gedacht. Für hohe Volumen, automatische Sonderfälle, bestehende Systeme, API-Endpunkte, E-Mail-Weiterleitung, E-Rechnungsversand, ERP-/Shop-Anbindung, SSO, White-Label oder SLA ist Enterprise der richtige Einstieg.

Erst testen, dann automatisieren

Prüfen Sie zunächst einzelne Dateien im Validator oder erstellen Sie eine E-Rechnung im Browser. Wenn Ihr Prozess steht, kann RechneX die API-, ERP- oder Enterprise-Anbindung für hohe Volumen und Sonderfälle übernehmen.

Häufige Fragen zur XRechnung API

Was ist eine XRechnung API?

Eine XRechnung API ist eine Schnittstelle, über die ein ERP, CRM, Shop oder anderes System strukturierte Rechnungsdaten übergibt. Die API erzeugt daraus eine XRechnung-XML, validiert sie und stellt sie für Download, Versand oder Archivierung bereit.

Kann eine API auch ZUGFeRD erstellen?

Ja, wenn der Anbieter ZUGFeRD unterstützt. Dann kann aus denselben Rechnungsdaten ein hybrides PDF/A-3-Dokument mit eingebettetem XML erzeugt werden. RechneX unterstützt neben XRechnung auch ZUGFeRD-Workflows.

Was ist JSON-to-XML-Mapping bei XRechnung?

JSON-to-XML-Mapping bedeutet, dass einfache API-Felder wie invoiceNumber, buyerReference, vatRate oder iban in die korrekten EN-16931-, UBL- oder CII-Strukturen übersetzt werden. Genau diese Übersetzung ist einer der wichtigsten Teile einer E-Rechnung API.

Warum ist KoSIT-Validierung wichtig?

Die KoSIT-Validierung erkennt technische und fachliche Fehler, bevor eine Rechnung an Kunden, Behörden, Portale oder interne Systeme weitergegeben wird. Ohne Validierung besteht das Risiko, dass Rechnungen abgelehnt oder manuell korrigiert werden müssen.

Kann ich XRechnung komplett selbst implementieren?

Ja, technisch ist das möglich. Sie müssen dann aber XML-Erzeugung, EN-16931-Mapping, XRechnung-Regeln, Codelisten, Rundung, Sonderfälle, Versionierung, Validierung und Fehlerhandling dauerhaft selbst pflegen. Für viele Unternehmen ist eine API- oder Enterprise-Anbindung effizienter.

Wann brauche ich Enterprise statt Pro?

Pro eignet sich für regelmäßige Standardrechnungen, manuelle Erstellung, Validierung und Standard-Konvertierung. Enterprise ist sinnvoll, wenn Rechnungen automatisch aus ERP, CRM oder Shop erzeugt werden sollen, wenn Sonderfälle automatisch verarbeitet werden müssen oder wenn hohe Volumen, Freigaben, Fehlerlisten, E-Mail-Weiterleitung, E-Rechnungsversand, SSO, White-Label oder SLA benötigt werden.

Fazit: Die API ist das Sicherheitsnetz für E-Rechnungsprozesse

Eine gute XRechnung API ist mehr als ein XML-Generator. Sie ist das technische Sicherheitsnetz zwischen ERP, Shop, Buchhaltung, Empfänger, Portal und Archiv. Sie sorgt dafür, dass Rechnungsdaten strukturiert übernommen, korrekt gemappt, validiert und erst dann weitergegeben werden.

Wer nur einzelne Rechnungen erstellt, kann mit Browser-Tools starten. Wer regelmäßig Standardrechnungen erzeugt, sollte Pro prüfen. Wer bestehende Systeme, hohe Volumen, Sonderfälle, API-Endpunkte oder Versandprozesse anbinden möchte, sollte direkt über Enterprise nachdenken.

RechneX unterstützt alle drei Einstiegspunkte: kostenlos testen, Pro für wiederkehrende Standardfälle und Enterprise für individuelle E-Rechnungsprozesse mit API-, ERP-, CRM- und Shop-Anbindung.

Kostenlos registrieren und E-Rechnung erstellen

Preise und Pro-Tarif/Enterprise ansehen

Quellen und weiterführende Informationen

* Bundesfinanzministerium: FAQ zur obligatorischen E-Rechnung
* XStandards Einkauf: XRechnung
* XStandards Einkauf: XRechnung 4.0 und EN 16931-1:2026
* RechneX: E-Rechnung erstellen, konvertieren und validieren
* RechneX: KoSIT Validator API für E-Rechnung, XRechnung und ZUGFeRD
* RechneX: Preise für Konverter, Generator, Validator und Enterprise

Tags:

xrechnung apie-rechnung apirest api e-rechnungxrechnung json to xmlzugferd apien 16931 apikosit validator apixrechnung erp anbindunge-rechnung schnittstellexrechnung endpoints

XRechnung vor dem Versand kostenlos prüfen

XML auf EN 16931 und KoSIT-Regeln prüfen