E-Rechnung API für Entwickler: XRechnung und ZUGFeRD per REST erzeugen und prüfen

NormAPI ist eine REST-API, ein Webservice für E-Rechnungen. Sie schicken die Rechnungsdaten als JSON und bekommen eine XRechnung (UBL oder CII) oder ein ZUGFeRD-PDF zurück — jede einzelne vor der Auslieferung mit einer Konformitätsprüfung gegen das offizielle KoSIT-Regelwerk. Die XRechnung API und die ZUGFeRD API sind dieselbe Schnittstelle, ein Parameter wählt das Format. Eingehende E-Rechnungen liest dieselbe API als JSON aus.

Stand: 12. November 2026 · Regelwerk v2026-08-31 · KoSIT-Validator 1.6.3

Auf einen Blick

Formate
XRechnung 3.0.2 in UBL und CII, ZUGFeRD 2 / Factur-X als PDF/A-3 (Profil XRECHNUNG), auf Wunsch in Ihr eigenes PDF eingebettet; für Unternehmen dieselben Formate nach EN 16931.
Prüfung
jede Rechnung vor der Auslieferung gegen das offizielle KoSIT-Regelwerk (v2026-08-31); jeder Regelverstoß im Klartext erklärt, auf Deutsch, Englisch oder Französisch.
Kostenlos
50 erzeugte Rechnungen im Monat ohne Kreditkarte, Prüfen und Auslesen unbegrenzt; danach ab 19 € im Monat.
Eingang
empfangene XRechnung, ZUGFeRD und Factur-X als JSON auslesen, im Format der Erzeugung, mit den Summen, wie sie in der Rechnung stehen.
Für Software-Anbieter
jeder Ihrer Kunden für sich gezählt, mit eigener Monatsobergrenze und eigenem Schlüssel, wenn Sie wollen — ein Konto, ein Kontingent (Kunden Ihrer Software).
Datenschutz
Server in Deutschland, keine Speicherung von Rechnungsinhalten, Auftragsverarbeitungsvertrag für jeden Kunden.
Integration
REST mit JSON, OpenAPI-Spezifikation, TypeScript-Client @normapi/client, MCP-Server für KI-Agenten, Idempotency-Key für sichere Wiederholungen.

Ein Aufruf

Rechnungsdaten als JSON hinein, eine geprüfte XRechnung heraus. Mit syntax=cii kommt dieselbe Rechnung als CII, mit syntax=zugferd als ZUGFeRD-PDF. Die Summen rechnet der Server, in Dezimalarithmetik.

curl
curl -X POST 'https://api.normapi.de/v1/invoices?syntax=ubl' \
  -H "Authorization: Bearer $NORMAPI_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept-Language: de' \
  -o rechnung.xml \
  -d '{
    "invoiceNumber": "RE-2026-0042",
    "issueDate": "2026-10-16",
    "dueDate": "2026-11-15",
    "currency": "EUR",
    "buyerReference": "04011000-12345-03",
    "seller": {
      "name": "Muster Software GmbH",
      "vatId": "DE123456789",
      "electronicAddress": "rechnung@muster-software.de",
      "address": { "street": "Beispielstraße 12", "city": "Berlin",
                   "postcode": "10115", "country": "DE" },
      "contact": { "name": "Maria Muster", "phone": "+49 30 1234567",
                   "email": "maria@muster-software.de" }
    },
    "buyer": {
      "name": "Beispiel Handel AG",
      "electronicAddress": "einkauf@beispiel-handel.de",
      "address": { "street": "Handelsweg 3", "city": "Hamburg",
                   "postcode": "20095", "country": "DE" }
    },
    "payment": { "meansCode": "58", "iban": "DE02120300000000202051" },
    "lines": [
      { "name": "Softwarelizenz Jahresabo", "quantity": 3, "unit": "C62",
        "unitPrice": 199.00, "vatCategory": "S", "vatRate": 19 }
    ]
  }'
Python (requests)
import json, os
import requests

# dieselben Felder wie im curl-Beispiel
with open("rechnung.json", encoding="utf-8") as f:
    invoice = json.load(f)

r = requests.post(
    "https://api.normapi.de/v1/invoices",
    params={"syntax": "ubl"},
    headers={"Authorization": f"Bearer {os.environ['NORMAPI_KEY']}"},
    json=invoice,
)
r.raise_for_status()
with open("rechnung.xml", "wb") as f:
    f.write(r.content)
