> 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/extensibility.md).
# Extensibilité
Étendre le mappage des clients et des magasins de Comarch avec des points d’extension de script du connecteur.
Le mappage par défaut couvre les champs de fidélité courants. L’extensibilité est utile lorsqu’un projet a besoin d’attributs Comarch supplémentaires ou d’une forme différente de charge utile de la Carte. La référence complète des scripts Comarch, avec leur enregistrement, leurs gestionnaires et des exemples concrets, se trouve dans la [scripts Comarch](https://docs.thewalletcrew.io/developers-guides/scripting/extensions/comarch) page des guides des développeurs.
## Où le mappage personnalisé est configuré
Le mappage personnalisé est configuré dans l’ **Avancé** onglet de l’éditeur des paramètres Comarch.
C’est ici que les scripts de mappage du client et du magasin sont ajoutés ou examinés.
C’est ici que des scripts de connecteur peuvent être ajoutés pour étendre ou remplacer le mappage par défaut du client et du magasin.
{% hint style="info" %}
Le support de Wallet Crew peut être contacté lorsque le mappage personnalisé doit être configuré ou examiné.
{% endhint %}
## Hooks disponibles
Le connecteur expose quatre hooks de script.
| Hook | Objectif | Quand il s’exécute |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `extensions.comarch.customerMapper` | Étendre ou remplacer le mappage du client | Après la récupération des données client et l’application du mappage standard |
| `extensions.comarch.locationMapper` | Étendre ou remplacer le mappage du magasin | Après la récupération des données du magasin et l’application du mappage standard |
| `extensions.comarch.walletInstallationCustomerUpdater` | Décider des changements appliqués au client Comarch lorsque la Carte est installée dans un Wallet ou en est retirée | À chaque installation et suppression de Carte, tant que le paramètre Comarch **mise à jour lors du changement d’installation de la Carte** est activé |
| `extensions.comarch.couponMapper` | Ajuster, ou ignorer, l’avantage représenté par chaque coupon Comarch | Pour chaque coupon, à chaque création de Carte et mise à jour des métadonnées de la Carte, lorsque le paramètre Comarch de synchronisation des coupons est activé |
## Quand utiliser l’extensibilité
Utilisez un hook personnalisé lorsque la Carte a besoin de données qui ne sont pas mappées par défaut.
Les cas courants incluent des attributs de profil personnalisés, des libellés de fidélité, des métadonnées de localisation supplémentaires ou des noms de champs spécifiques au projet.
## Ce que les hooks reçoivent
Les hooks client et magasin reçoivent la réponse brute de Comarch et l’entité Carte.
Cela permet de réutiliser n’importe quel champ présent dans la charge utile source, et pas seulement les champs mappés par défaut.
Les objets bruts sont également exposés pour inspection sous :
* `debug.comarch.customer`
* `debug.comarch.store`
## Approche recommandée
Commencez d’abord par le mappage par défaut.
Ajoutez ensuite uniquement les champs supplémentaires dont la Carte a réellement besoin. Cela simplifie les modèles et réduit la maintenance à long terme.
## Notes de sécurité
Appliquez d’abord les modifications de mappage dans l’environnement de préproduction.
Un script de mappage peut affecter chaque actualisation de Carte qui utilise le connecteur. La validation doit couvrir à la fois l’exactitude des données et le rendu du modèle.
## FAQ
Où le mappage Comarch personnalisé est-il configuré ?
Le mappage personnalisé est configuré dans l’ **Avancé** onglet de l’éditeur des paramètres Comarch.
C’est ici que des scripts de connecteur peuvent être ajoutés pour étendre ou remplacer le mappage par défaut.
Quand l’extensibilité doit-elle être utilisée ?
L’extensibilité est utile lorsque le mappage par défaut ne couvre pas les besoins du projet.
Les cas courants incluent des attributs Comarch supplémentaires, des champs renommés ou des règles de transformation spécifiques au projet.
L’extensibilité peut-elle modifier à la fois le mappage du client et celui du magasin ?
Oui. Des hooks distincts sont disponibles pour le mappage du client et le mappage du magasin.
Cela permet d’adapter chaque partie indépendamment.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.thewalletcrew.io/connectors/fr/crm-and-fidelity/comarch/extensibility.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
