# API Cegid Retail Y2
Cette page répertorie les services Cegid Retail Y2 utilisés par le connecteur The Wallet Crew. Elle explique le rôle de chaque service, son importance et les méthodes appelées.
Pour la configuration du connecteur, voir [Connexion avec Cegid Retail Y2](/docs/fr/connecter/pos/cegid/connect-with-cegid-retail-y2.md). Pour la synchronisation des champs client, voir [Mappage des champs Cegid Retail Y2](/docs/fr/connecter/pos/cegid/cegid-retail-y2-fields-mapping.md).
### En un coup d’œil
The Wallet Crew se connecte à Cegid Retail Y2 en temps réel via des API et des notifications métier. Chaque service prend en charge un cas d’usage Wallet spécifique.
* **Client** prend en charge la recherche de profil, la création, la mise à jour et la gestion du consentement. Il est utilisé pour exposer les données client dans les parcours Wallet.
* **Opérations de caisse** expose les bons et les cartes-cadeaux disponibles. Il est utilisé pour afficher les avantages Wallet et la valeur stockée.
* **Fidélité** prend en charge la création de cartes de fidélité et la récupération des données de fidélité, comme les détails de la carte ou les points.
* **Documents de vente** expose les reçus et les documents de vente. Il est utilisé pour l’affichage des reçus et les parcours liés au click-and-collect.
* **Notifications métier** envoie des événements liés à l’activité de fidélité, d’achat ou de commande. Il est utilisé pour actualiser les données Wallet et déclencher des notifications push en temps réel.
Exemples concrets
* Une marque crée ou met à jour un client à partir d’un formulaire d’inscription. The Wallet Crew réécrit le profil dans Cegid Retail Y2.
* Une carte de fidélité est créée dans Cegid Retail Y2, puis affichée dans Apple Wallet ou Google Wallet avec les soldes ou avantages à jour.
* Un achat récent déclenche la récupération du reçu ou la génération d’un PDF, afin que le document puisse être exposé dans un parcours Wallet.
### Comment fonctionne l’intégration
The Wallet Crew utilise deux modes d’intégration avec Cegid Retail Y2. Les appels aux services web récupèrent ou mettent à jour les données à la demande. Les notifications métier signalent des événements devant déclencher un rafraîchissement ou une notification Wallet.
En pratique, les services client et fidélité prennent en charge l’inscription et le cycle de vie des cartes. Les services d’opérations de caisse et de documents de vente exposent les avantages et les données de transaction. Le point de terminaison du rapport de ventes génère des PDF de reçus lorsqu’un fichier document est nécessaire.
### Services utilisés par The Wallet Crew
#### Client
Le service client prend en charge la recherche de profil, la création, la mise à jour et la synchronisation du consentement. Il constitue la base des parcours Wallet liés au compte.
**Point de terminaison :** `CustomerWcfService.svc`
**Méthodes utilisées**
* `SearchCustomerIds` recherche des fiches client, généralement par e-mail.
* `UpdateCustomer` met à jour un profil client existant.
* `AddNewCustomer` crée un nouveau client dans Cegid Retail Y2.
#### Opérations de caisse
Le service d’opérations de caisse expose les bons et les cartes-cadeaux rattachés à un client. Cela rend la valeur stockée ou les avantages disponibles accessibles dans les expériences Wallet.
**Point de terminaison :** `CashOperationsWcfService.svc`
**Méthodes utilisées**
* `GetCustomerAvailableBons` récupère les bons ou cartes-cadeaux disponibles pour un client.
#### Fidélité
Les services de fidélité gèrent les cartes de fidélité et les données des programmes. Ils sont utilisés pour créer des cartes, récupérer les détails d’une carte et déterminer quels programmes sont disponibles.
**Points de terminaison :** `LoyaltyWcfService.svc` et `LoyaltyEngineLoyaltyEngineService.svc`
**Méthodes utilisées**
* `GetCustomerCards` renvoie les cartes de fidélité liées à un client.
* `GetLoyaltyCard` renvoie les détails d’une carte de fidélité spécifique.
* `CreateLoyaltyCard` crée une nouvelle carte de fidélité dans Cegid Retail Y2.
* `GetCardCreationActiveProgramsOnStore` renvoie les programmes de fidélité disponibles pour un magasin.
#### Documents de vente
Le service de documents de vente donne accès aux enregistrements de transaction. Il est utilisé pour les cas d’usage Wallet qui dépendent de reçus ou de documents liés au click-and-collect.
**Point de terminaison :** `SaleDocumentService.svc`
**Méthodes utilisées**
* `GetByKey` récupère un document de vente spécifique par clé.
* `GetHeaderList` récupère une liste de documents de vente récents.
#### Rapport de ventes
Le service de rapport de ventes génère un PDF de reçu. Il est utilisé lorsqu’un document rendu est nécessaire à la place des données brutes du document de vente.
**Point de terminaison :** `SalesExternalReport` (REST)
**Flux de génération du PDF de reçu**
Le flux de reçu comporte trois étapes. D’abord, `generatedocument` lance la génération du PDF. Ensuite `poll` vérifie si le fichier est prêt. Enfin, `download` récupère le PDF généré.
**Méthodes utilisées**
* `generatedocument` lance une nouvelle génération de PDF.
* `poll` vérifie si le PDF est disponible.
* `download` télécharge le PDF généré.
#### Employé
Le service employé récupère les données du personnel du magasin. Il est principalement utilisé lorsqu’une mise en page Wallet doit afficher un conseiller ou un vendeur.
**Point de terminaison :** `EmployeeSalespersonsService.svc`
**Méthodes utilisées**
* `GetListDetail` renvoie la liste des conseillers d’un magasin.
#### Notifications métier
Les notifications métier maintiennent les données Wallet à jour sans attendre un rafraîchissement manuel. Elles permettent à The Wallet Crew de réagir à des événements tels que des mises à jour de fidélité, des achats ou des commandes.
**Point de terminaison :** `BusinessNotificationSubscriptionService.svc`
**Méthodes utilisées**
* `GetActive` liste les abonnements actifs.
* `Update` met à jour un abonnement existant.
* `Create` crée un nouvel abonnement.
* `Delete` supprime un abonnement existant.
### Pourquoi ces API sont importantes
Ensemble, ces services permettent à The Wallet Crew de maintenir les profils client, les données de fidélité, les avantages et les enregistrements de transaction synchronisés avec Cegid Retail Y2. Cette synchronisation est ce qui permet aux passes Wallet de sembler à jour, fiables et utiles opérationnellement.
### FAQ
Le connecteur s’appuie-t-il uniquement sur les notifications ?
Non. Le connecteur utilise des appels API directs pour lire et écrire les données, ainsi que des notifications métier pour réagir aux événements en quasi temps réel.
Quel service est utilisé pour les bons et les cartes-cadeaux ?
`CashOperationsWcfService.svc` est utilisé à cette fin via `GetCustomerAvailableBons`.
Quel service génère les PDF de reçus ?
`SalesExternalReport` génère le PDF. `SaleDocumentService.svc` est utilisé séparément pour récupérer les données des documents de vente et les listes de documents.
---
# Agent Instructions: 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:
```
GET https://docs.thewalletcrew.io/docs/fr/connecter/pos/cegid/cegid-retail-y2-apis.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.