Dokumentation unserer REST-API

Skalierbare E-Rechnungs-API für XRechnung, Peppol und ZUGFeRD: Unsere performante Schnittstelle ist in wenigen Minuten implementiert und bietet die automatisierte Erstellung und Validierung von E-Rechnung auch für große Volumen.

Inhaltsübersicht

1. Allgemeine Informationen
2. REST-API verwenden
3. Interne Datenobjekte
- 3.1. Rechnungsdaten
- 3.2. Konformitätsprüfung
4. Verfügbare Endpunkte

1. Allgemeine Informationen

Eine API-Schnittstelle ermöglicht den automatisierten, großvolumigen und performanten Austausch von Daten zwischen Systemen. Um unsere Systeme und Infrastruktur zu schützen, haben wir standardmäßige Limits für die Häufigkeit von Anfragen über die API-Schnitstelle festgelegt:

höchstens 100 Abfragen alle 60 Sekunden
höchstens 5.000 Abfragen alle 24 Stunden

Bitte begrenzen Sie Ihre Zugriffe entsprechend, damit diese Limits nicht überschritten werden. Andernfalls werden Anfragen, die eines der Limits überschreiten, solange vom System abgewiesen, bis die entsprechende Abfragerate wieder unterschritten ist. Wenn Sie größere Volumen benötigen, nehmen Sie bitte Kontakt mit uns auf.

Die Basis-URL für den Zugriff auf alle API-Endpunkte lautet: https://api.eu-rechnung.de/v1/

Hinweis: In dem von Ihnen gebuchten Paket ist eine bestimmte Anzahl von REST-API-Abfragen zum Hochladen und Anlegen neuer Rechnungen enthalten. Die Anzahl richtet sich nach dem jeweiligen Guthaben zur Umwandlung von PDF-Rechnungen. Beispielsweise erlaubt das "Paket M" das Hochladen oder Anlegen von 50 Rechnungen über die REST-API. Diese Begrenzung gilt nicht für das Auslesen oder die Weiterverarbeitung vorhandener Rechnungen in unserem System, sondern ausschließlich für das Hinzufügen neuer Rechnungen. Das Kontingent kann bei Bedarf über zusätzliche Erweiterungen im Nutzerbereich erhöht werden.

Bitte beachten Sie: Die Verwendung der REST-API setzt mindestens das Paket M oder höher voraus.

2. REST-API verwenden

2.1. Authentifikation

Unsere REST-API arbeitet für die Authorisierung mit sogenannten Bearer-Token. Das bedeutet, dass bei jedem Zugriff auf einen Endpunkt ein geheimer Schlüssel im Headerfeld Authorization der Anfrage mitgeliefert werden muss. Der API-Schlüssel kann im Nutzerbereich in den Einstellungen abgerufen und erneuert werden.

Wichtig: Bitte halten Sie den API-Zugriffstoken geheim, um einen Missbrauch durch Dritte zu vermeiden.

Die Authorisierung an der REST-API ist denkbar einfach. Ein Zugriff mit PHP und cURL sieht beispielhaft wie folgt aus:

$url = 'https://api.eu-rechnung.de/v1/products';
$token = 'vPDHTMS3tRtaxObE25oxk9nLnn7KCZTP7jtqcJLi';
$header = [
    "Authorization: Bearer {$token}",
    'Content-Type: application/json',
];

$payload = json_encode([
    'item_number' => '1003',
    'item_measure' => 'HUR',
    'name' => 'Dienstleistung IT-Support Level 2',
    'description' => 'Analyse und Behebung von Systemfehlern',
    'unit_net' => 85,
    'tax_code' => 'STD-NORMAL',
]);

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($curl, CURLOPT_POSTFIELDS, $payload);
$result = curl_exec($curl);

2.2. HTTP-Antwortcodes

Folgende HTTP-Antwortcodes können bei Anfragen von unserer API zurückgegeben werden:

HTTP-Code	Beschreibung
`200`	Die Anfrage wurde vom System entgegengenommen und erfolgreich verarbeitet.
`202`	Das angeforderte Dokument steht noch nicht zum Abruf bereit. Versuchen Sie es später noch einmal.
`401`	Der Zugriff auf die REST-API ist nicht möglich. Weitere Informationen finden Sie im Antworttext. Dieser Fehler tritt beispielsweise bei der Verwendung fehlerhafter API-Zugangsdaten auf.
`402`	Das Guthaben ist aufgebraucht. Weitere Informationen finden Sie im Antworttext. Dieser Fehler tritt beispielsweise auf, wenn nicht ausreichend Guthaben zur PDF-Umwandlung verfügbar ist.
`403`	Der Zugriff auf den Endpunkt ist nicht erlaubt. Weitere Informationen finden Sie im Antworttext. Das Umwandeln einer PDF-Datei bei nicht ausreichendem Guthaben führt beispielsweise zu diesem Fehler.
`404`	Das Element, auf welches Sie zugreifen möchten, existiert nicht.
`409`	Die gewünschte Anfrage kann nicht ausgeführt werden, weil ein Konflikt aufgetreten ist. Dieser Fehler kann beispielsweise auftreten, wenn Sie versuchen, eine bereits abgeschlossene E-Rechnung zu bearbeiten.
`422`	Die Anfrage war fehlerhaft. Weitere Hinweise erhalten Sie im Antworttext. Dieser Fehler bedeutet, dass die Anfragedaten semantische oder syntaktische Fehler enthalten.
`429`	Beim Überschreiten der Abfragelimits für die REST-API wird dieser Fehler zurückgegeben. Bitte drosseln Sie das Abfragevolumen und versuchen es später erneut.
`500`	Es ist ein interner Systemfehler aufgetreten. Bitte versuchen Sie es später erneut.
`503`	Dieser Status zeigt an, dass auf unseren Systemen Wartungsarbeiten stattfinden. Bitte versuchen Sie es später erneut.

2.3. Struktur von Anfragen und Antworten

Grundsätzlich wird JSON als Format für Anfragen (Request Body) sowie für Antworten (Response Body) verwendet. Dazu sollte im Header der Anfrage das Feld Content-Type: application/json angegeben werden. Beispiele für den Payload von Anfragen und Antworten finden Sie nachfolgend unter Dokumentation der einzelnen Endpunkte.

Alle Objekte, wie Rechnungen und Stammdaten, die über unsere REST-API verwaltet werden können, werden über eine eindeutige Kennung in Form einer UUID identifiziert. Diese wird auch benötigt, um weitere Abfragen auf einem bestimmten Objekt auszuführen, bspw. zum Bearbeiten oder Abrufen weiterer Informationen. Wenn neue Objekte mittels POST-Request erfolgreich angelegt werden konnten, wird die zugehörige UUID im Response Body von der API zurückgegeben.

Hinweis: Speziell für den Abruf der Konformitätsprüfungen kann die Rückgabe des Ergebnisses wahlweise als JSON-Objekt mit allen Rohdaten oder als fertig erzeugter PDF-Bericht erfolgen. Die kann über die Angabe des Content-Type im Header der Anfrage gesteuert werden. Mit Verwendung des MIME-Types application/json wird das Ergebnis als JSON-Objekt zurückgegeben, andersfalls sollte application/pdf verwendet werden, um das entsprechende PDF-Dokument zu empfangen.

2.4. Austausch von Dokumenten

Der Austausch von Dokumenten über die API erfolgt ebenfalls als JSON-formatiertes Objekt. Das Dateiobjekt muss im Feld file übergeben werden. Der eigentliche Inhalt der Datei wird dabei Base64-kodiert übergeben. Ein beispielhafter Aufruf mit PHP und cURL sieht wie folgt aus:

$url = 'https://api.eu-rechnung.de/v1/validator';
$token = 'vPDHTMS3tRtaxObE25oxk9nLnn7KCZTP7jtqcJLi';
$header = [
    "Authorization: Bearer {$token}",
    'Content-Type: application/json',
];

$path = __DIR__ . '/storage/invoice.pdf';
$content = file_get_contents($path);
$payload = json_encode([
    'file' => [
        'filename' => basename($path),
        'mimetype' => 'application/pdf',
        'content' => base64_encode($content),
    ],
]);

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($curl, CURLOPT_POSTFIELDS, $payload);
$result = curl_exec($curl);

Bitte beachten Sie beim Hochladen die jeweils höchstens zulässige Dateigröße von 10 MB für umzuwandelnde PDF-Dateien im Rechnungsausgang und 20 MB für Dokumente in den Bereichen Rechnungseingang und Rechnungsprüfung.

Über die REST-API abgerufene Dokumente werden in einem festen Format ausgegeben. Der eigentliche Inhalt wird dabei als Base64-kodierte Zeichenkette zurückgegeben. Weiterhin enthält die Antwort zusätzliche Metadaten für das Dokument. Eine entsprechende Antwort der API sieht wie folgt aus:

{
    "uuid": "10e6d900-d927-47d7-a94c-e104126bd06d",
    "filename": "Rechnung RE2438-0987.pdf",
    "filesize": 57286,
    "mimetype": "application/pdf",
    "content": "uWc-WsMMY7S_UG60ruf6R2s3DYKctokXFHzxpsXF3vu4xHvORi(...)UKntT9rpVn5r_I18YlMrd_us4Qd-bj-RbPomNfPDrSrSxYcWY="
}

2.5. Referenzlisten gemäß EN 16931

Die Digitalisierung der Rechnungsstellung funktioniert nur, wenn maschinenlesbare Daten von allen Systemen einheitlich verstanden werden. Dazu ist es erforderlich, dass verschiedene Angaben, wie beispielweise die Maßeinheiten von Rechnungspositionen oder die Angabe von Währungen, aus einer gemeinsamen Codeliste entnommen werden. Im Rahmen der XRechnung kommen folgende Codelisten zum Einsatz, die auch von unserer Software unterstützt werden:

Liste	Beschreibung	Quelle
ISO 3166-1	Standardisierte Codes für Ländernamen zur eindeutigen internationalen Identifikation.
ISO 4217	Internationale Standardcodes zur einheitlichen Bezeichnung von Währungen in Finanztransaktionen.
UNTDID 1001	Klassifizierung verschiedener Dokumentenarten, wie beispielsweise Rechnungen oder Gutschriften.
UNTDID 1153	Codes zur Spezifizierung von Referenzarten, wie Bestellnummern oder Vertragsnummern.
UNTDID 2005	Formate zur einheitlichen Angabe von Datum, Uhrzeit oder bestimmten Zeiträumen.
UNTDID 4451	Codes zur Kategorisierung von Freitexten und zusätzlichen Rechnungsinformationen.
UNTDID 4461	Definition der vereinbarten Zahlungsmittel, beispielsweise Banküberweisung, Lastschrift oder Barzahlung.
UNTDID 5189	Spezifizierung von Gründen für angewandte Zu- und Abschläge auf Rechnungen.
UNTDID 5305	Codes für verschiedene Steuerkategorien, wie Standard- oder ermäßigter Umsatzsteuersatz.
UNTDID 7143	Kennzeichnung der Art einer Artikelnummer, wie EAN, GTIN oder Käuferartikelnummer.
UNTDID 7161	Codes zur Kategorisierung von speziellen Dienstleistungen, Gebühren, Zu- und Abschlägen.
ICD	ISO 6523 Codes zur Identifikation von Organisationen und Behörden (Leitweg-ID).
EAS	Schema zur Spezifizierung von Adressierungsarten für den elektronischen Dokumentenempfang.
VATEX	Standardisierte Begründungen für die Anwendung von Umsatzsteuerbefreiungen bei Rechnungen.
Rec 20	Einheitliche Codes für physikalische Maßeinheiten wie Kilogramm, Meter oder Stück.
Rec 21	Standardisierte Codes zur Klassifizierung verschiedener Verpackungsarten und Transportbehälter.

2.6. Dokumentation der Endpunkte

Jede Endpunkt-Definition enthält Angaben zum Schema der einzugebenden und ausgegebenen Daten. Kleine farbige Labels an jedem Attribut geben Aufschluss über Datentypen und den Anwendungsbereich der jeweiligen Information:

STRING	Bezeichnung des verwendeten Datentyps.
OUT	Das Feld wird in der Antwort zurückgegeben.
IN	Das Feld kann in der Anfrage übergeben werden.
IN	Es handelt sich um eine Pflichtangabe für die Anfrage.
BT-10	Verweis auf das entsprechende BT-Feld einer XRechnung.

Folgende Datentypen werden in der Dokumentation verwendet:

UUID	Eindeutige Kennung für interne Objekte (z.B. Rechnungen).
STRING	Zeichenkette mit einer maximalen Länge von 255 Zeichen.
TEXT	Texte mit einer maximalen Länge von 65535 Zeichen.
EMAIL	Übergebener Wert muss eine E-Mail-Adresse sein.
INT	Unformatierte, ganzzahlige Werte.
DATE	Datumsangabe gemäß ISO 9075-Standard im Format "YYYY-MM-DD".
TIMESTAMP	Zeitangabe als UTC-Zeitstempel im Format "YYYY-MM-DD HH:mm:ss".
DECIMAL	Dezimalzahl mit Punkt als Dezimaltrenner und zwei Nachkommastellen.
PERCENTAGE	Prozentwert im Bereich 0-100 mit bis zu zwei Nachkommastellen.
REFERENCE	Verweis auf eine EN 16931-Referenzliste gemäß Punkt 2.5.
ENUM	Es muss ein Wert aus der vorgegebenen Liste verwendet werden.
BASE64	Es handelt sich um einen Base64-kodierten Wert (meist für Dokumente verwendet).
OBJECT	Das Element ist ein Objekt, das aus weiteren Unterelementen besteht.
LIST	Das Element ist eine Auflistung von Werten oder weiteren Unterobjekten.

3. Interne Datenobjekte

3.1. Rechnungsdaten

EU-Rechnung verwaltet E-Rechnungen intern in einer eigenen Datenstruktur. Diese Struktur speichert mindestens alle von einer XRechnung unterstützten Informationen und Attribute. Da es sich hierbei um eine sehr umfangreiche Struktur handelt, wird diese aus Gründen der Übersichtlichkeit an dieser Stelle umfassend dokumentiert. In der nachfolgenden Dokumentation der verfügbaren Endpunkte wird bei Bedarf auf diesen Abschnitt referenziert.

Bitte beachten Sie: Beim Anlegen von Ausgangsrechnungen werden derzeit nur die Eingabefelder erlaubt, die im Rechnungsformular im Rechnungsausgang zur Verfügung stehen, auch wenn intern alle Angaben einer XRechnung unterstützt werden. Dies ermöglicht es, Rechnungen zugleich über die Weboberfläche und über die REST-API verwalten zu können.

Hinweis: Angaben, die grundsätzlich für eine E-Rechnung erforderlich sind, sind im nachfolgenden Schema entsprechend markiert. Abhängig von den weiteren Inhalten Ihrer Rechnung, kann sich aufgrund verschiedener Geschäftsregeln (Business Rules) ergeben, dass weitere Angaben benötigt werden. Diese komplexen Szenarien lassen sich nicht im Rahmen dieser Dokumentation darstellen. Beim Anlegen der Rechnung, werden in diesem Fall entsprechende Fehlermeldungen mit weiteren Informationen zu Pflichtangaben zurückgegeben.

seller_address OBJECT OUT IN

Angaben zur Identität des Verkäufers.
- brand STRING OUT IN BT-28
  
  Marke oder Handelsname des Verkäufers.
- name STRING OUT IN BT-27
  
  Vollständiger Name des Verkäufers.
- line_one STRING OUT IN BT-35
  
  Hauptzeile der Verkäuferanschrift (Adresszeile 1).
- line_two STRING OUT IN BT-36
  
  Zusätzliche Zeile der Verkäuferanschrift (Adresszeile 2).
- line_three STRING OUT IN BT-162
  
  Zusätzliche Zeile der Verkäuferanschrift (Adresszeile 3).
- zipcode STRING OUT IN BT-38
  
  Postleitzahl der Verkäuferanschrift.
- city STRING OUT IN BT-37
  
  Stadt oder Gemeinde des Verkäufers.
- district STRING OUT BT-39
  
  Region oder Bundesland des Verkäufers.
- country REFERENCE OUT IN BT-40
  
  Land, in dem sich die Verkäuferanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
- contact_person STRING OUT IN BT-41
  
  Ansprechpartner oder Kontakt beim Verkäufer.
- contact_department STRING OUT BT-41
  
  Abteilung für den Kontakt beim Verkäufer.
- contact_phone STRING OUT IN BT-42
  
  Telefonnummer des Kontakts beim Verkäufer.
- contact_email EMAIL OUT IN BT-43
  
  E-Mail-Adresse des Kontakts beim Verkäufer.
- vat_number STRING OUT IN BT-31
  
  Umsatzsteuer-Identifikationsnummer des Verkäufers.
- tax_number STRING OUT IN BT-32
  
  Örtliche Steuernummer des Verkäufers.
- legal_number STRING OUT IN BT-30
  
  Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
- legal_scheme REFERENCE OUT BT-30
  
  Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
- legal_information TEXT OUT BT-33
  
  Weitere maßgebliche rechtliche Informationen zum Verkäufer.
- identifier LIST OUT
  
  Liste von Kennungen zur Identifizierung des Verkäufers.
  - ident_number STRING OUT IN BT-29
    
    Eindeutige Kennung des Verkäufers gemäß eines ISO-Schemas.
  - ident_scheme REFERENCE OUT IN BT-29
    
    Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
- electronic_address STRING OUT IN BT-34
  
  Elektronische Adresse gemäß EAS-Schema für Antworten zur Rechnung.
- electronic_scheme REFERENCE OUT IN BT-34
  
  Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.
- creditor_number STRING OUT
  
  Eindeutige Identifikationsnummer in Ihrem System (Lieferantennummer).
buyer_address OBJECT OUT IN

Angaben zur Identität des Käufers.
- debtor_number STRING OUT IN
  
  Eindeutige Identifikationsnummer in Ihrem System (Kundennummer).
- brand STRING OUT IN BT-45
  
  Marke oder Handelsname des Käufers.
- name STRING OUT IN BT-44
  
  Vollständiger Name des Käufers.
- line_one STRING OUT IN BT-50
  
  Hauptzeile der Käuferanschrift (Adresszeile 1).
- line_two STRING OUT IN BT-51
  
  Zusätzliche Zeile der Käuferanschrift (Adresszeile 2).
- line_three STRING OUT IN BT-163
  
  Zusätzliche Zeile der Käuferanschrift (Adresszeile 3).
- zipcode STRING OUT IN BT-53
  
  Postleitzahl der Käuferanschrift.
- city STRING OUT IN BT-52
  
  Stadt oder Gemeinde des Käufers.
- district STRING OUT BT-54
  
  Region oder Bundesland des Käufers.
- country REFERENCE OUT IN BT-55
  
  Land, in dem sich die Käuferanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
- contact_person STRING OUT IN BT-56
  
  Ansprechpartner oder Kontakt beim Käufer.
- contact_department STRING OUT BT-56
  
  Abteilung für den Kontakt beim Käufer.
- contact_phone STRING OUT IN BT-57
  
  Telefonnummer des Kontakts beim Käufer.
- contact_email EMAIL OUT IN BT-58
  
  E-Mail-Adresse des Kontakts beim Käufer.
- vat_number STRING OUT IN BT-48
  
  Umsatzsteuer-Identifikationsnummer des Käufers.
- legal_number STRING OUT IN BT-47
  
  Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
- legal_scheme REFERENCE OUT BT-47
  
  Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
- identifier LIST OUT
  
  Liste von Kennungen zur Identifizierung des Käufers.
  - ident_number STRING OUT IN BT-46
    
    Eindeutige Kennung des Käufers gemäß eines ISO-Schemas.
  - ident_scheme REFERENCE OUT IN BT-46
    
    Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
- electronic_address STRING OUT IN BT-49
  
  Elektronische Adresse gemäß EAS-Schema, an die die Rechnung gesendet werden soll.
- electronic_scheme REFERENCE OUT IN BT-49
  
  Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.

delivery_address OBJECT OUT IN

Angabe einer abweichenden Lieferanschrift.

name STRING OUT IN BT-70

Name des Empfängers der Ware oder Dienstleistung.
line_one STRING OUT IN BT-75

Hauptzeile der Lieferanschrift (Adresszeile 1).
line_two STRING OUT IN BT-76

Zusätzliche Zeile der Lieferanschrift (Adresszeile 2).
line_three STRING OUT IN BT-165

Zusätzliche Zeile der Lieferanschrift (Adresszeile 3).
zipcode STRING OUT IN BT-78

Postleitzahl der Lieferanschrift.
city STRING OUT IN BT-77

Stadt oder Gemeinde der Lieferanschrift.
district STRING OUT BT-79

Region oder Bundesland der Lieferanschrift.
country REFERENCE OUT IN BT-80

Land, in dem sich die Lieferanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
ident_number STRING OUT IN BT-71

Eindeutige Kennung für die Lieferanschrift gemäß eines ISO-Schemas.
ident_scheme REFERENCE OUT IN BT-71

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.

custom_data ENUM OUT

Angabe, ob eine Lieferanschrift vorhanden ist. Entspricht einem der folgenden Werte:

`yes`	Es wurde eine Lieferanschrift angegeben.
`no`	Keine Angaben zur Lieferanschrift vorhanden.

tax_representative OBJECT OUT

Angaben zum steuerlichen Vertreter.

name STRING OUT BT-62

Vollständiger Name des steuerlichen Vertreters.
line_one STRING OUT BT-64

Hauptzeile der Anschrift (Adresszeile 1).
line_two STRING OUT BT-65

Zusätzliche Zeile der Anschrift (Adresszeile 2).
line_three STRING OUT BT-164

Zusätzliche Zeile der Anschrift (Adresszeile 3).
zipcode STRING OUT BT-67

Postleitzahl des steuerlichen Vertreters.
city STRING OUT BT-66

Stadt oder Gemeinde des steuerlichen Vertreters.
district STRING OUT BT-68

Region oder Bundesland des steuerlichen Vertreters.
country REFERENCE OUT BT-69

Land, in dem sich der steuerliche Vertreter befindet. Es ist die Liste ISO 3166-1 zu verwenden.
vat_number STRING OUT BT-63

Umsatzsteuer-Identifikationsnummer des Vertreters.

custom_data ENUM OUT

Angabe, ob ein steuerlicher Vertreter vorhanden ist. Entspricht einem der folgenden Werte:

`yes`	Es wurden Angaben zum steuerlichen Vertreter gemacht.
`no`	Keine Angaben zum steuerlichen Vertreter vorhanden.

invoice_meta OBJECT OUT IN

Allgemeine Angaben zur Rechnung.

business_process STRING OUT BT-23

Kontext des Geschäftsprozesses (Prozesskennung der E-Rechnung).
buyer_reference STRING OUT IN BT-10

Käuferreferenz für interne Lenkungszwecke (Leitweg-ID).
contract_reference STRING OUT IN BT-12

