Zum Hauptinhalt springen

LineItem

LineItem-Objektschema für Bestellprodukte.

Verfasst von Frank Birzle

id

Typ: string

Beschreibung: Der (technische) eindeutige Identifier des Bestellartikels in dieser Bestellung.

Beispielwert(e): '123456789' oder 'A-2344234230-B'

productName

Typ: string

Beschreibung: Name des Produkts (Modell).

Beispielwert(e): 'Awesome Porridge - Cinamon' oder 'Nike Air Max 90'

productId

Typ: string

Beschreibung: Der (technische) eindeutige Identifier des Produkts in deinem (Shop-)System.

Beispielwert(e): '123456789' oder 'A-2344234230-B'

productVariantName

Typ: string

Beschreibung: Titel der Variante des Produkts (Modell).

Beispielwert(e): 'Awesome Porridge - Cinamon - 250g' oder 'Nike Air Max 90 - Size 10'

productVariantId

Typ: string

Beschreibung: Der (technische) eindeutige Identifier der Produktvariante in deinem (Shop-)System.

Beispielwert(e): '123456790' oder 'A-2344234230-B-10'

productBrand

Typ: string

Beschreibung: Die Marke des Produkts.

Beispielwert(e): 'Awesome Foods'

productCollection

Typ: string

Beschreibung: Die Produktkollektion oder -kategorie.

Beispielwert(e): 'Porridge' oder 'Sneakers' oder 'Shoes > Sneakers'

productCogs

Typ: number

Beschreibung: Die Cost of Goods Sold (COGS) für dieses Produkt.

Beispielwert(e): 3.50 oder 0.99

productGmv

Typ: number

Beschreibung: Der Bruttowarenwert des Produkts bzw. die unverbindliche Preisempfehlung für einen der Produktartikel. Das ist die Basis für die Bruttoumsatz-Berechnung.

Beispielwert(e): 19.99 oder 35

productShippingWeightInGrams

Typ: number

Beschreibung: Das Gewicht des Produkts in Gramm.

Beispielwert(e): 120 (120 Gramm) oder 2500 (2,5 kg = 2500 g)

sku

Typ: string

Beschreibung: Die Stock Keeping Unit (SKU) des Produkts.

Beispielwert(e): '123456789' oder 'A-123-797-C'

quantity

Typ: number

Beschreibung: Die Anzahl dieses spezifischen Line Items in dieser Bestellung.

Beispielwert(e): 5 oder 99

productTags

Typ: [string]

Beschreibung: Ein Array von Tags, das das Produkt weiter spezifiziert.

Beispielwert(e): ['food', 'beverages', 'with_deposit'] oder ['free_item']

discounts

Typ: [Discount]

Beschreibung: Ein Array von Discount-Objekten, die auf das lineItem angewendet werden. Beachte, dass die Werte pro Artikel angegeben werden müssen (also „nicht mit quantity multipliziert").

Beispielwert(e): Siehe Discount.

taxes

Typ: [Tax]

Beschreibung: Ein Array von Tax-Objekten, die auf das lineItem angewendet werden. Beachte, dass die Werte pro Artikel angegeben werden müssen (also „nicht mit quantity multipliziert").

Beispielwert(e): Siehe Tax.

totalAmountBeforeTaxesAndDiscounts

Typ: number

Beschreibung: Der Gesamtbetrag für dieses lineItem (nicht die Bestellung), bevor Steuern und Rabatte angewendet werden. Die Formel ist quantity * productGmv. Hinweis: Obwohl wir diesen Wert aus den bereits bereitgestellten Einzelwerten berechnen könnten, empfehlen wir, ihn mitzusenden, damit wir die Korrektheit der Berechnung validieren können. Kurz gesagt: Diese Werte sind interne Prüfsummen, um die Korrektheit der Elemente der Berechnungsformel zu validieren.

Beispielwert(e): 37,50 (quantity 3 und productGmv von 12,50) oder

totalAmountAfterTaxesAndDiscounts

Typ: number

Beschreibung: Der Gesamtbetrag für dieses lineItem (nicht die Bestellung) nach Abzug von Steuern und Rabatten. Die Formel ist (quantity * productGmv) - (sum(taxes.taxAmount) * quantity) - (sum(discounts.discountAmount) * quantity). Hinweis: Obwohl wir diesen Wert aus den bereits bereitgestellten Einzelwerten berechnen könnten, empfehlen wir, ihn mitzusenden, damit wir die Korrektheit der Berechnung validieren können. Kurz gesagt: Diese Werte sind interne Prüfsummen, um die Korrektheit der Elemente der Berechnungsformel zu validieren.

Beispielwert(e): 30,75 (quantity 3 und productGmv von 12,50) - 3.75 (10% Voucher) - 7.13 (19% MwSt.)

totalLogisticsCosts

Typ: number

Beschreibung: Der Betrag der gesamten (zusätzlichen) Logistikkosten, die auf dieses/diese lineItem(s) entfallen. Z.B. wenn die Bestellung einen Artikel enthielt, der aufgrund seiner Sperrigkeit oder seines Gewichts per Spedition versendet werden musste.

Beispielwert(e): 50.00 (Zusatzgebühr für Spedition zur Lieferung einer Waschmaschine)

Hat dies deine Frage beantwortet?