Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > agorum core Module und Plugins > Dokument | E-Rechnung
Normalisierte Daten für die E-Rechnung
Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins Dokument | E-Rechnung. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Die folgende Tabelle enthält eine Liste der normalisierten Daten, die in agorum core für die E-Rechnung verwendet werden.
Eingehende E-Rechnungen werden analysiert und die vorhandenen Daten werden unabhängig vom E-Rechnungsformat in die normalisierten Daten (agorum-Metadaten) überführt.
Umgekehrt werden die normalisierten Daten für das Erstellen einer E-Rechnung verwendet. Nicht alle Daten müssen für die Rechnungserstellung zwingend angegeben werden. Die Validierung der E-Rechnung meldet fehlende Daten im Rahmen der Vorgaben (siehe dazu Rechnungsinhalte und Pflichtfelder).
Sie finden eine Beispiel-JSON-Datei im Plugin-Ordner unter test/data/completeDataStructure.json, eine kleine vollständige Rechnung unter test/data/EN16931_COMPLIANT/minimal_json.json.
Die Spalte BT-Feld nennt das Geschäftsfeld der EN 16931 (Business Term), auf das ein Feld abgebildet wird. Felder mit „–“ sind agorum-interne Felder oder Erweiterungen, die in der E-Rechnung nicht oder nur im ZUGFeRD-Profil EXTENDED geschrieben werden. Welche Felder Pflicht sind, zeigt der Vergleich der Pflichtfelder in den E-Rechnungsformaten.
Hinweis: Einige Felder gibt es seit Version 1.1.0 von agorum core accounting in einer neuen Fassung mit der Endung _v2, etwa document_payment_discount_amount_v2, document_tax_point_date_<n>_v2 oder document_delivery_postalcode_v2. Verwenden Sie bei Neuentwicklungen die _v2-Felder. Wo ein altes Feld noch ausgewertet wird, ist das in der Tabelle vermerkt.
Codelisten: Gültige Werte für Codelisten-Felder finden Sie in den Referenzen am Ende der Seite: Dokumenttyp-Codes, Zahlungsarten, Steuerkategorien und Einheiten.
Allgemeine Rechnungsdaten
| Name | BT-Feld | Beschreibung | Typ (ggf. Formatmaske) | Beispiel |
|---|---|---|---|---|
| Allgemeine Dokumentinformationen | ||||
| agorum_accounting_document_number | BT-1 | Rechnungsnummer | STRING | RG-12345678 |
| agorum_accounting_document_type_code | BT-3 | Dokumenttyp-Code | STRING | Typische Werte sind:
|
| agorum_accounting_document_date | BT-2 | Rechnungsdatum | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_due_date | BT-9 | Fälligkeitsdatum. Beim Erstellen im CII-/ZUGFeRD-Format Rückfall, wenn agorum_accounting_document_payment_due_date nicht gesetzt ist | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_tax_point_date | (BT-7) | Steuerzeitpunkt (Kopffeld). Wird im CII-/ZUGFeRD-Format nicht geschrieben und gemeldet; verwenden Sie agorum_accounting_document_tax_point_date_<n>_v2 | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_currency | BT-5 | Währung | STRING | EUR |
| agorum_accounting_document_copy_indicator | – | Dokumentkopie-Indikator (agorum-intern / XRechnung-Extension) | BOOLEAN | false |
| agorum_accounting_document_function_code | BT-24 | Spezifikationskennung. Im UBL-Format (XRechnung, Peppol) als CustomizationID geschrieben und damit übersteuerbar; für Peppol BIS Billing 3.0: urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0. Im CII-/ZUGFeRD-Format bestimmen Format und Profil den Wert | STRING | urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0 |
| agorum_accounting_document_invoice_type | – | Rechnungs-Format (agorum-intern, kein BT) | STRING | UBL |
| agorum_accounting_document_is_credit_note | – | Ist eine Gutschrift (agorum-intern, kein BT) | BOOLEAN | false |
| agorum_accounting_document_note | BT-22 | Notiz | STRING | Beispielnotiz |
| Rechnungsinformationen | ||||
| agorum_accounting_document_version_id | BT-23 | Geschäftsprozesskennung (Profil-ID). Im UBL-Format als ProfileID geschrieben; ohne Angabe gilt der Wert aus dem Beispiel | STRING | urn:fdc:peppol.eu:2017:poacc:billing:01:1.0 |
| agorum_accounting_document_business_process_id | BT-23 | Geschäftsprozesskennung im CII-/ZUGFeRD-Format. Schlüssel in den Rechnungsdaten, kein Metadatum; ohne Angabe gilt der Wert aus dem Beispiel | STRING | urn:fdc:peppol.eu:2017:poacc:billing:01:1.0 |
| agorum_accounting_document_procuring_project_id | BT-11 | Projektkennung des Käufers (Vergabeprojekt); Schlüssel in den Rechnungsdaten | STRING | PROJ-2026-17 |
| agorum_accounting_document_invoice_currency | BT-5 | Rechnungswährung | STRING | EUR |
| agorum_accounting_document_invoice_period_from_date | BT-73 | Rechnungsperiode von | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_invoice_period_until_date | BT-74 | Rechnungsperiode bis | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_contract_reference | BT-12 | Vertragsreferenz | STRING | CR-20231234 |
| agorum_accounting_document_referenced_number | BT-25 | Referenznummer (vorausgegangene Rechnung); beim Erstellen nur ausgewertet, wenn agorum_accounting_document_billing_reference nicht gesetzt ist | STRING | DOC-REF-12345 |
| agorum_accounting_document_direction | – | Richtung (agorum-intern IN/OUT, kein BT) | STRING | IN |
| agorum_accounting_document_invoice_with_positions | – | Rechnung mit Positionen (agorum-intern, kein BT) | BOOLEAN | true |
| Kundendaten | ||||
| agorum_accounting_document_customer_attn | BT-56 | Zu Händen an / Ansprechpartner | STRING | Buchhaltung |
| agorum_accounting_document_customer_city | BT-52 | Stadt | STRING | Stuttgart |
| agorum_accounting_document_customer_country | BT-55 | Land | STRING | DE |
| agorum_accounting_document_customer_fax | – | Fax (kein BT im EN16931-Kern) | STRING | +49 89 87654321 |
| agorum_accounting_document_customer_house_number | (BT-50) | Hausnummer (Teil der Adresszeile BT-50) | STRING | 37 |
| agorum_accounting_document_customer_legal_registration_id | BT-47 | Handelsregisternummer | STRING | BI123456 |
| agorum_accounting_document_customer_mail | BT-58 | E-Mail des Kontakts | STRING | customer@example.com |
| agorum_accounting_document_customer_mobile | – | Mobiltelefon (kein BT im EN16931-Kern) | STRING | +49 171 9876543 |
| agorum_accounting_document_customer_name | BT-44 | Kundenname | STRING | Käufer AG |
| agorum_accounting_document_customer_number | BT-46 | Kundennummer / Debitorennummer | STRING | |
| agorum_accounting_document_customer_phone | BT-57 | Telefon | STRING | +49 89 9876543 |
| agorum_accounting_document_customer_post_office | – | Postfach (kein BT). Wird im CII-/ZUGFeRD-Format derzeit nicht in die E-Rechnung geschrieben | STRING | Postfach 123 |
| agorum_accounting_document_customer_state | BT-54 | Bundesland des Kunden | STRING | NRW |
| agorum_accounting_document_customer_street | BT-50 | Straße (Adresszeile 1) | STRING | Beispielstraße |
| agorum_accounting_document_customer_add_street | – | Adresszusatz; im CII-/ZUGFeRD-Format als Adresszeile 2 (BT-36 bzw. BT-51) geschrieben, im UBL-Format nicht – dort _additional_street verwenden | STRING | |
| agorum_accounting_document_customer_url | – | Webseite (kein BT). Wird im CII-/ZUGFeRD-Format nicht in die E-Rechnung geschrieben | STRING | https://www.example.com |
| agorum_accounting_document_customer_vat_id | BT-48 | Umsatzsteuer-ID | STRING | DE987654321 |
| agorum_accounting_document_customer_vat_type | – | Umsatzsteuer-Typ (agorum-intern, kein BT) | STRING | VAT |
| agorum_accounting_document_customer_zip | BT-53 | PLZ | STRING | 80331 |
| agorum_accounting_document_customer_additional_street | BT-51 | Zusätzliche Straßenadresse des Kunden (Adresszeile 2) | STRING | im Hinterhof |
| agorum_accounting_document_customer_care_of | – | c/o-Zusatz der Anschrift (kein BT). Im CII-/ZUGFeRD-Format als CareOf in der Anschrift, nur im Profil EXTENDED | STRING | Buchhaltung |
| agorum_accounting_document_customer_endpoint_id | BT-49 | Endpunkt-ID des Kunden, elektronische Adresse des Kunden; Pflicht für XRechnung CII/ZUGFeRD | STRING | customer@example.com |
| agorum_accounting_document_customer_trading_business_name | BT-45 | Handelsname des Kunden | STRING | Käufer Trading |
| agorum_accounting_document_customer_tax_registrations | BT-48/BT-* | Liste mehrerer Steuer-Registrierungen des Käufers | Array von Steuerregistrierungen (vat_id, vat_type) | siehe Liste der Steuer-Registrierungen |
| Abweichende Kundendaten | ||||
| agorum_accounting_document_product_end_user_name | – | Kundenname (ZUGFeRD-Extended, kein EN16931-Kern-BT) | STRING | |
| agorum_accounting_document_product_end_user_street | – | Straße (ZUGFeRD-Extended) | STRING | |
| agorum_accounting_document_product_end_user_add_street | – | Erweiterung Straße (ZUGFeRD-Extended) | STRING | |
| agorum_accounting_document_product_end_user_house_number | – | Hausnummer (ZUGFeRD-Extended) | STRING | |
| agorum_accounting_document_product_end_user_city | – | Stadt (ZUGFeRD-Extended) | STRING | |
| agorum_accounting_document_product_end_user_zip | – | Postleitzahl (ZUGFeRD-Extended) | STRING | |
| agorum_accounting_document_product_end_user_country | – | Land (ZUGFeRD-Extended) | STRING | |
| agorum_accounting_document_product_end_user_state | – | Bundesland (ZUGFeRD-Extended) | STRING | |
| agorum_accounting_document_invoicee_… | – | Abweichender Rechnungsempfänger (nur ZUGFeRD-Profil EXTENDED, im Profil EN 16931 ausgelassen und gemeldet). Schlüssel mit den Endungen _number, _name, _care_of, _contact_name, _contact_department, _attn, _phone, _mobile, _fax, _mail, _street, _add_street, _add_street_2 bis _4, _house_number, _post_office, _zip, _city, _state, _country, _endpoint_id, _endpoint_scheme_id. Schlüssel in den Rechnungsdaten; als Metadaten nur, sofern agorum core accounting sie bereitstellt | STRING | |
| Lieferantendaten | ||||
| agorum_accounting_document_supplier_assigned_account_id | BT-29 | Lieferantenidentifikation (vom Käufer vergebene Kreditorennummer) | STRING | 123456789 |
| agorum_accounting_document_supplier_attn | BT-41 | Zu Händen an / Ansprechpartner | STRING | Buchhaltung |
| agorum_accounting_document_supplier_bic | BT-86 | BIC Lieferant (Zahlungsempfänger-Institut) | STRING | BICCODEXXX |
| agorum_accounting_document_supplier_care_of | – | c/o-Zusatz der Anschrift (kein BT). Im CII-/ZUGFeRD-Format als CareOf in der Anschrift, nur im Profil EXTENDED | STRING | Buchhaltung |
| agorum_accounting_document_supplier_city | BT-37 | Lieferantenstadt | STRING | München |
| agorum_accounting_document_supplier_contact_name | BT-41 | Kontaktperson (Ansprechpartner) | STRING | |
| agorum_accounting_document_supplier_contact_department | BT-41 | Abteilung (Teil von BT-41) | STRING | |
| agorum_accounting_document_supplier_country | BT-40 | Lieferantenland | STRING | DE |
| agorum_accounting_document_supplier_fax | – | Lieferantenfax (kein BT im EN16931-Kern) | STRING | +49 89 87654321 |
| agorum_accounting_document_supplier_house_number | (BT-35) | Lieferantenhausnummer (Teil der Adresszeile BT-35) | STRING | 1 |
| agorum_accounting_document_supplier_iban | BT-84 | IBAN Lieferant (Empfängerkonto) | STRING | |
| agorum_accounting_document_supplier_identifier | BT-29 | Lieferantenidentifikation (GlobalID mit Schema) | STRING | |
| agorum_accounting_document_supplier_identifier_id | BT-29 | Lieferantenidentifikation-ID (Schema-ID) | STRING | |
| agorum_accounting_document_supplier_legal_registration_id | BT-30 | Handelsregister-/Registrierungsnummer des Lieferanten | STRING | HRB 234567 |
| agorum_accounting_document_supplier_mail | BT-43 | E-Mail des Kontakts | STRING | supplier@example.com |
| agorum_accounting_document_supplier_mobile | – | Mobiltelefon (kein BT im EN16931-Kern) | STRING | +49 170 1234567 |
| agorum_accounting_document_supplier_name | BT-27 | Lieferantenname | STRING | Musterfirma |
| agorum_accounting_document_supplier_phone | BT-42 | Telefon des Kontakts | STRING | +49 89 12345678 |
| agorum_accounting_document_supplier_post_office | – | Postfach (kein BT). Wird im CII-/ZUGFeRD-Format derzeit nicht in die E-Rechnung geschrieben | STRING | Postfach 123 |
| agorum_accounting_document_supplier_state | BT-39 | Bundesland des Lieferanten. Wird im CII-/ZUGFeRD-Format derzeit nicht in die E-Rechnung geschrieben | STRING | |
| agorum_accounting_document_supplier_street | BT-35 | Straße (Adresszeile 1) | STRING | Musterstraße |
| agorum_accounting_document_supplier_add_street | – | Adresszusatz; im CII-/ZUGFeRD-Format als Adresszeile 2 (BT-36 bzw. BT-51) geschrieben, im UBL-Format nicht – dort _additional_street verwenden | STRING | |
| agorum_accounting_document_supplier_url | – | Webseite (kein BT). Wird im CII-/ZUGFeRD-Format nicht in die E-Rechnung geschrieben | STRING | https://www.example.com |
| agorum_accounting_document_supplier_vat_id | BT-31 | Umsatzsteuer-ID | STRING | DE987654321 |
| agorum_accounting_document_supplier_vat_type | – | Umsatzsteuer-Typ (agorum-intern, kein BT) | STRING | VAT |
| agorum_accounting_document_supplier_zip | BT-38 | PLZ | STRING | 12345 |
| agorum_accounting_document_supplier_number | – | Lieferantennummer (agorum-intern, kein BT) | STRING | SUP-12345 |
| agorum_accounting_document_supplier_endpoint_id | BT-34 | Elektronische Adresse des Lieferanten, Pflicht für XRechnung CII/ZUGFeRD | STRING | supplier@example.com |
| agorum_accounting_document_supplier_trading_business_name | BT-28 | Handelsname des Lieferanten | STRING | Muster Trading |
| agorum_accounting_document_supplier_tax_registrations | BT-31/BT-32 | Liste mehrerer Steuer-Registrierungen des Lieferanten (z. B. USt-IdNr. + Steuernummer) | Array von Steuerregistrierungen (vat_id, vat_type) | siehe Liste der Steuer-Registrierungen |
| Zahlungsinformationen | ||||
| agorum_accounting_document_payment_bank | BT-85 | Bank / Kontoinhaber | STRING | Commerzbank |
| agorum_accounting_document_payment_bic | BT-86 | BIC | STRING | COBADEFXXX |
| agorum_accounting_document_payment_date | – | Bezahldatum (agorum-intern, kein BT) | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_payment_details | BT-82 | Zahlungsdetails / Zahlungsmethode in Textform | STRING | |
| agorum_accounting_document_payment_discount_amount | – | Skontobetrag (Abzug vom Zahlbetrag) | DOUBLE ("#,###,##0.00##") | 10.0 |
| agorum_accounting_document_payment_discount_due_date | – | Zahlungsziel für Skonto; im CII-/ZUGFeRD-Format für die Skontogruppe ausgewertet (nur EXTENDED) | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_payment_discount_rate | – | Skontobetrag Prozentsatz | DOUBLE ("#,###,##0.####") | 1.0 |
| agorum_accounting_document_payment_iban | BT-84 | IBAN | STRING | DE89370400440532013000 |
| agorum_accounting_document_payment_marker | – | Bezahlt (agorum-intern, kein BT) | BOOLEAN | false |
| agorum_accounting_document_payment_means | – | Container-Feld (agorum-intern, kein BT). Enthält eine Liste von Zahlungsbedingungen, deren Einträge BT-84, BT-85, BT-86 und BT-81 tragen. | Array von Zahlungsbedingungen | siehe Liste der Zahlungsbedingungen |
| agorum_accounting_document_payment_terms | – | Container-Feld (agorum-intern, kein BT). Enthält eine Liste von Zahlungsfristen, deren Einträge auf BT-9 bzw. BT-20 abgebildet werden. | Array von Zahlungsfristen | siehe Liste der Zahlungsfristen |
| agorum_accounting_document_payment_method | BT-81 | Zahlmethode (Code UNCL4461) | STRING | 59; für eine Liste der möglichen Werte siehe Payment means code (UNCL4461) |
| agorum_accounting_document_payment_penalty_terms | – | Verzugskosten-Hinweis als Freitext. Hat im CII-/ZUGFeRD-Format kein Ziel, wird nicht geschrieben und unter suppressed gemeldet. Die Verzugsgruppe (nur EXTENDED) entsteht aus document_payment_penalty_basis_amount_v2 in den Zahlungsfristen | STRING | 1 |
| agorum_accounting_document_payment_recharging | – | Weiterverrechnung (agorum-intern, kein BT) | STRING | Metadaten "weiterverrechnen" (furtherRecharging) oder "weiterverrechnet" (recharged) |
| agorum_accounting_document_payment_reference_id | BT-83 | Verwendungszweck. Im CII-/ZUGFeRD-Format als PaymentReference geschrieben; fehlt das Feld, wird der erste Eintrag aus agorum_accounting_document_payment_means mit Verwendungszweck verwendet | STRING | PAY-REF-123456 |
| agorum_accounting_document_payment_status | – | Zahlstatus (agorum-intern, kein BT). Wird im CII-/ZUGFeRD-Format nicht in die E-Rechnung geschrieben; im UBL-Format landet er als Zahlungskanal-Code in der Rechnung – für UBL-Rechnungen leer lassen. | STRING | Paid |
| agorum_accounting_document_due_payable_amount | BT-115 | Fälliger Zahlungsbetrag | DOUBLE ("#,###,##0.00##") | 226 |
| Steuerinformationen | ||||
| agorum_accounting_document_tax_currency_code | (BT-6) | Abweichende Steuerwährung. Wird derzeit nicht in die E-Rechnung geschrieben, weil dazu auch BT-111 (Steuerbetrag in Buchungswährung) nötig wäre, das noch nicht unterstützt wird; eine Angabe wird gemeldet | STRING | EUR |
| agorum_accounting_document_tax_total_amount | BT-110 | Gesamtsteuerbetrag in Rechnungswährung | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_tax_id_1 | BT-118 | Steuer-ID 1 (Kategorie-Code, z. B. 'S') | STRING | S |
| agorum_accounting_document_tax_id_2 | BT-118 | Steuer-ID 2 (Kategorie-Code) | STRING | S |
| agorum_accounting_document_tax_id_3 | BT-118 | Steuer-ID 3 (Kategorie-Code) | STRING | S |
| agorum_accounting_document_tax_rate_1 | BT-119 | Steuersatz 1 | DOUBLE ("#,###,##0.####") | 19 |
| agorum_accounting_document_tax_rate_2 | BT-119 | Steuersatz 2 | DOUBLE ("#,###,##0.####") | 7 |
| agorum_accounting_document_tax_rate_3 | BT-119 | Steuersatz 3 | DOUBLE ("#,###,##0.####") | |
| agorum_accounting_document_tax_schema_id_1 | – | Steuer-Schema-ID 1 (agorum-intern, Scheme VAT/FC) | STRING | VAT |
| agorum_accounting_document_tax_schema_id_2 | – | Steuer-Schema-ID 2 (agorum-intern) | STRING | VAT |
| agorum_accounting_document_tax_schema_id_3 | – | Steuer-Schema-ID 3 (agorum-intern) | STRING | VAT |
| agorum_accounting_document_total_tax_amount_1 | BT-117 | Summe Steuerbetrag 1 pro USt-Kategorie | DOUBLE ("#,###,##0.00##") | 380 |
| agorum_accounting_document_total_tax_amount_2 | BT-117 | Summe Steuerbetrag 2 pro USt-Kategorie | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_total_tax_amount_3 | BT-117 | Summe Steuerbetrag 3 pro USt-Kategorie | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_total_tax_exemption_notice | BT-120 | Hinweis zur Steuerbefreiung (Grund in Textform) | STRING | Hinweis |
| agorum_accounting_document_total_tax_rate_1 | BT-119 | Steuersatz 1 pro Aufgliederung | DOUBLE ("#,###,##0.####") | 19.0 |
| agorum_accounting_document_total_tax_rate_2 | BT-119 | Steuersatz 2 pro Aufgliederung | DOUBLE ("#,###,##0.####") | |
| agorum_accounting_document_total_tax_rate_3 | BT-119 | Steuersatz 3 pro Aufgliederung | DOUBLE ("#,###,##0.####") | |
| agorum_accounting_document_total_tax_exemption_reason_1 | BT-120 | Steuerbefreiungs-Grund 1 (Textform) | STRING | |
| agorum_accounting_document_total_tax_exemption_reason_2 | BT-120 | Steuerbefreiungs-Grund 2 (Textform) | STRING | |
| agorum_accounting_document_total_tax_exemption_reason_3 | BT-120 | Steuerbefreiungs-Grund 3 (Textform) | STRING | |
| agorum_accounting_document_total_tax_exemption_reason_code_1 | BT-121 | Steuerbefreiungs-Code 1 | STRING | |
| agorum_accounting_document_total_tax_exemption_reason_code_2 | BT-121 | Steuerbefreiungs-Code 2 | STRING | |
| agorum_accounting_document_total_tax_exemption_reason_code_3 | BT-121 | Steuerbefreiungs-Code 3 | STRING | |
| agorum_accounting_document_tax_point_date_1 | BT-7 | Steuerzeitpunkt zu Steuersatz 1 (neu: _v2). BT-7 wird nur einmal je Rechnung geschrieben: der erste belegte Wert, weitere werden gemeldet | STRING | |
| agorum_accounting_document_tax_point_date_2 | BT-7 | Steuerzeitpunkt zu Steuersatz 2 (neu: _v2) | STRING | |
| agorum_accounting_document_tax_point_date_3 | BT-7 | Steuerzeitpunkt zu Steuersatz 3 (neu: _v2) | STRING | |
| Versandinformationen | ||||
| agorum_accounting_document_shipping_date | – | Versanddatum (agorum-intern / kein EN16931-Kern-BT; Lieferdatum → BT-72) | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_shipping_instructions | – | Versandanweisungen (agorum-intern, kein BT) | STRING | Vorsicht Glas |
| agorum_accounting_document_shipping_location | – | Versandort (agorum-intern, kein BT) | STRING | LOC-123 |
| agorum_accounting_document_shipping_method | – | Versandmethode (agorum-intern, kein BT) | STRING | Ground |
| Frachtkosten | ||||
| agorum_accounting_document_logistics_service_charge_description | – | Beschreibung (ZUGFeRD-Extended, kein Kern-BT) | STRING | |
| agorum_accounting_document_logistics_service_charge_amount | – | Betrag (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_logistics_service_charge_tax_schema_id | – | Steuerklassifizierung (ZUGFeRD-Extended) | STRING | |
| agorum_accounting_document_logistics_service_charge_tax_id | – | Steuer-ID (ZUGFeRD-Extended) | STRING | |
| agorum_accounting_document_logistics_service_charge_tax_rate | – | Gesamtsteuersatz (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.####") | |
| Lieferinformationen | ||||
| agorum_accounting_document_delivery_address | BT-75 | Lieferadresse (Adresszeile 1) | STRING | Lieferstraße 1 |
| agorum_accounting_document_delivery_add_address | BT-76 | Erweiterung Lieferadresse (Adresszeile 2) | STRING | |
| agorum_accounting_document_delivery_city | BT-77 | Lieferstadt | STRING | Musterstadt |
| agorum_accounting_document_delivery_conditions | – | Lieferbedingungen (agorum-Extension, kein Kern-BT) | STRING | DAP |
| agorum_accounting_document_delivery_date | BT-72 | Lieferdatum / Datum der Leistungserbringung | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_delivery_method | – | Liefermethode (agorum-Extension, kein Kern-BT) | STRING | Air |
| agorum_accounting_document_delivery_note_number | BT-16 | Lieferscheinnummer / Versandanzeige | STRING | DN-20231234 |
| agorum_accounting_document_delivery_party | BT-70 | Lieferpartei / Name Warenempfänger | STRING | Name |
| agorum_accounting_document_delivery_place | BT-71 | Lieferort (Kennung Lieferanschrift) | STRING | Lieferort |
| agorum_accounting_document_delivery_postcalcode | BT-78 | Liefer-PLZ (historische Schreibweise; neu: agorum_accounting_document_delivery_postalcode_v2, das alte Feld wird beim Erstellen weiterhin gelesen). Ohne Postleitzahl wird keine Lieferanschrift geschrieben. | STRING | 54321 |
| agorum_accounting_document_delivery_country | BT-80 | Lieferland | STRING | DE |
| agorum_accounting_document_delivery_state | BT-79 | Bundesland der Lieferung | STRING | NRW |
| Dienstleistungsinformationen | ||||
| agorum_accounting_document_service_date | BT-72 | Leistungsdatum (Ende) / Lieferdatum | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_service_start | BT-73 | Leistungsbeginn / Beginn Abrechnungszeitraum | DATE | 2023-11-01T10:00:00.000Z |
| Bestellinformationen | ||||
| agorum_accounting_document_order_date | – | Bestelldatum (kein separates Kern-BT; BestelldatumsAngabe wird ggf. über BT-13/BT-14 abgebildet) | DATE | 2023-11-01T10:00:00.000Z |
| agorum_accounting_document_order_number | BT-13 | Bestellnummer (Auftragsnummer Käufer) | STRING | ORD-20231234 |
| agorum_accounting_document_receipt_date | – | Empfangsdatum (agorum-intern, kein Kern-BT) | DATE | 2023-11-01T10:00:00.000Z |
| Projekte und Referenzen | ||||
| agorum_accounting_document_buyer_reference_number | BT-10 | Käuferreferenznummer / Leitweg-ID | STRING | 90000000-03083-72 |
| agorum_accounting_document_project_reference | – | Projektreferenz (allgemeines agorum-Feld; für BT-11 ist procuring_project_id zu verwenden) |
STRING | PROJ-12345 |
| agorum_accounting_document_sales_reference | BT-14 | Verkaufsreferenz / Auftragsnummer Verkäufer | STRING | SALES-REF-12345 |
| agorum_accounting_document_reference_goods_receipt_notification | BT-15 | Wareneingangsreferenz / Empfangsbestätigung | STRING | GRN-12345 |
| agorum_accounting_document_tender_reference | BT-17 | Ausschreibungs-/Angebotsreferenz | STRING | TEND-REF-54321 |
| agorum_accounting_document_billing_reference | BT-25 | Zugehörige (vorausgegangene) Rechnung | STRING | |
| Beträge | ||||
| agorum_accounting_document_tax_basis_total_amount | BT-109 | Steuerbemessungsgrundlage Gesamtbetrag / Nettobetrag Rechnung | DOUBLE ("#,###,##0.00##") | 200.0 |
| agorum_accounting_document_total_add_amount | BT-108 | Gesamtsumme aller Zuschläge auf Rechnungsebene | DOUBLE ("#,###,##0.00##") | 20.0 |
| agorum_accounting_document_total_add_rate | – | Zuschlag in Prozent (kein Kern-BT auf Rechnungsebene) | DOUBLE ("#,###,##0.####") | 2.0 |
| agorum_accounting_document_total_allowance_charge_amount | – | Gesamtbetrag der Zulagen und Gebühren (ZUGFeRD-Extended, Summe BT-107 + BT-108) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_total_deposit_fee_information_amount | – | Gesamtbetrag der Einzahlungsgebühreninformationen (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_total_discount_amount | BT-107 | Rabattbetrag (Gesamtsumme aller Nachlässe auf Rechnungsebene) | DOUBLE ("#,###,##0.00##") | 10.0 |
| agorum_accounting_document_total_discount_information_amount | – | Gesamtbetrag der Rabattinformationen (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_total_discount_rate | – | Rabatt in Prozent (kein Kern-BT auf Rechnungsebene) | DOUBLE ("#,###,##0.####") | 1.0 |
| agorum_accounting_document_total_discountable_amount | BT-106 (UBL) | Gesamtbetrag rabattierbar / Summe der Nettoeinzelbeträge | DOUBLE ("#,###,##0.00##") | 200.0 |
| agorum_accounting_document_total_gross_amount | BT-112 | Gesamtbruttobetrag | DOUBLE ("#,###,##0.00##") | 200.0 |
| agorum_accounting_document_total_net_amount | BT-106 (CII) / BT-109 (UBL) | Summe Nettoeinzelbeträge ALLER Positionen (BT-109 ist tax_basis_total_amount) |
DOUBLE ("#,###,##0.00##") | 200.0 |
| agorum_accounting_document_total_net_amount_1 | BT-116 | Netto pro USt-Kategorie 1 | DOUBLE ("#,###,##0.00##") | 200.0 |
| agorum_accounting_document_total_net_amount_2 | BT-116 | Netto pro USt-Kategorie 2 | DOUBLE ("#,###,##0.00##") | 200.0 |
| agorum_accounting_document_total_net_amount_3 | BT-116 | Netto pro USt-Kategorie 3 | DOUBLE ("#,###,##0.00##") | 200.0 |
| agorum_accounting_document_total_prepaid_amount | BT-113 | Vorausbezahlter Gesamtbetrag | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_total_retail_value_information_amount | – | Gesamtbetrag der Einzelhandelswertinformationen (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_retail_value_excluding_tax_information_amount | – | Einzelhandelswert ohne Steuerinformationsbetrag (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_rounding_amount | BT-114 | Rundungsbetrag | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_gross_line_total_amount | – | Bruttozeilen-Gesamtbetrag (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_information_amount | – | Informationsbetrag (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_net_including_taxes_line_total_amount | – | Netto-Gesamtbetrag inklusive Steuern (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_net_line_total_amount | – | Nettozeilen-Gesamtbetrag (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| agorum_accounting_document_product_value_excluding_tobacco_tax_information_amount | – | Produktwert ohne Tabaksteuerinformationsbetrag (ZUGFeRD-Extended) | DOUBLE ("#,###,##0.00##") | |
| Teilrechnungen | ||||
| agorum_accounting_document_billing_references | BT-25/BT-26 | Teilrechnungen (Liste vorausgegangener Rechnungen) | Array von Teilrechnungen | siehe Teilrechnungen |
| Positionsliste/Artikelinformationen | ||||
| agorum_accounting_document_item_list | BG-25 | Positionen (Business Group der Rechnungspositionen) | Array von Rechnungspositionen | siehe Rechnungspositionsliste |
| Zu- und Abschläge | ||||
| agorum_accounting_document_addition_discount_list | BG-20/BG-21 | Zu- und Abschläge auf Rechnungsebene | Array von Zuschlägen/Abschlägen | siehe Abschlagsliste/Zuschlagsliste |
| Sonstiges | ||||
| agorum_accounting_document_accounting_cost | BT-19 | Kontierungshinweis / Kosten | STRING | |
| Kommentarliste | ||||
| agorum_accounting_document_notes | BG-1 (BT-21, BT-22) | Kommentare / Rechnungs-Notizen mit Betreffcode | Array von Kommentaren | siehe Kommentarliste |
Positionsliste/Artikelinformationen
Die Positionsliste kann folgende normalisierte Daten enthalten:
| Name | BT-Feld | Beschreibung | Typ (ggf. Formatmaske) | Beispiel |
|---|---|---|---|---|
| number | BT-126 | Position (Zeilennummer) | STRING | 2 |
| unit | BT-130 | Einheit | STRING | DAY, siehe Unit-Werte |
| quantity | BT-129 | Menge | DOUBLE ("#,###,##0.####") | 5 |
| item_id | BT-155 | ID / Artikelnummer Verkäufer | STRING | item-0002 |
| invoice_period_until_date | BT-135 | Rechnungsperiode bis Datum / Ende Zeitraum Position | DATE | 2023-11-01T10:00:00.000Z |
| description | BT-153 | Beschreibung / Kurzbezeichnung | STRING | Produktname |
| invoice_period_from_date | BT-134 | Rechnungsperiode von Datum / Beginn Zeitraum Position | DATE | 2023-11-01T10:00:00.000Z |
| net_price | BT-146 | Einzelpreis netto (Nettopreis inkl. Rabatt) | DOUBLE ("#,###,##0.00##") | 200.0 |
| gross_price | BT-148 | Einzelpreis brutto / Bruttopreis (Listenpreis) | DOUBLE ("#,###,##0.00##") | 238.0 |
| gross_amount | – | Bruttobetrag Position (ZUGFeRD-Extended, kein Kern-BT) | DOUBLE ("#,###,##0.00##") | 1190.0 |
| net_amount | – | Nettobetrag der Position. Bei der Vorprüfung für UBL Pflicht, wird dort aber nicht in die XML geschrieben; im CII-Format zusätzlich als Nettobetrag geschrieben (nur EXTENDED). BT-131 entsteht in beiden Syntaxen aus line_total_amount. Wird in der Plausibilitätsprüfung mit quantity × net_price verglichen. Geben Sie net_amount und line_total_amount mit demselben Wert an. |
DOUBLE ("#,###,##0.00##") | 1000.0 |
| invoice_currency | BT-5 | Währung (identisch zu Rechnung) | STRING | EUR |
| tax_rate | BT-152 | Steuersatz Position | DOUBLE ("#,###,##0.####") | 19 |
| article_number | BT-155 | Artikelnummer Verkäufer | STRING | art-B |
| tax_amount | – | Steuerbetrag der Position (kein Kern-BT auf Positionsebene) | DOUBLE ("#,###,##0.00##") | 190.0 |
| order_number | – | Bestellnummer der Position (kein Kern-BT auf Positionsebene) | STRING | BESTELL-20231234 |
| delivery_note_number | – | Lieferscheinnummer der Position (kein Kern-BT auf Positionsebene) | STRING | LIEFER-20231234 |
| article_number_according_schema | – | Artikelnummer nach Schema. Die ISO-Postenkennung (BT-157) wird über item_id_schema abgebildet. |
STRING | LIST-B |
| article_identification_buyer | BT-156 | Artikelnummer Käufer | STRING | B-200 |
| item_classification_identifier | BT-158 | Artikelklassifizierungscode | STRING | B-200 |
| customer_data | – | Kundendaten (agorum-intern, kein BT) | STRING | |
| additional_description | BT-154 | Zusätzliche Beschreibung Position | STRING | Version Pro |
| country_of_origin | BT-159 | Ursprungsland | STRING | DE |
| line_total_amount | BT-131 | Gesamtbetrag der Zeile (Nettobetrag Position) | DOUBLE ("#,###,##0.00##") | |
| tax_type | – | Steuer-Typ (Teil der TaxCategory-Struktur, kein eigenes BT) | STRING | VAT |
| tax_category | BT-151 | Steuer-Kategorie Position | STRING | S |
| addition_discount_list | BG-27/BG-28 | Zu- und Abschläge auf Positionsebene | Array von Zuschlägen/Abschlägen | siehe Abschlagsliste/Zuschlagsliste |
| note | BT-127 | Notiz zur Position (Freitext) | STRING | |
| item_id_schema | BT-157 | Schema der Artikel-ID (mit BT-157) | STRING | |
| order_reference | BT-132 | Referenznummer Käufer für die Rechnungsposition | STRING | |
| add_description | BT-154 | Zusatzbeschreibung Position | STRING | |
| discount_description | BT-139 | Rabattbeschreibung / Grund Nachlass Position (Textform) | STRING | |
| shipping_location | – | Versandort (kein Kern-BT auf Positionsebene) | STRING | 12345 |
| delivery_party | – | Lieferpartei (kein Kern-BT auf Positionsebene; nur BG-13 auf Rechnungsebene) | STRING | Standort 1 |
| delivery_address | – | Lieferadresse Position (kein Kern-BT auf Positionsebene) | STRING | Lieferstraße 19 |
| delivery_postalcode | – | Liefer-PLZ Position (kein Kern-BT auf Positionsebene) | STRING | 10115 |
| delivery_city | – | Lieferstadt Position (kein Kern-BT auf Positionsebene) | STRING | Berlin |
| delivery_state | – | Lieferbundesland Position (kein Kern-BT auf Positionsebene) | STRING | NRW |
| delivery_country | – | Lieferland Position (kein Kern-BT auf Positionsebene) | STRING | DE |
Die möglichen Werte für Unit sind:
- DAY (Tag)
- EA (Stück)
- HUR (Stunde(n))
- MIN (Minute(n))
- C62 (Einheiten)
- KGM (Kilogramm)
- LTR (Liter)
- MTR (Meter)
- KWH (Kilowattstunde)
- GRM (Gramm)
- MMT (Millimeter)
- MTK (Quadratmeter)
- MTQ (Kubikmeter)
- LBR (Pfund)
- FTQ (Kubikfuß)
- INQ (Kubikzoll)
- GLL (Gallone)
- MGM (Milligramm)
- MLT (Milliliter)
- MC (Tausend)
- PR (Paar)
- PK (Packung)
- SET (Satz)
Abschlagsliste/Zuschlagsliste
Die Abschlagsliste oder Zuschlagsliste kann folgende normalisierte Daten enthalten. Auf Rechnungsebene gelten die Nachlass-BTs BT-92–BT-98 bzw. Zuschlag-BTs BT-99–BT-105; auf Positionsebene gelten BT-136–BT-140 (Nachlass) bzw. BT-141–BT-145 (Zuschlag). Ob es sich um einen Nachlass oder einen Zuschlag handelt, entscheidet charge_indicator.
| Name | BT-Feld | Beschreibung | Typ (ggf. Formatmaske) | Beispiel |
|---|---|---|---|---|
| amount | BT-92 / BT-99 (Rechn.) BT-136 / BT-141 (Pos.) |
Betrag Nachlass / Zuschlag | DOUBLE ("#,###,##0.00##") | 609.5 |
| charge_indicator | – | Zuschlag (true) oder Nachlass (false) – Marker, kein eigenes BT | BOOLEAN | false |
| description | BT-97 / BT-104 (Rechn.) BT-139 / BT-144 (Pos.) |
Beschreibung / Grund in Textform | STRING | Abschlag |
| vat_amount_1 | – | Betrag 1 (agorum-intern, kein BT) | DOUBLE ("#,###,##0.00##") | |
| vat_amount_2 | – | Betrag 2 (agorum-intern, kein BT) | DOUBLE ("#,###,##0.00##") | |
| vat_amount_3 | – | Betrag 3 (agorum-intern, kein BT) | DOUBLE ("#,###,##0.00##") | |
| vat_basis_amount | BT-93 / BT-100 (Rechn.) BT-137 / BT-142 (Pos.) |
Basisbetrag zur Berechnung | DOUBLE ("#,###,##0.00##") | |
| vat_basis_amount_1 | BT-93 / BT-100 | Basisbetrag 1 (pro USt-Kategorie) | DOUBLE ("#,###,##0.00##") | |
| vat_basis_amount_2 | BT-93 / BT-100 | Basisbetrag 2 | DOUBLE ("#,###,##0.00##") | |
| vat_basis_amount_3 | BT-93 / BT-100 | Basisbetrag 3 | DOUBLE ("#,###,##0.00##") | |
| vat_category_1 | BT-95 / BT-102 | USt-Kategorie 1 | STRING | S |
| vat_category_2 | BT-95 / BT-102 | USt-Kategorie 2 | STRING | S |
| vat_category_3 | BT-95 / BT-102 | USt-Kategorie 3 | STRING | S |
| vat_rate_1 | BT-96 / BT-103 | USt-Prozent 1 | DOUBLE ("#,###,##0.####") | 19 |
| vat_rate_2 | BT-96 / BT-103 | USt-Prozent 2 | DOUBLE ("#,###,##0.####") | 7 |
| vat_rate_3 | BT-96 / BT-103 | USt-Prozent 3 | DOUBLE ("#,###,##0.####") | 0 |
| vat_type_1 | – | Typ 1 (agorum-intern, Scheme VAT/FC) | STRING | VAT |
| vat_type_2 | – | Typ 2 (agorum-intern) | STRING | VAT |
| vat_type_3 | – | Typ 3 (agorum-intern) | STRING | VAT |
Liste der Zahlungsbedingungen
Eine Rechnung kann mehrere Zahlungsbedingungen, einschließlich unterschiedlicher Bankverbindungen, enthalten. Beim Auslesen einer Rechnung wird die erste Zahlungsbedingung sowohl den allgemeinen Rechnungsdaten als auch als erster Eintrag in der Liste der Zahlungsbedingungen zugeordnet. Die übrigen Zahlungsbedingungen werden ausschließlich in die Liste der Zahlungsbedingungen aufgenommen.
Beim Erstellen einer Rechnung müssen alle Zahlungsbedingungen in die Metadatenliste der Zahlungsbedingungen (payment_means) integriert werden, um sie korrekt den entsprechenden Feldern der XRechnung zuzuordnen.
Beim Erstellen einer Rechnung müssen alle Zahlungsbedingungen in die Metadatenliste der Zahlungsbedingungen (payment_means) integriert werden, um sie korrekt den entsprechenden Feldern der XRechnung zuzuordnen.
| Name | BT-Feld | Beschreibung | Typ (ggf. Formatmaske) | Beispiel |
|---|---|---|---|---|
| document_payment_due_date | BT-9 | Zahlungsziel / Fälligkeitsdatum | DATE |
2023-12-02T10:00:00.000Z
|
| document_payment_method | BT-81 | Zahlmethode (Code UNCL4461) | STRING | 59; für eine Liste der möglichen Werte siehe Payment means code (UNCL4461) |
| document_payment_status | – | Zahlstatus (agorum-intern, kein BT) | STRING | Pending |
| document_payment_date | – | Bezahldatum (agorum-intern, kein BT) | DATE | 2023-11-20T10:00:00.000Z |
| document_payment_iban | BT-84 | IBAN | STRING | DE02700100800030876808 |
| document_payment_bic | BT-86 | BIC | STRING | PBNKDEFF |
| document_payment_bank | BT-85 | Bank / Kontoinhaber | STRING | Testbank |
| document_payment_recharging | – | Weiterverrechnung (agorum-intern, kein BT) | STRING | Metadaten "weiterverrechnen" (furtherRecharging) oder "weiterverrechnet" (recharged) |
| document_payment_marker | – | Bezahlt (agorum-intern, kein BT) | BOOLEAN | true |
| document_payment_reference_id | BT-83 | Zahlungsreferenz-ID / Verwendungszweck | STRING | PAY-REF-654321 |
Liste der Zahlungsfristen
Eine Rechnung kann mehrere Einträge zu Zahlungsfristen (payment_terms) enthalten.
| Name | BT-Feld | Beschreibung | Typ (ggf. Formatmaske) | Beispiel |
|---|---|---|---|---|
| document_payment_due_date | BT-9 | Fälligkeitsdatum | DATE | |
| document_payment_details | BT-82 | Zahlungsdetails / Zahlungsmethode in Textform | STRING | |
| document_payment_discount_amount | – | Rabattbetrag / Skonto (DEPRECATED ab 1.1.0; bitte document_payment_discount_amount_v2 verwenden) |
STRING | |
| document_payment_discount_rate | – | Rabattprozentsatz / Skonto (DEPRECATED ab 1.1.0; bitte document_payment_discount_rate_v2 verwenden) |
STRING | |
| document_payment_discount_basis_amount | – | Rabattbasisbetrag / Skonto-Bemessungsgrundlage (DEPRECATED ab 1.1.0; bitte document_payment_discount_basis_amount_v2 verwenden) |
STRING | |
| document_payment_penalty_terms | – | Strafbedingungen / Verzugskosten-Hinweis | STRING | 5 |
| document_payment_penalty_basis_amount | – | Strafbasisbetrag / Verzugskosten-Bemessungsgrundlage (DEPRECATED ab 1.1.0; bitte document_payment_penalty_basis_amount_v2 verwenden) |
STRING | |
| document_due_date | BT-9 | Fälligkeitsdatum (alternativ) | DATE |
Kommentarliste
Die Kommentarliste kann Einträge mit folgendem Inhalt enthalten:
| Name | BT-Feld | Beschreibung | Typ (ggf. Formatmaske) | Beispiel |
|---|---|---|---|---|
| subject_code | BT-21 | Kommentartyp / Kodierter Betreff der Rechnungsnotiz | STRING | AAI, für eine Liste der möglichen Werte siehe Text subject code qualifier |
| comment | BT-22 | Kommentar / Rechnungsnotiz (Freitext) | STRING | Gutschrift zu Rechnungsnummer XXX |
Teilrechnungen
Die Liste der Teilrechnungen kann Rechnungsreferenzen mit folgendem Inhalt enthalten:
| Name | BT-Feld | Beschreibung | Typ (ggf. Formatmaske) | Beispiel |
|---|---|---|---|---|
| invoice_number | BT-25 | Nummer einer vorausgegangenen Rechnung | STRING |
Liste der Steuer-Registrierungen
Eine Rechnung kann je Partei (Lieferant, Käufer) mehrere Steuer-Registrierungen enthalten (z. B. zusätzlich zur USt-IdNr. eine örtliche Steuernummer). Die Einträge der Listen agorum_accounting_document_supplier_tax_registrations und agorum_accounting_document_customer_tax_registrations haben folgenden Aufbau:
| Name | BT-Feld | Beschreibung | Typ (ggf. Formatmaske) | Beispiel |
|---|---|---|---|---|
| vat_id | BT-31 / BT-32 / BT-48 | Steuer-Identifikation (USt-IdNr. beim Verkäufer → BT-31, Steuernummer → BT-32, USt-IdNr. beim Käufer → BT-48) | STRING | DE198023952 |
| vat_type | – | Typ der Registrierung (agorum-intern, kein BT): üblich VAT (Umsatzsteuer-ID) oder FC (Fiscal Code / Steuernummer) |
STRING | VAT |
Referenz: Dokumenttyp-Codes (UNTDID 1001)
Der Dokumenttyp (agorum_accounting_document_type_code, BT-3) bestimmt, ob eine Rechnung, Gutschrift oder Korrektur entsteht. Dokument | E-Rechnung kennt die folgenden 29 Codes und zeigt sie mit Bezeichnung an, etwa in der PDF-Ansicht. Die Spalte UBL-Dokument nennt das Wurzelelement, das im UBL-Format entsteht; im CII-Format wird nur der Code geschrieben.
Hinweis: Die Funktionen der Bibliothek prüfen Codewerte nicht. Ein unbekannter Code wird unverändert in die XML geschrieben und erst vom KoSIT-Validator gemeldet – im Workflow-Knoten E-Rechnung aus normalisierten Daten erstellen also vor der Erstellung, bei direktem Aufruf von createInvoice erst bei einer anschließenden Prüfung. Bieten Sie in Eingabemasken deshalb nur gültige Codes zur Auswahl an. Für Auswahlfelder steht der Datahandler agorum_electronic_invoicing_document_type bereit.
| Code | Bezeichnung | UBL-Dokument |
|---|---|---|
| 130 | Rechnungsdatenblatt | Invoice |
| 202 | Verkürzte Baurechnung | Invoice |
| 203 | Vorläufige Baurechnung | Invoice |
| 204 | Baurechnung | Invoice |
| 211 | Zwischen-(abschlags-)rechnung | Invoice |
| 325 | Proformarechnung | Invoice |
| 326 | Teilrechnung | Invoice |
| 380 | Rechnung (Standardfall) | Invoice |
| 381 | Gutschriftanzeige | CreditNote |
| 383 | Belastungsanzeige | Invoice |
| 384 | Rechnungskorrektur | CreditNote |
| 385 | Konsolidierte Rechnung | Invoice |
| 386 | Vorauszahlungsrechnung | Invoice |
| 387 | Mietrechnung | Invoice |
| 388 | Steuerrechnung | Invoice |
| 389 | Gutschrift (Selbst ausgestellte Rechnung) | Invoice |
| 390 | Delkredere-Rechnung | Invoice |
| 393 | Inkasso-Rechnung | Invoice |
| 394 | Leasing-Rechnung | Invoice |
| 395 | Konsignationsrechnung | Invoice |
| 396 | Inkasso-Gutschrift | CreditNote |
| 456 | Belastungsanzeige | Invoice |
| 457 | Storno einer Belastung | Invoice |
| 458 | Storno einer Gutschrift | Invoice |
| 575 | Rechnung des Versicherers | Invoice |
| 623 | Speditionsrechnung | Invoice |
| 633 | Hafenkostenrechnung | Invoice |
| 780 | Frachtrechnung | Invoice |
| 935 | Zollrechnung | Invoice |
In der Praxis genügen meist 380, 381, 384 und 389. Bei 381 und 384 geben Sie die Bezugsrechnung in agorum_accounting_document_billing_reference (BT-25) an. Die Formate XRechnung und Peppol lassen nicht alle Codes zu; der KoSIT-Validator meldet unzulässige Codes.
Referenz: Zahlungsarten (UNCL 4461)
Die Zahlungsart steht in agorum_accounting_document_payment_method bzw. je Zahlungsweg in document_payment_method der Liste agorum_accounting_document_payment_means (BT-81). Dokument | E-Rechnung kennt folgende 21 Codes mit Bezeichnung:
| Code | Bezeichnung |
|---|---|
| 10 | Bargeld |
| 20 | Scheck |
| 30 | Überweisung (nicht-SEPA) |
| 31 | Überweisung in Raten |
| 32 | SEPA-Überweisung |
| 33 | SEPA-Echtzeitüberweisung |
| 40 | Lastschrift (nicht-SEPA) |
| 41 | SEPA-Lastschrift |
| 42 | Basislastschrift |
| 43 | Firmenlastschrift (B2B-Lastschrift) |
| 48 | Bankkarte |
| 49 | Lastschrift (nicht-SEPA) |
| 50 | Kartenzahlung |
| 51 | Kreditkarte |
| 52 | Debitkarte |
| 57 | Dauerauftrag |
| 58 | SEPA-Überweisung (häufigster Code für Überweisungen) |
| 59 | SEPA-Lastschrift |
| 60 | Elektronische Geldbörse (E-Wallet) |
| 97 | Sonstige Zahlungsmethode |
| 99 | Keine Zahlungsmethode erforderlich |
Hinweis: Angaben zum SEPA-Lastschriftmandat (Mandatsreferenz BT-89, Gläubiger-ID BT-90) werden derzeit nicht unterstützt. Für Lastschriften (59) kann eine E-Rechnung deshalb nur ohne diese Angaben erstellt werden.
Referenz: Steuerkategorien (UNCL 5305)
Die Steuerkategorie steht je Position in tax_category (BT-151), je Steuersatz in agorum_accounting_document_tax_id_1 bis _3 (BT-118) und bei Zu- und Abschlägen in vat_category_1 bis _3. Die EN 16931 lässt folgende Werte zu; das Plugin reicht den Wert ungeprüft durch.
| Code | Bedeutung | Hinweis |
|---|---|---|
| S | Normaler Steuersatz | Standardfall, z. B. 19 % oder 7 % |
| Z | Nullsatz | steuerpflichtig mit 0 % |
| E | Steuerbefreit | Befreiungsgrund angeben |
| AE | Umkehr der Steuerschuldnerschaft (Reverse Charge) | Steuersatz 0; Befreiungsgrund, etwa VATEX-EU-AE |
| K | Innergemeinschaftliche Lieferung | Steuersatz 0; Befreiungsgrund, etwa VATEX-EU-IC |
| G | Ausfuhr in Drittländer | Steuersatz 0; Befreiungsgrund, etwa VATEX-EU-G |
| O | Nicht steuerbar | keine Steuer; Befreiungsgrund angeben |
| L | Kanarische Inseln (IGIC) | regionale Steuer |
| M | Ceuta und Melilla (IPSI) | regionale Steuer |
Den Befreiungsgrund geben Sie je Steuersatz auf Rechnungsebene an: als Code (VATEX-Codeliste) in agorum_accounting_document_total_tax_exemption_reason_code_1 bis _3 (BT-121) und als Text in agorum_accounting_document_total_tax_exemption_reason_1 bis _3 (BT-120). Auf Positionsebene gibt es kein eigenes Feld für den Befreiungsgrund. Eine Rechnung kann höchstens drei verschiedene Steuersätze bzw. -kategorien enthalten.
Elektronische Adressen (Endpoint-IDs) und Peppol
Für Pflicht- und Peppol-konforme Rechnungen sind die elektronischen Adressen von Lieferant und Käufer zentrale Felder:
| Name | BT-Feld | Beschreibung | Typ | Beispiel |
|---|---|---|---|---|
| agorum_accounting_document_supplier_endpoint_id | BT-34 | Elektronische Adresse des Lieferanten. Pflicht für XRechnung CII und ZUGFeRD. Die Kennung ohne Präfix eintragen (z. B. DE198023952); das Schema (z. B. 9930) gehört im CII-/ZUGFeRD-Format in das Feld agorum_accounting_document_supplier_endpoint_scheme_id. |
STRING | lieferant@domain.de |
| agorum_accounting_document_customer_endpoint_id | BT-49 | Elektronische Adresse des Käufers. Bei B2G die Leitweg-ID; Pflicht für XRechnung CII und ZUGFeRD. Die Kennung ohne Präfix eintragen; das Schema (z. B. 0204) gehört im CII-/ZUGFeRD-Format in das Feld agorum_accounting_document_customer_endpoint_scheme_id. |
STRING | kunde@domain.de |
| agorum_accounting_document_supplier_endpoint_scheme_id agorum_accounting_document_customer_endpoint_scheme_id agorum_accounting_document_invoicee_endpoint_scheme_id |
BT-34-1 / BT-49-1 | Schema der elektronischen Adresse als Code der EAS-Codeliste. Ohne Angabe wird EM (E-Mail) geschrieben, auch wenn der Wert keine E-Mail-Adresse ist. Wirkt nur im CII-/ZUGFeRD-Format; das UBL-Format (XRechnung UBL, Peppol) schreibt immer EM. Ab Version 1.1.0 von Dokument | E-Rechnung; als Metadatenfelder ab agorum core accounting 1.2.0. | STRING | 0204 |
Hinweis: Die Vorprüfung mit checkRequiredFields verlangt die elektronischen Adressen nur für die CII-Formate. Die Geschäftsregeln von XRechnung und Peppol schreiben sie auch für UBL vor; fehlen sie, meldet das der KoSIT-Validator.
Verbreitete Schema-Codes (EAS-Codeliste):
9930– Deutschland: USt-IdNr.0204– Deutschland: Leitweg-ID (B2G)0184– Dänemark: CVR0192– Norwegen: Organisationsnummer0009– Frankreich: SIRET0088– GLN (Global Location Number)EM– E-Mail-Adresse (nicht für Peppol)