Vertragsnummer, auf die sich die Rechnung bezieht.
delivery_date DATE OUT IN BT-72

Datum der Lieferung oder Leistungserbringung.
despatch_reference STRING OUT IN BT-16

Kennung einer Versandanzeige.

exemption_code ENUM OUT IN

Anzuwendender Ausnahmegrund von der Umsatzsteuer.
Es ist ein Wert aus folgender Liste zu verwenden (die konkrete Auswahl hängt vom Einzelfall ab):

`NONE`	Keine Ausnahme von der USt.
`ZERO`	0% (keine USt.)
`EXEMPT`	0% (USt.-Ausnahme)
`USTG-19`	0% (gem. § 19 UStG)
`USTG-13B`	0% (gem. § 13b UStG)
`USTG-25B`	0% (gem. § 25b UStG)
`INTRA`	0% (Innergemein. Lfrg.)
`EXPORT`	0% (Ausfuhrlieferung)

invoice_currency REFERENCE OUT IN BT-5

Währungskennzeichen für Rechnungsbeträge. Es ist die Liste ISO 4217 zu verwenden.
invoice_date DATE OUT IN BT-2

Ausstellungsdatum der Rechnung.
invoice_number STRING OUT IN BT-1

Eindeutige Kennung der Rechnung (Rechnungsnummer).

invoice_type REFERENCE OUT IN BT-3

Art des Rechnungsdokuments. Es ist die Liste UNTDID 1001 zu verwenden. Folgende Rechnungstypen werden derzeit unterstützt:

`380`	Rechnung
`326`	Teilrechnung
`384`	Stornorechnung
`381`	Kaufmännische Gutschrift
`389`	Gutschrift nach § 14 UStG
`875`	Abschlagsrechnung (Bauleistung)
`876`	Teilschlussrechnung (Bauleistung)
`877`	Schlussrechnung (Bauleistung)

invoiced_object_id STRING OUT BT-18

Objektkennung, auf die sich die Rechnung bezieht (bspw. Zählernummer).
invoiced_object_scheme REFERENCE OUT BT-18

Verwendetes Schema für die Kennung. Es ist die Liste UNTDID 1153 zu verwenden.
notes LIST OUT

Notizen und rechnungsrelevante Erläuterungen.
- subject_code REFERENCE OUT IN BT-21
  
  Kodierter Betreff für die Rechnungsnotiz. Es ist die Liste UNTDID 4451 zu verwenden.
- content TEXT OUT IN BT-22
  
  Weitere maßgebliche Informationen zur Rechnung.
preceding LIST OUT

Referenz auf vorausgegangene Rechnungen.
- invoice_date DATE OUT IN BT-26
  
  Datum einer vorausgegangenen Rechnung.
- invoice_number STRING OUT IN BT-25
  
  Nummer einer vorausgegangenen Rechnung.
project_name STRING OUT BT-11

Projektname, auf den sich die Rechnung zieht. Wird ausschließlich in CII-Syntax unterstützt.
project_reference STRING OUT IN BT-11

Projektnummer, auf die sich die Rechnung bezieht.
purchase_reference STRING OUT IN BT-13

Auftragsnummer des Käufers (Bestellreferenz).
receiving_reference STRING OUT BT-15

Kennung einer Empfangsbestätigung.
sales_date DATE OUT

Bestelldatum des Käufers.
sales_reference STRING OUT IN BT-14

Auftragsnummer des Verkäufers.
service_from DATE OUT IN BT-73

Beginn des Abrechnungszeitraums für die Rechnung.
service_to DATE OUT IN BT-74

Ende des Abrechnungszeitraums für die Rechnung.
shipping_terms TEXT OUT IN

Lieferbedingungen für die abgerechneten Waren.
shipping_type STRING OUT IN

Art des Versands bei postalischer Zustellung.
tax_country ENUM OUT IN

Für die Abführung der Umsatzsteuer maßgebliches Land. Der Wert muss entweder dem Land des Verkäufers, des Käufers oder der Lieferanschrift entsprechen.
tax_currency REFERENCE OUT BT-6

Währungskennzeichen für Umsatzsteuerbeträge. Es ist die Liste ISO 4217 zu verwenden.
tax_date_code REFERENCE OUT BT-8

Buchungszeitpunkt für die Umsatzsteuer. Es ist die Liste UNTDID 2005 zu verwenden.
tax_date_point DATE OUT BT-7

Abrechnungszeitpunkt für die Umsatzsteuer.
tender_reference STRING OUT BT-17

Kennung der Ausschreibung, auf die sich die Rechnung bezieht.
xml_specification STRING OUT BT-24

Kennung des semantischen Regelwerks (Spezifikationskennung).

invoice_items LIST OUT IN

Liste der Rechnungspositionen.

additions LIST OUT

Nachlässe und Zuschläge für Rechnungspositionen.

addition_net DECIMAL OUT BT-136 BT-141

Nachlassbetrag bzw. Zuschlag ohne Umsatzsteuer.
base_amount DECIMAL OUT BT-137 BT-142

Grundbetrag zur Berechnung des Nachlasses oder Zuschlags.
percentage PERCENTAGE OUT BT-138 BT-143

Prozentsatz zur Berechnung des Nachlasses oder Zuschlags.
reason_code REFERENCE OUT BT-140 BT-145

Kodierter Grund für den Nachlass oder Zuschlag. Es sind die Listen UNTDID 5189 und UNTDID 7161 zu verwenden.
reason_text STRING OUT BT-139 BT-144

Grund für den Nachlass oder Zuschlag in Textform.

type ENUM OUT

Art der Betragsveränderung des Rechnungspostens. Es ist ein Wert aus folgender Liste zu verwenden:

`allowance`	Es handelt sich um einen Nachlass auf den Betrag.
`charge`	Es handelt sich um einen Zuschlag auf den Betrag.

attributes LIST OUT

Eigenschaften der in Rechnung gestellten Waren und Dienstleistungen.
- name STRING OUT BT-160
  
  Name der Eigenschaft des Rechnungspostens (bspw. "Farbe").
- value STRING OUT BT-161
  
  Wert der Eigenschaft des Rechnungspostens (bspw. "rot").
buyer_accounting STRING OUT BT-133

Kontierungshinweis zur Rechnungsposition für den Käufer.
buyer_reference STRING OUT IN BT-156

Kennung des Käufers für den Posten.
children LIST OUT

Unterpositionen zur aktuellen Rechnungsposition. Wird ausschließlich in UBL-Syntax unterstützt.
classification LIST OUT

Klassifizierung des Postens nach Typ, Art oder Beschaffenheit.
- classification_id STRING OUT BT-158
  
  Kennung zur Klassifizierung des Postens.
- classification_scheme REFERENCE OUT BT-158
  
  Verwendetes Schema für die Kennung. Es ist die Liste UNTDID 7143 zu verwenden.
- classification_version REFERENCE OUT BT-158
  
  Verwendetes Version des Schemas.
date_from DATE OUT IN BT-134

Beginn des Abrechnungszeitraums der Rechnungsposition.
date_to DATE OUT IN BT-135

Ende des Abrechnungszeitraums der Rechnungsposition.
description TEXT OUT IN BT-154

Beschreibung mit weiteren Einzelheiten zum Rechnungsposten.
ident_number STRING OUT IN BT-157

Eindeutige Kennung des Postens gemäß eines ISO-Schemas.
ident_scheme REFERENCE OUT IN BT-157

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
item_discount PERCENTAGE OUT IN

Prozentualer Nachlass auf den Rechnungsposten.
item_measure REFERENCE OUT IN BT-130

Für die berechnete Menge geltende Maßeinheit. Es sind die Listen Rec 20 und Rec 21 zu verwenden.
item_net DECIMAL OUT IN BT-131

Nettobetrag der Rechnungsposition inklusive Nachlässen und Zuschlägen.
item_number STRING OUT IN BT-155

Kennung des Verkäufers für den Posten (Artikelnummer).
item_quantity DECIMAL OUT IN BT-129

Menge der berechneten Waren oder Dienstleistungen (bis zu 4 Nachkommastellen).
name STRING OUT IN BT-153

Name oder Kurzbezeichnung des Rechnungspostens.
note TEXT OUT BT-127

Freitext für maßgebliche Informationen zur Rechnungsposition.
object_id STRING OUT BT-128

Objektkennung, auf die sich die Rechnungsposition bezieht (bspw. Zählernummer).
object_scheme REFERENCE OUT BT-128

Verwendetes Schema für die Kennung. Es ist die Liste UNTDID 1153 zu verwenden.
origin_country REFERENCE OUT BT-159

Herkunftsland der Ware oder Dienstleistung. Es ist die Liste ISO 3166-1 zu verwenden.
position STRING OUT BT-126

Eindeutige Bezeichnung für die Rechnungsposition (Zeilennummer).
purchase_reference STRING OUT IN BT-132

Referenznummer des Käufers für die Rechnungsposition.
tax_category REFERENCE OUT BT-151

Umsatzsteuerkategorie für die Rechnungsposition. Es ist die Liste UNTDID 5305 zu verwenden.

tax_code ENUM OUT IN

Anzuwendende Besteuerungsgrundlage gemäß steuerlichem Status.
Es ist ein Wert aus folgender Liste zu verwenden (die konkrete Auswahl hängt vom Einzelfall ab):

`STD-NORMAL`	19% (normale USt.)
`STD-REDUCED`	7% (reduzierte USt.)
`AGRI-NORMAL`	7,8% (gem. § 24 UStG)
`AGRI-REDUCED`	5,5% (gem. § 24 UStG)
`ZERO`	0% (keine USt.)
`EXEMPT`	0% (USt.-Ausnahme)
`USTG-19`	0% (gem. § 19 UStG)
`USTG-13B`	0% (gem. § 13b UStG)
`USTG-25B`	0% (gem. § 25b UStG)
`INTRA`	0% (Innergemein. Lfrg.)
`EXPORT`	0% (Ausfuhrlieferung)

tax_rate PERCENTAGE OUT BT-152

Umsatzsteuersatz für die Rechnungsposition.
unit_discount DECIMAL OUT BT-147

Auf den Einzelposten anzuwendender Rabatt (bis zu 4 Nachkommastellen).
unit_gross DECIMAL OUT BT-148

Nettopreis des Einzelpostens ohne Rabatt (bis zu 4 Nachkommastellen).
unit_measure REFERENCE OUT BT-150

Zugrundeliegende Maßeinheit für den Rechnungsposten. Es sind die Listen Rec 20 und Rec 21 zu verwenden.
unit_net DECIMAL OUT IN BT-146

Nettopreis des Einzelpostens inklusive Rabatt (bis zu 4 Nachkommastellen).
unit_quantity DECIMAL OUT BT-149

Menge der Einheiten, für die der Postenpreis gilt (bis zu 4 Nachkommastellen).

payment_data OBJECT OUT IN

Zahlungsangaben und -informationen.

additions LIST OUT

Nachlässe und Zuschläge auf Rechnungsebene.

addition_net DECIMAL OUT BT-92 BT-99

Nachlassbetrag bzw. Zuschlag ohne Umsatzsteuer.
base_amount DECIMAL OUT BT-93 BT-100

Grundbetrag zur Berechnung des Nachlasses oder Zuschlags.
percentage PERCENTAGE OUT BT-94 BT-101

Prozentsatz zur Berechnung des Nachlasses oder Zuschlags.
reason_code REFERENCE OUT BT-98 BT-105

Kodierter Grund für den Nachlass oder Zuschlag. Es sind die Listen UNTDID 5189 und UNTDID 7161 zu verwenden.
reason_text STRING OUT BT-97 BT-104

Grund für den Nachlass oder Zuschlag in Textform.
tax_category REFERENCE OUT BT-95 BT-102

Umsatzsteuerkategorie für den Nachlass oder Zuschlag. Es ist die Liste UNTDID 5305 zu verwenden.
tax_rate PERCENTAGE OUT BT-96 BT-103

Umsatzsteuersatz für den Nachlass oder Zuschlag.

type ENUM OUT

Art der Veränderung für den Rechnungsbetrag. Es ist ein Wert aus folgender Liste zu verwenden:

`allowance`	Es handelt sich um einen Nachlass auf den Betrag.
`charge`	Es handelt sich um einen Zuschlag auf den Betrag.

bank_creditor STRING OUT IN BT-90

Gläubiger-ID für Lastschriften.
bank_mandate STRING OUT IN BT-89

Mandatsreferenz für Lastschriften.
buyer_accounting STRING OUT IN BT-19

Kontierungshinweis zur Rechnung für den Käufer.
due_amount DECIMAL OUT IN BT-115

Ausstehender Betrag, der vom Käufer zu zahlen ist.
due_date DATE OUT IN BT-9

Fälligkeitsdatum des Rechnungsbetrags.

due_discounts LIST OUT IN

Informationen zu Skontoregelungen.

base_amount DECIMAL OUT IN

Abweichender Grundbetrag für die Ermittlung des Skontobetrags.
discount_amount DECIMAL OUT IN

Betrag, um den der Rechnungsbetrag gemindert werden darf (Skontobetrag).
due_date DATE OUT IN

Datum, bis zu dem der fällige Betrag zur Gewährung von Skonto gezahlt werden muss.
due_days INT OUT IN

Zahlungsfrist in Tagen, in der Skonto gewährt wird.
due_discount PERCENTAGE OUT IN

Gewährter Zahlungsnachlass in Prozent.

custom_amount ENUM OUT IN

Angabe, ob sich die Regelung auf einen abweichenden Grundbetrag bezieht. Entspricht einem der folgenden Werte:

`yes`	Die Regelung wird auf einen abweichenden Grundbetrag angewendet.
`no`	Die Skontoregelung wird auf den Rechnungsbetrag angewendet.

foreign_tax DECIMAL OUT BT-111

Gesamtbetrag der Umsatzsteuer in abweichender Abrechnungswährung.
paid_amount DECIMAL OUT IN BT-113

Summe der bereits durch den Käufer gezahlten Beträge.
payee_creditor STRING OUT BT-90

Gläubiger-ID für Lastschriften. Wird ausschließlich in UBL-Syntax unterstützt.
payee_ident_number STRING OUT BT-60

Eindeutige Kennung für den Zahlungsempfänger.
payee_ident_scheme REFERENCE OUT BT-60

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
payee_legal_number STRING OUT BT-61

Erteilte Nummer einer Registerstelle für den Zahlungsempfänger.
payee_legal_scheme REFERENCE OUT BT-61

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
payee_name STRING OUT BT-59

Name des abweichenden Zahlungsempfängers.
payment_accounts LIST OUT IN

Für die gewählte Zahlart anzuwendende Zahlungsverbindungen.
- account_id STRING OUT IN BT-84 BT-87 BT-91
  
  Kontonummer (IBAN) oder Kreditkartennummer für die Zahlungstransaktion.
- bank_code STRING OUT IN BT-86
  
  Kennung des kontoführenden Instituts (BIC).
- name STRING OUT IN BT-85 BT-88
  
  Name des Konto- oder Karteninhabers.
payment_method STRING OUT BT-82

Verwendete Zahlungsmethode in Textform.
payment_purpose STRING OUT IN BT-83

Referenztext für die Zahlung (Verwendungszweck).
payment_terms TEXT OUT IN BT-20

Zahlungsbedingungen und Skontohinweis.
payment_type REFERENCE OUT IN BT-81

Kodierte Angabe der Zahlungsmethode. Es ist die Liste UNTDID 4461 zu verwenden.
sum_allowances DECIMAL OUT BT-107

Gesamtsumme aller Nachlässe auf Rechnungsebene.
sum_charges DECIMAL OUT BT-108

Gesamtsumme aller Zuschläge auf Rechnungsebene.
sum_items_net DECIMAL OUT BT-106

Gesamtsumme der Nettoeinzelbeträge aller Rechnungspositionen.
tax_details LIST OUT

Aufschlüsselung der Umsatzsteuer.
- exemption_code REFERENCE OUT BT-121
  
  Kodierte Angabe des Grunds für die Ausnahme von der Umsatzsteuer. Es ist die Liste VATEX zu verwenden.
- exemption_text STRING OUT BT-120
  
  Grund für die Ausnahme von der Umsatzsteuer in Textform.
- net_amount DECIMAL OUT BT-116
  
  Summe der Nettoeinzelbeträge der jeweiligen Umsatzsteuerkategorie.
- tax_amount DECIMAL OUT BT-117
  
  Betrag der Umsatzsteuer für die Umsatzsteuerkategorie.
- tax_category REFERENCE OUT BT-118
  
  Kodierte Angabe der Umsatzsteuerkategorie. Es ist die Liste UNTDID 5305 zu verwenden.
- tax_rate PERCENTAGE OUT BT-119
  
  Höhe des Umsatzsteuersatzes für die Umsatzsteuerkategorie.
third_claims LIST OUT

Informationen über Fremdforderungen. Wird ausschließlich in UBL-Syntax unterstützt.
- amount DECIMAL OUT BT-DEX-002
  
  Betrag der Fremdforderung (Bruttobetrag).
- currency REFERENCE OUT BT-DEX-002
  
  Währungskennzeichen für Rechnungsbeträge. Es ist die Liste ISO 4217 zu verwenden.
- description TEXT OUT BT-DEX-003
  
  Eindeutige Beschreibung der Fremdforderung.
- type STRING OUT BT-DEX-001
  
  Art der Fremdforderung.
total_discount PERCENTAGE OUT IN

Auf den Rechnungsbetrag anzuwendender Rabatt.
total_gross DECIMAL OUT IN BT-112

Gesamtbetrag der Rechnung mit Umsatzsteuer (Bruttobetrag).
total_net DECIMAL OUT IN BT-109

Gesamtbetrag der Rechnung ohne Umsatzsteuer (Nettobetrag).
total_rounding DECIMAL OUT IN BT-114

Betrag, um den der Rechnungsbetrag gerundet wurde (Rundungskorrektur).
total_tax DECIMAL OUT IN BT-110

Gesamtbetrag der Umsatzsteuer in Rechnungswährung.

attachments LIST OUT IN

Liste von rechnungsbegründenden Anlagen.

identifier STRING OUT IN BT-122

Eindeutige Kennung für die Rechnungsanlage.
type_code REFERENCE OUT BT-122

Kodierter Typ der Anlage. Entspricht in der Regel dem Wert "916".
filename STRING OUT IN BT-125

Ursprünglicher Name der eingebetteten Datei.
filesize INT OUT IN

Größe der eingebetteten Datei in Bytes.

mimetype ENUM OUT IN BT-125

Kennzeichnung des Dateityps (MIME-Type). Es ist ein Wert aus folgender Liste zu verwenden:

`application/pdf`	Datei im PDF-Format
`image/png`	Bilddatei im PNG-Format
`image/jpeg`	Bilddatei im JPEG-Format
`text/csv`	Tabellendaten im CSV-Format
`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`	Tabellenkalkulation (z.B. Excel)
`application/vnd.oasis.opendocument.spreadsheet`	Textdokumente (z.B. Word)

content BASE64 OUT IN BT-125

Eingebettetes Dokument als Base64-kodierte Zeichenkette.
location STRING OUT IN BT-124

URL der externen Quelle des Dokuments.
description TEXT OUT IN BT-123

Beschreibung der Rechnungsanlage.

