--- title: "merchant_relationship" url: "https://wiki.merchant.mercanto.ch/fr/article/merchant-relationship" language: "fr" last_updated: "2026-01-20T09:12:48.192Z" --- # merchant_relationship Exemple de fichier dans [gitlab](https://gitlab.com/mercanto/iocanto-spec/-/blob/master/examples/merchant_relationship.iocanto.json). ## 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](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](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. |