> 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

Configurez le connecteur Comarch dans The Wallet Crew, connectez les identifiants et validez l’intégration.

La configuration de Comarch commence par la préparation du projet. L'équipe doit s'aligner sur le cas d'utilisation 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, voir 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 la **portée 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é des changements 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, collectez 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 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 dans 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 également :

* **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 au support de 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.

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FXWWZEbTygIWAiMQdAECg%2Fimage.png?alt=media&#x26;token=43968bca-0c4f-4ba0-93b8-8f516d1168bb" alt="Comarch connector connection settings in The Wallet Crew, with base URL, client credentials, program code, and partner code"><figcaption><p>Vérifiez que chaque champ de connexion correspond aux valeurs fournies par l'administrateur Comarch.</p></figcaption></figure>

Utilisez les valeurs fournies par l'administrateur Comarch.

Les principaux champs sont :

* **URL de base**
* **ID client**
* **Secret client**
* **Code 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 diffusion d'événements en continu. 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 un rafraîchissement des cartes Wallet concernées.

Kafka réduit le délai entre une modification 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.

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FdbAVcRcaSPPbXnnw1zUK%2Fimage.png?alt=media&#x26;token=6af9a286-ff03-4bd9-a096-e6840e74219f" alt="Kafka section of the Comarch connector settings, with bootstrap servers, username, password, and topic"><figcaption><p>Laissez cette section vide à moins que Comarch ne publie des événements de fidélité dans un topic Kafka.</p></figcaption></figure>

Renseignez les champs suivants :

* **Serveurs Bootstrap**
* **Nom d'utilisateur**
* **Mot de passe**
* **Topic**

Si cette section reste vide, le connecteur fonctionne quand même. Les cartes se rafraîchissent alors uniquement à l'ouverture de la Carte ou lors du rafraîchissement planifié.
{% endstep %}

{% step %}

#### Associez les fournisseurs du modèle de Carte

Assurez-vous que `comarch.customer` est activé comme fournisseur de données de Carte dans la configuration avancée du fichier `server/flows.yml`.

Assurez-vous que `comarch.store` est également activé comme fournisseur de données de Carte lorsque les données du 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 le rafraîchissement de la Carte renvoie les données client. Si `storeId` est présent, confirmez également les données du magasin.
{% endstep %}
{% endstepper %}

## Configuration avancée

### Examinez la limite de limitation

La limitation par défaut est de **80 appels API par seconde**.

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FKh5KRCrcUW7zFMpL4Tg7%2Fimage.png?alt=media&#x26;token=7fd2e8de-7ee4-4bea-bbaf-cfd695393dc5" alt="Throttling setting of the Comarch connector, showing the API calls per second limit"><figcaption><p>Confirmez que cette limite correspond au quota du Comarch CLM B2B Gateway accordé au tenant.</p></figcaption></figure>

Cela correspond au quota habituel du tenant Comarch CLM B2B Gateway. Ne le modifiez que lorsqu'une limite différente est confirmée.

### Récupérer le solde des transactions client

Activer **Récupérer le solde des transactions client** lorsque la Carte a besoin de plus que le solde principal des points.

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FztAivk1UaybTkQVnmd0f%2Fimage.png?alt=media&#x26;token=fd69468d-93a8-4c62-bde6-8b60c597cf3c" alt="Retrieve customer transaction balance option in the Comarch connector settings"><figcaption><p>Activez cette option uniquement lorsque des points en attente ou des soldes détaillés doivent apparaître sur la Carte.</p></figcaption></figure>

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 API Comarch lors du rafraîchissement.

## Liste de validation

Une configuration valide confirme 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

<details>

<summary><strong>Quand faut-il contacter le support de The Wallet Crew ?</strong></summary>

Contactez le support de The Wallet Crew avant le début de la configuration afin que le connecteur Comarch puisse être activé sur le tenant. Le support de The Wallet Crew peut également être contacté pour toute question sur la configuration.

</details>

<details>

<summary><strong>Que faut-il vérifier si l'authentification échoue ?</strong></summary>

Vérifiez **URL de base**, **ID client**, et **Secret client** d'abord.

Confirmez ensuite que le client OAuth peut accéder aux API de profil et de 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](/developers-guides/fr/pass-architecture/infrastructure.md#outgoing-ip-addresses) page.

</details>

<details>

<summary><strong>Quand faut-il <code>Récupérer le solde des transactions client</code> être activé ?</strong></summary>

Activez-le lorsque la Carte a besoin d'informations de solde détaillées, comme des points en attente. Si la Carte a seulement besoin du solde de points, ce n'est pas nécessaire.

</details>

<details>

<summary><strong>The Wallet Crew stocke-t-il les données de fidélité Comarch ?</strong></summary>

Non. The Wallet Crew lit les données nécessaires depuis Comarch lorsqu'un rafraîchissement de 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.

</details>

<details>

<summary><strong>Kafka est-il requis pour que la configuration fonctionne ?</strong></summary>

Non. Kafka est facultatif. Sans lui, le connecteur fonctionne toujours et les cartes peuvent encore se rafraîchir à l'ouverture de la Carte ou lors du rafraîchissement planifié.

</details>

<details>

<summary><strong>Comment The Wallet Crew reste-t-il à jour avec les informations Comarch ?</strong></summary>

Kafka aide The Wallet Crew à rester synchronisé avec les changements Comarch au fur et à mesure qu'ils se produisent.

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, le rafraîchissement fonctionne toujours, mais il dépend de l'ouverture de la Carte ou du calendrier de rafraîchissement.

Voir [Mises à jour en temps réel](/connectors/fr/crm-and-fidelity/comarch/real-time-updates.md) pour le flux détaillé.

</details>

<details>

<summary><strong>Que faut-il valider en premier ?</strong></summary>

Commencez par la recherche client. Validez ensuite la recherche de magasin lorsque `storeId` en fait partie. Le rafraîchissement en temps réel peut être validé une fois que le flux de données de base fonctionne.

</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/setup.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.