Input schema (JSON)
{
"type": "object",
"required": [
"invoice"
],
"properties": {
"lang": {
"enum": [
"de",
"en"
],
"type": "string",
"description": "Sprache der aus den Daten gesetzten Rechnung (Beschriftungen, Zahlen- und Datumsformat). Standard: de."
},
"invoice": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"invoiceNumber",
"issueDate",
"seller",
"buyer",
"lines",
"vatBreakdown",
"totalNet",
"totalVat",
"totalGross"
],
"properties": {
"buyer": {
"type": "object",
"required": [
"name"
],
"properties": {
"gln": {
"type": "string",
"maxLength": 20
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"vatId": {
"type": "string",
"maxLength": 20
},
"address": {
"type": "object",
"default": {},
"properties": {
"city": {
"type": "string",
"maxLength": 100
},
"line1": {
"type": "string",
"maxLength": 150
},
"line2": {
"type": "string",
"maxLength": 150
},
"postalCode": {
"type": "string",
"maxLength": 20
},
"countryCode": {
"type": "string",
"default": "DE",
"maxLength": 2,
"minLength": 2
}
},
"additionalProperties": false
},
"contact": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 150
},
"email": {
"type": "string",
"maxLength": 150
},
"phone": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
},
"registrationId": {
"type": "string",
"maxLength": 60,
"description": "BT-30 (Verkäufer) / BT-47 (Käufer): Handelsregisternummer bzw. Registerkennung der Partei, z. B. \"HRB 12345, Amtsgericht München\". Nur angeben, wenn sie auf der Rechnung steht. Beim Käufer reicht sie bei Reverse Charge (Kategorie AE) statt der USt-IdNr., bei innergemeinschaftlicher Lieferung (K) nicht."
},
"electronicAddress": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"scheme": {
"type": "string",
"default": "EM",
"maxLength": 10
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"quantity",
"unitPriceNet",
"vatRatePercent",
"lineNetAmount"
],
"properties": {
"name": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"quantity": {
"type": "number"
},
"unitCode": {
"type": "string",
"default": "C62",
"maxLength": 12
},
"categoryCode": {
"type": "string",
"maxLength": 12
},
"unitPriceNet": {
"type": "number"
},
"lineNetAmount": {
"type": "number"
},
"buyerArticleId": {
"type": "string",
"maxLength": 200
},
"vatRatePercent": {
"type": "number"
},
"globalArticleId": {
"type": "string",
"maxLength": 60
},
"sellerArticleId": {
"type": "string",
"maxLength": 200
},
"allowanceCharges": {
"type": "array",
"items": {
"type": "object",
"required": [
"charge"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "BT-136/BT-141: Betrag ohne Vorzeichen. Darf fehlen, wenn percent gesetzt ist: dann gilt round2(basisAmount × percent / 100)."
},
"charge": {
"type": "boolean",
"description": "true = Zuschlag (BG-28), false = Abzug/Rabatt (BG-27)."
},
"reason": {
"type": "string",
"maxLength": 200
},
"percent": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "BT-138/BT-143: Prozentsatz, z. B. 10 für 10 % Rabatt."
},
"reasonCode": {
"type": "string",
"maxLength": 10
},
"basisAmount": {
"type": "number",
"description": "BT-137/BT-142: Grundbetrag des Prozentsatzes. Ohne Angabe Menge × unitPriceNet der Position (je Eintrag, nicht gestaffelt)."
}
},
"additionalProperties": false
},
"maxItems": 10
},
"globalArticleScheme": {
"type": "string",
"pattern": "^[0-9A-Za-z]+$",
"maxLength": 10
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"notes": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 1000
},
"subjectCode": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"maxItems": 20
},
"payee": {
"type": "object",
"required": [
"name"
],
"properties": {
"gln": {
"type": "string",
"maxLength": 20
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"registrationId": {
"type": "string",
"maxLength": 60
}
},
"additionalProperties": false
},
"seller": {
"type": "object",
"required": [
"name"
],
"properties": {
"gln": {
"type": "string",
"maxLength": 20
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"vatId": {
"type": "string",
"maxLength": 20
},
"address": {
"type": "object",
"default": {},
"properties": {
"city": {
"type": "string",
"maxLength": 100
},
"line1": {
"type": "string",
"maxLength": 150
},
"line2": {
"type": "string",
"maxLength": 150
},
"postalCode": {
"type": "string",
"maxLength": 20
},
"countryCode": {
"type": "string",
"default": "DE",
"maxLength": 2,
"minLength": 2
}
},
"additionalProperties": false
},
"contact": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 150
},
"email": {
"type": "string",
"maxLength": 150
},
"phone": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
},
"registrationId": {
"type": "string",
"maxLength": 60,
"description": "BT-30 (Verkäufer) / BT-47 (Käufer): Handelsregisternummer bzw. Registerkennung der Partei, z. B. \"HRB 12345, Amtsgericht München\". Nur angeben, wenn sie auf der Rechnung steht. Beim Käufer reicht sie bei Reverse Charge (Kategorie AE) statt der USt-IdNr., bei innergemeinschaftlicher Lieferung (K) nicht."
},
"electronicAddress": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"scheme": {
"type": "string",
"default": "EM",
"maxLength": 10
}
},
"additionalProperties": false
},
"customerAssignedId": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"dueDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"payment": {
"type": "object",
"properties": {
"bic": {
"type": "string",
"pattern": "^[A-Za-z0-9 ]*$",
"maxLength": 15
},
"iban": {
"type": "string",
"pattern": "^[A-Za-z0-9 ]*$",
"maxLength": 40
},
"terms": {
"type": "string",
"maxLength": 1000
},
"mandateId": {
"type": "string",
"maxLength": 35
},
"meansCode": {
"type": "string"
},
"reference": {
"type": "string",
"maxLength": 140
},
"creditorId": {
"type": "string",
"maxLength": 35
},
"accountName": {
"type": "string",
"maxLength": 200
},
"debitedIban": {
"type": "string",
"pattern": "^[A-Za-z0-9 ]*$",
"maxLength": 40
},
"discountDays": {
"type": "integer",
"maximum": 999,
"minimum": 0
},
"discountPercent": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"profile": {
"enum": [
"en16931",
"xrechnung"
],
"type": "string",
"default": "en16931"
},
"currency": {
"type": "string",
"default": "EUR",
"maxLength": 3,
"minLength": 3
},
"delivery": {
"type": "object",
"properties": {
"gln": {
"type": "string",
"maxLength": 20
},
"name": {
"type": "string",
"maxLength": 200
},
"address": {
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 100
},
"line1": {
"type": "string",
"maxLength": 150
},
"line2": {
"type": "string",
"maxLength": 150
},
"postalCode": {
"type": "string",
"maxLength": 20
},
"countryCode": {
"type": "string",
"maxLength": 2,
"minLength": 2
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"totalNet": {
"type": "number"
},
"totalVat": {
"type": "number"
},
"issueDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"costCenter": {
"type": "string",
"maxLength": 60
},
"paidAmount": {
"type": "number",
"minimum": 0
},
"totalGross": {
"type": "number"
},
"deliveryDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"vatBreakdown": {
"type": "array",
"items": {
"type": "object",
"required": [
"ratePercent",
"basisAmount",
"taxAmount"
],
"properties": {
"taxAmount": {
"type": "number"
},
"basisAmount": {
"type": "number"
},
"ratePercent": {
"type": "number"
},
"categoryCode": {
"type": "string",
"default": "S",
"maxLength": 12
},
"exemptionReason": {
"type": "string",
"maxLength": 500
},
"exemptionReasonCode": {
"type": "string",
"maxLength": 30
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1
},
"invoiceNumber": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"buyerReference": {
"type": "string",
"maxLength": 80
},
"invoicingPeriod": {
"type": "object",
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"additionalProperties": false
},
"taxCurrencyCode": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"allowanceCharges": {
"type": "array",
"items": {
"type": "object",
"required": [
"charge"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "BT-92/BT-99: Betrag ohne Vorzeichen. Darf fehlen, wenn percent gesetzt ist: dann gilt round2(basisAmount × percent / 100)."
},
"charge": {
"type": "boolean",
"description": "true = Zuschlag (BG-21), false = Abzug/Nachlass (BG-20)."
},
"reason": {
"type": "string",
"maxLength": 200
},
"percent": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "BT-94/BT-101: Prozentsatz, z. B. 2 für 2 % Nachlass."
},
"reasonCode": {
"type": "string",
"maxLength": 10
},
"basisAmount": {
"type": "number",
"description": "BT-93/BT-100: Grundbetrag des Prozentsatzes. Ohne Angabe die Summe der lineNetAmount aller Positionen mit ratePercent (bei gemischten Kategorien desselben Satzes nur die mit categoryCode)."
},
"ratePercent": {
"type": "number",
"description": "BT-96/BT-103: Steuersatz in Prozent. Darf beim Prozent-Eintrag ohne basisAmount fehlen, wenn alle Positionen denselben Satz haben."
},
"categoryCode": {
"type": "string",
"default": "S",
"maxLength": 12
}
},
"additionalProperties": false
},
"maxItems": 50
},
"documentTypeCode": {
"type": "string",
"default": "380"
},
"projectReference": {
"type": "string",
"maxLength": 200
},
"contractReference": {
"type": "string",
"maxLength": 200
},
"despatchAdviceRef": {
"type": "string",
"maxLength": 200
},
"receivingAdviceRef": {
"type": "string",
"maxLength": 200
},
"deliveryCountryCode": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"precedingInvoiceDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"totalVatInTaxCurrency": {
"type": "number"
},
"precedingInvoiceNumber": {
"type": "string",
"maxLength": 60
},
"purchaseOrderReference": {
"type": "string",
"maxLength": 60
}
},
"description": "Strukturierte Rechnungsdaten nach EN 16931 (wird gegen Schema und Geschäftsregeln geprüft).",
"additionalProperties": false
},
"filename": {
"type": "string",
"description": "Dateiname der erzeugten Rechnung (Standard: invoice.pdf)."
},
"logo_mime": {
"enum": [
"image/png",
"image/jpeg",
"image/svg+xml"
],
"type": "string",
"description": "Optional; der Typ wird sonst aus dem Inhalt erkannt."
},
"upload_id": {
"type": "string",
"description": "Referenz auf eine zuvor über request_upload_link hochgeladene Datei, anstelle von pdf_base64. Höchstens eines von beiden angeben."
},
"pdf_base64": {
"type": "string",
"description": "Optional: die visuelle Rechnungs-PDF, Base64-kodiert (max. 25 MB). In sie wird das CII-XML eingebettet. Alternativ 'upload_id' angeben. Ohne beides wird die Rechnung aus den Daten gesetzt. Chat-Clients, die eine angehängte Datei nicht zuverlässig als Base64 übergeben können, rufen zuerst request_upload_link auf.",
"contentEncoding": "base64",
"contentMediaType": "application/pdf"
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"filename",
"data_base64"
],
"properties": {
"filename": {
"type": "string"
},
"mime_type": {
"type": "string",
"description": "Optional; wird sonst aus der Dateiendung abgeleitet."
},
"data_base64": {
"type": "string",
"description": "Dateiinhalt, Base64-kodiert (max. 10 MB).",
"contentEncoding": "base64"
},
"description": {
"type": "string",
"description": "Optionale Beschreibung der rechnungsbegründenden Unterlage (BT-123), z. B. \"Stundennachweis März 2026\". Ohne Angabe steht dort der Dateiname."
}
},
"additionalProperties": false
},
"description": "Optionale Anhänge (z. B. Stundennachweise). Erlaubt: PDF, PNG, JPEG, CSV, XLSX, ODS, XML; je max. 10 MB."
},
"logo_base64": {
"type": "string",
"description": "Optionales Logo für die aus den Daten gesetzte Rechnung (nur ohne PDF): PNG, JPEG oder SVG, Base64-kodiert oder als data:-URI, max. 500 KB. Steht rechts oben im Kopf. SVG nur ohne Skripte und ohne Verweise auf andere Dateien.",
"contentEncoding": "base64"
}
},
"additionalProperties": false
}