{
    "seller_address": {
        "brand": "Schlieper Group",
        "name": "Schlieper Group Verwaltungs GmbH",
        "line_one": "Silksteinweg 41",
        "line_two": "Geb\u00e4ude B, Etage 3",
        "line_three": "Frau Brodde",
        "zipcode": "53426",
        "city": "K\u00f6nigsfeld",
        "district": "Rheinland-Pfalz",
        "country": "DE",
        "contact_person": "Adalbert Schlieper",
        "contact_department": null,
        "contact_phone": "+494066969300",
        "contact_email": "kontakt@example.com",
        "vat_number": "DE999999999",
        "tax_number": "30\/123\/45678",
        "legal_number": "HRB 12345 B",
        "legal_scheme": null,
        "legal_information": "Kein Ausweis von Umsatzsteuer, da Kleinunternehmer gemäß § 19 UStG",
        "identifier": [
            {
                "ident_number": "999999999",
                "ident_scheme": "0060"
            }
        ],
        "electronic_address": "991-1234512345-06",
        "electronic_scheme": "0204"
        "creditor_number": "L10010"
    },
    "buyer_address": {
        "debtor_number": "K10081",
        "brand": "Schultheiss Marketing",
        "name": "Schultheiss Marketing OHG",
        "line_one": "Holunderweg 6",
        "line_two": "Aufgang C, 4. OG",
        "line_three": "Buchhaltung",
        "zipcode": "73460",
        "city": "H\u00fcttlingen",
        "district": "Baden-W\u00fcrttemberg",
        "country": "DE",
        "contact_person": "Frau Annkristin Schultheiss",
        "contact_department": null,
        "contact_phone": "+493023125000",
        "contact_email": "hello@example.com",
        "vat_number": "DE123456789",
        "legal_number": "HRA 1234\/100",
        "legal_scheme": null
        "identifier": [
            {
                "ident_number": "5412345000013",
                "ident_scheme": "0088"
            }
        ],
        "electronic_address": "991-1234512345-06",
        "electronic_scheme": "0204",
    },
    "delivery_address": {
        "name": "Puch Holding GmbH",
        "ident_number": "999999999",
        "ident_scheme": "0060",
        "line_one": "Fechenbachstr. 15",
        "line_two": "Innenstadt",
        "line_three": null,
        "zipcode": "33332",
        "city": "G\u00fctersloh",
        "district": "Nordrhein-Westfalen",
        "country": "DE",
        "custom_data": "yes"
    },
    "tax_representative": {
        "name": "Selma S Mathiasen",
        "line_one": "Strandvej 71",
        "line_two": null,
        "line_three": null,
        "zipcode": "1266",
        "city": "København",
        "district": null,
        "country": "DK",
        "vat_number": "DK87654321",
        "custom_data": "yes"
    },
    "invoice_meta": {
        "business_process": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
        "buyer_reference": "991-1234512345-06",
        "contract_reference": "VERT-98765-100",
        "delivery_date": "2026-07-01",
        "despatch_reference": "LS-2026-00412",
        "exemption_code": "NONE",
        "invoice_currency": "EUR",
        "invoice_date": "2026-07-01",
        "invoice_number": "R201120",
        "invoice_type": "380",
        "invoiced_object_id": "871234531000222200",
        "invoiced_object_scheme": null,
        "notes": [
            {
                "subject_code": "AAI",
                "content": "Wir danken f\u00fcr den Auftrag und freuen uns auf die weitere Zusammenarbeit"
            }
        ],
        "preceding": [
            {
                "invoice_date": "2026-04-01",
                "invoice_number": "R150033"
            }
        ],
        "project_name": "Implementation ERP-System",
        "project_reference": "PROJ-2026-A99",
        "purchase_reference": "PO-4500123456",
        "receiving_reference": "WE-2026-00278",
        "sales_date": "2026-04-15",
        "sales_reference": "AUF-2026-7890",
        "service_from": "2026-05-01",
        "service_to": "2026-07-31",
        "shipping_terms": "Anlieferung frei Haus",
        "shipping_type": "Spedition",
        "tax_country": "DE",
        "tax_currency": "DKK",
        "tax_date_code": null,
        "tax_date_point": "2026-05-07",
        "tender_reference": "LOS-04-COMPLIANCE",
        "xml_specification": "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0"
    },
    "invoice_items": [
        {
            "additions": [
                {
                    "addition_net": 74.38,
                    "base_amount": 1487.5,
                    "percentage": 5,
                    "reason_code": "95",
                    "reason_text": "Rabatt",
                    "type": "allowance"
                }
            ],
            "attributes": [
                {
                    "name": "SLA Reaktionszeit",
                    "value": "innerhalb 24h Vor-Ort"
                }
            ],
            "buyer_accounting": "ACC.21778",
            "buyer_reference": "ITM-190.002.320",
            "children": [],
            "classification": [
                {
                    "classification_id": "43211503"
                    "classification_scheme": "UNS",
                    "classification_version": "26.0"
                }
            ],
            "date_from": "2026-05-01",
            "date_to": "2026-05-08",
            "description": "Analyse und Behebung von Systemfehlern",
            "ident_number": "4012345678901",
            "ident_scheme": "0160",
            "item_discount": 5,
            "item_measure": "HUR",
            "item_net": 1413.12,
            "item_number": "1003",
            "item_quantity": 17.5,
            "name": "Dienstleistung IT-Support Level 2",
            "note": "Hauptposition der Serviceleistung",
            "object_id": "INC-2026-89412",
            "object_scheme": "CBA",
            "origin_country": "DK",
            "position": "1",
            "purchase_reference": "PO-4500123456.1",
            "tax_category": "S",
            "tax_code": "STD-NORMAL",
            "tax_rate": 19,
            "unit_discount": 10,
            "unit_gross": 95,
            "unit_measure": "MIN",
            "unit_net": 85,
            "unit_quantity": 60
        }
    ],
    "payment_data": {
        "additions": [
            {
                "addition_net": 141.31,
                "base_amount": 1413.12,
                "percentage": 10,
                "reason_code": "95",
                "reason_text": "Rabatt",
                "tax_category": "S",
                "tax_rate": 19,
                "type": "allowance"
            }
        ],
        "bank_creditor": "DE98ZZZ09999999999",
        "bank_mandate": "VERT-2026-12345",
        "buyer_accounting": "Kostenstelle 100230\/Projekt EU-Rechnung",
        "due_amount": 713.48,
        "due_date": "2026-07-15",
        "due_discounts": [
            {
                "base_amount": 0,
                "discount_amount": 0,
                "due_date": "2026-07-04",
                "due_days": 3,
                "due_discount": 2.5,
                "custom_amount": "yes"
            }
        ],
        "foreign_tax": 241.64,
        "paid_amount": 800,
        "payee_creditor": null,
        "payee_ident_number": "999999999",
        "payee_ident_scheme": "0060",
        "payee_legal_number": "HRB 185/2300",
        "payee_legal_scheme": null,
        "payee_name": "Schlieper Financial",
        "payment_accounts": [
            {
                "account_id": "DE02370502990000684712",
                "bank_code": "COKSDE33",
                "name": "Schultheiss Marketing"
            }
        ],
        "payment_method": "SEPA Lastschrift/Bankeinzug",
        "payment_purpose": "R001120 - K10081",
        "payment_terms": "Sofern nicht anders angegeben, entspricht das Liefer-\/Leistungsdatum dem Rechnungsdatum.\r\nDer Rechnungsbetrag wird innerhalb von 14 Tagen vom angegebenen Konto eingezogen.",
        "payment_type": "59",
        "sum_allowances": 141.31,
        "sum_charges": 0,
        "sum_items_net": 1413.12,
        "tax_details": [
            {
                "exemption_code": null,
                "exemption_text": null,
                "net_amount": 1271.81,
                "tax_amount": 241.64,
                "tax_category": "S",
                "tax_rate": 19
            }
        ],
        "third_claims": [
            {
                "amount": 10.8,
                "currency": "EUR",
                "description": "Inkassogeb\u00fchr f\u00fcr Drittanbieter-Leistung",
                "type": "Geb\u00fchren"
            }
        ],
        "total_discount": 10,
        "total_gross": 1513.45,
        "total_net": 1271.81,
        "total_rounding": 0.03,
        "total_tax": 241.64
    },
    "attachments": [
        {
            "identifier": "Stundennachweis",
            "type_code": "916",
            "filename": null,
            "filesize": 0,
            "mimetype": null,
            "content": null,
            "location": "https:\/\/www.example.com\/",
            "description": "Den Stundennachweis finden Sie unter dem angegeben Link."
        }
    ]
}

3.2. Konformitätsprüfung

Alle durch EU-Rechnung verarbeiteten E-Rechnungen durchlaufen grundsätzlich eine Konformitätsprüfung. Insbesondere für ZUGFeRD setzen wir dazu mehrere Prüfverfahren ein und kombinieren die Ergebnisse zu einem Gesamtergebnis. Die Rohdaten einer solchen Prüfungen können daher sehr umfangreich werden. Aus diesem Grund ist die Konformitätsprüfung an dieser Stelle dokumentiert. Insofern ein Endpunkt eine Konformitätsprüfung bereitstellt, wird auf diese Dokumentation verwiesen.

Bitte beachten Sie: Bei XML-Rechnungen kommt in der Regel nur ein Validator zum Einsatz. Hybride PDF-Rechnungen hingegen werden mit mehreren Validatoren überprüft und deren Ergebnisse für die Beurteilung der Konformität kombiniert.

meta OBJECT OUT

Allgemeine Informationen zur Konformitätsprüfung.
- version STRING OUT
  
  Versionsnummer von EU-Rechnung zum Zeitpunkt der Prüfung.
- reference UUID OUT
  
  Eindeutige Kennung der Rechnung in unserem System.
- timestamp TIMESTAMP OUT
  
  Prüfzeitpunkt der Konformitätsprüfung.
- validator STRING OUT
  
  Softwarekennung unseres Validators.

invoice OBJECT OUT

Zusammenfassendes Prüfergebnis und Rechnungsdetails.

auditStatus ENUM OUT

Gesamtergebnis der Konformitätsprüfung. Entspricht einem der folgenden Werte:

`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.

auditType STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.

xmlSyntax ENUM OUT

Angabe der Syntax der XML-Rechnung. Entspricht einem der folgenden Werte:

`CI Invoice`	CII-Syntax gemäß UN/CEFACT XML Cross Industry Invoice D16B.
`UBL Invoice`	UBL Invoice-Syntax gemäß ISO/IEC 19845 (UBL 2.1).
`UBL CreditNote`	UBL CreditNote-Syntax gemäß ISO/IEC 19845 (UBL 2.1).
`ZUGFeRD 1`	Es handelt sich um ein veraltetes ZUGFeRD 1-Dokument.

invoiceNumber STRING OUT

Eindeutige Kennung der Rechnung (Rechnungsnummer).
invoiceDate DATE OUT

Ausstellungsdatum der Rechnung.
invoiceTotal DECIMAL OUT

Gesamtbetrag der Rechnung mit Umsatzsteuer (Bruttobetrag).
invoiceCurrency REFERENCE OUT

Währungskennzeichen für Rechnungsbeträge. Es ist die Liste ISO 4217 zu verwenden.
dueDate DATE OUT

Fälligkeitsdatum des Rechnungsbetrags.
dueAmount DECIMAL OUT

Ausstehender Betrag, der vom Käufer zu zahlen ist.
partnerName STRING OUT

Name des Rechnungsstellers oder -empfängers.
partnerZipcode STRING OUT

Postleitzahl des Rechnungsstellers oder -empfängers.
partnerCity STRING OUT

Stadt des Rechnungsstellers oder -empfängers.
partnerCountry REFERENCE OUT

Land, in dem sich der Rechnungssteller oder -empfänger befindet. Es ist die Liste ISO 3166-1 zu verwenden.

attachments ENUM OUT

Gibt an, in welchem Rechnungsdokument ein Rechnungsanhang gefunden wurde. Entspricht einem der folgenden Werte:

`none`	Es wurden keine Anlagen zur Rechnung gefunden.
`xml`	Das XML-Dokument enthält weitere Anlagen zur Rechnung.
`pdf`	Das PDF-Dokument enthält weitere Anlagen zur Rechnung.
`both`	Sowohl im XML- als auch PDF-Anteil wurden Anlagen gefunden.

scope ENUM OUT

Gibt an, ob die Rechnung als Eingangs- oder Ausgangsrechnung erkannt werden konnte. Entspricht einem der folgenden Werte:

`buyer`	Die angegebenen Adressdaten beziehen sich auf den Käufer.
`seller`	Die angegebenen Adressdaten beziehen sich auf den Verkäufer.

result OBJECT OUT

Detaillierte Ergebnisse der einzelnen Validatoren.

mustang OBJECT OUT

Ergebnis der Prüfung hybrider E-Rechnungsdokumente.

meta OBJECT OUT

Allgemeine Informationen zum Prüfvorgang.

reference UUID OUT

Eindeutige Kennung der Rechnung in unserem System.
timestamp TIMESTAMP OUT

Prüfzeitpunkt der Konformitätsprüfung.
validator STRING OUT

Softwarekennung des verwendeten Validators.
pdfSignature STRING OUT

Informationen zu einer vorhandenen PDF-Signatur.
zugferdVersion STRING OUT

Erkannte Version der ZUGFeRD-Spezifikation.
zugferdProfile STRING OUT

Erkanntes Profil der ZUGFeRD-Rechnung.
xmlSpecification STRING OUT

Erkannte Spezifikation des eingebetteten XML-Dokuments (BT-24).
xmlFilename STRING OUT

Dateiname des eingebetteten XML-Dokuments.
documentType STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.
documentVersion STRING OUT

Angabe, mit welcher ZUGFeRD-Spezifikation der erkannte Dokumenttyp kompatibel ist.
maximumCompliance STRING OUT

Angabe der ZUGFeRD-Version, mit welcher die E-Rechnung höchstens kompatibel ist.
requiredCompliance STRING OUT

Mindestens erforderliche ZUGFeRD-Version für Konformität.

validityStatus ENUM OUT

Gibt an, ob der erkannte E-Rechnungsstandard noch gültig ist. Entspricht einem der folgenden Werte:

`active`	Es handelt sich um einen aktuell gültigen E-Rechnungsstandard.
`deprecated`	Der erkannte Standard ist abgekündigt und sollte nicht mehr verwendet werden.
`obsolete`	Es handelt sich um einen veralteten, nicht mehr rechtsgültigen E-Rechnungsstandard.

file OBJECT OUT

Prüfergebnis auf Dateiebene.

isValid ENUM OUT

Angabe, ob die Teilprüfung durch den Validator bestanden wurde. Entspricht einem der folgenden Werte:

`true`	Teilprüfung für Konformität wurde bestanden.
`false`	Es sind Fehler aufgetreten, das Dokument ist nicht konform.

messages LIST OUT

Hinweise und Fehlermeldungen zur Rechnung. Es handelt sich hierbei um Rohdaten des Validators.
cntHardError INT OUT

Anzahl kritischer Fehler dieser Teilprüfung (führen zur Nicht-Konformität).
cntSoftError INT OUT

Schwerwiegende Fehler der Rechnung, die trotzdem noch toleriert werden.
cntWarning INT OUT

Anzahl Fehler und Warnungen zur Rechnung (beeinträchtigen nicht die Konformität).
cntInformation INT OUT

Hinweise und leichte Fehler zur Rechnung (beeinträchtigen nicht die Konformität).

pdf OBJECT OUT

Prüfergebnis des PDF-Anteils.

isValid ENUM OUT

Angabe, ob die Teilprüfung durch den Validator bestanden wurde. Entspricht einem der folgenden Werte:

`true`	Teilprüfung für Konformität wurde bestanden.
`false`	Es sind Fehler aufgetreten, das Dokument ist nicht konform.

messages LIST OUT

Hinweise und Fehlermeldungen zur Rechnung. Es handelt sich hierbei um Rohdaten des Validators.
cntHardError INT OUT

Anzahl kritischer Fehler dieser Teilprüfung (führen zur Nicht-Konformität).
cntSoftError INT OUT

Schwerwiegende Fehler der Rechnung, die trotzdem noch toleriert werden.
cntWarning INT OUT

Anzahl Fehler und Warnungen zur Rechnung (beeinträchtigen nicht die Konformität).
cntInformation INT OUT

Hinweise und leichte Fehler zur Rechnung (beeinträchtigen nicht die Konformität).

xml OBJECT OUT

Prüfergebnis des XML-Anteils.

isValid ENUM OUT

Angabe, ob die Teilprüfung durch den Validator bestanden wurde. Entspricht einem der folgenden Werte:

`true`	Teilprüfung für Konformität wurde bestanden.
`false`	Es sind Fehler aufgetreten, das Dokument ist nicht konform.

messages LIST OUT

Hinweise und Fehlermeldungen zur Rechnung. Es handelt sich hierbei um Rohdaten des Validators.
cntHardError INT OUT

Anzahl kritischer Fehler dieser Teilprüfung (führen zur Nicht-Konformität).
cntSoftError INT OUT

Schwerwiegende Fehler der Rechnung, die trotzdem noch toleriert werden.
cntWarning INT OUT

Anzahl Fehler und Warnungen zur Rechnung (beeinträchtigen nicht die Konformität).
cntInformation INT OUT

Hinweise und leichte Fehler zur Rechnung (beeinträchtigen nicht die Konformität).

verapdf OBJECT OUT

Ergebnis der Prüfung der PDF/A-Konformität.

meta OBJECT OUT

Allgemeine Informationen zum Prüfvorgang.

reference UUID OUT

Eindeutige Kennung der Rechnung in unserem System.
timestamp TIMESTAMP OUT

Prüfzeitpunkt der Konformitätsprüfung.
validator STRING OUT

Softwarekennung des verwendeten Validators.

xmpPackage ENUM OUT

Angabe, ob XMP Paketdaten in den Kopfdaten gefunden wurden. Entspricht einem der folgenden Werte:

`true`	Es wurden XMP Paketinformationen im PDF gefunden.
`false`	Die PDF-Datei enthält keine XPM Metadaten.

xmpProfile ENUM OUT

Angabe, ob XMP Profildaten in den Kopfdaten gefunden wurden. Entspricht einem der folgenden Werte:

`true`	Es wurde eine Angabe zum PDF Profil in den Metadaten gefunden.
`false`	Die Metadaten enthalten keine Informationen zum PDF-Profil.

pdfProfile STRING OUT

Erkanntes PDF-Profil des Dokuments.
maximumCompliance STRING OUT

Angabe der PDF-Version, mit welcher das Dokument höchstens kompatibel ist.
requiredCompliance STRING OUT

Mindestens erforderliche PDF-Version für Konformität.

pdf OBJECT OUT

Prüfergebnis des PDF-Anteils.

isValid ENUM OUT

Angabe, ob die Teilprüfung durch den Validator bestanden wurde. Entspricht einem der folgenden Werte:

`true`	Teilprüfung für Konformität wurde bestanden.
`false`	Es sind Fehler aufgetreten, das Dokument ist nicht konform.

messages LIST OUT

Hinweise und Fehlermeldungen zur Datei. Es handelt sich hierbei um Rohdaten des Validators.
cntHardError INT OUT

Anzahl kritischer Fehler dieser Teilprüfung (führen zur Nicht-Konformität).
cntSoftError INT OUT

Schwerwiegende Fehler der Datei, die trotzdem noch toleriert werden.
cntWarning INT OUT

Anzahl Fehler und Warnungen zur Datei (beeinträchtigen nicht die Konformität).
cntInformation INT OUT

Hinweise und leichte Fehler zur Datei (beeinträchtigen nicht die Konformität).

kosit OBJECT OUT

Ergebnis der Prüfung von XML-Dokumenten.

meta OBJECT OUT

Allgemeine Informationen zum Prüfvorgang.

reference UUID OUT

Eindeutige Kennung der Rechnung in unserem System.
timestamp TIMESTAMP OUT

Prüfzeitpunkt der Konformitätsprüfung.
validator STRING OUT

Softwarekennung des verwendeten Validators.
xmlSpecification STRING OUT

Erkannte Spezifikation des eingebetteten XML-Dokuments (BT-24).
xmlDefinition STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.
xmlStandard STRING OUT

Erkannter (nationaler) EN 16931-Standard der XML-Datei.
xmlVersion STRING OUT

Erkannte Hauptversion des verwendeten EN 16931-Standards.
xmlVariant STRING OUT

Variante des EN 16931-Standards. Entspricht im Regelfall "CIUS".
documentType STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.
documentVersion STRING OUT

Angabe, mit welchem XML-Standard der erkannte Dokumenttyp kompatibel ist.
maximumCompliance STRING OUT

Angabe der XML-Spezifikation, mit welcher die E-Rechnung höchstens kompatibel ist.
requiredCompliance STRING OUT

Mindestens erforderliche Version des Standards für Konformität.

validityStatus ENUM OUT

Gibt an, ob der erkannte E-Rechnungsstandard noch gültig ist. Entspricht einem der folgenden Werte:

`active`	Es handelt sich um einen aktuell gültigen E-Rechnungsstandard.
`deprecated`	Der erkannte Standard ist abgekündigt und sollte nicht mehr verwendet werden.
`obsolete`	Es handelt sich um einen veralteten, nicht mehr rechtsgültigen E-Rechnungsstandard.

xml OBJECT OUT

Prüfergebnis des XML-Anteils.

stages LIST OUT

Ergebnisse der einzelnen Teilprüfschritte des Validators.

reference STRING OUT

Eindeutige Bezeichnung des Prüfschritts.
source STRING OUT

Informationen über die Art der durchgeführten Prüfung.

isValid ENUM OUT

Angabe, ob die Teilprüfung durch den Validator bestanden wurde. Entspricht einem der folgenden Werte:

`true`	Teilprüfung für Konformität wurde bestanden.
`false`	Es sind Fehler aufgetreten, das Dokument ist nicht konform.

cntHardError INT OUT

Anzahl kritischer Fehler dieser Teilprüfung (führen zur Nicht-Konformität).
cntSoftError INT OUT

Schwerwiegende Fehler der Rechnung, die trotzdem noch toleriert werden.
cntWarning INT OUT

Anzahl Fehler und Warnungen zur Rechnung (beeinträchtigen nicht die Konformität).
cntInformation INT OUT

Hinweise und leichte Fehler zur Rechnung (beeinträchtigen nicht die Konformität).

messages LIST OUT

Hinweise und Fehlermeldungen zur Rechnung. Es handelt sich hierbei um Rohdaten des Validators.

summary OBJECT OUT

Zusammenfassung der Prüfergebnisse der einzelnen Validatoren.

mustang OBJECT OUT

Ergebnis der Prüfung hybrider E-Rechnungsdokumente.

compliance ENUM OUT

Gibt an, ob die Prüfung bestanden wurde. Entspricht einem der folgenden Werte:

`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.

processable ENUM OUT

Hinweis, ob die Rechnung weiterverarbeitet werden kann. Entspricht einem der folgenden Werte:

`true`	Die Rechnung kann weiterverarbeitet werden.
`false`	Die Rechnung sollte zurückgewiesen werden.

verapdf OBJECT OUT

Ergebnis der Prüfung der PDF/A-Konformität.

compliance ENUM OUT

Gibt an, ob die Prüfung bestanden wurde. Entspricht einem der folgenden Werte:

`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.

processable ENUM OUT

Hinweis, ob die Rechnung weiterverarbeitet werden kann. Entspricht einem der folgenden Werte:

`true`	Die Rechnung kann weiterverarbeitet werden.
`false`	Die Rechnung sollte zurückgewiesen werden.

kosit OBJECT OUT

Ergebnis der Prüfung von XML-Dokumenten.

compliance ENUM OUT

Gibt an, ob die Prüfung bestanden wurde. Entspricht einem der folgenden Werte:

`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.

processable ENUM OUT

Hinweis, ob die Rechnung weiterverarbeitet werden kann. Entspricht einem der folgenden Werte:

`true`	Die Rechnung kann weiterverarbeitet werden.
`false`	Die Rechnung sollte zurückgewiesen werden.

