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 Feld measurement_quantity mitgegeben werden.
  • Entspricht das packaging der Basiseinheit und ist eine „nicht-gemessene Menge“, bspw. Karton (karton), Flasche (flasche) oder Rollbehälter (rollbehalter), dann muss das Feld base_quantity mitgegeben werden.
  • Entspricht das packaging NICHT der Basiseinheit, dann muss das Objekt packaging_base mitgegeben werden inklusive des codes und der quantity der 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: pack ist die Basiseinheit = „nicht-gemessene Menge“, darum base_quantity.
  • Zweites packaging: multipack, aufbauend auf der packaging_base pack.
  • Drittes packaging: umkarton, aufbauend auf der packaging_base multipack.

 

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: flasche ist die Basiseinheit = „gemessene Menge“, darum measurement_quantity.
  • Zweites packaging: karton, aufbauend auf der packaging_base flasche.
  • Drittes packaging: umkarton, aufbauend auf der packaging_base karton.

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.