> 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/setup.md). # Configuration La configuration de Comarch commence par la préparation du projet. L’équipe doit s’aligner sur le cas d’usage de fidélité, le contenu cible de la Carte et le parcours opérationnel avant de renseigner les paramètres du connecteur. Cette préparation aide à confirmer quelles données Comarch sont nécessaires, comment la Carte doit se comporter et comment l’intégration sera validée. Pour les prérequis et la configuration côté Comarch, consultez la [documentation du connecteur Comarch](https://comarch.gitbook.io/comarch-docs/VsZEsCv9WjWJFEsWq8vr/connectors/twc). ## Ce qu’il faut collecter avant la configuration Avant d’ouvrir les paramètres du connecteur, alignez-vous sur le **périmètre métier de l’intégration**. Cela inclut généralement le type de Carte, les données qui doivent y apparaître et le comportement de rafraîchissement attendu après les événements de fidélité. **Scénarios cibles** doivent également être clairs avant le début de la configuration. Les scénarios typiques incluent la création de Carte, le rafraîchissement de la Carte après un achat, la visibilité du changement de statut, l’affichage du magasin préféré ou la mise à jour des coupons. **Cas de test** doivent être préparés en même temps. Ils doivent permettre de valider à la fois l’expérience client attendue et les données renvoyées par Comarch pendant la configuration. Une fois cette préparation terminée, récupérez les valeurs techniques ci-dessous : * **URL de base** de l’API Comarch CLM B2B Gateway, par exemple `https://clm.brand.com/` * **ID client** et **secret client** pour l’accès OAuth 2.0 * **Code du programme** pour le programme de fidélité * **Code partenaire** pour l’unité commerciale * Confirmez que les adresses IP sortantes de The Wallet Crew sont autorisées par Comarch. La liste actuelle est disponible sur la [Infrastructure](/developers-guides/fr/pass-architecture/infrastructure.md#outgoing-ip-addresses) page. Si les mises à jour en temps réel doivent être activées, préparez aussi : * **Serveurs bootstrap** pour le cluster Kafka * **Nom d’utilisateur** et **Mot de passe** pour l’authentification Kafka * **Topic** utilisé par les événements Comarch CLM ## Configurer le connecteur {% hint style="info" %} Demandez à l’assistance The Wallet Crew d’activer le connecteur Comarch sur le tenant avant le début de la configuration. {% endhint %} {% stepper %} {% step %} #### Renseignez les paramètres de connexion Ouvrez **Connecteurs → Comarch** et renseignez les champs de connexion.
Utilisez les valeurs fournies par l’administrateur Comarch. Les principaux champs sont : * **URL de base** * **ID client** * **secret client** * **Code du programme** * **Code partenaire** {% endstep %} {% step %} #### Configurez Kafka si nécessaire N’ouvrez la section Kafka que lorsque Comarch publie des flux d’événements. {% hint style="info" %} Kafka est une plateforme de streaming d’événements. Comarch publie les changements de fidélité dans un topic Kafka. The Wallet Crew s’abonne à ce topic. Les événements pris en charge déclenchent une actualisation des Cartes Wallet concernées. Kafka réduit le délai entre une modification dans Comarch et la mise à jour de sa Carte. C’est facultatif. {% endhint %} Voir [Mises à jour en temps réel](/connectors/fr/crm-and-fidelity/comarch/real-time-updates.md) pour les paramètres Kafka et les événements pris en charge.
Renseignez les champs suivants : * **Serveurs bootstrap** * **Nom d’utilisateur** * **Mot de passe** * **Topic** Si cette section reste vide, le connecteur fonctionne toujours. Les Cartes se mettent alors à jour uniquement à l’ouverture de la Carte ou lors de l’actualisation programmée. {% endstep %} {% step %} #### Associez les fournisseurs du modèle de Carte Vérifiez que `comarch.customer` est activé comme fournisseur de données de Carte dans la configuration avancée du fichier `server/flows.yml`. Vérifiez que `comarch.store` est également activé comme fournisseur de données de Carte lorsque des données de magasin sont nécessaires sur la Carte. {% endstep %} {% step %} #### Validez la configuration Testez avec une Carte qui contient déjà `id.comarch.customerId`. Confirmez ensuite que l’actualisation de la Carte renvoie les données client. Si `storeId` est présent, confirmez aussi les données du magasin. {% endstep %} {% endstepper %} ## Configuration avancée ### Vérifiez la limite de débit La limitation par défaut est de **80 appels API par seconde**.
Cela correspond au quota habituel du tenant Comarch CLM B2B Gateway. Ne le modifiez que lorsqu’une autre limite a été confirmée. ### Récupérer le solde détaillé des transactions client Activer **Récupérer le solde détaillé des transactions client** lorsque la Carte a besoin de plus que le solde principal de points.
Cette option effectue un appel API supplémentaire à Comarch pour récupérer le solde détaillé des transactions client, y compris les points en attente et les détails de solde associés. Utilisez-la uniquement lorsque ces valeurs sont requises sur la Carte ou dans le périmètre de validation. Elle augmente le nombre d’appels à l’API Comarch lors de l’actualisation. ## Liste de vérification de validation Une configuration valide vérifie généralement quatre éléments : * L’authentification OAuth réussit * les données client se chargent depuis Comarch * les données du magasin se chargent lorsque `storeId` existe * les champs de la Carte affichent les valeurs attendues ## FAQ
Quand faut-il contacter l’assistance The Wallet Crew ? Contactez l’assistance The Wallet Crew avant le début de la configuration afin que le connecteur Comarch puisse être activé sur le tenant. Vous pouvez également contacter l’assistance The Wallet Crew à chaque fois que vous avez une question sur la configuration.
Que faut-il vérifier si l’authentification échoue ? Vérifiez le **URL de base**, **ID client**, et **secret client** d’abord. Confirmez ensuite que le client OAuth peut accéder aux API profil et partenaire. Si les identifiants sont corrects et que l’authentification échoue toujours, confirmez que les adresses IP sortantes de The Wallet Crew sont autorisées par Comarch. La liste actuelle est disponible dans la [Infrastructure](https://docs.thewalletcrew.io/developers-guides/pass-architecture/infrastructure#outgoing-ip-addresses) page.
Quand faut-il Récupérer le solde détaillé des transactions client être activé ? Activez-la lorsque la Carte a besoin d’informations détaillées sur le solde, telles que les points en attente. Si la Carte n’a besoin que du solde de points, ce n’est pas nécessaire.
The Wallet Crew stocke-t-il les données de fidélité Comarch ? Non. The Wallet Crew lit les données nécessaires depuis Comarch lorsqu’une actualisation de la Carte l’exige. Ce connecteur est conçu pour conserver Comarch comme source de vérité pour les données de fidélité telles que les points, le niveau, le profil ou les informations de magasin.
Kafka est-il requis pour que la configuration fonctionne ? Non. Kafka est facultatif. Sans lui, le connecteur fonctionne toujours et les Cartes peuvent toujours s’actualiser à l’ouverture de la Carte ou lors de l’actualisation programmée.
Comment The Wallet Crew reste-t-il à jour avec les informations Comarch ? Kafka aide The Wallet Crew à rester synchronisé avec les changements Comarch au fur et à mesure. Lorsque Comarch publie des événements de fidélité dans Kafka, The Wallet Crew peut réagir à des changements tels que des mises à jour de points, des changements de statut ou des mises à jour de magasin. Sans Kafka, l’actualisation fonctionne toujours, mais elle dépend du moment de l’ouverture de la Carte ou de l’actualisation programmée. Voir [Mises à jour en temps réel](/connectors/fr/crm-and-fidelity/comarch/real-time-updates.md) pour le flux détaillé.
Que faut-il valider en premier ? Commencez par la recherche client. Validez ensuite la recherche de magasin lorsque `storeId` fait partie du scénario. L’actualisation en temps réel peut être validée une fois que le flux de données de base fonctionne.
--- # 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/setup.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.