> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/crm-and-fidelity/comarch/data-mapping.md).

# Mappage des données

Le mappage Comarch détermine quelles données de fidélité deviennent visibles sur la Carte. Cette page répertorie les champs exposés par le connecteur et explique quand ils sont disponibles.

<details>

<summary><strong>Exemples concrets</strong></summary>

* Une carte de fidélité affiche les points, le niveau et le numéro de membre provenant de Comarch.
* Une Carte magasin affiche le magasin préféré capturé lors de l'inscription.
* Une Carte clienteling affiche ensemble les données du profil client et le contexte du magasin.

</details>

## Champs client

Le connecteur lit les données client depuis le Comarch CLM `profil/clients` API.

Les champs ci-dessous sont disponibles par défaut dans la Carte.

| Champ Wallet                            | Source Comarch                             | Notes                                                                               |
| --------------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------- |
| `firstName`                             | Prénom du client                           | Champ client standard                                                               |
| `lastName`                              | Nom de famille du client                   | Champ client standard                                                               |
| `e-mail`                                | E-mail de connexion ou e-mail de l'adresse | Utilise l'e-mail trouvé dans le profil                                              |
| `numéro de téléphone`                   | Mobile ou téléphone de l'adresse           | Utilise le numéro de téléphone trouvé dans le profil                                |
| `comarch.customer.loyaltyPointsBalance` | Solde principal de points                  | Disponible par défaut                                                               |
| `comarch.customer.mainIdentifier`       | Numéro principal de carte de fidélité      | Utile pour afficher des numéros de membre visibles                                  |
| `comarch.customer.statusName`           | Libellé du statut d'adhésion               | Souvent utilisé pour l'affichage du niveau                                          |
| `comarch.customer.waitingToBookPoints`  | Solde de points en attente                 | Disponible uniquement lorsque la récupération du solde des transactions est activée |

La charge utile client complète est également disponible sous `debug.comarch.customer`.

## Option des points en attente

Par défaut, le connecteur lit uniquement le solde principal de points.

Activer **Récupérer le solde des transactions client** lorsque les points en attente sont également nécessaires. Cela ajoute un appel supplémentaire à l'API Comarch lors de l'actualisation.

## Champs magasin

Les données du magasin ne sont récupérées que lorsque la Carte ou le flux d'inscription fournit `storeId`.

Le connecteur lit ensuite l'emplacement correspondant depuis l'API partenaire Comarch.

| Champ Wallet               | Source Comarch        | Notes                                      |
| -------------------------- | --------------------- | ------------------------------------------ |
| `comarch.store.code`       | Code de l'emplacement | Généralement la originale `storeId` valeur |
| `comarch.store.name`       | Nom de l'emplacement  | Nom affiché du magasin                     |
| `comarch.store.address`    | Rue                   | Adresse principale                         |
| `comarch.store.city`       | Ville                 | Ville du magasin                           |
| `comarch.store.postalCode` | Code postal           | Code postal du magasin                     |
| `comarch.store.country`    | Pays                  | Pays du magasin                            |
| `comarch.store.latitude`   | Latitude GPS          | Coordonnée d'emplacement facultative       |
| `comarch.store.longitude`  | Longitude GPS         | Coordonnée d'emplacement facultative       |

La charge utile complète du magasin est également disponible sous `debug.comarch.store`.

## Utilisez les champs dans un modèle de Carte

Définissez le modèle de Carte **Fournisseur client** à `comarch.customer`.

Définissez l' **Fournisseur magasin** à `comarch.store` lorsque des données de magasin sont nécessaires.

Les expressions de modèle typiques incluent :

* `{{ comarch.customer.loyaltyPointsBalance }}`
* `{{ comarch.customer.statusName }}`
* `{{ comarch.store.name }}`

## Personnaliser le mappage

Le mappage par défaut couvre les cas d'utilisation les plus courants liés à la fidélité et au magasin.

Lorsqu'un projet nécessite une structure de champs différente, des champs supplémentaires ou une logique de transformation personnalisée, le mappage peut être adapté grâce à l'extensibilité.

Cela permet de remodeler les données Comarch avant qu'elles ne soient exposées à la Carte.

Voir [Extensibilité](/connectors/fr/crm-and-fidelity/comarch/extensibility.md) pour le modèle de personnalisation.

## Notes de mappage

Gardez la première version de la Carte simple.

La plupart des projets commencent avec le numéro de membre, les points, le niveau et un champ magasin. Des champs supplémentaires peuvent suivre une fois que le chemin d'actualisation de base est validé.

## FAQ

<details>

<summary><strong>Le mappage Comarch par défaut peut-il être personnalisé ?</strong></summary>

Oui. Le mappage par défaut peut être adapté grâce à l'extensibilité lorsqu'un projet nécessite des champs personnalisés, des champs renommés ou des règles de transformation spécifiques.

Voir [Extensibilité](/connectors/fr/crm-and-fidelity/comarch/extensibility.md) pour l'approche de mise en œuvre.

</details>

<details>

<summary><strong>Tous les champs Comarch sont-ils exposés par défaut ?</strong></summary>

Non. Cette page répertorie les champs par défaut exposés par le connecteur.

Des champs supplémentaires peuvent être ajoutés lorsque la charge utile Comarch les contient et que le mappage du projet est étendu en conséquence.

</details>

<details>

<summary><strong>Quand les données du magasin sont-elles disponibles sur la Carte ?</strong></summary>

Les données du magasin sont disponibles uniquement lorsqu'un `storeId` est fourni dans le flux de Carte ou d'inscription.

Sans cette valeur, le connecteur n'effectue pas la recherche du magasin.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/connectors/fr/crm-and-fidelity/comarch/data-mapping.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.