PHP
<?php
// dieselben Felder wie im curl-Beispiel
$invoice = file_get_contents('rechnung.json');

$ch = curl_init('https://api.normapi.de/v1/invoices?syntax=ubl');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('NORMAPI_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $invoice,
    CURLOPT_RETURNTRANSFER => true,
]);
$xml = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) !== 200) {
    throw new RuntimeException($xml);
}
file_put_contents('rechnung.xml', $xml);

Alle Felder, Fehlercodes und Varianten stehen in der API-Dokumentation; KI-Agenten verbinden sich über den MCP-Server.

Was die API abdeckt

  • Rechnung, Gutschrift, Rechnungskorrektur, Teil- und Schlussrechnung, Gutschriftsverfahren
  • Nachlässe und Zuschläge auf Rechnung und Position, bereits gezahlte Beträge
  • Überweisung, SEPA-Lastschrift und Kartenzahlung
  • Ihr eigenes Rechnungslayout: die XML in Ihr PDF eingebettet, gegen PDF/A-3 geprüft
  • Eingehende E-Rechnungen prüfen und als JSON auslesen, kostenlos — XRechnung, ZUGFeRD und Factur-X
  • Erklärung jeder Prüfregel per Code, für Fehlermeldungen in Ihrer eigenen Oberfläche

Nicht enthalten sind Versand und Archivierung: Die fertige Datei geht an Ihr System zurück. Wer seine Rechnungen schon mit horstoeko, Mustang oder eigenem Code erzeugt und nur die Prüfung braucht, findet sie auf der Seite KoSIT-Validator als API. Für eine einzelne empfangene Rechnung genügt der XRechnung Viewer, und wer nur ab und zu eine Rechnung schreibt, erstellt sie hier im Formular — mit derselben API.

Preise

TarifPro MonatErzeugte Rechnungen
Validator0 €50 im Monat
Starter19 €500 im Monat
Business49 €2.500 im Monat
Scale149 €10.000 im Monat, darüber 0,02 € je Rechnung

Prüfen und Auslesen sind in jedem Tarif kostenlos. Mit Einzelvertrag und SLA: 599 € im Monat für 900.000 Rechnungen im Jahr. Alles Weitere auf der Preisseite.

Kostenlos starten

Häufige Fragen

Was ist eine E-Rechnung API?

Eine Schnittstelle, über die Software E-Rechnungen erzeugen lässt, statt das XML-Format selbst zu bauen und aktuell zu halten. Bei NormAPI schickt Ihr System die Rechnungsdaten als JSON und bekommt eine geprüfte XRechnung oder ein ZUGFeRD-PDF zurück.

Was kostet die API?

Prüfen und Auslesen sind kostenlos und unbegrenzt. Erzeugen: 50 Rechnungen im Monat kostenlos, dann 19 € im Monat für 500, 49 € für 2.500 oder 149 € für 10.000. Mit Einzelvertrag und SLA: 599 € im Monat für 900.000 Rechnungen im Jahr. Alle Preise netto.

Kann ich die API kostenlos testen?

Ja: Konto anlegen, Schlüssel erzeugen, loslegen — ohne Kreditkarte. 50 erzeugte Rechnungen im Monat sind frei, Prüfen und Auslesen zählen nie mit.

Welche Formate erzeugt die API?

XRechnung 3.0.2 in UBL und CII sowie ZUGFeRD 2 / Factur-X als PDF/A-3 im Profil XRECHNUNG — wahlweise mit unserem Layout oder eingebettet in Ihr eigenes PDF. Für Rechnungen an Unternehmen mit profile=en16931 dieselben Formate nach EN 16931, ohne Leitweg-ID, Ansprechpartner und elektronische Adressen, als ZUGFeRD im Profil EN 16931. Rechnung, Gutschrift, Rechnungskorrektur, Teil- und Schlussrechnung.

Wird jede Rechnung geprüft?

Ja. Jede erzeugte Rechnung läuft vor der Auslieferung durch den offiziellen KoSIT-Validator 1.6.3 (Regelwerk v2026-08-31); eine 200-Antwort heißt, sie besteht. Neue Regelwerke ziehen wir nach, ohne dass Sie Ihre Integration ändern.

Wo werden die Daten verarbeitet?

In Deutschland (Düsseldorf). Rechnungsinhalte werden verarbeitet, aber nicht gespeichert; einen Auftragsverarbeitungsvertrag schließen wir mit jedem Kunden.

