ZUGFeRD Validator is an MCP server published by de.zugferd-validator, hosted at api.zugferd-validator.de. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 7 tools, including validate_invoice, extract_xml, check_consistency, view_invoice, check_leitweg_id.
Validiert E-Rechnungen (ZUGFeRD/Factur-X, XRechnung) gegen EN 16931 mit Korrekturvorschlägen.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Validiert eine E-Rechnung (ZUGFeRD/Factur-X PDF oder XRechnung XML) gegen EN 16931 und gibt strukturierte Ergebnisse mit Korrekturvorschlägen zurück.
| Parameter | Type | Description |
|---|---|---|
| profile | string | Erwartetes Profil (optional, wird automatisch erkannt) |
| file_type * | string | 'pdf' für ZUGFeRD/Factur-X, 'xml' für XRechnung |
| file_content * | string | Base64-kodierter Inhalt der PDF- oder XML-Datei |
{
"name": "validate_invoice",
"description": "Validiert eine E-Rechnung (ZUGFeRD/Factur-X PDF oder XRechnung XML) gegen EN 16931 und gibt strukturierte Ergebnisse mit Korrekturvorschlägen zurück.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"file_content",
"file_type"
],
"properties": {
"profile": {
"enum": [
"minimum",
"basic_wl",
"basic",
"en16931",
"extended",
"xrechnung"
],
"type": "string",
"description": "Erwartetes Profil (optional, wird automatisch erkannt)"
},
"file_type": {
"enum": [
"pdf",
"xml"
],
"type": "string",
"description": "'pdf' für ZUGFeRD/Factur-X, 'xml' für XRechnung"
},
"file_content": {
"type": "string",
"description": "Base64-kodierter Inhalt der PDF- oder XML-Datei"
}
},
"additionalProperties": false
}
}Extrahiert die eingebettete XML-Datei aus einem ZUGFeRD/Factur-X PDF.
| Parameter | Type | Description |
|---|---|---|
| pdf_content * | string | Base64-kodierter Inhalt der ZUGFeRD-PDF-Datei |
{
"name": "extract_xml",
"description": "Extrahiert die eingebettete XML-Datei aus einem ZUGFeRD/Factur-X PDF.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pdf_content"
],
"properties": {
"pdf_content": {
"type": "string",
"description": "Base64-kodierter Inhalt der ZUGFeRD-PDF-Datei"
}
},
"additionalProperties": false
}
}Prüft ob die sichtbaren PDF-Daten mit den eingebetteten XML-Daten übereinstimmen.
| Parameter | Type | Description |
|---|---|---|
| pdf_content * | string | Base64-kodierter Inhalt der ZUGFeRD-PDF-Datei |
{
"name": "check_consistency",
"description": "Prüft ob die sichtbaren PDF-Daten mit den eingebetteten XML-Daten übereinstimmen.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pdf_content"
],
"properties": {
"pdf_content": {
"type": "string",
"description": "Base64-kodierter Inhalt der ZUGFeRD-PDF-Datei"
}
},
"additionalProperties": false
}
}Zeigt eine E-Rechnung lesbar an: XRechnung oder CII als XML oder eine ZUGFeRD/Factur-X-PDF. Liefert HTML der Rechnung (KoSIT-Visualisierung, bereinigt: kein Script, lädt nichts nach) und die eingebetteten Anhänge getrennt. Mit check=true kommt die Kurzfassung der Prüfung dazu. Zählt nicht aufs Prüfkontingent, hat aber ein eigenes Tageslimit. Es wird nichts gespeichert.
| Parameter | Type | Description |
|---|---|---|
| check | boolean | Zusätzlich prüfen und das Ergebnis kurz mitgeben. Standard false. |
| language | string | Sprache der Ansicht. Standard 'de'. |
| file_type * | string | 'pdf' für ZUGFeRD/Factur-X, 'xml' für XRechnung/CII |
| file_content * | string | Base64-kodierter Inhalt der PDF- oder XML-Datei |
{
"name": "view_invoice",
"description": "Zeigt eine E-Rechnung lesbar an: XRechnung oder CII als XML oder eine ZUGFeRD/Factur-X-PDF. Liefert HTML der Rechnung (KoSIT-Visualisierung, bereinigt: kein Script, lädt nichts nach) und die eingebetteten Anhänge getrennt. Mit check=true kommt die Kurzfassung der Prüfung dazu. Zählt nicht aufs Prüfkontingent, hat aber ein eigenes Tageslimit. Es wird nichts gespeichert.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"file_content",
"file_type"
],
"properties": {
"check": {
"type": "boolean",
"description": "Zusätzlich prüfen und das Ergebnis kurz mitgeben. Standard false."
},
"language": {
"enum": [
"de",
"en",
"fr"
],
"type": "string",
"description": "Sprache der Ansicht. Standard 'de'."
},
"file_type": {
"enum": [
"pdf",
"xml"
],
"type": "string",
"description": "'pdf' für ZUGFeRD/Factur-X, 'xml' für XRechnung/CII"
},
"file_content": {
"type": "string",
"description": "Base64-kodierter Inhalt der PDF- oder XML-Datei"
}
},
"additionalProperties": false
}
}Prüft eine Leitweg-ID (BT-10, Pflicht bei XRechnung an Bund, Länder und Kommunen): Aufbau, Kennzahl des Landes oder Bundes und Prüfziffer nach Modulo 97-10 (KoSIT-Formatspezifikation 2.0.2). Bei falscher oder fehlender Prüfziffer nennt die Antwort die passende ID in corrected_id. Ob die ID vergeben ist, kann nur der Auftraggeber bestätigen; ein öffentliches Verzeichnis gibt es nicht. Zählt auf kein Kontingent. Es wird nichts gespeichert.
| Parameter | Type | Description |
|---|---|---|
| language | string | Sprache der Meldungen. Standard 'de'. |
| leitweg_id * | string | Die Leitweg-ID, etwa '04011000-1234512345-06' |
{
"name": "check_leitweg_id",
"description": "Prüft eine Leitweg-ID (BT-10, Pflicht bei XRechnung an Bund, Länder und Kommunen): Aufbau, Kennzahl des Landes oder Bundes und Prüfziffer nach Modulo 97-10 (KoSIT-Formatspezifikation 2.0.2). Bei falscher oder fehlender Prüfziffer nennt die Antwort die passende ID in corrected_id. Ob die ID vergeben ist, kann nur der Auftraggeber bestätigen; ein öffentliches Verzeichnis gibt es nicht. Zählt auf kein Kontingent. Es wird nichts gespeichert.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"leitweg_id"
],
"properties": {
"language": {
"enum": [
"de",
"en",
"fr"
],
"type": "string",
"description": "Sprache der Meldungen. Standard 'de'."
},
"leitweg_id": {
"type": "string",
"maxLength": 200,
"description": "Die Leitweg-ID, etwa '04011000-1234512345-06'"
}
},
"additionalProperties": false
}
}Erstellt aus strukturierten Daten eine gültige E-Rechnung, als ZUGFeRD-PDF (PDF/A-3 mit eingebettetem XML) oder als XRechnung-XML. Unterstützt mehrere Positionen, durchlaufende Posten, Rabatte und Zuschläge, Leistungszeitraum, schon gezahlte Beträge, Steuernummer, SEPA-Lastschrift und Anlagen. Anlagen stecken Base64-kodiert in der Rechnung und machen Aufruf und Antwort groß; schicken Sie hier nur kleine. Mit Anlagen enthält die ZUGFeRD-Antwort nur pdf_base64, das XML steckt in der PDF (extract_xml holt es). Wir speichern nichts.
| Parameter | Type | Description |
|---|---|---|
| date * | string | Belegdatum (YYYY-MM-DD) |
| note | string | Freitext-Hinweis |
| buyer | object | Käufer / Rechnungsempfänger, Pflicht. Bei self_billed (389) stellen Sie als Käufer die Gutschrift aus: weglassen, dann setzen wir die Absenderdaten aus dem Konto ein. |
| lines * | array | Rechnungspositionen (mindestens eine) |
| format * | string | 'zugferd' = PDF/A-3 mit eingebettetem XML, 'xrechnung' = reines XML |
| number * | string | Belegnummer |
| seller | object | Verkäufer / Rechnungssteller. Weglassen, wenn im Konto feste Absenderdaten hinterlegt sind — sie werden dann eingesetzt. Bei self_billed (389) der Leistende, der die Gutschrift empfängt: dann immer angeben. |
| currency | string |
Erzeugt aus einer E-Rechnung einen Validierungsbericht als PDF (PDF/A-3b) zum Ablegen und Weitergeben. Der Bericht nennt Ergebnis, alle Meldungen mit Regel-ID und Feld, den Prüfzeitpunkt, Format und Profil, die SHA-256-Prüfsumme der geprüften Datei sowie die Versionen der Prüfwerkzeuge. Auf Wunsch wird die geprüfte Rechnung sichtbar angehängt. Gibt das PDF base64-kodiert zurück. Ab dem Tarif Automatisieren.
| Parameter | Type | Description |
|---|---|---|
| lang | string | Sprache des Berichts. Standard 'de'. |
| file_name | string | Dateiname, der im Bericht steht. |
| file_type * | string | Dateityp: 'pdf' für ZUGFeRD/Factur-X, 'xml' für XRechnung/CII |
| file_content * | string | Base64-kodierter Inhalt der PDF- oder XML-Datei |
| attach_source | boolean | Geprüfte Rechnung sichtbar anhängen (PDF-Seiten bzw. abgedruckter XML-Inhalt). Standard false. |
{
"name": "validation_report",
"description": "Erzeugt aus einer E-Rechnung einen Validierungsbericht als PDF (PDF/A-3b) zum Ablegen und Weitergeben. Der Bericht nennt Ergebnis, alle Meldungen mit Regel-ID und Feld, den Prüfzeitpunkt, Format und Profil, die SHA-256-Prüfsumme der geprüften Datei sowie die Versionen der Prüfwerkzeuge. Auf Wunsch wird die geprüfte Rechnung sichtbar angehängt. Gibt das PDF base64-kodiert zurück. Ab dem Tarif Automatisieren.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"file_content",
"file_type"
],
"properties": {
"lang": {
"enum": [
"de",
"en",
"fr"
],
"type": "string",
"description": "Sprache des Berichts. Standard 'de'."
},
"file_name": {
"type": "string",
"description": "Dateiname, der im Bericht steht."
},
"file_type": {
"enum": [
"pdf",
"xml"
],
"type": "string",
"description": "Dateityp: 'pdf' für ZUGFeRD/Factur-X, 'xml' für XRechnung/CII"
},
"file_content": {
"type": "string",
"description": "Base64-kodierter Inhalt der PDF- oder XML-Datei"
},
"attach_source": {
"type": "boolean",
"description": "Geprüfte Rechnung sichtbar anhängen (PDF-Seiten bzw. abgedruckter XML-Inhalt). Standard false."
}
},
"additionalProperties": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| Währung (Standard EUR) |
| due_date | string | Fälligkeitsdatum (YYYY-MM-DD) |
| issuer_id | string | Absender (Rechnungssteller) aus dem Konto, GET /v1/absender. Ohne Angabe gilt der Standard-Absender. Felder unter seller gehen vor. |
| type_code | string | Roher UNTDID-1001-Code (überschreibt document_type; für seltene Typen wie 875-877 Bauleistung) |
| self_check | boolean | Wenn true, wird die erzeugte Rechnung sofort gegen EN 16931 geprüft (langsamer). Standard: false. |
| attachments | array | Anlagen (BG-24): PDF, PNG, JPEG, CSV, XLSX oder ODS, höchstens 10 Dateien, zusammen höchstens 5 MB, jeder Dateiname nur einmal. Ab zwei Anlagen warnt die Prüfung mit CII-SR-476; die Rechnung bleibt gültig. |
| seller_logo | string | Logo als Base64 (PNG/JPG) — nur im Pro/Ultra-Tarif |
| direct_debit | object | SEPA-Lastschrift (BG-19) mit Mandatsreferenz, Gläubiger-ID und IBAN Ihres Kunden. Setzt die Zahlungsart 59; ein Empfängerkonto kommt dann nicht ins XML (BR-DE-25-b). |
| delivery_date | string | Leistungsdatum (BT-72, YYYY-MM-DD). Ohne Angabe: Ende von billing_period, bei einer Vorschussrechnung (prepayment) keins, sonst das Belegdatum. |
| document_type | string | Rechnungsart (BT-3), Standard invoice. credit_note = Rechnungskorrektur (Storno), corrected = Korrektur, self_billed = Gutschriftverfahren, prepayment = Vorschuss- oder Anzahlungsrechnung (XRechnung warnt mit BR-DE-17, die Rechnung bleibt gültig), partial = Teilrechnung, debit_note = Belastungsanzei… |
| payment_means | object | Zahlungsangaben (IBAN etc.) |
| payment_terms | string | Zahlungsbedingungen (Freitext) |
| billing_period | object | Leistungszeitraum (BG-14, BT-73/74), jeweils YYYY-MM-DD, Ende nicht vor Anfang. Ohne delivery_date gilt das Ende als Leistungsdatum (BT-72). |
| buyer_reference | string | Leitweg-ID / Käuferreferenz (BT-10, bei XRechnung Pflicht) |
| preceding_invoice | object | Bezug auf eine frühere Rechnung (BG-3, BT-25/26), etwa bei einer Rechnungskorrektur (Storno). Für mehrere Bezüge preceding_invoices, nicht beides. |
| prepaid_vat_cents | integer | Umsatzsteuer im schon gezahlten Betrag, in Cent. Nur mit prepaid_amount_cents; der Hinweis nennt dann Entgelt und Steuer des Abzugs (§ 14 Abs. 5 UStG). |
| allowances_charges | array | Rabatte/Zuschläge auf Dokumentebene |
| preceding_invoices | array | Bezüge auf frühere Rechnungen (BG-3), etwa Vorschussrechnungen, höchstens 20. Ins XML kommt in beiden Formaten nur der erste als BG-3; alle weiteren nennt der Hinweis (BT-22). |
| prepaid_amount_cents | integer | Schon gezahlt, etwa ein Vorschuss, brutto in Cent (BT-113). Wir ziehen es vom Zahlbetrag ab (BR-CO-16); höher als der Gesamtbetrag geht nicht. Dazu kommt ein Hinweis (BT-22) mit dem Abzug und den Bezügen. |
{
"name": "create_invoice",
"description": "Erstellt aus strukturierten Daten eine gültige E-Rechnung, als ZUGFeRD-PDF (PDF/A-3 mit eingebettetem XML) oder als XRechnung-XML. Unterstützt mehrere Positionen, durchlaufende Posten, Rabatte und Zuschläge, Leistungszeitraum, schon gezahlte Beträge, Steuernummer, SEPA-Lastschrift und Anlagen. Anlagen stecken Base64-kodiert in der Rechnung und machen Aufruf und Antwort groß; schicken Sie hier nur kleine. Mit Anlagen enthält die ZUGFeRD-Antwort nur pdf_base64, das XML steckt in der PDF (extract_xml holt es). Wir speichern nichts.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"format",
"number",
"date",
"lines"
],
"properties": {
"date": {
"type": "string",
"description": "Belegdatum (YYYY-MM-DD)"
},
"note": {
"type": "string",
"description": "Freitext-Hinweis"
},
"buyer": {
"type": "object",
"required": [
"name"
],
"properties": {
"zip": {
"type": "string",
"description": "Postleitzahl"
},
"city": {
"type": "string",
"description": "Ort"
},
"name": {
"type": "string",
"minLength": 1,
"description": "Firmenname / Name"
},
"email": {
"type": "string",
"description": "E-Mail / elektronische Adresse (für XRechnung Pflicht)"
},
"phone": {
"type": "string",
"description": "Telefon (Kontakt)"
},
"street": {
"type": "string",
"description": "Straße und Hausnummer"
},
"vat_id": {
"type": "string",
"description": "USt-IdNr. (z.B. DE123456789)"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO-3166 Alpha-2 Ländercode, Standard DE"
},
"contact_name": {
"type": "string",
"description": "Ansprechpartner"
}
},
"description": "Käufer / Rechnungsempfänger, Pflicht. Bei self_billed (389) stellen Sie als Käufer die Gutschrift aus: weglassen, dann setzen wir die Absenderdaten aus dem Konto ein.",
"additionalProperties": false
},
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"quantity",
"unit_net_price_cents",
"vat_rate"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Bezeichnung der Position"
},
"unit": {
"type": "string",
"description": "Einheit (UN/ECE Rec 20, Standard C62 = Stück)"
},
"quantity": {
"type": "number",
"description": "Menge"
},
"vat_rate": {
"type": "number",
"description": "USt-Satz in Prozent (0 bei Z/E/AE)"
},
"description": {
"type": "string",
"description": "Optionale Detailbeschreibung"
},
"pass_through": {
"type": "boolean",
"description": "true = durchlaufender Posten (§ 10 Abs. 1 UStG) ohne Umsatzsteuer: vat_rate 0, vat_category weglassen oder E. Im XML Kategorie E mit Grund und Code VATEX-EU-79-C. Nicht zusammen mit anderen Positionen der Kategorie E (BR-E-01). Standard false."
},
"vat_category": {
"enum": [
"S",
"Z",
"E",
"AE",
"K",
"G",
"O"
],
"type": "string",
"description": "USt-Kategorie (Standard S). Z = 0 %, E = befreit, AE = Reverse Charge, K, G. Durchlaufende Posten über pass_through."
},
"unit_net_price_cents": {
"type": "integer",
"description": "Netto-Einzelpreis in Cent"
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "Rechnungspositionen (mindestens eine)"
},
"format": {
"enum": [
"zugferd",
"xrechnung"
],
"type": "string",
"description": "'zugferd' = PDF/A-3 mit eingebettetem XML, 'xrechnung' = reines XML"
},
"number": {
"type": "string",
"minLength": 1,
"description": "Belegnummer"
},
"seller": {
"type": "object",
"required": [
"name"
],
"properties": {
"zip": {
"type": "string",
"description": "Postleitzahl"
},
"city": {
"type": "string",
"description": "Ort"
},
"name": {
"type": "string",
"minLength": 1,
"description": "Firmenname / Name"
},
"email": {
"type": "string",
"description": "E-Mail / elektronische Adresse (für XRechnung Pflicht)"
},
"phone": {
"type": "string",
"description": "Telefon (Kontakt)"
},
"street": {
"type": "string",
"description": "Straße und Hausnummer"
},
"vat_id": {
"type": "string",
"description": "USt-IdNr. (z.B. DE123456789)"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO-3166 Alpha-2 Ländercode, Standard DE"
},
"tax_number": {
"type": "string",
"description": "Steuernummer (BT-32, z.B. 21/815/08150), wenn keine USt-IdNr. vorliegt. Ohne USt-IdNr. steht sie auch als Kennung des Verkäufers im XML (BT-29), denn EN 16931 verlangt eine (BR-CO-26)."
},
"contact_name": {
"type": "string",
"description": "Ansprechpartner"
}
},
"description": "Verkäufer / Rechnungssteller. Weglassen, wenn im Konto feste Absenderdaten hinterlegt sind — sie werden dann eingesetzt. Bei self_billed (389) der Leistende, der die Gutschrift empfängt: dann immer angeben.",
"additionalProperties": false
},
"currency": {
"type": "string",
"description": "Währung (Standard EUR)"
},
"due_date": {
"type": "string",
"description": "Fälligkeitsdatum (YYYY-MM-DD)"
},
"issuer_id": {
"type": "string",
"description": "Absender (Rechnungssteller) aus dem Konto, GET /v1/absender. Ohne Angabe gilt der Standard-Absender. Felder unter seller gehen vor."
},
"type_code": {
"type": "string",
"description": "Roher UNTDID-1001-Code (überschreibt document_type; für seltene Typen wie 875-877 Bauleistung)"
},
"self_check": {
"type": "boolean",
"description": "Wenn true, wird die erzeugte Rechnung sofort gegen EN 16931 geprüft (langsamer). Standard: false."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"filename",
"content_base64"
],
"properties": {
"filename": {
"type": "string",
"description": "Dateiname mit Endung .pdf, .png, .jpg, .jpeg, .csv, .xlsx oder .ods, höchstens 100 Zeichen"
},
"description": {
"type": "string",
"description": "Beschreibung (BT-123), höchstens 200 Zeichen"
},
"content_base64": {
"type": "string",
"description": "Inhalt der Datei, Base64-kodiert"
}
},
"additionalProperties": false
},
"description": "Anlagen (BG-24): PDF, PNG, JPEG, CSV, XLSX oder ODS, höchstens 10 Dateien, zusammen höchstens 5 MB, jeder Dateiname nur einmal. Ab zwei Anlagen warnt die Prüfung mit CII-SR-476; die Rechnung bleibt gültig."
},
"seller_logo": {
"type": "string",
"description": "Logo als Base64 (PNG/JPG) — nur im Pro/Ultra-Tarif"
},
"direct_debit": {
"type": "object",
"properties": {
"creditor_id": {
"type": "string",
"description": "Ihre Gläubiger-ID (BT-90), z.B. DE98ZZZ09999999999. Fehlt sie, nehmen wir die aus dem Absenderprofil."
},
"debtor_iban": {
"type": "string",
"description": "IBAN Ihres Kunden (BT-91). Bei ZUGFeRD auch gekürzt (DE89**************3000), bei XRechnung nur voll."
},
"mandate_reference": {
"type": "string",
"description": "Mandatsreferenz (BT-89), höchstens 35 Zeichen"
}
},
"description": "SEPA-Lastschrift (BG-19) mit Mandatsreferenz, Gläubiger-ID und IBAN Ihres Kunden. Setzt die Zahlungsart 59; ein Empfängerkonto kommt dann nicht ins XML (BR-DE-25-b).",
"additionalProperties": false
},
"delivery_date": {
"type": "string",
"description": "Leistungsdatum (BT-72, YYYY-MM-DD). Ohne Angabe: Ende von billing_period, bei einer Vorschussrechnung (prepayment) keins, sonst das Belegdatum."
},
"document_type": {
"enum": [
"invoice",
"credit_note",
"corrected",
"self_billed",
"prepayment",
"partial",
"debit_note"
],
"type": "string",
"description": "Rechnungsart (BT-3), Standard invoice. credit_note = Rechnungskorrektur (Storno), corrected = Korrektur, self_billed = Gutschriftverfahren, prepayment = Vorschuss- oder Anzahlungsrechnung (XRechnung warnt mit BR-DE-17, die Rechnung bleibt gültig), partial = Teilrechnung, debit_note = Belastungsanzeige."
},
"payment_means": {
"type": "object",
"properties": {
"bic": {
"type": "string",
"description": "BIC"
},
"iban": {
"type": "string",
"description": "IBAN des Zahlungsempfängers"
},
"type_code": {
"type": "string",
"description": "BT-81: 58 = SEPA-Überweisung; für eine Lastschrift direct_debit angeben (59)."
},
"account_name": {
"type": "string",
"description": "Kontoinhaber"
}
},
"description": "Zahlungsangaben (IBAN etc.)",
"additionalProperties": false
},
"payment_terms": {
"type": "string",
"description": "Zahlungsbedingungen (Freitext)"
},
"billing_period": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string"
},
"start": {
"type": "string"
}
},
"description": "Leistungszeitraum (BG-14, BT-73/74), jeweils YYYY-MM-DD, Ende nicht vor Anfang. Ohne delivery_date gilt das Ende als Leistungsdatum (BT-72).",
"additionalProperties": false
},
"buyer_reference": {
"type": "string",
"description": "Leitweg-ID / Käuferreferenz (BT-10, bei XRechnung Pflicht)"
},
"preceding_invoice": {
"type": "object",
"required": [
"number"
],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD"
},
"number": {
"type": "string"
}
},
"description": "Bezug auf eine frühere Rechnung (BG-3, BT-25/26), etwa bei einer Rechnungskorrektur (Storno). Für mehrere Bezüge preceding_invoices, nicht beides.",
"additionalProperties": false
},
"prepaid_vat_cents": {
"type": "integer",
"description": "Umsatzsteuer im schon gezahlten Betrag, in Cent. Nur mit prepaid_amount_cents; der Hinweis nennt dann Entgelt und Steuer des Abzugs (§ 14 Abs. 5 UStG)."
},
"allowances_charges": {
"type": "array",
"items": {
"type": "object",
"required": [
"charge",
"amount_cents",
"vat_rate"
],
"properties": {
"charge": {
"type": "boolean",
"description": "true = Zuschlag, false = Rabatt (auf Dokumentebene)"
},
"reason": {
"type": "string",
"description": "Begründung"
},
"vat_rate": {
"type": "number",
"description": "Zugehöriger USt-Satz in Prozent"
},
"amount_cents": {
"type": "integer",
"description": "Betrag in Cent (positiv)"
},
"vat_category": {
"enum": [
"S",
"Z",
"E",
"AE",
"K",
"G",
"O"
],
"type": "string",
"description": "Zugehörige USt-Kategorie (Standard S)"
}
},
"additionalProperties": false
},
"description": "Rabatte/Zuschläge auf Dokumentebene"
},
"preceding_invoices": {
"type": "array",
"items": {
"type": "object",
"required": [
"number"
],
"properties": {
"date": {
"type": "string",
"description": "Datum der früheren Rechnung (BT-26, YYYY-MM-DD)"
},
"number": {
"type": "string",
"maxLength": 100,
"description": "Nummer der früheren Rechnung (BT-25), höchstens 100 Zeichen"
}
},
"additionalProperties": false
},
"description": "Bezüge auf frühere Rechnungen (BG-3), etwa Vorschussrechnungen, höchstens 20. Ins XML kommt in beiden Formaten nur der erste als BG-3; alle weiteren nennt der Hinweis (BT-22)."
},
"prepaid_amount_cents": {
"type": "integer",
"description": "Schon gezahlt, etwa ein Vorschuss, brutto in Cent (BT-113). Wir ziehen es vom Zahlbetrag ab (BR-CO-16); höher als der Gesamtbetrag geht nicht. Dazu kommt ein Hinweis (BT-22) mit dem Abzug und den Bezügen."
}
},
"additionalProperties": false
}
}