product_concrete
Beispiel-Datei in gitlab.
Beschreibung
Beinhaltet die Verkaufsvarianten eines product_abstracts. Pro Abstract muss mindestens ein Concrete (product_concrete) festgelegt werden. Primär wichtig ist, dass die Verbindung zum product_abstract hergestellt (abstract_sku) wird, die Artikelnummer (concrete_sku, entspricht immer der abstract_sku) festgelegt wird, der Verfügbarkeitsstatus (availability/status) definiert wird und die Verpackungseinheiten (packaging) zum Artikel definiert werden.
Eine Besonderheit der Verpackungseinheiten ist, dass diese hierarchisch aufeinander aufbauen und deshalb die Verpackungsbasis in Abhängigkeit zur Verpackungseinheit ändern kann.
Für den Aufbau des packaging Objekts gelten folgende Regeln:
- Entspricht das packaging der Basiseinheit und ist eine „gemessene Menge“, also bspw. Kilogramm (
kg), Meter (m) oder Liter (l), dann muss das Feldmeasurement_quantitymitgegeben werden. - Entspricht das packaging der Basiseinheit und ist eine „nicht-gemessene Menge“, bspw. Karton (
karton), Flasche (flasche) oder Rollbehälter (rollbehalter), dann muss das Feldbase_quantitymitgegeben werden. - Entspricht das
packagingNICHT der Basiseinheit, dann muss das Objektpackaging_basemitgegeben werden inklusive descodesund derquantityder Einheit innerhalb dieses packagings.
Beispiel 1: Basiseinheit (base_packaging_code) = Pack (pack)
"packaging": {
"pack": {
"is_active": false,
"base_quantity": 1
},
"multipack": {
"is_active": true,
"packaging_base": {
"code": "pack",
"quantity": 200
}
},
"umkarton": {
"is_active": true,
"packaging_base": {
"code": "multipack",
"quantity": 10
}
}
}
- Erstes packaging:
packist die Basiseinheit = „nicht-gemessene Menge“, darumbase_quantity. - Zweites packaging:
multipack, aufbauend auf derpackaging_basepack. - Drittes packaging:
umkarton, aufbauend auf derpackaging_basemultipack.
Beispiel 2: Basiseinheit (base_measurement_code) = Liter (LITR)
"packaging": {
"flasche": {
"is_active": false,
"measurement_quantity": 1
},
"karton": {
"is_active": true,
"packaging_base": {
"code": "flasche",
"quantity": 10
}
},
"umkarton": {
"is_active": true,
"packaging_base": {
"code": "karton",
"quantity": 4
}
}
}
- Erstes packaging:
flascheist die Basiseinheit = „gemessene Menge“, darummeasurement_quantity. - Zweites packaging:
karton, aufbauend auf derpackaging_baseflasche. - Drittes packaging:
umkarton, aufbauend auf derpackaging_basekarton.
Verfügbare Felder
| Feld (* = Pflicht) | Beschreibung |
abstract_sku * String (100) | Stock keeping unit des Artikels (Artikelnummer). Zulässige Zeichen: Zahlen 0-9, Buchstaben A-Z a-z, Bindestriche –, Unterstriche _, Klammern (), Punkte .. |
concrete_sku * String (100) | Stock keeping unit des Artikels (Artikelnummer) - muss der abstract_sku entsprechen. Zulässige Zeichen: Zahlen 0-9, Buchstaben A-Z a-z, Bindestriche –, Unterstriche _, Klammern (), Punkte .. |
availability/status * String (enum) | Aktueller Verfügbarkeitsstatus des Artikels. Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#verfugbarkeitsstatus |
availability/order_deadline_date String (YYYY-MM-DD) | Bestimmt den letzten Tag, an welchem der Artikel noch bestellt werden kann. Muss bei Vorbestellartikel zwingend angegeben werden. |
availability/order_deliverable_from_date String (YYYY-MM-DD) | Bestimmt das früheste Datum, ab welchem der Artikel geliefert werden kann. Muss bei Artikeln mit Lieferverzug und Vorbestellartikel zwingend angegeben werden. |
availability/information_text Localized String (10000) | Zusatzinformation zur Verfügbarkeit. |
packaging/is_active boolean (true, false) | Inaktive Produkte werden im Webshop nicht angezeigt und nach zwei Jahren automatisch gelöscht. default = true |
packaging/gtin String (8,14) | Global Trade Item Number der Verpackungseinheit. |
packaging/packaging_base/code String (enum) | Definiert die Einheit, die sich in dieser Verpackungseinheit befinden (bspw. Karton à 10 Rollen). Zulässige Werte: https://my.mercanto.ch/de/definierte-werte#verpackungseinheit und https://my.mercanto.ch/de/definierte-werte#einheit |
packaging/packaging_base/quantity Number (0, 10000000) | Definiert die Anzahl Basiseinheiten, die sich in dieser Verpackungseinheit befinden (bspw. Karton à 10 Rollen). |
packaging/measurement_quantity Number (0, 10000000) | Anzahl, in der der Artikel verkauft wird, wenn Einheit = base_measurement_code ist. Entweder dieses Feld oder base_quantity muss befüllt sein. |
packaging/base_quantity Number (0, 10000000) | Anzahl, in der der Artikel verkauft wird, wenn Einheit = base_packaging_code ist. Entweder dieses Feld oder measurement_quantity muss befüllt sein. |
packaging/quantity_increment Number (1, 99999) | Der Betrag, um den eine Menge erhöht/verringert werden kann. |
packaging/minimum_quantity Number (1, 99999) | Für eine Bestellung erforderliche Mindestmenge des Artikels. default = 1 |
packaging/maximum_quantity Number (1, 99999) | Maximalmenge des Artikels innerhalb einer Bestellung. |
packaging/deposit Number (0, 10000000) | Der Depot-Betrag, der für diese Verpackung gilt. |