> 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é
Étendez le mappage client et magasin Comarch avec les hooks 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 structure différente de charge utile de Carte.
## 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 client et 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 client et magasin par défaut.
{% hint style="info" %}
Le support Wallet Crew peut être contacté lorsque le mappage personnalisé doit être configuré ou examiné.
{% endhint %}
## Hooks disponibles
Le connecteur expose deux hooks de script.
| Hook | Objectif | Quand il s'exécute |
| ----------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------ |
| `extensions.comarch.customerMapper` | Étendre ou remplacer le mappage 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 magasin | Après la récupération des données magasin et l'application du mappage standard |
## 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 reçoivent les hooks
Chaque hook reçoit la réponse brute de Comarch et l'entité Carte.
Cela permet de réutiliser tout 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 changements de mappage dans l'environnement de préproduction.
Un script de mappage peut affecter chaque rafraîchissement 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 faut-il utiliser l'extensibilité ?
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 client et le mappage magasin ?
Oui. Des hooks séparés sont disponibles pour le mappage client et le mappage 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 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/extensibility.md?ask=&goal=
```
`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.