{
    "meta": {
        "version": 2.6,
        "reference": "b6495a5d-91ff-4dfe-84c7-fe6f934fae18",
        "timestamp": "2026-07-02 05:10:28",
        "validator": "EU-Rechnung v2.60"
    },
    "invoice": {
        "auditStatus": "error",
        "auditType": "ZUGFeRD 2 (EN16931)",
        "xmlSyntax": "CI Invoice",
        "invoiceNumber": "R201120",
        "invoiceDate": "2026-07-01",
        "invoiceTotal": 713.48,
        "invoiceCurrency": "EUR",
        "dueDate": "2026-07-15",
        "dueAmount": 713.48,
        "partnerName": "Schlieper Group Verwaltungs GmbH",
        "partnerZipcode": "53426",
        "partnerCity": "K\u00f6nigsfeld",
        "partnerCountry": "DE",
        "attachments": "pdf",
        "scope": "seller"
    },
    "result": {
        "mustang": {
            "meta": {
                "reference": "b6495a5d-91ff-4dfe-84c7-fe6f934fae18",
                "timestamp": "2026-07-02 05:10:28",
                "validator": "ZUGFeRD Mustang Project 2.24.0",
                "pdfSignature": "unknown",
                "zugferdVersion": "2.5",
                "zugferdProfile": "XRECHNUNG",
                "xmlSpecification": "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0",
                "xmlFilename": "xrechnung.xml",
                "documentType": "ZUGFeRD 2 (XRECHNUNG)",
                "documentVersion": "ZUGFeRD 2.5 (XRECHNUNG)",
                "maximumCompliance": "ZUGFeRD 2.5.0",
                "requiredCompliance": "ZUGFeRD 2.5.0",
                "validityStatus": "active"
            },
            "file": {
                "isValid": false,
                "messages": [],
                "cntHardError": 0,
                "cntSoftError": 0,
                "cntWarning": 0,
                "cntInformation": 0
            },
            "pdf": {
                "isValid": false,
                "messages": [
                    {
                        "severity": "error",
                        "code": 15,
                        "text": "XMP Metadata: Version not found"
                    },
                    {
                        "severity": "error",
                        "code": 16,
                        "text": "XMP Metadata: Version contains invalid value"
                    },
                    (...)
                ],
                "cntHardError": 8,
                "cntSoftError": 0,
                "cntWarning": 0,
                "cntInformation": 1
            },
            "xml": {
                "rulesTotal": 22,
                "rulesFailed": 10,
                "isValid": false,
                "messages": [
                    {
                        "severity": "information",
                        "code": 27,
                        "location": "\/rsm:CrossIndustryInvoice\/rsm:ExchangedDocumentContext[1]",
                        "criteria": "ram:BusinessProcessSpecifiedDocumentContextParameter\/ram:ID",
                        "text": "Business process MUST be provided. [ID PEPPOL-EN16931-R001] from \/xslt\/XR_30\/XRechnung-CII-validation.xslt)"
                    },
                    (...)
                ],
                "cntHardError": 3,
                "cntSoftError": 0,
                "cntWarning": 1,
                "cntInformation": 7
            }
        },
        "verapdf": {
            "meta": {
                "reference": "b6495a5d-91ff-4dfe-84c7-fe6f934fae18",
                "timestamp": "2026-07-02 05:10:28",
                "validator": "veraPDF 1.28.2",
                "xmpPackage": true,
                "xmpProfile": true,
                "pdfProfile": "PDF\/A-3B",
                "maximumCompliance": "PDF\/A-3",
                "requiredCompliance": "PDF\/A-3"
            },
            "pdf": {
                "isValid": true,
                "messages": [],
                "cntHardError": 0,
                "cntSoftError": 0,
                "cntWarning": 0,
                "cntInformation": 0
            }
        },
        "kosit": {
            "meta": {
                "reference": "b6495a5d-91ff-4dfe-84c7-fe6f934fae18",
                "timestamp": "2026-07-02 05:10:29",
                "validator": "KoSIT Validator 1.6.2",
                "xmlSpecification": "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0",
                "xmlDefinition": "EN16931 XRechnung (CII)",
                "xmlStandard": "EN16931 XRechnung",
                "xmlVersion": "3.0",
                "xmlVariant": "CIUS",
                "documentType": "EN16931 XRechnung (CII)",
                "documentVersion": "XRechnung 3.0 (CIUS)",
                "maximumCompliance": "XRechnung 3.0.2",
                "requiredCompliance": "XRechnung 3.0.2",
                "validityStatus": "active"
            },
            "xml": {
                "stages": [
                    {
                        "reference": "val-xsd",
                        "source": "XML Schema for UN\/CEFACT XML (SCRDM - CII uncoupled)",
                        "isValid": true,
                        "cntHardError": 0,
                        "cntSoftError": 0,
                        "cntWarning": 0,
                        "cntInformation": 0
                    },
                    {
                        "reference": "val-sch.1",
                        "source": "Schematron rules for EN16931 (CII)",
                        "isValid": false,
                        "cntHardError": 4,
                        "cntSoftError": 0,
                        "cntWarning": 0,
                        "cntInformation": 0
                    },
                    {
                        "reference": "val-sch.2",
                        "source": "Schematron rules for CIUS XRechnung (CII)",
                        "isValid": true,
                        "cntHardError": 0,
                        "cntSoftError": 0,
                        "cntWarning": 0,
                        "cntInformation": 0
                    },
                    {
                        "reference": "val-xml",
                        "source": null,
                        "isValid": true,
                        "cntHardError": 0,
                        "cntSoftError": 0,
                        "cntWarning": 0,
                        "cntInformation": 0
                    }
                ],
                "messages": [
                    {
                        "reference": "val-sch.1.4",
                        "stage": "val-sch.1",
                        "severity": "error",
                        "location": "\/Q{urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100}CrossIndustryInvoice[1]\/Q{urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100}ExchangedDocument[1]\/Q{urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100}IssueDateTime[1]\/Q{urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100}DateTimeString[1]",
                        "code": "CII-DT-097",
                        "text": "[CII-DT-097] - Date time string with format attribute 102 shall be YYYYMMDD."
                    },
                    (...)
                ]
            }
        }
    },
    "summary": {
        "mustang": {
            "compliance": "error",
            "processable": false
        },
        "verapdf": {
            "compliance": "success",
            "processable": true
        },
        "kosit": {
            "compliance": "error",
            "processable": false
        }
    }
}

4. Verfügbare Endpunkte

4.1. Rechnungsausgang

GET https://api.eu-rechnung.de/v1/outgoing

URL Abfrageparameter

offset INT IN

Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
limit INT IN

Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.

Datenschema

items LIST OUT

Rechnungen im Bereich Rechnungsausgang, die der Suchanfrage entsprechen.

uuid UUID OUT

Eindeutige Kennung der Rechnung in unserem System.
invoice_number STRING OUT

Eindeutige Kennung der Rechnung (Rechnungsnummer).
invoice_date DATE OUT

Ausstellungsdatum der Rechnung.
invoice_total DECIMAL OUT

Gesamtbetrag der Rechnung mit Umsatzsteuer (Bruttobetrag).
invoice_currency REFERENCE OUT

Währungskennzeichen für Rechnungsbeträge. Es ist die Liste ISO 4217 zu verwenden.
due_date DATE OUT

Fälligkeitsdatum des Rechnungsbetrags.
due_amount DECIMAL OUT

Ausstehender Betrag, der vom Käufer zu zahlen ist.
partner_name STRING OUT

Name des Rechnungsempfängers.
partner_zipcode STRING OUT

Postleitzahl des Rechnungsempfängers.
partner_city STRING OUT

Stadt des Rechnungsempfängers.
partner_country REFERENCE OUT

Land, in dem sich der Rechnungsempfänger befindet. Es ist die Liste ISO 3166-1 zu verwenden.

attachments ENUM OUT

Gibt an, in welchem Rechnungsdokument ein Rechnungsanhang gefunden wurde. Entspricht einem der folgenden Werte:

`none`	Es wurden keine Anlagen zur Rechnung gefunden.
`xml`	Das XML-Dokument enthält weitere Anlagen zur Rechnung.
`pdf`	Das PDF-Dokument enthält weitere Anlagen zur Rechnung.
`both`	Sowohl im XML- als auch PDF-Anteil wurden Anlagen gefunden.

data_status ENUM OUT

Bearbeitungszustand einer nicht abgeschlossenen Rechnung. Entspricht einem der folgenden Werte:

`pending`	Die Rechnung befindet sich in einer Vorprüfung und kann noch nicht bearbeitet werden.
`complete`	Alle mindestens erforderlichen Angaben zur Erstellung der E-Rechnung sind vorhanden.
`incomplete`	Die Angaben sind fehlerhaft oder es wurden nicht alle Pflichtangaben ausgefüllt.
`check`	Alle Pflichtangaben sind vorhanden, die Rechnung sollte dennoch auf Vollständigkeit geprüft werden.

audit_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Konformitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.
`fatal`	Es ist ein Systemfehler aufgetreten.

audit_type STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.

payment_status ENUM OUT

Gibt an, ob die Rechnung als bezahlt markiert wurde. Entspricht einem der folgenden Werte:

`unpaid`	Es sind noch keine Zahlungsausgänge zur Rechnung hinterlegt.
`partial`	Es sind Teilzahlungen hinterlegt und ein Restbetrag ist offen.
`paid`	Die Rechnung wurde als vollständig bezahlt markiert.

supported_flavors LIST OUT

Verfügbare Rechnungsformate für die Erstellung der finalen E-Rechnung.
Derzeit werden folgende Formate unterstützt, die konkrete Auswahl hängt vom Einzelfall ab:

`EN16931-CII`	XML-Rechnung im Standard EN 16931 und der CII-Syntax.
`XRECHNUNG-CII`	XML-Rechnung im Standard XRechnung und der CII-Syntax.
`PEPPOLBIS-UBL-CN`	XML-Gutschrift im Standard Peppol Billing BIS mit UBL-Syntax.
`PEPPOLBIS-UBL-INV`	XML-Rechnung im Standard Peppol Billing BIS mit UBL-Syntax.
`ZUGFERD-EN16931-CII`	PDF-Rechnung im Standard ZUGFeRD mit dem Profil EN16931.
`ZUGFERD-XRECHNUNG-CII`	PDF-Rechnung im Standard ZUGFeRD mit dem Profil XRECHNUNG.

export_flavor ENUM OUT

Rechnungsformat der finalen E-Rechnung. Entspricht einem der Werte aus dem Feld supported_flavors.
finalized_date TIMESTAMP OUT

Zeitpunkt, an dem die E-Rechnung final erstellt wurde. Sie ist gemäß GoBD nicht mehr veränderbar.
exchanged_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung elektronisch an den Empfänger verschickt wurde.
archived_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung ins Rechnungsarchiv verschoben wurde.
voided_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung auf dokumentierte Weise (GoBD-konform) gelöscht wurde.
debtor UUID OUT

Verknüpfung der Rechnung zu einem Debitor aus der Kundenverwaltung.

pagination OBJECT OUT

Metadaten zur aktuellen Suchanfrage.
- offset INT OUT
  
  Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
- limit INT OUT
  
  Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.
- count INT OUT
  
  Tatsächliche Anzahl der Datensätze in der aktuellen Antwort.
- total INT OUT
  
  Gesamtzahl aller verfügbaren Datensätze über alle Seiten hinweg.

Antwort (HTTP 200 )

{
    "items": [
        {
            "uuid": "089c6fd1-919d-4497-ac20-05c1c0ff6d42",
            "invoice_number": "R201120",
            "invoice_date": "2026-07-01",
            "invoice_total": 1513.45,
            "invoice_currency": "EUR",
            "due_date": "2026-07-15",
            "due_amount": 713.48,
            "partner_name": "Schlieper Group Verwaltungs GmbH",
            "partner_zipcode": "53426",
            "partner_city": "K\u00f6nigsfeld",
            "partner_country": "DE",
            "attachments": "both",
            "data_status": "complete",
            "audit_status": "success",
            "audit_type": "ZUGFeRD 2 (XRECHNUNG)",
            "payment_status": "paid",
            "supported_flavors": [
                "ZUGFERD-XRECHNUNG-CII"
            ],
            "export_flavor": "ZUGFERD-XRECHNUNG-CII",
            "finalized_date": "2026-06-29 08:56:24",
            "exchanged_date": "2026-06-29 08:56:24",
            "archived_date": "2026-06-29 17:48:55",
            "voided_date": null,
            "debtor": "bc3efbde-a463-4034-8117-154b5f54aff0"
        },
        (...)
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "count": 100,
        "total": 225
    }
}

GET https://api.eu-rechnung.de/v1/outgoing/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung der Rechnung in unserem System.
invoice_number STRING OUT

Eindeutige Kennung der Rechnung (Rechnungsnummer).
invoice_date DATE OUT

Ausstellungsdatum der Rechnung.
invoice_total DECIMAL OUT

Gesamtbetrag der Rechnung mit Umsatzsteuer (Bruttobetrag).
invoice_currency REFERENCE OUT

Währungskennzeichen für Rechnungsbeträge. Es ist die Liste ISO 4217 zu verwenden.
due_date DATE OUT

Fälligkeitsdatum des Rechnungsbetrags.
due_amount DECIMAL OUT

Ausstehender Betrag, der vom Käufer zu zahlen ist.
partner_name STRING OUT

Name des Rechnungsempfängers.
partner_zipcode STRING OUT

Postleitzahl des Rechnungsempfängers.
partner_city STRING OUT

Stadt des Rechnungsempfängers.
partner_country REFERENCE OUT

Land, in dem sich der Rechnungsempfänger befindet. Es ist die Liste ISO 3166-1 zu verwenden.

attachments ENUM OUT

Gibt an, in welchem Rechnungsdokument ein Rechnungsanhang gefunden wurde. Entspricht einem der folgenden Werte:

`none`	Es wurden keine Anlagen zur Rechnung gefunden.
`xml`	Das XML-Dokument enthält weitere Anlagen zur Rechnung.
`pdf`	Das PDF-Dokument enthält weitere Anlagen zur Rechnung.
`both`	Sowohl im XML- als auch PDF-Anteil wurden Anlagen gefunden.

data_status ENUM OUT

Bearbeitungszustand einer nicht abgeschlossenen Rechnung. Entspricht einem der folgenden Werte:

`pending`	Die Rechnung befindet sich in einer Vorprüfung und kann noch nicht bearbeitet werden.
`complete`	Alle mindestens erforderlichen Angaben zur Erstellung der E-Rechnung sind vorhanden.
`incomplete`	Die Angaben sind fehlerhaft oder es wurden nicht alle Pflichtangaben ausgefüllt.
`check`	Alle Pflichtangaben sind vorhanden, die Rechnung sollte dennoch auf Vollständigkeit geprüft werden.

audit_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Konformitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.
`fatal`	Es ist ein Systemfehler aufgetreten.

audit_type STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.

payment_status ENUM OUT

Gibt an, ob die Rechnung als bezahlt markiert wurde. Entspricht einem der folgenden Werte:

`unpaid`	Es sind noch keine Zahlungsausgänge zur Rechnung hinterlegt.
`partial`	Es sind Teilzahlungen hinterlegt und ein Restbetrag ist offen.
`paid`	Die Rechnung wurde als vollständig bezahlt markiert.

supported_flavors LIST OUT

Verfügbare Rechnungsformate für die Erstellung der finalen E-Rechnung.
Derzeit werden folgende Formate unterstützt, die konkrete Auswahl hängt vom Einzelfall ab:

`EN16931-CII`	XML-Rechnung im Standard EN 16931 und der CII-Syntax.
`XRECHNUNG-CII`	XML-Rechnung im Standard XRechnung und der CII-Syntax.
`PEPPOLBIS-UBL-CN`	XML-Gutschrift im Standard Peppol Billing BIS mit UBL-Syntax.
`PEPPOLBIS-UBL-INV`	XML-Rechnung im Standard Peppol Billing BIS mit UBL-Syntax.
`ZUGFERD-EN16931-CII`	PDF-Rechnung im Standard ZUGFeRD mit dem Profil EN16931.
`ZUGFERD-XRECHNUNG-CII`	PDF-Rechnung im Standard ZUGFeRD mit dem Profil XRECHNUNG.

export_flavor ENUM OUT

Rechnungsformat der finalen E-Rechnung. Entspricht einem der Werte aus dem Feld supported_flavors.
finalized_date TIMESTAMP OUT

Zeitpunkt, an dem die E-Rechnung final erstellt wurde. Sie ist gemäß GoBD nicht mehr veränderbar.
exchanged_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung elektronisch an den Empfänger verschickt wurde.
archived_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung ins Rechnungsarchiv verschoben wurde.
voided_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung auf dokumentierte Weise (GoBD-konform) gelöscht wurde.
debtor UUID OUT

Verknüpfung der Rechnung zu einem Debitor aus der Kundenverwaltung.

Antwort (HTTP 200 )

{
    "uuid": "089c6fd1-919d-4497-ac20-05c1c0ff6d42",
    "invoice_number": "R201120",
    "invoice_date": "2026-07-01",
    "invoice_total": 1513.45,
    "invoice_currency": "EUR",
    "due_date": "2026-07-15",
    "due_amount": 713.48,
    "partner_name": "Schlieper Group Verwaltungs GmbH",
    "partner_zipcode": "53426",
    "partner_city": "K\u00f6nigsfeld",
    "partner_country": "DE",
    "attachments": "both",
    "data_status": "complete",
    "audit_status": "success",
    "audit_type": "ZUGFeRD 2 (XRECHNUNG)",
    "payment_status": "paid",
    "supported_flavors": [
        "ZUGFERD-XRECHNUNG-CII"
    ],
    "export_flavor": "ZUGFERD-XRECHNUNG-CII",
    "finalized_date": "2026-06-29 08:56:24",
    "exchanged_date": "2026-06-29 08:56:24",
    "archived_date": "2026-06-29 17:48:55",
    "voided_date": null,
    "debtor": "bc3efbde-a463-4034-8117-154b5f54aff0"
}

GET https://api.eu-rechnung.de/v1/outgoing/number

Antwort (HTTP 200 )

"R201121"

GET https://api.eu-rechnung.de/v1/outgoing/{uuid}/data

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Hinweis: Bei den internen Rechnungsdaten von EU-Rechnung handelt es sich um eine umfangreiche Datenstruktur.
Mehr Informationen zum Aufbau und ein Beispiel eines solchen JSON-Objekts finden Sie im Abschnitt Rechnungsdaten.

GET https://api.eu-rechnung.de/v1/outgoing/{uuid}/invoice

Hinweis: Für XML-Rechnungen entspricht der MIME-Type dem Wert application/xml.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "f3df40ad-84cb-40e1-883d-41be779d7db1",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 27536,
    "mimetype": "application\/pdf",
    "content": "9Pxw2Q2HJoVofC73NuX8hhtFEMGeKThLYCcXXQl08-sZlRk4Oa(...)_FFowls-Ses9rUkMjvsDzOZpVWXe3yrIG2SYm0mMeTuLQ8yJQ="
}

GET https://api.eu-rechnung.de/v1/outgoing/{uuid}/payment

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

LIST OUT

Liste der erfassten Zahlungseingänge.

remaining_amount DECIMAL OUT

Offener Restbetrag der Rechnung.
payment_amount DECIMAL OUT

Bezahlte Summe zur Begleichung des offenen Betrags.
payment_date DATE OUT

Datum des Zahlungseingangs.
payment_type REFERENCE OUT

Kodierte Angabe der Zahlungsmethode. Es ist die Liste UNTDID 4461 zu verwenden.

treat_as ENUM OUT

Gibt bei Teilbeträgen an, wie mit dem offenen Restbetrag umgegangen werden soll. Es ist ein Wert aus folgender Liste zu verwenden:

`partial`	Der Betrag wird als Teilzahlung verbucht.
`discount`	Ein offener Restbetrag wird als Rabatt verbucht.
`paid`	Die Rechnung wird als vollständig bezahlt markiert.

Antwort (HTTP 200 )

[
    {
        "remaining_amount": 1513.45,
        "payment_amount": 500,
        "payment_date": "2026-07-01",
        "payment_type": "58",
        "treat_as": "partial"
    },
    {
        "remaining_amount": 1013.45,
        "payment_amount": 1013.45,
        "payment_date": "2026-07-04",
        "payment_type": "58",
        "treat_as": "paid"
    }
]

GET https://api.eu-rechnung.de/v1/outgoing/{uuid}/preview

Hinweis: Die Vorschau von Rechnungen erfolgt grundsätzlich im Rechnungsformat ZUGFeRD mit dem Profil XRECHNUNG.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "aeff8d63-9ff5-46c7-87da-7795ba3e8cfd",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 27536,
    "mimetype": "application\/pdf",
    "content": "9Pxw2Q2HJoVofC73NuX8hhtFEMGeKThLYCcXXQl08-sZlRk4Oa(...)_FFowls-Ses9rUkMjvsDzOZpVWXe3yrIG2SYm0mMeTuLQ8yJQ="
}

GET https://api.eu-rechnung.de/v1/outgoing/{uuid}/report

Hinweis: Mit Angabe von Content-Type: application/json im Header der Anfrage wird der Prüfbericht als JSON-Objekt zurückgegeben.
Struktur und ein Beispiel eines solchen Berichts im JSON-Format finden Sie im Abschnitt Konformitätsprüfung.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "4020b995-8202-47c1-8348-67681b3204fe",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 57288,
    "mimetype": "application\/pdf",
    "content": "tUsSQVoXERFTfB7YkjjMd5_LPSWnaoFIgcm3RwIi5ygbthlTdV(...)UUhPdIMQBBqoTX4O9AdvFhdGtOcOV0JZbgq6xvVqNuS_uLTy4="
}

Antwort (HTTP 202 )

null

Wenn die Konformitätsprüfung noch nicht abgeschlossen ist, wird dieser Antwortcode zurückgegeben.

GET https://api.eu-rechnung.de/v1/outgoing/{uuid}/xml

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "c15a005b-dc1b-42aa-a443-1ac912cb5ca5",
    "filename": "ZUGFeRD Invoice.xml",
    "filesize": 7406,
    "mimetype": "application\/xml",
    "content": "Eszgt6Tg_5FgNKlGA8pOHL6KgPX4K_nIex_PZVhADOYUrymua5(...)CA6WRDTp-yZrOa5NVYxKRX56XJZWg5PPBxe-8R4VmKVcNvC2o="
}

POST https://api.eu-rechnung.de/v1/outgoing/{uuid}

Hinweis: Es sind stets die kompletten Rechnungsdaten zu übermitteln. Jede Aktualisierung überschreibt alle vorhandenen Daten.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Anfragedaten

{
    "seller_address": {
        "name": "Schlieper Group Verwaltungs GmbH",
        "zipcode": "53426",
        "city": "K\u00f6nigsfeld",
        "country": "DE",
        "contact_person": "Adalbert Schlieper",
        "contact_email": "kontakt@example.com",
        "contact_phone": "+494066969300",
        "vat_number": "DE999999999"
    },
    "buyer_address": {
        "name": "Schultheiss Marketing OHG",
        "zipcode": "73460",
        "city": "H\u00fcttlingen",
        "country": "DE",
        "contact_email": "hello@example.com"
    },
    "invoice_items": [
        {
            "item_discount": 0,
            "item_measure": "HUR",
            "item_quantity": 6.5,
            "item_net": 552.5,
            "name": "Dienstleistung IT-Support Level 2",
            "tax_code": "STD-NORMAL",
            "unit_net": 85
        }
    ],
    "invoice_meta": {
        "exemption_code": "NONE",
        "invoice_type": "381",
        "invoice_currency": "EUR",
        "invoice_date": "2026-07-01",
        "invoice_number": "R201120",
        "delivery_date": "2026-07-01",
        "tax_country": "DE"
    },
    "payment_data": {
        "due_amount": 341.73,
        "due_date": "2026-07-15",
        "paid_amount": 250,
        "payment_accounts": [
            {
                "account_id": "DE89370400440532013000"
            }
        ],
        "payment_type": "58",
        "total_discount": 10,
        "total_gross": 591.73,
        "total_net": 497.25,
        "total_rounding": 0,
        "total_tax": 94.48
    },
    "attachments": [
        {
            "filename": "beispiel.csv",
            "filesize": 7829,
            "mimetype": "text\/csv",
            "content": "ZxdcwnCQBcPMzVW3f6o40kNRGZpKTZtwLqJmASalBp2gnnIOKG(...)pp4XXhotbiHlH4m4rm_qG_9ZTinGN46556e1uQPIC5Jdpuam8="
        }
    ]
}
}

Antwort (HTTP 200 )

null

Antwort (HTTP 422 )

