↓ Zum Hauptinhalt springen
csv2zugferd

docs

BT-155 Verkäufer-Artikelnummer in ZUGFeRD richtig mappen

BT-155 ist die Verkäufer-Artikelnummer in ZUGFeRD und XRechnung. So mappen Sie sie in csv2zugferd auf lineItems.fields.sellerAssignedId – mit CSV-Beispiel und typischen Fehlern.

BT-155 ist die Verkäufer-Artikelnummer – die vom Verkäufer vergebene, eindeutige Kennung eines Artikels. In csv2zugferd mappen Sie sie auf lineItems.fields.sellerAssignedId, nicht in die Bezeichnungs- oder Beschreibungsfelder.

Was ist BT-155?
#

BT-155 (Item Seller’s identifier) ist die Artikelnummer, unter der der Verkäufer das Produkt führt. Sie identifiziert die Position eindeutig und maschinenlesbar – im Unterschied zur lesbaren Positionsbezeichnung BT-153.

Pflicht oder optional?
#

Optional nach EN 16931. In der Praxis ist BT-155 aber wertvoll: Der Empfänger kann die Position über die Artikelnummer automatisiert in ERP, Warenwirtschaft oder DMS zuordnen. Wo eine Artikelnummer existiert, sollte sie gesetzt werden.

YAML-Key in csv2zugferd
#

lineItems:
  fields:
    name:
      column: "PRODUCT_NAME"
    sellerAssignedId:
      column: "PRODUCT_CODE"
    description:
      column: "PRODUCT_DESCRIPTION"

sellerAssignedId entspricht BT-155. name (BT-153) bleibt für den lesbaren Namen reserviert, description für echte Artikelbeschreibungen.

CSV-Beispiel
#

PRODUCT_NAME_0PRODUCT_CODE_0PRODUCT_DESCRIPTION_0
Demo Software 9 Light Lizenz00210Einzelplatz, 12 Monate

PRODUCT_CODE_0 (00210) ist die Verkäufer-Artikelnummer und wird auf BT-155 gemappt. Der lesbare Name steht in PRODUCT_NAME_0, die Beschreibung in PRODUCT_DESCRIPTION_0.

So landet der Wert im ZUGFeRD-XML
#

lineItems.fields.sellerAssignedId wird je Position als vom Verkäufer vergebene Artikelkennung (SpecifiedTradeProduct → SellerAssignedID) geschrieben. Im columns-Modus wird die Spalte positionsbezogen aufgelöst (PRODUCT_CODE_0, PRODUCT_CODE_1, …).

Typischer Fehler
#

  • Artikelnummer als description gemappt statt in sellerAssignedId – dann steht die Nummer im Beschreibungsfeld und ist nicht als Kennung auswertbar.
  • Käufer- und Verkäufer-Artikelnummer vermischt – BT-155 ist ausdrücklich die Nummer des Verkäufers.
  • Nummer fehlt und erschwert dem Empfänger die spätere Weiterverarbeitung in ERP oder DMS.

Praxishinweis für csv2zugferd
#

sellerAssignedId ist für interne Produktnummern gedacht; description bleibt für echte Artikelbeschreibungen reserviert. Trennen Sie beide Spalten sauber, damit Nummer und Freitext nicht in dasselbe XML-Feld geraten.

Weiterführende Links#

Häufige Fragen

Ist BT-155 ein Pflichtfeld?

Nein, BT-155 ist optional. Die Verkäufer-Artikelnummer ist aber sehr praxisnah, weil sie die Weiterverarbeitung der Rechnung in ERP- und DMS-Systemen des Empfängers erleichtert.

Worin unterscheidet sich BT-155 von der Positionsbezeichnung?

BT-155 ist die eindeutige Artikelnummer des Verkäufers, etwa ‘00210’. BT-153 ist der lesbare Positionsname. Die Nummer gehört in sellerAssignedId, nicht in das Namens- oder Beschreibungsfeld.