> 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/pos/cegid/how-the-cegid-retail-y2-connector-works.md).

# Comment fonctionne le connecteur Cegid Retail Y2

Comprenez comment le connecteur Cegid Retail Y2 échange les données client, de fidélité, de voucher et de ventes avec The Wallet Crew.

Deux principes expliquent le comportement du connecteur : Cegid reste le système de référence, et le connecteur lit les données à la demande.

### Cegid détient les données, The Wallet Crew détient la carte

Le connecteur ne se comporte pas comme une base de données client Cegid distincte. Lorsqu'un formulaire d'inscription est soumis, le profil est écrit dans Cegid Retail Y2 puis relu. Lorsqu'une carte est générée, ses données client, de fidélité et de bons sont récupérées depuis Cegid. The Wallet Crew conserve la carte et les identifiants nécessaires pour la relier à l'enregistrement Cegid correspondant.

{% hint style="warning" %}
Si un enregistrement client est écrasé ou corrompu dans Cegid, The Wallet Crew ne peut pas le restaurer. Il n'existe pas de seconde copie. La récupération relève de Cegid, via sa propre piste d'audit.
{% endhint %}

### Les deux sens du trafic

Les données circulent entre les deux systèmes de deux façons très différentes, et les confondre est une source fréquente de malentendus.

```mermaid
flowchart LR
  subgraph twc["The Wallet Crew"]
    Form["Flux d'inscription"]
    Build["Génération de carte"]
    Notif["Point de terminaison des notifications métier"]
  end
  Y2["Cegid Retail Y2<br/>système de référence"]

  Form -->|"Écrire le profil, puis le relire"| Y2
  Build -->|"Lire le client, la fidélité et les bons à chaque génération"| Y2
  Y2 -.->|"Notification facultative, identifiants uniquement"| Notif
  Notif -->|"Lire l'enregistrement concerné, actualiser les cartes"| Y2
```

**Appels sortants** transportent presque tout le trafic. Le connecteur appelle les services web Y2 pour rechercher un client, créer ou mettre à jour un profil, créer une carte de fidélité, lister les bons ou récupérer un document de vente. Ces appels se produisent lorsqu'un formulaire est soumis puis à nouveau chaque fois qu'une carte est générée. Comme Apple Wallet et Google Wallet interrogent les mises à jour de carte selon leur propre calendrier, un seul client peut générer de nombreuses lectures sur une journée, d'où l'existence de la mise en cache et de la limitation du débit. Les deux sont abordées dans [Configuration avancée](/connectors/fr/pos/cegid/installation-et-configuration/advanced-configuration.md).

**Notifications métier entrantes** sont facultatives et transportent très peu de données. Cegid peut être configuré pour notifier The Wallet Crew lorsqu'un client est créé ou mis à jour, qu'un reçu est créé ou qu'une opération sur carte de fidélité se produit. La notification transporte des identifiants, pas du contenu : le connecteur réagit en relisant l'enregistrement concerné depuis Cegid et en actualisant les cartes pertinentes.

{% hint style="info" %}
Comme les notifications déclenchent des lectures plutôt qu'elles ne les remplacent, activer les notifications métier augmente le trafic vers Cegid au lieu de le réduire. L'avantage est la fraîcheur, pas l'efficacité.
{% endhint %}

### Ce qui se retrouve sur une carte

Lorsque le connecteur identifie un client, il écrit un petit ensemble d'identifiants sur la carte afin que les lectures ultérieures aillent directement au bon enregistrement Cegid au lieu de rechercher à nouveau. L'identifiant client Cegid est stocké sous la forme `id.y2.customerId`, et une carte de fidélité associée sous la forme `y2.loyaltyCardId`. Les cartes cadeau, les certificats et les dépôts reçoivent chacun leur propre identifiant dans la même famille.

Les valeurs de fidélité sont exposées pour être utilisées dans les modèles de carte sous un `loyalty.` préfixe : le nom du programme, les dates d'activation et d'expiration, le solde de points, et pour les produits à valeur stockée, un montant et une devise.

{% hint style="warning" %}
Le connecteur place aussi la réponse brute de Cegid sur le compte sous des clés commençant `debug.y2.`. Ce sont des **et non** champs de modèle de carte. Ils existent dans les données transmises à un script de mappage, afin d'aider à écrire et à déboguer les mappages, et sont décrits dans [Personnaliser le mappage](/connectors/fr/pos/cegid/donnees-client-et-fidelite/customise-the-mapping.md).
{% endhint %}

### Les éléments en jeu

Trois types de composants constituent le connecteur, et la configuration du tenant les désigne par leur nom.

**Fournisseurs client** lisent dans Cegid lorsqu'une carte ou un formulaire a besoin de données. Le `y2` récupère le profil client, `y2.loyalty` récupère les cartes de fidélité, `y2.customerCashOperations` et `y2.cashOperations` récupèrent les bons et la valeur stockée, et `y2.tickets` récupère les documents de vente.

**Éléments de flux** sont les étapes d'un flux d'inscription ou de mise à jour qui écrivent dans Cegid. Le `y2Customer` crée ou met à jour le profil, `y2Loyalty` crée une carte de fidélité, `y2PendingTicket` génère un reçu en attente, et `y2ExecuteScheduledTask` déclenche une tâche planifiée Cegid.

**Travaux planifiés** s'exécute selon son propre calendrier. La `cegid.newOrderWalletUpdate` tâche actualise les cartes affectées par les commandes récentes, en remontant par défaut sur une heure.

### FAQ

<details>

<summary><strong>The Wallet Crew stocke-t-il les données personnelles des clients de Cegid ?</strong></summary>

Le connecteur lit les données client depuis Cegid lorsqu'il est nécessaire de générer ou mettre à jour une carte. Il ne maintient pas de base de données client Cegid distincte.

</details>

<details>

<summary><strong>Pourquoi un seul client génère-t-il autant d'appels à Cegid ?</strong></summary>

Apple Wallet et Google Wallet interrogent les mises à jour de carte indépendamment de toute action utilisateur, et chaque interrogation qui entraîne la reconstruction d'une carte lit les données depuis Cegid. La mise en cache, décrite dans [Configuration avancée](/connectors/fr/pos/cegid/installation-et-configuration/advanced-configuration.md), est la solution prévue.

</details>

<details>

<summary><strong>Les notifications métier sont-elles nécessaires ?</strong></summary>

Non. Sans elles, les données Wallet se rafraîchissent toujours chaque fois qu'une carte est reconstruite. Les notifications permettent que ce rafraîchissement se produise rapidement après une activité en magasin plutôt que selon leur propre calendrier.

</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 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/pos/cegid/how-the-cegid-retail-y2-connector-works.md?ask=<question>&goal=<user_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.