merchant_relationship

Exemple de fichier dans gitlab.

Description

Pour qu’une correspondance correcte entre customer_invitation et merchant_relationship puisse avoir lieu, il faut s’assurer que le même customer_key soit défini dans les deux objets.
Il est donc recommandé de regrouper les types de données customer_invitation et merchant_relationship dans un seul fichier, comme illustré dans l’exemple.

Si des frais s’appliquent et doivent être définis par client ou si des clients doivent déroger aux frais standards, ces informations doivent être transmises via transaction_fees dans le type de données merchant_relationship pour chaque customer_key.

Pour les frais, les options suivantes sont disponibles :

Choix parmi différents types de frais.
Les frais peuvent être définis en valeur absolue ou en pourcentage.
Les frais peuvent être échelonnés (paliers).
Pour chaque type de frais, une valeur de base doit être définie.
Les frais peuvent être définis « par commande » ou « par livraison » (Remarque : chez Mercanto, une commande peut contenir plusieurs livraisons).

Champs disponibles

Champ (* = Obligatoire)	Description
`customer_key` * String (100)	Identifiant unique du client du point de vue du fournisseur.
`label` String (100)	Identifiant lisible du client du point de vue du fournisseur (généralement identique à `customer_key`).
`active` boolean (true, false)	Définit si la relation client est active. Les clients inactifs ne peuvent pas passer de commandes. défaut = `true`
`customer_type` String (enum)	Utilisé à des fins statistiques pour distinguer les commandes/ventes des clients réguliers de celles des testeurs ou employés du fournisseur. Valeurs autorisées : https://my.mercanto.ch/fr/valeurs-definies#typedeclient
`delivery_address/ street` * String (100)	Rue du client/de l’unité opérationnelles.
`delivery_address/ street_additional`* String (100)	Complément d’adresse.
`delivery_address/ postal_code` * String (10)	Code postal du client/de l’unité opérationnelles.
`delivery_address/city` * String (100)	Localité du client/de l’unité opérationnelles.
`delivery_address/ country_code` * String (enum)	Pays du client/de l’unité opérationnelles. Valeurs autorisées : `CH`, `LI`
`delivery_methods/ delivery_method` String (100)	Option de livraison disponible pour le client. Doit correspondre à une `delivery_method` valide créée par Mercanto.
`delivery_methods/ delivery_group` String (100)	Groupe de livraison auquel le client/l’unité opérationnelles appartient.
`price_group_key` String (100)	Groupe de prix auquel le client/l’unité opérationnelles appartient.
`product_list_group` String (100)	Groupe de listes de produits auquel le client/l’unité opérationnelles appartient.
`transaction_fees/ fee_type` String (enum)	Type de frais applicable. Valeurs autorisées : https://my.mercanto.ch/fr/valeurs-definies#typedefrais
`transaction_fees/ delivery_method` String (100)	Option de livraison pour laquelle ce type de frais s’applique. Doit correspondre à une `delivery_method` valide.
`transaction_fees/ fee_model/logic` String (enum)	Définit si le frais est calculé comme une valeur fixe ou un pourcentage. Valeurs autorisées : `single_value_threshold`, `single_value_threshold_percentage`
`transaction_fees/ fee_model/applies_to` String (enum)	Définit si les frais doivent être appliqués uniquement à la commande ou à toutes les livraisons comprises dans une commande (par exemple, facturation multiple des frais de livraison dans une seule commande). Valeurs autorisées : `order`, `delivery`
`transaction_fees/ fee_model/ value_reference` String (enum)	Détermine la valeur utilisée comme référence pour le calcul du frais. Valeurs autorisées : `order_total`, `delivery_total`
`transaction_fees/ fee_model/fee_tiers/ upper_bound` Integer (0, 10000000000)	Limite supérieure du palier de frais. ATTENTION : Les prix CHF dans les fichiers JSON doivent être multipliés par le facteur 100'000.
`transaction_fees/ fee_model/fee_tiers/ percentage` Integer (0, 10000000000)	Pourcentage appliqué dans le palier. ATTENTION : Les prix CHF dans les fichiers JSON doivent être multipliés par le facteur 100'000.
`transaction_fees/ fee_model/fee_tiers/ fee` Integer (0, 10000000000)	Montant CHF pour le palier. ATTENTION : Les prix CHF dans les fichiers JSON doivent être multipliés par le facteur 100'000.
`transaction_fees/ fee_model/ default_fee` Integer (0, 10000000000)	Montant CHF de base pour ce type de frais. ATTENTION : Les prix CHF dans les fichiers JSON doivent être multipliés par le facteur 100'000.