---
title: "customer_invitation"
url: "https://wiki.merchant.mercanto.ch/fr/article/customer-invitation"
language: "fr"
last_updated: "2026-05-12T06:11:13.682Z"
---

# customer_invitation

Exemple de fichier dans [gitlab](https://gitlab.com/mercanto/iocanto-spec/-/blob/master/examples/merchant_relationship.iocanto.json).

## Description

Ce type de données sert à inviter un client sur Mercanto.

Les règles suivantes s’appliquent :

-   Il faut fournir les informations de l’entreprise, au minimum un numéro client (`customer_key`) et un nom d’entreprise (`company_name`), pouvant être complétés par l’IDE (`uid`) et la forme juridique (`legal_form`). L’IDE est particulièrement importante pour l’identification afin d’éviter les doublons si l’entreprise existe déjà sur Mercanto.
-   Pour chaque entreprise, il faut indiquer la personne de contact, composée du prénom (`first_name`), du nom (`last_name`) et de l’adresse e-mail (`email`).
-   Pour chaque entreprise, il faut indiquer quelles unités operationelles (`business_units`) appartiennent à cette entreprise. Une entreprise peut se voir attribuer un nombre illimité d’unités operationelles.
-   Les unités operationelles peuvent être des filiales, des sous-entités ou des départements.
-   Le numéro client (`customer_key`) attribué à l’entreprise doit **toujours** être renseigné également en tant qu’unité operationelle.

## Champs disponibles

| **Champ**  <br>(\* = Obligatoire) | **Description** |
| --- | --- |
| `customer_key` \*  <br>*String (100)* | Identifiant unique du client du point de vue du fournisseur. |
| `company_name`  <br>*String (100)* | Nom du client. |
| `uid`  <br>*String (100)* | IDE du client. |
| `legal_form`  <br>*String (enum)* | Forme juridique du client.   <br>Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#formejuridique](https://my.mercanto.ch/fr/valeurs-definies#formejuridique) |
| `business_units/ customer_key` \*   <br>*String (100)* | Identifiant de l’unité opérationnelles du point de vue du fournisseur. |
| `business_units/ parent_customer_key` \*   <br>*String (100)* | Identifiant de l’unité opérationnelles dont celle-ci dépend (p. ex. siège principal et filiales). |
| `business_units/name` \*   <br>*String (100)* | Nom de l’unité opérationnelles. |
| `contact_person/email` \*  <br>*String (email)* | Adresse e-mail de la personne de contact. Nécessaire pour l’envoi des données d’accès. |
| `contact_person/ first_name` \*  <br>*String (100)* | Prénom de la personne de contact. |
| `contact_person/ last_name` \*  <br>*String (100)* | Nom de la personne de contact. |
| `contact_person/ language_code`  <br>*String (enum)* | Langue de la personne de contact (e-mails envoyés par Mercanto dans la langue sélectionnée).   <br>Valeurs autorisées : `de_CH`, `fr_CH`, `it_CH`, `en_GB` |