Kann ich mein eigenes Rechnungslayout behalten?

Ja. Schicken Sie Ihr PDF mit, und die API bettet die XML hinein; das Ergebnis wird mit veraPDF gegen PDF/A-3 geprüft, bevor es zurückkommt.

Gibt es SDKs?

Einen TypeScript-Client auf npm (@normapi/client) und eine OpenAPI-Spezifikation, aus der sich Clients für jede Sprache erzeugen lassen. Für KI-Agenten gibt es einen MCP-Server. Beispiele für PHP, Java und CI stehen auf der Seite zum KoSIT-Validator als API.

Versendet die API die Rechnungen?

Nein. Die fertige Datei geht an Ihr System zurück, Ihr Versandweg übernimmt — E-Mail oder Ihr Peppol-Anbieter. Archiviert wird ebenfalls bei Ihnen.

Kann ich auch eingehende E-Rechnungen prüfen und auslesen?

Ja, kostenlos und unbegrenzt: XRechnung in UBL und CII sowie ZUGFeRD- und Factur-X-PDFs. Der Prüf-Endpunkt erklärt jeden Regelverstoß im Klartext. POST /v1/parse liest die Rechnung als JSON aus — im selben Format, das die Erzeugung annimmt, dazu Summen und Steueraufschlüsselung genau so, wie sie in der Rechnung stehen, und eine Liste von allem, was das Format nicht abbildet. Mit validate=true kommt die Prüfung in derselben Antwort.

Kann meine Software Rechnungen für ihre eigenen Kunden erzeugen?

Ja. Eine Buchhaltung, ein Shop-System oder ein Portal nennt bei jedem Aufruf im Header X-Normapi-Customer die eigene Kennung des Kunden. Es bleibt ein Konto mit einem Kontingent, aber NormAPI zählt jeden Kunden für sich: Im Konto stehen die Zahlen je Kunde und Monat, auch als CSV und über GET /v1/customers. Je Kunde lässt sich eine monatliche Obergrenze setzen und ein eigener Schlüssel anlegen, der nur für diesen Kunden bucht.

Was passiert, wenn das Kontingent aufgebraucht ist?

Bei Starter und Business antwortet die API mit 402, bis der Monat wechselt oder der Tarif. Scale rechnet weiter je Rechnung ab, bis zu der Obergrenze, die Sie festlegen — voreingestellt 300 € im Monat.

XRechnung oder ZUGFeRD — was brauche ich?

Für Rechnungen an öffentliche Auftraggeber in der Regel die XRechnung, mit Leitweg-ID. Im B2B-Verkehr sind beide zulässig; ZUGFeRD ist praktisch, wenn der Empfänger die Rechnung auch ohne Software lesen soll. Beides kommt aus demselben Aufruf.

Welche Software brauche ich für eine E-Rechnung?

Zum Empfangen genügen ein E-Mail-Postfach und ein Viewer. Zum Erstellen braucht es eine Software, die XRechnung oder ZUGFeRD schreibt; die meisten Buchhaltungs- und ERP-Programme können das inzwischen. Wer eigene Software betreibt, die Rechnungen erzeugt, setzt das Format selbst um oder bindet eine API wie diese an.

Kann ich eine E-Rechnung erstellen, ohne Software?

Von Hand kaum: Eine E-Rechnung ist eine XML-Datei, die rund 300 Regeln erfüllen muss, und ein Word- oder PDF-Dokument ist keine. Für einzelne Rechnungen gibt es Online-Formulare; für Rechnungen aus eigener Software ist eine API der kürzeste Weg.

Welches Format muss die E-Rechnung haben?

Eines nach der europäischen Norm EN 16931. In Deutschland sind das vor allem die XRechnung (UBL oder CII) und ZUGFeRD ab Version 2.0.1, außer den Profilen MINIMUM und BASIC WL. Andere Formate wie EDI sind zulässig, wenn Absender und Empfänger sie vereinbaren und die Angaben der Norm enthalten sind.

Wer muss ab 2027 E-Rechnungen schreiben?

Ab dem 1. Januar 2027 Unternehmen mit mehr als 800.000 € Vorjahresumsatz, ab dem 1. Januar 2028 alle übrigen im inländischen B2B-Geschäft; Kleinunternehmer nach § 19 UStG bleiben ausgenommen. Empfangen können müssen alle E-Rechnungen schon seit 2025.