{
    "seller_address": {
        "name": "Please fill out this field",
        "brand": "Please fill out this field",
        "contact_email": "Invalid email address",
        "vat_number": "Not a valid VAT ID"
    },
    "buyer_address": {
        "brand": "Please fill out this field"
    },
    "invoice_meta": {
        "invoice_type": "Invalid selection",
        "exemption_code": "Invalid selection",
        "invoice_date": "Invalid date format",
        "invoice_number": "Invalid format"
    },
    "invoice_items": {
        "entry-1": {
            "item_measure": "Invalid selection",
            "item_discount": "Please fill out this field",
            "tax_code": "Invalid selection",
            "item_net": "The amount was calculated incorrectly"
        }
    },
    "payment_data": {
        "total_net": "The amount was calculated incorrectly",
        "total_tax": "The amount was calculated incorrectly",
        "total_gross": "The amount was calculated incorrectly",
        "due_amount": "The amount was calculated incorrectly",
        "payment_accounts": {
            "entry-1": {
                "account_id": "Not a valid IBAN"
            },
            "entry-2": {
                "account_id": "Please fill out this field"
            }
        }
    },
    "attachments": {
        "entry-1": {
            "content": "Only CSV, XLSX, ODS, JPEG, PNG, and PDF files are supported"
        }
    }
}

Wenn die Anfrage mit diesem Fehlercode beantwortet wird, kann ein Speichern der Rechnung dennoch erzwungen werden. Dazu muss die Kopfzeile X-Force-Request: true bei der Anfrage mitgesendet werden. Beachten Sie, dass die finale E-Rechnung trotzdem erst erzeugt werden kann, wenn der Datensatz fehlerfrei ist und das Feld data_status den Wert "complete" ausgibt.

POST https://api.eu-rechnung.de/v1/outgoing/{uuid}/archive

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn die E-Rechnung bspw. noch nicht abgeschlossen ist oder bereits archiviert wurde.

POST https://api.eu-rechnung.de/v1/outgoing/{uuid}/cancel

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn die E-Rechnung bspw. noch nicht abgeschlossen ist oder bereits storniert wurde.

POST https://api.eu-rechnung.de/v1/outgoing/{uuid}/clone

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

"f70295b6-dae6-4bd4-a1a3-a3c5a05e8e33"

Die Rückgabe enthält die eindeutige Kennung der neu angelegten Rechnung.

POST https://api.eu-rechnung.de/v1/outgoing/{uuid}/correct

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

"f70295b6-dae6-4bd4-a1a3-a3c5a05e8e33"

Die Rückgabe enthält die eindeutige Kennung der neu angelegten Rechnung.

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn die E-Rechnung bspw. noch nicht abgeschlossen ist oder bereits storniert wurde.

POST https://api.eu-rechnung.de/v1/outgoing/{uuid}/exchange

Hinweis: Der Versand einer E-Rechnung per E-Mail erfolgt grundsätzlich an die in der Rechnung angegebene E-Mail-Adresse des Käufers.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

subject STRING IN

Betreffzeile der E-Mail-Nachricht.
body TEXT IN

Nachrichteninhalt der zu versendenden E-Mail. Es wird empfohlen HTML zu verwenden.
Für die Gestaltung mit HTML werden folgende HTML-Tags unterstützt: p, span, pre, h1, h2, h3, h4, h5, h6, strong, em, br
Als HTML-Text darf nur der Inhalt zwischen dem body-Tag übermittelt werden.
recipient_bcc EMAIL IN

Zusätzliche E-Mail-Adresse, an die die Rechnung unsichtbar versendet wird (BCC).
attachment OBJECT IN

Ein zusätzlicher Dateianhang zur E-Mail gemäß Austausch von Dokumenten.
- filename STRING IN
  
  Name der Datei.
- mimetype STRING IN
  
  Kennzeichnung des Dateityps (MIME-Type).
- content BASE64 IN
  
  Datei als Base64-kodierte Zeichenkette.

Anfragedaten

{
    "subject": "Ihre aktuelle Rechnung",
    "body": "<p>Im Anhang erhalten Sie Ihre aktuelle Rechnung.<\/p>"
}

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn die E-Rechnung noch nicht abgeschlossen ist oder die E-Mail-Einstellungen fehlerhaft sind.

Antwort (HTTP 422 )

{
    "subject": "Please fill out this field",
    "body": "The text contains invalid information",
    "recipient_bcc": "Invalid email address"
}

POST https://api.eu-rechnung.de/v1/outgoing/{uuid}/generate

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

export_flavor ENUM IN

Verfügbare Rechnungsformate für die Erstellung der finalen E-Rechnung.
Derzeit werden folgende Formate unterstützt, die konkrete Auswahl hängt vom Einzelfall ab:

`EN16931-CII`	XML-Rechnung im Standard EN 16931 und der CII-Syntax.
`XRECHNUNG-CII`	XML-Rechnung im Standard XRechnung und der CII-Syntax.
`PEPPOLBIS-UBL-CN`	XML-Gutschrift im Standard Peppol Billing BIS mit UBL-Syntax.
`PEPPOLBIS-UBL-INV`	XML-Rechnung im Standard Peppol Billing BIS mit UBL-Syntax.
`ZUGFERD-EN16931-CII`	PDF-Rechnung im Standard ZUGFeRD mit dem Profil EN16931.
`ZUGFERD-XRECHNUNG-CII`	PDF-Rechnung im Standard ZUGFeRD mit dem Profil XRECHNUNG.

Anfragedaten

{
    "export_flavor": "ZUGFERD-XRECHNUNG-CII"
}

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn die E-Rechnung bspw. noch Fehler enthält oder bereits abgeschlossen ist.

Antwort (HTTP 422 )

{
    "export_flavor": "Invalid selection"
}

POST https://api.eu-rechnung.de/v1/outgoing/{uuid}/payment

Hinweis: Wenn der zu buchende Zahlbetrag von dem offenen Restbetrag der Rechnung abweicht, muss angegeben werden, ob es sich um eine Teilzahlung handelt, ob der offene Restbetrag als Rabatt verbucht oder die Rechnung trotzdem als vollständig bezahlt markiert werden soll. Nur wenn bei abweichendem Zahlbetrag die Zahlung als Teilzahlung gebucht wird, ist es möglich, nachträglich weitere Zahlungseingänge zu erfassen. Für alle anderen Fälle ist keine weitere Buchung möglich.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

payment_amount DECIMAL IN

Bezahlte Summe zur Begleichung des offenen Betrags.
payment_date DATE IN

Datum des Zahlungsausgangs.

payment_type REFERENCE IN

Kodierte Angabe der Zahlungsmethode. Folgende Rechnungstypen werden derzeit unterstützt:

`1`	(nicht angegeben)
`10`	Barzahlung
`30`	Nicht-SEPA Überweisung
`49`	Nicht-SEPA Lastschrift/Bankeinzug
`54`	Kreditkarte
`57`	Vorkasse/Zahlung bereits erfolgt
`58`	SEPA Überweisung
`59`	SEPA Lastschrift/Bankeinzug
`68`	Online-Bezahlung (PayPal, Klarna, usw.)
`97`	Verrechnung offener Posten

treat_as ENUM IN

Gibt bei Teilbeträgen an, wie mit dem offenen Restbetrag umgegangen werden soll. Es ist ein Wert aus folgender Liste zu verwenden:

`partial`	Der Betrag wird als Teilzahlung verbucht.
`discount`	Ein offener Restbetrag wird als Rabatt verbucht.
`paid`	Die Rechnung wird als vollständig bezahlt markiert.

Anfragedaten

{
    "payment_amount": 19.5,
    "payment_date": "2026-07-03",
    "payment_type": "58",
    "treat_as": "discount"
}

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn die E-Rechnung bspw. noch nicht abgeschlossen ist oder nicht mehr verändert werden darf.

Antwort (HTTP 422 )

{
    "payment_amount": "Invalid amount",
    "payment_type": "Invalid selection",
    "treat_as": "Please fill out this field"
}

POST https://api.eu-rechnung.de/v1/outgoing/{uuid}/void

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn die E-Rechnung bspw. noch nicht abgeschlossen ist oder bereits gelöscht wurde.

POST https://api.eu-rechnung.de/v1/outgoing/create

Anfragedaten

{
    "seller_address": {
        "name": "Schlieper Group Verwaltungs GmbH",
        "zipcode": "53426",
        "city": "K\u00f6nigsfeld",
        "country": "DE",
        "contact_person": "Adalbert Schlieper",
        "contact_email": "kontakt@example.com",
        "contact_phone": "+494066969300",
        "vat_number": "DE999999999"
    },
    "buyer_address": {
        "name": "Schultheiss Marketing OHG",
        "zipcode": "73460",
        "city": "H\u00fcttlingen",
        "country": "DE",
        "contact_email": "hello@example.com"
    },
    "invoice_items": [
        {
            "item_discount": 0,
            "item_measure": "HUR",
            "item_quantity": 6.5,
            "item_net": 552.5,
            "name": "Dienstleistung IT-Support Level 2",
            "tax_code": "STD-NORMAL",
            "unit_net": 85
        }
    ],
    "invoice_meta": {
        "exemption_code": "NONE",
        "invoice_type": "381",
        "invoice_currency": "EUR",
        "invoice_date": "2026-07-01",
        "invoice_number": "R201120",
        "delivery_date": "2026-07-01",
        "tax_country": "DE"
    },
    "payment_data": {
        "due_amount": 341.73,
        "due_date": "2026-07-15",
        "paid_amount": 250,
        "payment_accounts": [
            {
                "account_id": "DE89370400440532013000"
            }
        ],
        "payment_type": "58",
        "total_discount": 10,
        "total_gross": 591.73,
        "total_net": 497.25,
        "total_rounding": 0,
        "total_tax": 94.48
    },
    "attachments": [
        {
            "filename": "beispiel.csv",
            "filesize": 7829,
            "mimetype": "text\/csv",
            "content": "ZxdcwnCQBcPMzVW3f6o40kNRGZpKTZtwLqJmASalBp2gnnIOKG(...)pp4XXhotbiHlH4m4rm_qG_9ZTinGN46556e1uQPIC5Jdpuam8="
        }
    ]
}

Antwort (HTTP 200 )

"f70295b6-dae6-4bd4-a1a3-a3c5a05e8e33"

Die Rückgabe enthält die eindeutige Kennung der neu angelegten Rechnung.

Antwort (HTTP 422 )

{
    "seller_address": {
        "name": "Please fill out this field",
        "brand": "Please fill out this field",
        "contact_email": "Invalid email address",
        "vat_number": "Not a valid VAT ID"
    },
    "buyer_address": {
        "brand": "Please fill out this field"
    },
    "invoice_meta": {
        "invoice_type": "Invalid selection",
        "exemption_code": "Invalid selection",
        "invoice_date": "Invalid date format",
        "invoice_number": "Invalid format"
    },
    "invoice_items": {
        "entry-1": {
            "item_measure": "Invalid selection",
            "item_discount": "Please fill out this field",
            "tax_code": "Invalid selection",
            "item_net": "The amount was calculated incorrectly"
        }
    },
    "payment_data": {
        "total_net": "The amount was calculated incorrectly",
        "total_tax": "The amount was calculated incorrectly",
        "total_gross": "The amount was calculated incorrectly",
        "due_amount": "The amount was calculated incorrectly",
        "payment_accounts": {
            "entry-1": {
                "account_id": "Not a valid IBAN"
            },
            "entry-2": {
                "account_id": "Please fill out this field"
            }
        }
    },
    "attachments": {
        "entry-1": {
            "content": "Only CSV, XLSX, ODS, JPEG, PNG, and PDF files are supported"
        }
    }
}

Wenn die Anfrage mit diesem Fehlercode beantwortet wird, kann ein Anlegen der Rechnung dennoch erzwungen werden. Dazu muss die Kopfzeile X-Force-Request: true bei der Anfrage mitgesendet werden. Beachten Sie, dass die finale E-Rechnung trotzdem erst erzeugt werden kann, wenn der Datensatz fehlerfrei ist und das Feld data_status den Wert "complete" ausgibt.

POST https://api.eu-rechnung.de/v1/incoming

Bitte beachten Sie: Eine Anleitung zum Hochladen von Dateien finden Sie im Abschnitt Austausch von Dokumenten.

Datenschema

file OBJECT IN

Datenobjekt gemäß Austausch von Dokumenten.
- filename STRING IN
  
  Name der Datei.
- mimetype STRING IN
  
  Kennzeichnung des Dateityps (MIME-Type).
- content BASE64 IN
  
  Datei als Base64-kodierte Zeichenkette.

Antwort (HTTP 200 )

"f70295b6-dae6-4bd4-a1a3-a3c5a05e8e33"

Die Rückgabe enthält die eindeutige Kennung der neu angelegten Rechnung.

Antwort (HTTP 402 )

The credit for PDF conversion has been used up.

Beispielmeldung für aufgebrauchtes Guthaben zur PDF-Umwandlung. Sie können bei Bedarf zusätzliche Pakete für Guthaben hinzubuchen.

Antwort (HTTP 422 )

{
    "file": "Only images and PDF files are supported."
}

DELETE https://api.eu-rechnung.de/v1/outgoing/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn es sich bspw. um eine abgeschlossene E-Rechnung handelt, die gemäß GoBD nicht gelöscht werden darf.

4.2. Rechnungseingang

GET https://api.eu-rechnung.de/v1/incoming

URL Abfrageparameter

offset INT IN

Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
limit INT IN

Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.

Datenschema

items LIST OUT

Rechnungen im Bereich Rechnungseingang, die der Suchanfrage entsprechen.

uuid UUID OUT

Eindeutige Kennung der Rechnung in unserem System.
invoice_number STRING OUT

Eindeutige Kennung der Rechnung (Rechnungsnummer).
invoice_date DATE OUT

Ausstellungsdatum der Rechnung.
invoice_total DECIMAL OUT

Gesamtbetrag der Rechnung mit Umsatzsteuer (Bruttobetrag).
invoice_currency REFERENCE OUT

Währungskennzeichen für Rechnungsbeträge. Es ist die Liste ISO 4217 zu verwenden.
due_date DATE OUT

Fälligkeitsdatum des Rechnungsbetrags.
due_amount DECIMAL OUT

Ausstehender Betrag, der vom Käufer zu zahlen ist.
partner_name STRING OUT

Name des Rechnungsstellers.
partner_zipcode STRING OUT

Postleitzahl des Rechnungsstellers.
partner_city STRING OUT

Stadt des Rechnungsstellers.
partner_country REFERENCE OUT

Land, in dem sich der Rechnungssteller befindet. Es ist die Liste ISO 3166-1 zu verwenden.
source_file STRING OUT

Dateiname des urspünglichen E-Rechnungsdokuments.
source_type ENUM OUT

Dateityp der urspünglichen E-Rechnung. Entspricht einem der folgenden Werte:

xml XML-Rechnung (z.B.: XRechnung)

pdf Hybride PDF-Rechnung (z.B.: ZUGFeRD)

attachments ENUM OUT

Gibt an, in welchem Rechnungsdokument ein Rechnungsanhang gefunden wurde. Entspricht einem der folgenden Werte:

`none`	Es wurden keine Anlagen zur Rechnung gefunden.
`xml`	Das XML-Dokument enthält weitere Anlagen zur Rechnung.
`pdf`	Das PDF-Dokument enthält weitere Anlagen zur Rechnung.
`both`	Sowohl im XML- als auch PDF-Anteil wurden Anlagen gefunden.

audit_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Konformitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.
`fatal`	Es ist ein Systemfehler aufgetreten.

audit_type STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.

fraud_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Plausibilitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Niedriges bis überschaubares Risiko für eine Manipulation.
`warning`	Abweichungen, die auf eine mögliche Manipulation hinweisen.
`error`	Kritische Abweichungen erkannt. Eine Manipulation ist wahrscheinlich.
`fatal`	Es ist ein Systemfehler aufgetreten.

fraud_score PERCENTAGE OUT

Indikator für die Wahrscheinlichkeit einer Manipulation der E-Rechnung.

payment_status ENUM OUT

Gibt an, ob die Rechnung als bezahlt markiert wurde. Entspricht einem der folgenden Werte:

`unpaid`	Es sind noch keine Zahlungseingänge zur Rechnung hinterlegt.
`partial`	Es sind Teilzahlungen hinterlegt und ein Restbetrag ist offen.
`paid`	Die Rechnung wurde als vollständig bezahlt markiert.

archived_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung ins Rechnungsarchiv verschoben wurde.
voided_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung auf dokumentierte Weise (GoBD-konform) gelöscht wurde.
creditor UUID OUT

Verknüpfung der Rechnung zu einem Kreditor aus der Lieferantenverwaltung.

pagination OBJECT OUT

Metadaten zur aktuellen Suchanfrage.
- offset INT OUT
  
  Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
- limit INT OUT
  
  Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.
- count INT OUT
  
  Tatsächliche Anzahl der Datensätze in der aktuellen Antwort.
- total INT OUT
  
  Gesamtzahl aller verfügbaren Datensätze über alle Seiten hinweg.

Antwort (HTTP 200 )

{
    "items": [
        {
            "uuid": "2c9970e1-774b-4c37-833f-babd4f034dfe",
            "invoice_number": "R201120",
            "invoice_date": "2026-07-01",
            "invoice_total": 1513.45,
            "invoice_currency": "EUR",
            "due_date": "2026-07-15",
            "due_amount": 713.48,
            "partner_name": "Schlieper Group Verwaltungs GmbH",
            "partner_zipcode": "53426",
            "partner_city": "K\u00f6nigsfeld",
            "partner_country": "DE",
            "source_file": "ZUGFeRD Invoice.pdf",
            "source_type": "pdf",
            "attachments": "both",
            "audit_status": "success",
            "audit_type": "ZUGFeRD 2 (XRECHNUNG)",
            "fraud_status": "success",
            "fraud_score": 9.58,
            "payment_status": "paid",
            "archived_date": null,
            "voided_date": null,
            "creditor": "62f2d675-eaa0-4574-8574-ca323e544762"
        },
        (...)
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "count": 100,
        "total": 225
    }
}

GET https://api.eu-rechnung.de/v1/incoming/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung der Rechnung in unserem System.
invoice_number STRING OUT

Eindeutige Kennung der Rechnung (Rechnungsnummer).
invoice_date DATE OUT

Ausstellungsdatum der Rechnung.
invoice_total DECIMAL OUT

Gesamtbetrag der Rechnung mit Umsatzsteuer (Bruttobetrag).
invoice_currency REFERENCE OUT

Währungskennzeichen für Rechnungsbeträge. Es ist die Liste ISO 4217 zu verwenden.
due_date DATE OUT

Fälligkeitsdatum des Rechnungsbetrags.
due_amount DECIMAL OUT

Ausstehender Betrag, der vom Käufer zu zahlen ist.
partner_name STRING OUT

Name des Rechnungsstellers.
partner_zipcode STRING OUT

Postleitzahl des Rechnungsstellers.
partner_city STRING OUT

Stadt des Rechnungsstellers.
partner_country REFERENCE OUT

Land, in dem sich der Rechnungssteller befindet. Es ist die Liste ISO 3166-1 zu verwenden.
source_file STRING OUT

Dateiname des urspünglichen E-Rechnungsdokuments.
source_type ENUM OUT

Dateityp der urspünglichen E-Rechnung. Entspricht einem der folgenden Werte:

xml XML-Rechnung (z.B.: XRechnung)

pdf Hybride PDF-Rechnung (z.B.: ZUGFeRD)

attachments ENUM OUT

Gibt an, in welchem Rechnungsdokument ein Rechnungsanhang gefunden wurde. Entspricht einem der folgenden Werte:

`none`	Es wurden keine Anlagen zur Rechnung gefunden.
`xml`	Das XML-Dokument enthält weitere Anlagen zur Rechnung.
`pdf`	Das PDF-Dokument enthält weitere Anlagen zur Rechnung.
`both`	Sowohl im XML- als auch PDF-Anteil wurden Anlagen gefunden.

audit_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Konformitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.
`fatal`	Es ist ein Systemfehler aufgetreten.

audit_type STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.

fraud_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Plausibilitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Niedriges bis überschaubares Risiko für eine Manipulation.
`warning`	Abweichungen, die auf eine mögliche Manipulation hinweisen.
`error`	Kritische Abweichungen erkannt. Eine Manipulation ist wahrscheinlich.
`fatal`	Es ist ein Systemfehler aufgetreten.

fraud_score PERCENTAGE OUT

Indikator für die Wahrscheinlichkeit einer Manipulation der E-Rechnung.

payment_status ENUM OUT

Gibt an, ob die Rechnung als bezahlt markiert wurde. Entspricht einem der folgenden Werte:

`unpaid`	Es sind noch keine Zahlungseingänge zur Rechnung hinterlegt.
`partial`	Es sind Teilzahlungen hinterlegt und ein Restbetrag ist offen.
`paid`	Die Rechnung wurde als vollständig bezahlt markiert.

archived_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung ins Rechnungsarchiv verschoben wurde.
voided_date TIMESTAMP OUT

Zeitpunkt, an dem die Rechnung auf dokumentierte Weise (GoBD-konform) gelöscht wurde.
creditor UUID OUT

Verknüpfung der Rechnung zu einem Kreditor aus der Lieferantenverwaltung.

Antwort (HTTP 200 )

{
    "uuid": "2c9970e1-774b-4c37-833f-babd4f034dfe",
    "invoice_number": "R201120",
    "invoice_date": "2026-07-01",
    "invoice_total": 1513.45,
    "invoice_currency": "EUR",
    "due_date": "2026-07-15",
    "due_amount": 713.48,
    "partner_name": "Schlieper Group Verwaltungs GmbH",
    "partner_zipcode": "53426",
    "partner_city": "K\u00f6nigsfeld",
    "partner_country": "DE",
    "source_file": "ZUGFeRD Invoice.pdf",
    "source_type": "pdf",
    "attachments": "both",
    "audit_status": "success",
    "audit_type": "ZUGFeRD 2 (XRECHNUNG)",
    "fraud_status": "success",
    "fraud_score": 9.58,
    "payment_status": "paid",
    "archived_date": null,
    "voided_date": null,
    "creditor": "62f2d675-eaa0-4574-8574-ca323e544762"
}

GET https://api.eu-rechnung.de/v1/incoming/{uuid}/attachments

Hinweis: Anlagen einer Rechnung werden grundsätzlich als ZIP-Archiv zum Download bereitgestellt.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "6bdad431-311e-430d-b975-a6b9b202c9a9",
    "filename": "ZUGFeRD Invoice.zip",
    "filesize": 164887,
    "mimetype": "application\/zip",
    "content": "t2H3sQ7k8tJHk1TmHaU4E3EOhtVKzno1meqKdfeOVasPRyAo-S(...)7s87Cz1Gg_377sRjqkRqCByph8JbbCDSyqhlQcG5jme6eSAPk="
}

GET https://api.eu-rechnung.de/v1/incoming/{uuid}/booking

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

LIST OUT

Liste der erfassten Buchungen.

name STRING OUT

Bezeichnung für den Buchungsvorgang.
net_amount DECIMAL OUT

Nettobetrag für die Buchung.
tax_amount DECIMAL OUT

Steuerbetrag für die Buchung.
account INT OUT

Buchungskonto (in der Regel 4-stelliges Konto des SKR03 oder SKR04).

