BT-44 ist der Käufername – der offizielle Name des Rechnungsempfängers. In csv2zugferd mappen Sie diesen Wert auf den YAML-Key buyer.name. Das Feld ist die elementare Empfängeridentität einer ZUGFeRD- oder XRechnung-Rechnung.
Was ist BT-44?#
BT-44 bezeichnet nach EN 16931 den Namen des Käufers, also der Organisation oder Person, an die die Rechnung adressiert ist. Es ist der rechtlich erkennbare Empfängername, nicht ein Vertriebs- oder Kurzname und nicht der Ansprechpartner.
Pflicht oder optional?#
Pflicht. Ohne Käufername ist eine Rechnung nach EN 16931 nicht konform. BT-44 muss in jeder ZUGFeRD- und XRechnung-Rechnung vorhanden und befüllt sein. Bleibt das Feld leer, schlägt die Validierung fehl.
YAML-Key in csv2zugferd#
In csv2zugferd gehört der Käufername in den buyer-Block:
buyer:
name:
column: "ACCOUNT_NAME"Die weiteren Adressfelder (postalCode, city, street, country) stehen daneben im selben Block. name ist davon unabhängig und immer erforderlich.
CSV-Beispiel#
| ACCOUNT_NAME | INVOICE_BILL_CITY | CONTACT_LASTNAME |
|---|---|---|
| Beispiel Nord GmbH | Hamburg | Schmidt |
Der Firmenname steht in ACCOUNT_NAME und wird auf BT-44 gemappt. CONTACT_LASTNAME ist der Ansprechpartner und gehört nicht in buyer.name, sondern in buyer.contact.
So landet der Wert im ZUGFeRD-XML#
buyer.name wird im ZUGFeRD-XML als Name des Käufers (BuyerTradeParty) geschrieben. Validatoren prüfen lediglich, dass das Feld vorhanden und nicht leer ist – die inhaltliche Richtigkeit des Namens liegt beim Anwender.
Typische Fehler#
- Ansprechpartner statt Firmenname gemappt, z. B.
CONTACT_LASTNAMEinbuyer.name. - Kurz- oder Vertriebsname statt des rechtlich erkennbaren Empfängernamens.
- Käufername leer, obwohl Adressdaten wie Straße und Ort vorhanden sind – das führt zu einer ungültigen Rechnung.
Praxishinweis für csv2zugferd#
buyer.name akzeptiert sowohl eine CSV-Spalte (column) als auch einen festen Wert (value). Stellen Sie nur dann einen festen Wert ein, wenn alle Rechnungen denselben Empfänger haben – im Normalfall kommt der Käufername aus der CSV.