> 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/donnees-client-et-fidelite/loyalty-cards-and-programmes.md).
# Cartes de fidélité et programmes
Créez des cartes de fidélité Cegid Retail Y2 et affichez les noms des programmes, les points, la valeur stockée et la date d’expiration sur les cartes Wallet.
Le connecteur crée des cartes de fidélité dans Cegid Retail Y2 et lit les détails de la carte, les noms des programmes et les soldes de points pour les Cartes Wallet. Cela permet de maintenir les cartes de fidélité Apple Wallet et Google Wallet alignées avec les données Cegid.
Exemples concrets
* Un client s’inscrit en caisse et reçoit une Carte de fidélité portant son numéro de carte et son solde actuel.
* Un achat ajoute des points dans Cegid, et le solde sur la Carte se met à jour.
* Une carte est émise en ligne sans magasin associé, en utilisant un magasin par défaut configuré.
### Création d’une carte
Une carte de fidélité est créée en ajoutant l’étape correspondante au flux d’inscription, après l’étape qui crée le client. La carte est créée pour le magasin où le client est en cours d’inscription, et le flux peut être configuré pour ignorer le magasin indiqué par la session de l’utilisateur final et utiliser à la place un magasin par défaut fixe, ce qui est utile pour une inscription en ligne lorsqu’aucun magasin réel ne s’applique.
Deux prérequis Cegid déterminent si la création réussit. Le magasin doit appartenir à la campagne de fidélité concernée et il doit être ouvert. Lorsqu’un magasin fermé est utilisé, le connecteur réessaie une fois avec le magasin par défaut configuré avant d’échouer.
### Lecture des données de fidélité
Les cartes associées à un client sont lues à la demande, puis filtrées pour ne conserver que celles qui sont actives et non fermées. Lorsque Cegid indique quels programmes sont disponibles dans le magasin, la liste est encore réduite aux cartes appartenant à ces programmes, afin qu’une carte d’un programme sans lien n’apparaisse pas sur une Carte.
Les valeurs suivantes sont mises à disposition pour les modèles de Carte.
| Champ | Contient |
| ------------------------------------ | ----------------------------------------------------------------- |
| `loyalty.programName` | Le nom du programme de fidélité auquel appartient la carte. |
| `loyalty.points` | Le solde de points, sans les zéros finaux. |
| `loyalty.activationDate` | Quand la carte a été activée. |
| `loyalty.expirationdate` | Quand la carte expire. |
| `loyalty.amount`, `loyalty.currency` | Valeur stockée, lorsque le programme comporte un solde monétaire. |
{% hint style="warning" %}
`loyalty.expirationdate` est orthographié entièrement en minuscules, contrairement aux champs qui l’entourent. Il s’agit d’une incohérence connue ; les modèles doivent utiliser l’orthographe exactement comme affichée.
{% endhint %}
L’identifiant de la carte elle-même est inscrit sur la Carte sous la forme `y2.loyaltyCardId`.
### Lorsqu’une carte est désactivée
Une Carte porte l’identifiant de la carte de fidélité qu’elle représente. Si cette carte est ensuite désactivée dans Cegid, les lectures à son sujet échouent, et Cegid indique que le programme n’est pas associé à une campagne définie pour le magasin. Ce message est trompeur, car la cause sous-jacente est la carte plutôt que la campagne.
La solution consiste à supprimer l’identifiant de carte de fidélité de la Carte concernée, afin que la prochaine lecture résolve à la place la carte actuelle du client.
### FAQ
Un nouveau magasin ne peut pas créer de cartes de fidélité. Que manque-t-il ?
Le magasin est presque certainement absent de la campagne de fidélité Cegid. L’y ajouter résout le problème ; aucune modification n’est nécessaire dans The Wallet Crew.
Pourquoi une Carte n’affiche-t-elle aucun point immédiatement après un achat ?
Soit le cache de fidélité conserve une réponse récente, comme décrit dans [Configuration avancée](/connectors/fr/pos/cegid/installation-et-configuration/advanced-configuration.md), soit Wallet n’a pas encore demandé de mise à jour. [Notifications métier](/connectors/fr/pos/cegid/evenements-et-operations/business-notifications.md) raccourcissez le second délai.
Un client peut-il détenir plusieurs cartes de fidélité ?
Cegid l’autorise. Le connecteur lit les cartes actives et non fermées et les restreint aux programmes disponibles dans le magasin, de sorte que ce qui apparaît sur une Carte dépend de la configuration du programme.
---
# 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/donnees-client-et-fidelite/loyalty-cards-and-programmes.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.