Artikelmerkmale, Klassifizierung und Herkunftsland

Thema: VB.NET
SDK-Mitglieder: addApplicableProductCharacteristics() addDesignatedProductClassification() ApplicableProductCharacteristicsCount FillZUGFeRD_Structure() getApplicableProductCharacteristics() TradeItemsCount WriteLineItemOriginTradeCountry()
Business Terms: BG-31 Artikelinformationen BG-32 Artikelattribute BT-158 Kennung der Artikelklassifizierung BT-159 Artikelherkunftsland BT-160 Artikelattributname BT-161 Artikelattributwert BG-25 Rechnungsposition BT-153 Artikelname
Codebeispiele: VB.NET
Veröffentlicht: 7. Oktober 2026

Zu jeder Rechnungsposition gehören die Artikelinformationen (BG-31): Name, Beschreibung und Artikelnummern. Darüber hinaus kann die E-Rechnung die Ware genauer beschreiben – mit einer Klassifizierung (BT-158), dem Herkunftsland (BT-159) und beliebig vielen Artikelattributen wie Farbe oder Größe (BG-32 mit BT-160 und BT-161). Die Aloaha ZUGFeRD SDK bietet dafür drei Methoden. Alle erwarten als ersten Parameter den Index der Position, beginnend bei 0.

Übersicht

Feld	Bedeutung	Methode
BT-158	Kennung der Artikelklassifizierung, z. B. Zolltarifnummer, mit Schema und Version	`addDesignatedProductClassification`
BT-159	Herkunftsland (ISO 3166-1, z. B. DE)	`WriteLineItemOriginTradeCountry`
BT-160	Name des Attributs, z. B. „Farbe“	`addApplicableProductCharacteristics`
BT-161	Wert des Attributs, z. B. „Rot“	`addApplicableProductCharacteristics`

Name, Beschreibung und Artikelnummern (BT-153 bis BT-157) setzen Sie wie gewohnt beim Anlegen der Position mit AddProduct_Comfort.

Beispiel

VB.NET – Position 0 wurde zuvor mit AddProduct_Comfort angelegt:

' Klassifizierung: Zolltarifnummer nach Harmonisiertem System (Schema "HS")
alo.addDesignatedProductClassification(0, "61091000", "HS", "")
' Herkunftsland
alo.WriteLineItemOriginTradeCountry(0, "PT")
' Artikelattribute
alo.addApplicableProductCharacteristics(0, "Farbe", "Rot")
alo.addApplicableProductCharacteristics(0, "Größe", "XL")

VBA / VB6 (COM)

alo.addDesignatedProductClassification 0, "61091000", "HS", ""
alo.WriteLineItemOriginTradeCountry 0, "PT"
alo.addApplicableProductCharacteristics 0, "Farbe", "Rot"

Hinweise

Die Klassifizierung (BT-158) darf mehrfach vorkommen; jeder Aufruf fügt eine weitere hinzu. Das Schema (listID, BT-158-1) stammt aus der UNTDID 7143.
Der optionale fünfte Parameter ClassName (Name der Klassifizierung) gibt es nur in ZUGFeRD EXTENDED. Ist er gefüllt, stellt die SDK das Profil automatisch auf EXTENDED um.
Bei Artikelattributen sind Name und Wert immer gemeinsam anzugeben. Die optionalen Parameter TypeCode, ValueMeasure und ValueMeasureUnitCode gehören zu ZUGFeRD EXTENDED.

Artikelattribute lesen

ApplicableProductCharacteristicsCount(Position) nennt die Zahl der Attribute einer Position, getApplicableProductCharacteristics liefert Name (BT-160) und Wert (BT-161) eines Attributs über Referenzparameter. Beide Indizes beginnen bei 0. Die optionalen Ausgaben TypeCode, ValueMeasure und ValueMeasureUnitCode sind nur bei EXTENDED-Rechnungen belegt; fehlende Werte kommen als leere Zeichenkette zurück.

VB.NET

Dim alo As New Aloaha_ZUGFeRD.XML("IHR-LIZENZSCHLUESSEL")
If alo.FillZUGFeRD_Structure("C:\Rechnungen\eingang.xml", "IHR-LIZENZSCHLUESSEL") Then
    For i As Integer = 0 To alo.TradeItemsCount - 1
        For k As Integer = 0 To alo.ApplicableProductCharacteristicsCount(i) - 1
            Dim Name As String = "", Wert As String = ""
            alo.getApplicableProductCharacteristics(i, k, Name, Wert)
            Console.WriteLine($"Position {i + 1}: {Name} = {Wert}")
        Next
    Next
End If

VBA / VB6 (COM)

Dim i As Long, k As Long
Dim AttrName As String, AttrWert As String
For i = 0 To alo.TradeItemsCount - 1
    For k = 0 To alo.ApplicableProductCharacteristicsCount(i) - 1
        alo.getApplicableProductCharacteristics i, k, AttrName, AttrWert
        Debug.Print i + 1, AttrName, AttrWert
    Next k
Next i

Bei einem ungültigen Index liefert die Zählfunktion 0, und getApplicableProductCharacteristics lässt die übergebenen Variablen unverändert.

Häufige Fragen

Wie gebe ich die Farbe eines Artikels in der E-Rechnung an?

Als Artikelattribut (BG-32): Name „Farbe“ in BT-160 und Wert „Rot“ in BT-161. In der SDK mit addApplicableProductCharacteristics.

Wo trage ich die Zolltarifnummer ein?

In der Artikelklassifizierung BT-158 mit dem Schema HS. In der SDK mit addDesignatedProductClassification.

Ab welchem Profil sind Artikelattribute erlaubt?

Ab dem Profil EN 16931 (COMFORT), also auch in EXTENDED und XRECHNUNG.

Business Terms in diesem Artikel: BG-31 BG-32 BT-158 BT-159 BT-160 BT-161 BG-25 BT-153 BT-154 BT-155 BT-156 BT-157