automatic ENUM OUT

Gibt an, ob für diesen Buchungsvorgang eine Steuerautomatik angewendet werden soll. Es ist ein Wert aus folgender Liste zu verwenden:

`no`	Es soll keine Steuerautomatik angewendet werden.
`19`	Das Zielsystem arbeitet mit einer Automatik für den Steuersatz von 19%.
`7`	Das Zielsystem arbeitet mit einer Automatik für den Steuersatz von 7%.
`0`	Das Zielsystem arbeitet mit einer Automatik für den Steuersatz von 0%.

Antwort (HTTP 200 )

[
    {
        "name": "Wareneingang 19% VSt.",
        "net_amount": 100,
        "tax_amount": 19,
        "account": "3400",
        "automatic": "19"
    },
    {
        "name": "Wareneingang",
        "net_amount": 49.5,
        "tax_amount": 0,
        "account": "3200",
        "automatic": "0"
    }
]

GET https://api.eu-rechnung.de/v1/incoming/{uuid}/data

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

GET https://api.eu-rechnung.de/v1/incoming/{uuid}/fraudcheck

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "a3a1eec0-ee63-4ece-921d-6cc8a6e38eb5",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 64349,
    "mimetype": "application\/pdf",
    "content": "dlbsjsisKuZPxIpUmHnNoeUHN42f0HsJqVwSVsnUXHn8VHSYk-(...)12KAaFtHUGbWFD_6iOTuz5uCHsfC5NWecoMBP9uz9I4eWW7gg="
}

Antwort (HTTP 202 )

null

Wenn die Plausibilitätsprüfung noch nicht abgeschlossen ist, wird dieser Antwortcode zurückgegeben.

GET https://api.eu-rechnung.de/v1/incoming/{uuid}/payment

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

LIST OUT

Liste der erfassten Zahlungseingänge.

remaining_amount DECIMAL OUT

Offener Restbetrag der Rechnung.
payment_amount DECIMAL OUT

Bezahlte Summe zur Begleichung des offenen Betrags.
payment_date DATE OUT

Datum des Zahlungseingangs.
payment_type REFERENCE OUT

Kodierte Angabe der Zahlungsmethode. Es ist die Liste UNTDID 4461 zu verwenden.

treat_as ENUM OUT

Gibt bei Teilbeträgen an, wie mit dem offenen Restbetrag umgegangen werden soll. Es ist ein Wert aus folgender Liste zu verwenden:

`partial`	Der Betrag wird als Teilzahlung verbucht.
`discount`	Ein offener Restbetrag wird als Rabatt verbucht.
`paid`	Die Rechnung wird als vollständig bezahlt markiert.

Antwort (HTTP 200 )

[
    {
        "remaining_amount": 1513.45,
        "payment_amount": 500,
        "payment_date": "2026-07-01",
        "payment_type": "58",
        "treat_as": "partial"
    },
    {
        "remaining_amount": 1013.45,
        "payment_amount": 1013.45,
        "payment_date": "2026-07-04",
        "payment_type": "58",
        "treat_as": "paid"
    }
]

GET https://api.eu-rechnung.de/v1/incoming/{uuid}/report

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "4020b995-8202-47c1-8348-67681b3204fe",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 57288,
    "mimetype": "application\/pdf",
    "content": "tUsSQVoXERFTfB7YkjjMd5_LPSWnaoFIgcm3RwIi5ygbthlTdV(...)UUhPdIMQBBqoTX4O9AdvFhdGtOcOV0JZbgq6xvVqNuS_uLTy4="
}

Antwort (HTTP 202 )

null

Wenn die Konformitätsprüfung noch nicht abgeschlossen ist, wird dieser Antwortcode zurückgegeben.

GET https://api.eu-rechnung.de/v1/incoming/{uuid}/source

Hinweis: Für XML-Rechnungen entspricht der MIME-Type dem Wert application/xml.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "589b9066-70e9-426c-a349-941c364d799f",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 27621,
    "mimetype": "application\/pdf",
    "content": "FGODmTLtfI6NQwh-jx358QAszqdX7rt2CJb4qfwg8UKF3Xg34j(...)H3on6Ea8vhTUUQgaIpv1XoR5-d9pXUnwfx3e5XAQxRqmCjo8c="
}

GET https://api.eu-rechnung.de/v1/incoming/{uuid}/visual

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "e7c70a31-7a93-4587-bb92-5614822d493c",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 57800,
    "mimetype": "application\/pdf",
    "content": "nUh41QutnvE1GNavPw1Bu1JkG_LjgPY9sb_YbkVxsvNaTgs8Yb(...)0GOng-ZKtapd_bV3B4vfejq-GEULoo5E2VwIr16TriVVSP0tE="
}

GET https://api.eu-rechnung.de/v1/incoming/{uuid}/xml

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "c15a005b-dc1b-42aa-a443-1ac912cb5ca5",
    "filename": "ZUGFeRD Invoice.xml",
    "filesize": 7406,
    "mimetype": "application\/xml",
    "content": "Eszgt6Tg_5FgNKlGA8pOHL6KgPX4K_nIex_PZVhADOYUrymua5(...)CA6WRDTp-yZrOa5NVYxKRX56XJZWg5PPBxe-8R4VmKVcNvC2o="
}

POST https://api.eu-rechnung.de/v1/incoming

Bitte beachten Sie: Eine Anleitung zum Hochladen von Dateien finden Sie im Abschnitt Austausch von Dokumenten.

Datenschema

file OBJECT IN

Datenobjekt gemäß Austausch von Dokumenten.
- filename STRING IN
  
  Name der Datei.
- mimetype STRING IN
  
  Kennzeichnung des Dateityps (MIME-Type).
- content BASE64 IN
  
  Datei als Base64-kodierte Zeichenkette.

Antwort (HTTP 200 )

"f70295b6-dae6-4bd4-a1a3-a3c5a05e8e33"

Die Rückgabe enthält die eindeutige Kennung der neu angelegten Rechnung.

Antwort (HTTP 422 )

{
    "file": "Only e-invoices in XML and PDF format are supported."
}

POST https://api.eu-rechnung.de/v1/incoming/{uuid}/archive

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn es sich bspw. nicht um eine E-Rechnung handelt oder die Rechnung bereits archiviert wurde.

POST https://api.eu-rechnung.de/v1/incoming/{uuid}/booking

Hinweis: Es ist stets eine komplette Liste aller Buchungsdatensätze zu übermitteln. Jede Aktualisierung überschreibt alle vorhandenen Buchungsdaten.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

LIST IN

Liste der zu erfassenden Buchungen.

name STRING IN

Bezeichnung für den Buchungsvorgang.
net_amount DECIMAL IN

Nettobetrag für die Buchung.
tax_amount DECIMAL IN

Steuerbetrag für die Buchung.
account INT IN

Buchungskonto (in der Regel 4-stelliges Konto des SKR03 oder SKR04).

automatic ENUM IN

Gibt an, ob für diesen Buchungsvorgang eine Steuerautomatik angewendet werden soll. Es ist ein Wert aus folgender Liste zu verwenden:

`no`	Es soll keine Steuerautomatik angewendet werden.
`19`	Das Zielsystem arbeitet mit einer Automatik für den Steuersatz von 19%.
`7`	Das Zielsystem arbeitet mit einer Automatik für den Steuersatz von 7%.
`0`	Das Zielsystem arbeitet mit einer Automatik für den Steuersatz von 0%.

Anfragedaten

[
    {
        "name": "Wareneingang 19% VSt.",
        "net_amount": 100,
        "tax_amount": 19,
        "account": "3400",
        "automatic": "19"
    },
    {
        "name": "Wareneingang",
        "net_amount": 49.5,
        "tax_amount": 0,
        "account": "3200",
        "automatic": "0"
    }
]

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn es sich bspw. nicht um eine E-Rechnung handelt oder diese nicht mehr verändert werden darf.

Antwort (HTTP 422 )

{
    "entry-1": {
        "name": "Please fill out this field",
        "tax_amount": "Invalid numerical format"
    },
    "entry-2": {
        "net_amount": "Invalid numerical format",
        "account": "Invalid booking account",
        "automatic": "Invalid selection"
    },
    "deviation": "Totals do not match"
}

Fehler in den einzelnen Buchungsdatensätzen sind jeweils in den Elementen mit dem Schlüssel entry-N zu finden.
Zusätzlich wird bei einer Abweichung zwischen dem Gesamtbetrag der Buchungen und dem Gesamtbetrag der Rechnung ein Fehler im Element deviation zurückgegeben. Um dennoch ein Speichern der Daten bei abweichenden Beträgen zu erzwingen, muss die Kopfzeile X-Force-Request: true bei der Anfrage mitgesendet werden.

POST https://api.eu-rechnung.de/v1/incoming/{uuid}/creditor

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

creditor UUID IN

Kennung eines Kreditors aus der Lieferantenverwaltung.

Anfragedaten

{
    "creditor": "718625d6-6f70-4191-85a4-ea6c81b12129"
}

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn es sich bspw. nicht um eine E-Rechnung handelt oder diese nicht mehr verändert werden darf.

Antwort (HTTP 422 )

{
    "creditor": "Reference not found"
}

POST https://api.eu-rechnung.de/v1/incoming/{uuid}/fraudcheck

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

Antwort (HTTP 402 )

The credit for PDF conversion has been used up.

Beispielmeldung für aufgebrauchtes Guthaben zur PDF-Umwandlung. Sie können bei Bedarf zusätzliche Pakete für Guthaben hinzubuchen.

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn die Plausibilitätsprüfung bspw. aufgrund einer ungültigen E-Rechnung nicht durchgeführt werden kann.

POST https://api.eu-rechnung.de/v1/incoming/{uuid}/payment

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

payment_amount DECIMAL IN

Bezahlte Summe zur Begleichung des offenen Betrags.
payment_date DATE IN

Datum des Zahlungseingangs.

payment_type REFERENCE IN

Kodierte Angabe der Zahlungsmethode. Folgende Rechnungstypen werden derzeit unterstützt:

`1`	(nicht angegeben)
`10`	Barzahlung
`30`	Nicht-SEPA Überweisung
`49`	Nicht-SEPA Lastschrift/Bankeinzug
`54`	Kreditkarte
`57`	Vorkasse/Zahlung bereits erfolgt
`58`	SEPA Überweisung
`59`	SEPA Lastschrift/Bankeinzug
`68`	Online-Bezahlung (PayPal, Klarna, usw.)
`97`	Verrechnung offener Posten

treat_as ENUM IN

Gibt bei Teilbeträgen an, wie mit dem offenen Restbetrag umgegangen werden soll. Es ist ein Wert aus folgender Liste zu verwenden:

`partial`	Der Betrag wird als Teilzahlung verbucht.
`discount`	Ein offener Restbetrag wird als Rabatt verbucht.
`paid`	Die Rechnung wird als vollständig bezahlt markiert.

Anfragedaten

{
    "payment_amount": 19.5,
    "payment_date": "2026-07-03",
    "payment_type": "58",
    "treat_as": "discount"
}

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn es sich bspw. nicht um eine E-Rechnung handelt oder diese nicht mehr verändert werden darf.

Antwort (HTTP 422 )

{
    "payment_amount": "Invalid amount",
    "payment_type": "Invalid selection",
    "treat_as": "Please fill out this field"
}

POST https://api.eu-rechnung.de/v1/incoming/{uuid}/void

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn es sich bspw. nicht um eine E-Rechnung handelt oder die Rechnung bereits gelöscht wurde.

DELETE https://api.eu-rechnung.de/v1/incoming/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn es sich bspw. um eine E-Rechnung handelt, die gemäß GoBD nicht gelöscht werden darf.

4.3. Rechnungsprüfung

GET https://api.eu-rechnung.de/v1/validator

URL Abfrageparameter

offset INT IN

Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
limit INT IN

Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.

Datenschema

items LIST OUT

Rechnungen im Bereich Rechnungsprüfung, die der Suchanfrage entsprechen.

uuid UUID OUT

Eindeutige Kennung der Rechnung in unserem System.
invoice_number STRING OUT

Eindeutige Kennung der Rechnung (Rechnungsnummer).
invoice_date DATE OUT

Ausstellungsdatum der Rechnung.
invoice_total DECIMAL OUT

Gesamtbetrag der Rechnung mit Umsatzsteuer (Bruttobetrag).
invoice_currency REFERENCE OUT

Währungskennzeichen für Rechnungsbeträge. Es ist die Liste ISO 4217 zu verwenden.
due_date DATE OUT

Fälligkeitsdatum des Rechnungsbetrags.
due_amount DECIMAL OUT

Ausstehender Betrag, der vom Käufer zu zahlen ist.
partner_name STRING OUT

Name des Rechnungsstellers oder -empfängers.
partner_zipcode STRING OUT

Postleitzahl des Rechnungsstellers oder -empfängers.
partner_city STRING OUT

Stadt des Rechnungsstellers oder -empfängers.
partner_country REFERENCE OUT

Land, in dem sich der Rechnungssteller oder -empfänger befindet. Es ist die Liste ISO 3166-1 zu verwenden.
source_file STRING OUT

Dateiname des urspünglichen E-Rechnungsdokuments.
source_type ENUM OUT

Dateityp der urspünglichen E-Rechnung. Entspricht einem der folgenden Werte:

xml XML-Rechnung (z.B.: XRechnung)

pdf Hybride PDF-Rechnung (z.B.: ZUGFeRD)

attachments ENUM OUT

Gibt an, in welchem Rechnungsdokument ein Rechnungsanhang gefunden wurde. Entspricht einem der folgenden Werte:

`none`	Es wurden keine Anlagen zur Rechnung gefunden.
`xml`	Das XML-Dokument enthält weitere Anlagen zur Rechnung.
`pdf`	Das PDF-Dokument enthält weitere Anlagen zur Rechnung.
`both`	Sowohl im XML- als auch PDF-Anteil wurden Anlagen gefunden.

audit_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Konformitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.
`fatal`	Es ist ein Systemfehler aufgetreten.

audit_type STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.

fraud_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Plausibilitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Niedriges bis überschaubares Risiko für eine Manipulation.
`warning`	Abweichungen, die auf eine mögliche Manipulation hinweisen.
`error`	Kritische Abweichungen erkannt. Eine Manipulation ist wahrscheinlich.
`fatal`	Es ist ein Systemfehler aufgetreten.

fraud_score PERCENTAGE OUT

Indikator für die Wahrscheinlichkeit einer Manipulation der E-Rechnung.

pagination OBJECT OUT

Metadaten zur aktuellen Suchanfrage.
- offset INT OUT
  
  Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
- limit INT OUT
  
  Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.
- count INT OUT
  
  Tatsächliche Anzahl der Datensätze in der aktuellen Antwort.
- total INT OUT
  
  Gesamtzahl aller verfügbaren Datensätze über alle Seiten hinweg.

Antwort (HTTP 200 )

{
    "items": [
        {
            "uuid": "f70295b6-dae6-4bd4-a1a3-a3c5a05e8e33",
            "invoice_number": "R201120",
            "invoice_date": "2026-07-01",
            "invoice_total": 1513.45,
            "invoice_currency": "EUR",
            "due_date": "2026-07-15",
            "due_amount": 713.48,
            "partner_name": "Schlieper Group Verwaltungs GmbH",
            "partner_zipcode": "53426",
            "partner_city": "K\u00f6nigsfeld",
            "partner_country": "DE",
            "source_file": "ZUGFeRD Invoice.pdf",
            "source_type": "pdf",
            "attachments": "both",
            "audit_status": "success",
            "audit_type": "ZUGFeRD 2 (XRECHNUNG)",
            "fraud_status": "success",
            "fraud_score": 9.58
        },
        (...)
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "count": 100,
        "total": 225
    }
}

GET https://api.eu-rechnung.de/v1/validator/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung der Rechnung in unserem System.
invoice_number STRING OUT

Eindeutige Kennung der Rechnung (Rechnungsnummer).
invoice_date DATE OUT

Ausstellungsdatum der Rechnung.
invoice_total DECIMAL OUT

Gesamtbetrag der Rechnung mit Umsatzsteuer (Bruttobetrag).
invoice_currency REFERENCE OUT

Währungskennzeichen für Rechnungsbeträge. Es ist die Liste ISO 4217 zu verwenden.
due_date DATE OUT

Fälligkeitsdatum des Rechnungsbetrags.
due_amount DECIMAL OUT

Ausstehender Betrag, der vom Käufer zu zahlen ist.
partner_name STRING OUT

Name des Rechnungsstellers oder -empfängers.
partner_zipcode STRING OUT

Postleitzahl des Rechnungsstellers oder -empfängers.
partner_city STRING OUT

Stadt des Rechnungsstellers oder -empfängers.
partner_country REFERENCE OUT

Land, in dem sich der Rechnungssteller oder -empfänger befindet. Es ist die Liste ISO 3166-1 zu verwenden.
source_file STRING OUT

Dateiname des urspünglichen E-Rechnungsdokuments.
source_type ENUM OUT

Dateityp der urspünglichen E-Rechnung. Entspricht einem der folgenden Werte:

xml XML-Rechnung (z.B.: XRechnung)

pdf Hybride PDF-Rechnung (z.B.: ZUGFeRD)

attachments ENUM OUT

Gibt an, in welchem Rechnungsdokument ein Rechnungsanhang gefunden wurde. Entspricht einem der folgenden Werte:

`none`	Es wurden keine Anlagen zur Rechnung gefunden.
`xml`	Das XML-Dokument enthält weitere Anlagen zur Rechnung.
`pdf`	Das PDF-Dokument enthält weitere Anlagen zur Rechnung.
`both`	Sowohl im XML- als auch PDF-Anteil wurden Anlagen gefunden.

audit_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Konformitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Das Dokument ist konform zu den Vorgaben.
`warning`	Das Dokument enthält tolerierbare Fehler.
`error`	Das Dokument ist nicht konform.
`fatal`	Es ist ein Systemfehler aufgetreten.

audit_type STRING OUT

Angabe, welcher Dokumenttyp und ggf. welches E-Rechnungsprofil erkannt wurde.

fraud_status ENUM OUT

Verarbeitungszustand oder Ergebnis der Plausibilitätsprüfung. Entspricht einem der folgenden Werte:

`pending`	Die Prüfung wurde noch nicht durchgeführt.
`processing`	Die Prüfung wird derzeit durchgeführt.
`success`	Niedriges bis überschaubares Risiko für eine Manipulation.
`warning`	Abweichungen, die auf eine mögliche Manipulation hinweisen.
`error`	Kritische Abweichungen erkannt. Eine Manipulation ist wahrscheinlich.
`fatal`	Es ist ein Systemfehler aufgetreten.

fraud_score PERCENTAGE OUT

Indikator für die Wahrscheinlichkeit einer Manipulation der E-Rechnung.

Antwort (HTTP 200 )

{
    "uuid": "f70295b6-dae6-4bd4-a1a3-a3c5a05e8e33",
    "invoice_number": "R201120",
    "invoice_date": "2026-07-01",
    "invoice_total": 1513.45,
    "invoice_currency": "EUR",
    "due_date": "2026-07-15",
    "due_amount": 713.48,
    "partner_name": "Schlieper Group Verwaltungs GmbH",
    "partner_zipcode": "53426",
    "partner_city": "K\u00f6nigsfeld",
    "partner_country": "DE",
    "source_file": "ZUGFeRD Invoice.pdf",
    "source_type": "pdf",
    "attachments": "both",
    "audit_status": "success",
    "audit_type": "ZUGFeRD 2 (XRECHNUNG)",
    "fraud_status": "success",
    "fraud_score": 9.58
}

GET https://api.eu-rechnung.de/v1/validator/{uuid}/attachments

Hinweis: Anlagen einer Rechnung werden grundsätzlich als ZIP-Archiv zum Download bereitgestellt.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "6bdad431-311e-430d-b975-a6b9b202c9a9",
    "filename": "ZUGFeRD Invoice.zip",
    "filesize": 164887,
    "mimetype": "application\/zip",
    "content": "t2H3sQ7k8tJHk1TmHaU4E3EOhtVKzno1meqKdfeOVasPRyAo-S(...)7s87Cz1Gg_377sRjqkRqCByph8JbbCDSyqhlQcG5jme6eSAPk="
}

GET https://api.eu-rechnung.de/v1/validator/{uuid}/data

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

GET https://api.eu-rechnung.de/v1/validator/{uuid}/fraudcheck

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "a3a1eec0-ee63-4ece-921d-6cc8a6e38eb5",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 64349,
    "mimetype": "application\/pdf",
    "content": "dlbsjsisKuZPxIpUmHnNoeUHN42f0HsJqVwSVsnUXHn8VHSYk-(...)12KAaFtHUGbWFD_6iOTuz5uCHsfC5NWecoMBP9uz9I4eWW7gg="
}

Antwort (HTTP 202 )

null

Wenn die Plausibilitätsprüfung noch nicht abgeschlossen ist, wird dieser Antwortcode zurückgegeben.

GET https://api.eu-rechnung.de/v1/validator/{uuid}/report

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "4020b995-8202-47c1-8348-67681b3204fe",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 57288,
    "mimetype": "application\/pdf",
    "content": "tUsSQVoXERFTfB7YkjjMd5_LPSWnaoFIgcm3RwIi5ygbthlTdV(...)UUhPdIMQBBqoTX4O9AdvFhdGtOcOV0JZbgq6xvVqNuS_uLTy4="
}

Antwort (HTTP 202 )

null

Wenn die Konformitätsprüfung noch nicht abgeschlossen ist, wird dieser Antwortcode zurückgegeben.

GET https://api.eu-rechnung.de/v1/validator/{uuid}/source

Hinweis: Für XML-Rechnungen entspricht der MIME-Type dem Wert application/xml.

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "589b9066-70e9-426c-a349-941c364d799f",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 27621,
    "mimetype": "application\/pdf",
    "content": "FGODmTLtfI6NQwh-jx358QAszqdX7rt2CJb4qfwg8UKF3Xg34j(...)H3on6Ea8vhTUUQgaIpv1XoR5-d9pXUnwfx3e5XAQxRqmCjo8c="
}

GET https://api.eu-rechnung.de/v1/validator/{uuid}/visual

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "e7c70a31-7a93-4587-bb92-5614822d493c",
    "filename": "ZUGFeRD Invoice.pdf",
    "filesize": 57800,
    "mimetype": "application\/pdf",
    "content": "nUh41QutnvE1GNavPw1Bu1JkG_LjgPY9sb_YbkVxsvNaTgs8Yb(...)0GOng-ZKtapd_bV3B4vfejq-GEULoo5E2VwIr16TriVVSP0tE="
}

GET https://api.eu-rechnung.de/v1/validator/{uuid}/xml

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Dokuments in unserem System.
filename STRING OUT

Ursprünglicher Dateiname bei hochgeladenen Dokumenten, ansonsten vom System generierter Dateiname.
filesize INT OUT

