product_concrete

Exemple de fichier dans gitlab.

Description

Contient les variantes de vente d’un product_abstract. Pour chaque Abstract, au moins un Concrete (product_concrete) doit être défini. Il est essentiel que la liaison vers le product_abstract soit effectuée (abstract_sku), que le numéro d’article (concrete_sku, correspond toujours au abstract_sku) soit défini, que le statut de disponibilité (availability/status) soit indiqué et que les unités d’emballage (packaging) soient définies pour l’article.

Une particularité des unités d’emballage est qu’elles sont structurées de manière hiérarchique ; ainsi, la base d’emballage peut varier selon l’unité d’emballage.

Pour la construction de l’objet packaging, les règles suivantes s’appliquent :

  • Si le packaging correspond à l’unité de base et qu’il s’agit d’une « quantité mesurée », comme kilogramme (kg), mètre (m) ou litre (l), alors le champ measurement_quantity doit être renseigné.
  • Si le packaging correspond à l’unité de base mais n’est pas une « quantité mesurée », comme carton (karton), bouteille (flasche) ou conteneur roulant (rollbehalter), alors le champ base_quantity doit être renseigné.
  • Si le packaging ne correspond pas à l’unité de base, alors l’objet packaging_base doit être renseigné avec code et quantity définissant l’unité sur laquelle ce packaging se base.

 

Exemple 1 : Unité de base (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
        }
    }
}
  • Premier packaging : pack est l’unité de base = « quantité non mesurée », donc base_quantity.
  • Deuxième packaging : multipack, construit sur packaging_base → pack.
  • Troisième packaging : umkarton, construit sur packaging_base → multipack.

 

Exemple 2 : Unité de base (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
        }
    }
}
  • Premier packaging : flasche est l’unité de base = « quantité mesurée », donc measurement_quantity.
  • Deuxième packaging : karton, construit sur packaging_base → flasche.
  • Troisième packaging : umkarton, construit sur packaging_base → karton.

Champs disponibles

Champ 
(* = Obligatoire)
Description
abstract_sku *
String (100)
Unité de gestion des stocks de l’article (numéro d’article).
Caractères autorisés : chiffres 0-9, lettres A-Z a-z, tirets –, traits de soulignement _, parenthèses (), points ..
concrete_sku *
String (100)
Unité de gestion des stocks de l’article (numéro d’article) – doit correspondre à l'abstract_sku.
Caractères autorisés : chiffres 0-9, lettres A-Z a-z, tirets –, traits de soulignement _, parenthèses (), points ..
availability/status
String (enum)
Statut de disponibilité actuel de l’article. 
Valeurs autorisées : https://my.mercanto.ch/fr/valeurs-definies#statutdedisponibilite 
availability/ order_deadline_date
String (YYYY-MM-DD)
Détermine le dernier jour où l’article peut encore être commandé. Obligatoire pour les articles en précommande.
availability/ order_deliverable_ from_date
String (YYYY-MM-DD)
Détermine la première date à laquelle l’article peut être livré. Obligatoire pour les articles en précommande ou avec retard de livraison.
availability/ information_text
Localized String (10000)
Informations supplémentaires relatives à la disponibilité.
packaging/is_active
boolean (true, false)
Les articles inactifs ne sont pas affichés dans le webshop et sont supprimés après deux ans.
défaut = true
packaging/gtin
String (8,14)
Global Trade Item Number de l’unité d’emballage.
packaging/ packaging_base/code
String (enum)
Détermine l’unité contenue dans cette unité d’emballage (ex. : carton à 10 rouleaux).
Valeurs autorisées : https://my.mercanto.ch/fr/valeurs-definies#unitedemballage et https://my.mercanto.ch/fr/valeurs-definies#unite 
packaging/ packaging_base/quantity
Number (0, 10000000)
Quantité d’unités de base contenues dans cette unité d’emballage (ex. : carton à 10 rouleaux).
packaging/ measurement_quantity
Number (0, 10000000)
Quantité dans laquelle l’article est vendu lorsque l’unité = base_measurement_code. Ce champ ou base_quantity doit être rempli.
packaging/base_quantity
Number (0, 10000000)
Quantité dans laquelle l’article est vendu lorsque l’unité = base_packaging_code. Ce champ ou measurement_quantity doit être rempli.
packaging/ quantity_increment
Number (0, 10000000)
Valeur d’incrément permettant d’augmenter/diminuer la quantité.
packaging/ minimum_quantity
Number (1, 10000000)
Quantité minimale requise pour une commande.
packaging/ maximum_quantity
Number (1, 10000000)
Quantité maximale autorisée dans une commande.
packaging/deposit
Number (1, 10000000)
Montant de la consigne applicable à cet emballage.