Reale Größe der Datei in Bytes.
mimetype STRING OUT

Kennzeichnung des Dateityps (MIME-Type).
content BASE64 OUT

Base64-kodierter Inhalt der Datei (muss vor dem Speichern wieder dekodiert werden).

Antwort (HTTP 200 )

{
    "uuid": "c15a005b-dc1b-42aa-a443-1ac912cb5ca5",
    "filename": "ZUGFeRD Invoice.xml",
    "filesize": 7406,
    "mimetype": "application\/xml",
    "content": "Eszgt6Tg_5FgNKlGA8pOHL6KgPX4K_nIex_PZVhADOYUrymua5(...)CA6WRDTp-yZrOa5NVYxKRX56XJZWg5PPBxe-8R4VmKVcNvC2o="
}

POST https://api.eu-rechnung.de/v1/validator

Bitte beachten Sie: Eine Anleitung zum Hochladen von Dateien finden Sie im Abschnitt Austausch von Dokumenten.

Datenschema

file OBJECT IN

Datenobjekt gemäß Austausch von Dokumenten.
- filename STRING IN
  
  Name der Datei.
- mimetype STRING IN
  
  Kennzeichnung des Dateityps (MIME-Type).
- content BASE64 IN
  
  Datei als Base64-kodierte Zeichenkette.

Antwort (HTTP 200 )

"f70295b6-dae6-4bd4-a1a3-a3c5a05e8e33"

Die Rückgabe enthält die eindeutige Kennung der neu angelegten Rechnung.

Antwort (HTTP 422 )

{
    "file": "Only e-invoices in XML and PDF format are supported."
}

POST https://api.eu-rechnung.de/v1/validator/{uuid}/fraudcheck

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

Antwort (HTTP 402 )

The credit for PDF conversion has been used up.

Beispielmeldung für aufgebrauchtes Guthaben zur PDF-Umwandlung. Sie können bei Bedarf zusätzliche Pakete für Guthaben hinzubuchen.

Antwort (HTTP 409 )

The requested operation cannot be performed.

Dieser Fehler wird zurückgegeben, wenn die Plausibilitätsprüfung bspw. aufgrund einer ungültigen E-Rechnung nicht durchgeführt werden kann.

DELETE https://api.eu-rechnung.de/v1/validator/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung der Rechnung in unserem System.

Antwort (HTTP 200 )

null

4.4. Kundenverwaltung

GET https://api.eu-rechnung.de/v1/debtors

URL Abfrageparameter

offset INT IN

Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
limit INT IN

Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.

Datenschema

items LIST OUT

Liste der Kunden, die der Suchanfrage entsprechen.
- uuid UUID OUT
  
  Eindeutige Kennung des Kunden in unserem System.
- brand STRING OUT BT-45
  
  Marke oder Handelsname des Kunden.
- name STRING OUT BT-44
  
  Vollständiger Name des Kunden.
- line_one STRING OUT BT-50
  
  Hauptzeile der Kundenanschrift (Adresszeile 1).
- line_two STRING OUT BT-51
  
  Zusätzliche Zeile der Kundenanschrift (Adresszeile 2).
- line_three STRING OUT BT-163
  
  Zusätzliche Zeile der Kundenanschrift (Adresszeile 3).
- zipcode STRING OUT BT-53
  
  Postleitzahl der Kundenanschrift.
- city STRING OUT BT-52
  
  Stadt oder Gemeinde des Kunden.
- district STRING OUT BT-54
  
  Region oder Bundesland des Kunden.
- country REFERENCE OUT BT-55
  
  Land, in dem sich die Kundenanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
- contact_person STRING OUT BT-56
  
  Ansprechpartner oder Kontakt beim Kunden.
- contact_phone STRING OUT BT-57
  
  Telefonnummer des Kontakts beim Kunden.
- contact_email EMAIL OUT BT-58
  
  E-Mail-Adresse des Kontakts beim Kunden.
- vat_number STRING OUT BT-48
  
  Umsatzsteuer-Identifikationsnummer des Kunden.
- legal_number STRING OUT BT-47
  
  Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
- routing_id STRING OUT BT-10
  
  Kundenreferenz für interne Lenkungszwecke (Leitweg-ID).
- booking_account STRING OUT
  
  Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Debitorenkonto).
- debtor_number STRING OUT
  
  Eindeutige Identifikationsnummer in Ihrem System (Kundennummer).
- ident_number STRING OUT BT-46
  
  Eindeutige Kennung des Kunden gemäß eines ISO-Schemas.
- ident_scheme REFERENCE OUT BT-46
  
  Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
- electronic_address STRING OUT BT-49
  
  Elektronische Adresse gemäß EAS-Schema, an die die Rechnung gesendet werden soll.
- electronic_scheme REFERENCE OUT BT-49
  
  Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.
- seller_ident STRING OUT BT-29
  
  Eindeutige Kennung zur Identifizierung des Lieferanten beim Kunden gemäß eines ISO-Schemas.
- seller_scheme REFERENCE OUT BT-29
  
  Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
pagination OBJECT OUT

Metadaten zur aktuellen Suchanfrage.
- offset INT OUT
  
  Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
- limit INT OUT
  
  Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.
- count INT OUT
  
  Tatsächliche Anzahl der Datensätze in der aktuellen Antwort.
- total INT OUT
  
  Gesamtzahl aller verfügbaren Datensätze über alle Seiten hinweg.

Antwort (HTTP 200 )

{
    "items": [
        {
            "uuid": "eb8cedff-0abe-4463-bef6-02f5750fd29c",
            "brand": "Schultheiss Marketing",
            "name": "Schultheiss Marketing OHG",
            "line_one": "Holunderweg 6",
            "line_two": "Aufgang C, 4. OG",
            "line_three": null,
            "zipcode": "73460",
            "city": "H\u00fcttlingen",
            "country": "DE",
            "contact_person": "Frau Annkristin Schultheiss",
            "contact_phone": "+493023125000",
            "contact_email": "hello@example.com",
            "vat_number": "DE123456789",
            "legal_number": "HRA 1234/100",
            "routing_id": "991-1234512345-06",
            "booking_account": "12017",
            "debtor_number": "K10081",
            "ident_number": "5412345000013",
            "ident_scheme": "0088",
            "electronic_address": "991-1234512345-06",
            "electronic_scheme": "0204",
            "seller_ident": "999999999",
            "seller_scheme": "0060"
        },
        (...)
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "count": 100,
        "total": 225
    }
}

GET https://api.eu-rechnung.de/v1/debtors/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung des Kunden in unserem Systen.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Kunden in unserem System.
brand STRING OUT BT-45

Marke oder Handelsname des Kunden.
name STRING OUT BT-44

Vollständiger Name des Kunden.
line_one STRING OUT BT-50

Hauptzeile der Kundenanschrift (Adresszeile 1).
line_two STRING OUT BT-51

Zusätzliche Zeile der Kundenanschrift (Adresszeile 2).
line_three STRING OUT BT-163

Zusätzliche Zeile der Kundenanschrift (Adresszeile 3).
zipcode STRING OUT BT-53

Postleitzahl der Kundenanschrift.
city STRING OUT BT-52

Stadt oder Gemeinde des Kunden.
district STRING OUT BT-54

Region oder Bundesland des Kunden.
country REFERENCE OUT BT-55

Land, in dem sich die Kundenanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
contact_person STRING OUT BT-56

Ansprechpartner oder Kontakt beim Kunden.
contact_phone STRING OUT BT-57

Telefonnummer des Kontakts beim Kunden.
contact_email EMAIL OUT BT-58

E-Mail-Adresse des Kontakts beim Kunden.
vat_number STRING OUT BT-48

Umsatzsteuer-Identifikationsnummer des Kunden.
legal_number STRING OUT BT-47

Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
routing_id STRING OUT BT-10

Kundenreferenz für interne Lenkungszwecke (Leitweg-ID).
booking_account STRING OUT

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Debitorenkonto).
debtor_number STRING OUT

Eindeutige Identifikationsnummer in Ihrem System (Kundennummer).
ident_number STRING OUT BT-46

Eindeutige Kennung des Kunden gemäß eines ISO-Schemas.
ident_scheme REFERENCE OUT BT-46

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
electronic_address STRING OUT BT-49

Elektronische Adresse gemäß EAS-Schema, an die die Rechnung gesendet werden soll.
electronic_scheme REFERENCE OUT BT-49

Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.
seller_ident STRING OUT BT-29

Eindeutige Kennung zur Identifizierung des Lieferanten beim Kunden gemäß eines ISO-Schemas.
seller_scheme REFERENCE OUT BT-29

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.

Antwort (HTTP 200 )

{
    "uuid": "eb8cedff-0abe-4463-bef6-02f5750fd29c",
    "brand": "Schultheiss Marketing",
    "name": "Schultheiss Marketing OHG",
    "line_one": "Holunderweg 6",
    "line_two": "Aufgang C, 4. OG",
    "line_three": null,
    "zipcode": "73460",
    "city": "H\u00fcttlingen",
    "country": "DE",
    "contact_person": "Frau Annkristin Schultheiss",
    "contact_phone": "+493023125000",
    "contact_email": "hello@example.com",
    "vat_number": "DE123456789",
    "legal_number": "HRA 1234/100",
    "routing_id": "991-1234512345-06",
    "booking_account": "12017",
    "debtor_number": "K10081",
    "ident_number": "5412345000013",
    "ident_scheme": "0088",
    "electronic_address": "991-1234512345-06",
    "electronic_scheme": "0204",
    "seller_ident": "999999999",
    "seller_scheme": "0060"
}

GET https://api.eu-rechnung.de/v1/debtors/number

Antwort (HTTP 200 )

"K10082"

POST https://api.eu-rechnung.de/v1/debtors

Datenschema

brand STRING IN BT-45

Marke oder Handelsname des Kunden.
name STRING IN BT-44

Vollständiger Name des Kunden.
line_one STRING IN BT-50

Hauptzeile der Kundenanschrift (Adresszeile 1).
line_two STRING IN BT-51

Zusätzliche Zeile der Kundenanschrift (Adresszeile 2).
line_three STRING IN BT-163

Zusätzliche Zeile der Kundenanschrift (Adresszeile 3).
zipcode STRING IN BT-53

Postleitzahl der Kundenanschrift.
city STRING IN BT-52

Stadt oder Gemeinde des Kunden.
country REFERENCE IN BT-55

Land, in dem sich die Kundenanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
contact_person STRING IN BT-56

Ansprechpartner oder Kontakt beim Kunden.
contact_phone STRING IN BT-57

Telefonnummer des Kontakts beim Kunden.
contact_email EMAIL IN BT-58

E-Mail-Adresse des Kontakts beim Kunden.
vat_number STRING IN BT-48

Umsatzsteuer-Identifikationsnummer des Kunden.
legal_number STRING IN BT-47

Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
routing_id STRING IN BT-10

Kundenreferenz für interne Lenkungszwecke (Leitweg-ID).
booking_account STRING IN

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Debitorenkonto).
debtor_number STRING IN

Eindeutige Identifikationsnummer in Ihrem System (Kundennummer).
ident_number STRING IN BT-46

Eindeutige Kennung des Kunden gemäß eines ISO-Schemas.
ident_scheme REFERENCE IN BT-46

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
electronic_address STRING IN BT-49

Elektronische Adresse gemäß EAS-Schema, an die die Rechnung gesendet werden soll.
electronic_scheme REFERENCE IN BT-49

Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.
seller_ident STRING IN BT-29

Eindeutige Kennung zur Identifizierung des Lieferanten beim Kunden gemäß eines ISO-Schemas.
seller_scheme REFERENCE IN BT-29

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.

Anfragedaten

{
    "brand": "Schultheiss Marketing",
    "name": "Schultheiss Marketing OHG",
    "line_one": "Holunderweg 6",
    "line_two": "Aufgang C, 4. OG",
    "line_three": null,
    "zipcode": "73460",
    "city": "H\u00fcttlingen",
    "country": "DE",
    "contact_person": "Frau Annkristin Schultheiss",
    "contact_email": "hello@example.com",
    "contact_phone": "+493023125000",
    "vat_number": "DE123456789",
    "legal_number": "HRA 1234/100",
    "routing_id": "991-1234512345-06",
    "booking_account": "12017",
    "debtor_number": "K10081",
    "ident_number": "5412345000013",
    "ident_scheme": "0088",
    "electronic_address": "991-1234512345-06",
    "electronic_scheme": "0204",
    "seller_ident": "999999999",
    "seller_scheme": "0060"
}

Antwort (HTTP 200 )

"eb8cedff-0abe-4463-bef6-02f5750fd29c"

Die Rückgabe enthält die eindeutige Kennung des neu angelegten Kunden.

Antwort (HTTP 422 )

{
    "ident_scheme": "Invalid selection",
    "electronic_address": "Not a valid Peppol address",
    "brand": "Input is too long (max. 255 characters)",
    "country": "Invalid selection",
    "contact_email": "Invalid email address",
    "vat_number": "Not a valid VAT ID",
    "booking_account": "Invalid booking account"
}

POST https://api.eu-rechnung.de/v1/debtors/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung des Kunden in unserem Systen.

Datenschema

brand STRING IN BT-45

Marke oder Handelsname des Kunden.
name STRING IN BT-44

Vollständiger Name des Kunden.
line_one STRING IN BT-50

Hauptzeile der Kundenanschrift (Adresszeile 1).
line_two STRING IN BT-51

Zusätzliche Zeile der Kundenanschrift (Adresszeile 2).
line_three STRING IN BT-163

Zusätzliche Zeile der Kundenanschrift (Adresszeile 3).
zipcode STRING IN BT-53

Postleitzahl der Kundenanschrift.
city STRING IN BT-52

Stadt oder Gemeinde des Kunden.
country REFERENCE IN BT-55

Land, in dem sich die Kundenanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
contact_person STRING IN BT-56

Ansprechpartner oder Kontakt beim Kunden.
contact_phone STRING IN BT-57

Telefonnummer des Kontakts beim Kunden.
contact_email EMAIL IN BT-58

E-Mail-Adresse des Kontakts beim Kunden.
vat_number STRING IN BT-48

Umsatzsteuer-Identifikationsnummer des Kunden.
legal_number STRING IN BT-47

Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
routing_id STRING IN BT-10

Kundenreferenz für interne Lenkungszwecke (Leitweg-ID).
booking_account STRING IN

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Debitorenkonto).
debtor_number STRING IN

Eindeutige Identifikationsnummer in Ihrem System (Kundennummer).
ident_number STRING IN BT-46

Eindeutige Kennung des Kunden gemäß eines ISO-Schemas.
ident_scheme REFERENCE IN BT-46

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
electronic_address STRING IN BT-49

Elektronische Adresse gemäß EAS-Schema, an die die Rechnung gesendet werden soll.
electronic_scheme REFERENCE IN BT-49

Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.
seller_ident STRING IN BT-29

Eindeutige Kennung zur Identifizierung des Lieferanten beim Kunden gemäß eines ISO-Schemas.
seller_scheme REFERENCE IN BT-29

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.

Anfragedaten

{
    "line_one": "Kolpingstr. 7",
    "line_two": "Hofgeb\u00e4ude, Remise 1",
    "zipcode": "97828",
    "city": "Marktheidenfeld",
    "country": "DE",
    "contact_person": "Ing. Dr. Brandtner",
    "contact_email": "brandtner@example.com",
    "contact_phone": "+492214710200"
}

Antwort (HTTP 200 )

null

Antwort (HTTP 422 )

{
    "line_one": "Input is too long (max. 255 characters)",
    "country": "Invalid selection",
    "contact_email": "Invalid email address"
}

DELETE https://api.eu-rechnung.de/v1/debtors/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung des Kunden in unserem Systen.

Antwort (HTTP 200 )

null

4.5. Lieferantenverwaltung

GET https://api.eu-rechnung.de/v1/creditors

URL Abfrageparameter

offset INT IN

Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
limit INT IN

Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.

Datenschema

items LIST OUT

Liste der Lieferanten, die der Suchanfrage entsprechen.
- uuid UUID OUT
  
  Eindeutige Kennung des Lieferanten in unserem System.
- name STRING OUT BT-27
  
  Vollständiger Name des Lieferanten.
- line_one STRING OUT BT-35
  
  Hauptzeile der Lieferantenanschrift (Adresszeile 1).
- line_two STRING OUT BT-36
  
  Zusätzliche Zeile der Lieferantenanschrift (Adresszeile 2).
- line_three STRING OUT BT-162
  
  Zusätzliche Zeile der Lieferantenanschrift (Adresszeile 3).
- zipcode STRING OUT BT-38
  
  Postleitzahl der Lieferantenanschrift.
- city STRING OUT BT-37
  
  Stadt oder Gemeinde des Lieferanten.
- district STRING OUT BT-39
  
  Region oder Bundesland des Lieferanten.
- country REFERENCE OUT BT-40
  
  Land, in dem sich die Lieferantenanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
- contact_person STRING OUT BT-41
  
  Ansprechpartner oder Kontakt beim Lieferanten.
- contact_phone STRING OUT BT-42
  
  Telefonnummer des Kontakts beim Lieferanten.
- contact_email EMAIL OUT BT-43
  
  E-Mail-Adresse des Kontakts beim Lieferanten.
- vat_number STRING OUT BT-31
  
  Umsatzsteuer-Identifikationsnummer des Lieferanten.
- tax_number STRING OUT BT-32
  
  Örtliche Steuernummer des Lieferanten.
- legal_number STRING OUT BT-30
  
  Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
- payment_accounts LIST OUT
  
  Dem Lieferanten zugehörige Bankverbindungen (Liste zulässiger IBANs).
- booking_account STRING OUT
  
  Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Kreditorenkonto).
- creditor_number STRING OUT
  
  Eindeutige Identifikationsnummer in Ihrem System (Lieferantennummer).
- ident_number STRING OUT BT-29
  
  Eindeutige Kennung des Lieferanten gemäß eines ISO-Schemas.
- ident_scheme REFERENCE OUT BT-29
  
  Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
- electronic_address STRING OUT BT-34
  
  Elektronische Adresse gemäß EAS-Schema für Antworten zur Rechnung.
- electronic_scheme REFERENCE OUT BT-34
  
  Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.
pagination OBJECT OUT

Metadaten zur aktuellen Suchanfrage.
- offset INT OUT
  
  Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
- limit INT OUT
  
  Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.
- count INT OUT
  
  Tatsächliche Anzahl der Datensätze in der aktuellen Antwort.
- total INT OUT
  
  Gesamtzahl aller verfügbaren Datensätze über alle Seiten hinweg.

Antwort (HTTP 200 )

{
    "items": [
        {
            "uuid": "718625d6-6f70-4191-85a4-ea6c81b12129",
            "name": "Schlieper Group Verwaltungs GmbH",
            "line_one": "Silksteinweg 41",
            "line_two": "Geb\u00e4ude B, Etage 3",
            "line_three": null,
            "zipcode": "53426",
            "city": "K\u00f6nigsfeld",
            "district": null,
            "country": "DE",
            "contact_person": "Adalbert Schlieper",
            "contact_phone": "+494066969300",
            "contact_email": "kontakt@example.com",
            "vat_number": "DE999999999",
            "tax_number": "30\/123\/45678",
            "legal_number": "HRB 12345 B",
            "payment_accounts": [
                "AT022011100003429660",
                "DE02700100800030876808",
            ],
            "booking_account": "70001",
            "creditor_number": "L10010",
            "ident_number": "999999999",
            "ident_scheme": "0060",
            "electronic_address": "991-1234512345-06",
            "electronic_scheme": "0204"
        },
        (...)
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "count": 100,
        "total": 225
    }
}

GET https://api.eu-rechnung.de/v1/creditors/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung des Lieferanten in unserem Systen.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Lieferanten in unserem System.
name STRING OUT BT-27

Vollständiger Name des Lieferanten.
line_one STRING OUT BT-35

Hauptzeile der Lieferantenanschrift (Adresszeile 1).
line_two STRING OUT BT-36

Zusätzliche Zeile der Lieferantenanschrift (Adresszeile 2).
line_three STRING OUT BT-162

Zusätzliche Zeile der Lieferantenanschrift (Adresszeile 3).
zipcode STRING OUT BT-38

Postleitzahl der Lieferantenanschrift.
city STRING OUT BT-37

Stadt oder Gemeinde des Lieferanten.
district STRING OUT BT-39

Region oder Bundesland des Lieferanten.
country REFERENCE OUT BT-40

Land, in dem sich die Lieferantenanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
contact_person STRING OUT BT-41

Ansprechpartner oder Kontakt beim Lieferanten.
contact_phone STRING OUT BT-42

Telefonnummer des Kontakts beim Lieferanten.
contact_email EMAIL OUT BT-43

E-Mail-Adresse des Kontakts beim Lieferanten.
vat_number STRING OUT BT-31

Umsatzsteuer-Identifikationsnummer des Lieferanten.
tax_number STRING OUT BT-32

Örtliche Steuernummer des Lieferanten.
legal_number STRING OUT BT-30

Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
payment_accounts LIST OUT

Dem Lieferanten zugehörige Bankverbindungen (Liste zulässiger IBANs).
booking_account STRING OUT

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Kreditorenkonto).
creditor_number STRING OUT

Eindeutige Identifikationsnummer in Ihrem System (Lieferantennummer).
ident_number STRING OUT BT-29

Eindeutige Kennung des Lieferanten gemäß eines ISO-Schemas.
ident_scheme REFERENCE OUT BT-29

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
electronic_address STRING OUT BT-34

Elektronische Adresse gemäß EAS-Schema für Antworten zur Rechnung.
electronic_scheme REFERENCE OUT BT-34

Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.

Antwort (HTTP 200 )

{
    "uuid": "718625d6-6f70-4191-85a4-ea6c81b12129",
    "name": "Schlieper Group Verwaltungs GmbH",
    "line_one": "Silksteinweg 41",
    "line_two": "Geb\u00e4ude B, Etage 3",
    "line_three": null,
    "zipcode": "53426",
    "city": "K\u00f6nigsfeld",
    "district": null,
    "country": "DE",
    "contact_person": "Adalbert Schlieper",
    "contact_phone": "+494066969300",
    "contact_email": "kontakt@example.com",
    "vat_number": "DE999999999",
    "tax_number": "30\/123\/45678",
    "legal_number": "HRB 12345 B",
    "payment_accounts": [
        "AT022011100003429660",
        "DE02700100800030876808",
    ],
    "booking_account": "70001",
    "creditor_number": "L10010",
    "ident_number": "999999999",
    "ident_scheme": "0060",
    "electronic_address": "991-1234512345-06",
    "electronic_scheme": "0204"
}

GET https://api.eu-rechnung.de/v1/creditors/number

Antwort (HTTP 200 )

"L10011"

POST https://api.eu-rechnung.de/v1/creditors

Datenschema

name STRING IN BT-27

Vollständiger Name des Lieferanten.
line_one STRING IN BT-35

Hauptzeile der Lieferantenanschrift (Adresszeile 1).
line_two STRING IN BT-36

Zusätzliche Zeile der Lieferantenanschrift (Adresszeile 2).
line_three STRING IN BT-162

Zusätzliche Zeile der Lieferantenanschrift (Adresszeile 3).
zipcode STRING IN BT-38

Postleitzahl der Lieferantenanschrift.
city STRING IN BT-37

Stadt oder Gemeinde des Lieferanten.
country REFERENCE IN BT-40

Land, in dem sich die Lieferantenanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
contact_person STRING IN BT-41

Ansprechpartner oder Kontakt beim Lieferanten.
contact_phone STRING IN BT-42

Telefonnummer des Kontakts beim Lieferanten.
contact_email EMAIL IN BT-43

E-Mail-Adresse des Kontakts beim Lieferanten.
vat_number STRING IN BT-31

Umsatzsteuer-Identifikationsnummer des Lieferanten.
tax_number STRING IN BT-32

Örtliche Steuernummer des Lieferanten.
legal_number STRING IN BT-30

Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
payment_accounts LIST IN

Dem Lieferanten zugehörige Bankverbindungen (Liste zulässiger IBANs).
booking_account STRING IN

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Kreditorenkonto).
creditor_number STRING IN

Eindeutige Identifikationsnummer in Ihrem System (Lieferantennummer).
ident_number STRING IN BT-29

Eindeutige Kennung des Lieferanten gemäß eines ISO-Schemas.
ident_scheme REFERENCE IN BT-29

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
electronic_address STRING IN BT-34

Elektronische Adresse gemäß EAS-Schema für Antworten zur Rechnung.
electronic_scheme REFERENCE IN BT-34

Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.

Anfragedaten

{
    "name": "Schlieper Group Verwaltungs GmbH",
    "line_one": "Silksteinweg 41",
    "line_two": "Geb\u00e4ude B, Etage 3",
    "line_three": null,
    "zipcode": "53426",
    "city": "K\u00f6nigsfeld",
    "country": "DE",
    "contact_person": "Adalbert Schlieper",
    "contact_email": "kontakt@example.com",
    "contact_phone": "+494066969300",
    "vat_number": "DE999999999",
    "legal_number": "HRB 12345 B",
    "tax_number": "30\/123\/45678",
    "payment_accounts": [
        "AT022011100003429660",
        "DE02700100800030876808"
    ],
    "booking_account": "70001",
    "creditor_number": "L10010",
    "ident_number": "999999999",
    "ident_scheme": "0060",
    "electronic_address": "991-1234512345-06",
    "electronic_scheme": "0204"
}

Antwort (HTTP 200 )

"718625d6-6f70-4191-85a4-ea6c81b12129"

Die Rückgabe enthält die eindeutige Kennung des neu angelegten Lieferanten.

Antwort (HTTP 422 )

{
    "creditor_number": "Identifier has already been assigned",
    "name": "Input is too long (max. 255 characters)",
    "country": "Invalid selection",
    "contact_email": "Invalid email address",
    "vat_number": "Not a valid VAT ID",
    "payment_accounts": "Not a valid IBAN",
    "booking_account": "Invalid booking account"
}

POST https://api.eu-rechnung.de/v1/creditors/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung des Lieferanten in unserem Systen.

Datenschema

name STRING IN BT-27

Vollständiger Name des Lieferanten.
line_one STRING IN BT-35

Hauptzeile der Lieferantenanschrift (Adresszeile 1).
line_two STRING IN BT-36

Zusätzliche Zeile der Lieferantenanschrift (Adresszeile 2).
line_three STRING IN BT-162

Zusätzliche Zeile der Lieferantenanschrift (Adresszeile 3).
zipcode STRING IN BT-38

Postleitzahl der Lieferantenanschrift.
city STRING IN BT-37

Stadt oder Gemeinde des Lieferanten.
country REFERENCE IN BT-40

Land, in dem sich die Lieferantenanschrift befindet. Es ist die Liste ISO 3166-1 zu verwenden.
contact_person STRING IN BT-41

Ansprechpartner oder Kontakt beim Lieferanten.
contact_phone STRING IN BT-42

Telefonnummer des Kontakts beim Lieferanten.
contact_email EMAIL IN BT-43

E-Mail-Adresse des Kontakts beim Lieferanten.
vat_number STRING IN BT-31

Umsatzsteuer-Identifikationsnummer des Lieferanten.
tax_number STRING IN BT-32

Örtliche Steuernummer des Lieferanten.
legal_number STRING IN BT-30

Erteilte Nummer einer Registerstelle (Handelsregister, Vereinsregister etc.).
payment_accounts LIST IN

Dem Lieferanten zugehörige Bankverbindungen (Liste zulässiger IBANs).
booking_account STRING IN

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Kreditorenkonto).
creditor_number STRING IN

Eindeutige Identifikationsnummer in Ihrem System (Lieferantennummer).
ident_number STRING IN BT-29

Eindeutige Kennung des Lieferanten gemäß eines ISO-Schemas.
ident_scheme REFERENCE IN BT-29

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
electronic_address STRING IN BT-34

Elektronische Adresse gemäß EAS-Schema für Antworten zur Rechnung.
electronic_scheme REFERENCE IN BT-34

Verwendetes Schema für die Kennung. Es ist die Liste EAS zu verwenden.

Anfragedaten

{
    "contact_person": "Laura Brueggert",
    "contact_email": "brueggert@example.com",
    "legal_number": "HRA 137\/2990",
    "payment_accounts": [
        "AT022011100003429660",
        "DE02700100800030876808",
        "DE02100500000054540402"
    ]
}

Antwort (HTTP 200 )

null

Antwort (HTTP 422 )

{
    "contact_email": "Invalid email address",
    "payment_accounts": "Not a valid IBAN"
}

DELETE https://api.eu-rechnung.de/v1/creditors/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung des Lieferanten in unserem Systen.

Antwort (HTTP 200 )

null

4.6. Artikelverwaltung

GET https://api.eu-rechnung.de/v1/products

URL Abfrageparameter

offset INT IN

Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
limit INT IN

Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.

Datenschema

items LIST OUT

Liste der Produkte, die der Suchanfrage entsprechen.

uuid UUID OUT

Eindeutige Kennung des Produkts in unserem System.
item_number STRING OUT BT-155

Kennung des Verkäufers für den Posten (Artikelnummer).
ident_number STRING OUT BT-157

Eindeutige Kennung des Postens gemäß eines ISO-Schemas.
ident_scheme REFERENCE OUT BT-157

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
name STRING OUT BT-153

Name oder Kurzbezeichnung des Rechnungspostens.
description TEXT OUT BT-154

Beschreibung mit weiteren Einzelheiten zum Rechnungsposten.
item_measure REFERENCE OUT BT-130

Für die berechnete Menge geltende Maßeinheit. Es sind die Listen Rec 20 und Rec 21 zu verwenden.
unit_net DECIMAL OUT BT-146

Nettopreis des Einzelpostens inklusive Rabatt (bis zu 4 Nachkommastellen).
tax_rate PERCENTAGE OUT BT-152

Umsatzsteuersatz für die Rechnungsposition.
tax_category REFERENCE OUT BT-151

Umsatzsteuerkategorie für die Rechnungsposition. Es ist die Liste UNTDID 5305 zu verwenden.

tax_code ENUM OUT

Anzuwendende Besteuerungsgrundlage gemäß steuerlichem Status.
Es ist ein Wert aus folgender Liste zu verwenden (die konkrete Auswahl hängt vom Einzelfall ab):

`STD-NORMAL`	19% (normale USt.)
`STD-REDUCED`	7% (reduzierte USt.)
`AGRI-NORMAL`	7,8% (gem. § 24 UStG)
`AGRI-REDUCED`	5,5% (gem. § 24 UStG)
`ZERO`	0% (keine USt.)
`EXEMPT`	0% (USt.-Ausnahme)
`USTG-19`	0% (gem. § 19 UStG)
`USTG-13B`	0% (gem. § 13b UStG)
`USTG-25B`	0% (gem. § 25b UStG)
`INTRA`	0% (Innergemein. Lfrg.)
`EXPORT`	0% (Ausfuhrlieferung)

booking_account STRING OUT

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Erlöskonto).

pagination OBJECT OUT

Metadaten zur aktuellen Suchanfrage.
- offset INT OUT
  
  Startpunkt der Liste, wie viele Datensätze übersprungen wurden.
- limit INT OUT
  
  Maximale Anzahl der Datensätze, die pro Abfrage zurückgegeben werden.
- count INT OUT
  
  Tatsächliche Anzahl der Datensätze in der aktuellen Antwort.
- total INT OUT
  
  Gesamtzahl aller verfügbaren Datensätze über alle Seiten hinweg.

Antwort (HTTP 200 )

{
    "items": [
        {
            "uuid": "53b7ddaa-fe58-489b-beef-9c558bfdf368",
            "item_number": "1003",
            "ident_number": "4012345678901",
            "ident_scheme": "0160",
            "name": "Dienstleistung IT-Support Level 2",
            "description": "Analyse und Behebung von Systemfehlern",
            "item_measure": "HUR",
            "unit_net": 85,
            "tax_rate": 19,
            "tax_category": "S",
            "tax_code": "STD-NORMAL",
            "booking_account": "8400"
        },
        (...)
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "count": 100,
        "total": 225
    }
}

GET https://api.eu-rechnung.de/v1/products/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung des Produkts in unserem System.

Datenschema

uuid UUID OUT

Eindeutige Kennung des Produkts in unserem System.
item_number STRING OUT BT-155

Kennung des Verkäufers für den Posten (Artikelnummer).
ident_number STRING OUT BT-157

Eindeutige Kennung des Postens gemäß eines ISO-Schemas.
ident_scheme REFERENCE OUT BT-157

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
name STRING OUT BT-153

Name oder Kurzbezeichnung des Rechnungspostens.
description TEXT OUT BT-154

Beschreibung mit weiteren Einzelheiten zum Rechnungsposten.
item_measure REFERENCE OUT BT-130

Für die berechnete Menge geltende Maßeinheit. Es sind die Listen Rec 20 und Rec 21 zu verwenden.
unit_net DECIMAL OUT BT-146

Nettopreis des Einzelpostens inklusive Rabatt (bis zu 4 Nachkommastellen).
tax_rate PERCENTAGE OUT BT-152

Umsatzsteuersatz für die Rechnungsposition.
tax_category REFERENCE OUT BT-151

Umsatzsteuerkategorie für die Rechnungsposition. Es ist die Liste UNTDID 5305 zu verwenden.

tax_code ENUM OUT

Anzuwendende Besteuerungsgrundlage gemäß steuerlichem Status.
Es ist ein Wert aus folgender Liste zu verwenden (die konkrete Auswahl hängt vom Einzelfall ab):

`STD-NORMAL`	19% (normale USt.)
`STD-REDUCED`	7% (reduzierte USt.)
`AGRI-NORMAL`	7,8% (gem. § 24 UStG)
`AGRI-REDUCED`	5,5% (gem. § 24 UStG)
`ZERO`	0% (keine USt.)
`EXEMPT`	0% (USt.-Ausnahme)
`USTG-19`	0% (gem. § 19 UStG)
`USTG-13B`	0% (gem. § 13b UStG)
`USTG-25B`	0% (gem. § 25b UStG)
`INTRA`	0% (Innergemein. Lfrg.)
`EXPORT`	0% (Ausfuhrlieferung)

booking_account STRING OUT

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Erlöskonto).

Antwort (HTTP 200 )

{
    "uuid": "53b7ddaa-fe58-489b-beef-9c558bfdf368",
    "item_number": "1003",
    "ident_number": "4012345678901",
    "ident_scheme": "0160",
    "name": "Dienstleistung IT-Support Level 2",
    "description": "Analyse und Behebung von Systemfehlern",
    "item_measure": "HUR",
    "unit_net": 85,
    "tax_rate": 19,
    "tax_category": "S",
    "tax_code": "STD-NORMAL",
    "booking_account": "8400"
}

GET https://api.eu-rechnung.de/v1/products/number

Antwort (HTTP 200 )

"1004"

POST https://api.eu-rechnung.de/v1/products

Datenschema

item_number STRING IN BT-155

Kennung des Verkäufers für den Posten (Artikelnummer).
ident_number STRING IN BT-157

Eindeutige Kennung des Postens gemäß eines ISO-Schemas.
ident_scheme REFERENCE IN BT-157

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
name STRING IN BT-153

Name oder Kurzbezeichnung des Rechnungspostens.
description TEXT IN BT-154

Beschreibung mit weiteren Einzelheiten zum Rechnungsposten.
item_measure REFERENCE IN BT-130

Für die berechnete Menge geltende Maßeinheit. Es sind die Listen Rec 20 und Rec 21 zu verwenden.
unit_net DECIMAL IN BT-146

Nettopreis des Einzelpostens inklusive Rabatt (bis zu 4 Nachkommastellen).

tax_code ENUM IN

Anzuwendende Besteuerungsgrundlage gemäß steuerlichem Status.
Es ist ein Wert aus folgender Liste zu verwenden (die konkrete Auswahl hängt vom Einzelfall ab):

`STD-NORMAL`	19% (normale USt.)
`STD-REDUCED`	7% (reduzierte USt.)
`AGRI-NORMAL`	7,8% (gem. § 24 UStG)
`AGRI-REDUCED`	5,5% (gem. § 24 UStG)
`ZERO`	0% (keine USt.)
`EXEMPT`	0% (USt.-Ausnahme)
`USTG-19`	0% (gem. § 19 UStG)
`USTG-13B`	0% (gem. § 13b UStG)
`USTG-25B`	0% (gem. § 25b UStG)
`INTRA`	0% (Innergemein. Lfrg.)
`EXPORT`	0% (Ausfuhrlieferung)

booking_account STRING IN

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Erlöskonto).

Anfragedaten

{
    "item_number": "1003",
    "ident_number": "4012345678901",
    "ident_scheme": "0160",
    "item_measure": "HUR",
    "name": "Dienstleistung IT-Support Level 2",
    "description": "Analyse und Behebung von Systemfehlern",
    "unit_net": 85,
    "tax_code": "STD-NORMAL",
    "booking_account": "8400"
}

Antwort (HTTP 200 )

"53b7ddaa-fe58-489b-beef-9c558bfdf368"

Die Rückgabe enthält die eindeutige Kennung des neu angelegten Produkts.

Antwort (HTTP 422 )

{
    "item_number": "Identifier has already been assigned",
    "ident_scheme": "Invalid selection",
    "item_measure": "Invalid selection",
    "name": "Input is too long (max. 255 characters)",
    "unit_net": "Invalid numerical format",
    "tax_code": "Invalid selection",
    "booking_account": "Invalid booking account"
}

POST https://api.eu-rechnung.de/v1/products/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung des Produkts in unserem System.

Datenschema

item_number STRING IN BT-155

Kennung des Verkäufers für den Posten (Artikelnummer).
ident_number STRING IN BT-157

Eindeutige Kennung des Postens gemäß eines ISO-Schemas.
ident_scheme REFERENCE IN BT-157

Verwendetes Schema für die Kennung. Es ist die Liste ICD zu verwenden.
name STRING IN BT-153

Name oder Kurzbezeichnung des Rechnungspostens.
description TEXT IN BT-154

Beschreibung mit weiteren Einzelheiten zum Rechnungsposten.
item_measure REFERENCE IN BT-130

Für die berechnete Menge geltende Maßeinheit. Es sind die Listen Rec 20 und Rec 21 zu verwenden.
unit_net DECIMAL IN BT-146

Nettopreis des Einzelpostens inklusive Rabatt (bis zu 4 Nachkommastellen).

tax_code ENUM IN

Anzuwendende Besteuerungsgrundlage gemäß steuerlichem Status.
Es ist ein Wert aus folgender Liste zu verwenden (die konkrete Auswahl hängt vom Einzelfall ab):

`STD-NORMAL`	19% (normale USt.)
`STD-REDUCED`	7% (reduzierte USt.)
`AGRI-NORMAL`	7,8% (gem. § 24 UStG)
`AGRI-REDUCED`	5,5% (gem. § 24 UStG)
`ZERO`	0% (keine USt.)
`EXEMPT`	0% (USt.-Ausnahme)
`USTG-19`	0% (gem. § 19 UStG)
`USTG-13B`	0% (gem. § 13b UStG)
`USTG-25B`	0% (gem. § 25b UStG)
`INTRA`	0% (Innergemein. Lfrg.)
`EXPORT`	0% (Ausfuhrlieferung)

booking_account STRING IN

Zu verwendendes Buchungskonto für buchhalterische Vorgänge (Erlöskonto).

Anfragedaten

{
    "name": "Dienstleistung IT-Support Premium",
    "unit_net": 89.5,
    "booking_account": "8410"
}

Antwort (HTTP 200 )

null

Antwort (HTTP 422 )

{
    "name": "Input is too long (max. 255 characters)",
    "unit_net": "Invalid numerical format",
    "booking_account": "Invalid booking account"
}

DELETE https://api.eu-rechnung.de/v1/products/{uuid}

URL Pfadparameter

uuid UUID IN

Eindeutige Kennung des Produkts in unserem System.

Antwort (HTTP 200 )

null

4.7. Sonstiges

GET https://api.eu-rechnung.de/v1/quota

Datenschema

credits OBJECT OUT

Informationen zum Guthaben für die Umwandlung von PDF-Rechnungen.
- current_quota INT OUT
  
  Im Paket enthaltenes monatliches Guthaben.
- current_balance INT OUT
  
  Verfügbares Restguthaben für den aktuellen Abrechnungszeitraum.
- period_start DATE OUT
  
  Beginn des aktuellen Abrechnungszeitraum.
- period_end DATE OUT
  
  Ende des aktuellen Abrechnungszeitraum.
restapi OBJECT OUT

Informationen zum API-Kontingent für das Anlegen neuer Rechnungen.
- current_quota INT OUT
  
  Im Paket enthaltenes monatliches Guthaben.
- current_balance INT OUT
  
  Verfügbares Restguthaben für den aktuellen Abrechnungszeitraum.
- period_start DATE OUT
  
  Beginn des aktuellen Abrechnungszeitraum.
- period_end DATE OUT
  
  Ende des aktuellen Abrechnungszeitraum.
storage OBJECT OUT

Informationen zum verfügbaren Speicherplatz für Rechnungen.
- space_total INT OUT
  
  Größe des Speicherplatzes in Bytes.
- space_used INT OUT
  
  Verfügbarer Speicherplatz in Bytes.
- quota_usage DECIMAL OUT
  
  Prozentuale Auslastung (zwei Nachkommastellen).

Antwort (HTTP 200 )

{
    "credits": {
        "current_quota": 200,
        "current_balance": 195,
        "period_start": "2026-06-25",
        "period_end": "2026-07-24"
    },
    "restapi": {
        "current_quota": 200,
        "current_balance": 186,
        "period_start": "2026-06-25",
        "period_end": "2026-07-24"
    },
    "storage": {
        "space_total": 21474836480,
        "space_used": 6108741,
        "quota_usage": 0.03
    }
}

`xml`	XML-Rechnung (z.B.: XRechnung)
`pdf`	Hybride PDF-Rechnung (z.B.: ZUGFeRD)

Dokumentation unserer REST-API

Inhaltsübersicht

1. Allgemeine Informationen

2. REST-API verwenden

2.1. Authentifikation

2.2. HTTP-Antwortcodes

2.3. Struktur von Anfragen und Antworten

2.4. Austausch von Dokumenten

2.5. Referenzlisten gemäß EN 16931

2.6. Dokumentation der Endpunkte

3. Interne Datenobjekte

3.1. Rechnungsdaten

Schematischer Aufbau des Rechnungsobjekts

Beispiel einer vollständigen Rechnung

3.2. Konformitätsprüfung

Schematischer Aufbau der Prüfdaten

Beispiel einer Konformitätsprüfung

4. Verfügbare Endpunkte

4.1. Rechnungsausgang

/outgoingAuflistung aller vorhandenen Rechnungen im Bereich RechnungsausgangGET

URL Abfrageparameter

Datenschema

Antwort (HTTP 200 )

/outgoing/{uuid}Details der Rechnung aus dem Bereich Rechnungsausgang abrufenGET

URL Pfadparameter

Datenschema

Antwort (HTTP 200 )

/outgoing/numberAbrufen der nächsten freien Rechnungsnummer für eine neue RechnungGET

Antwort (HTTP 200 )

/outgoing/{uuid}/dataRohdaten der E-Rechnung als JSON-Objekt abrufenGET

URL Pfadparameter

/outgoing/{uuid}/invoiceDownload des E-Rechnungsdokuments der finalen RechnungGET

URL Pfadparameter

Datenschema

Antwort (HTTP 200 )

/outgoing/{uuid}/paymentAnzeige der gebuchten Zahlungen (Zahlungshistorie)GET

URL Pfadparameter

Datenschema

Antwort (HTTP 200 )

/outgoing/{uuid}/previewVorschau der Rechnung im Bearbeitungszustand als ZUGFeRD-PDFGET

URL Pfadparameter

Datenschema

Antwort (HTTP 200 )

/outgoing/{uuid}/reportAbruf der Konformitätsprüfung als JSON-Objekt oder PDF-DateiGET

URL Pfadparameter

Datenschema

Antwort (HTTP 200 )

Antwort (HTTP 202 )

/outgoing/{uuid}/xmlDownload des XML-Dokuments der finalen E-RechnungGET

URL Pfadparameter

Datenschema

Antwort (HTTP 200 )

/outgoing/{uuid}Bearbeiten der noch nicht abgeschlossenen E-RechnungPOST

URL Pfadparameter

Anfragedaten

Antwort (HTTP 200 )

Antwort (HTTP 422 )

/outgoing/{uuid}/archiveArchivieren der finalisierten E-RechnungPOST

URL Pfadparameter

Antwort (HTTP 200 )

Antwort (HTTP 409 )

/outgoing/{uuid}/cancelStornieren der finalisierten E-RechnungPOST

URL Pfadparameter

Antwort (HTTP 200 )

Antwort (HTTP 409 )

/outgoing/{uuid}/cloneErzeugen einer neuen Rechnung aus der vorhandenen RechnungPOST

URL Pfadparameter

Antwort (HTTP 200 )

/outgoing/{uuid}/correctKorrigieren der finalisierten E-Rechnung mittels Storno und KorrekturbelegPOST

URL Pfadparameter

Antwort (HTTP 200 )

Antwort (HTTP 409 )

/outgoing/{uuid}/exchangeVersand der finalen E-Rechnung per E-MailPOST

URL Pfadparameter

Datenschema

Anfragedaten

Antwort (HTTP 200 )

Antwort (HTTP 409 )

Antwort (HTTP 422 )

/outgoing/{uuid}/generateAbschließen und finales Erstellen der E-RechnungPOST