> 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/reference-developpeur/cegid-retail-y2-apis.md).

# API Cegid Retail Y2

Passez en revue les services Cegid Retail Y2 utilisés par The Wallet Crew et accordez l’accès utilisateur de service uniquement pour les parcours Wallet activés.

Cette page répertorie les services Cegid Retail Y2 utilisés par le connecteur et leur rôle. Elle prend en charge un accès par utilisateur de service à privilège minimal pour chaque parcours Wallet activé.

Pour la configuration du connecteur, voir [Configurer le connecteur Cegid Retail Y2](/connectors/fr/pos/cegid/installation-et-configuration/connect-with-cegid-retail-y2.md). Pour la synchronisation des champs client transportés par ces services, voir [Mappage des champs Cegid Retail Y2](/connectors/fr/pos/cegid/donnees-client-et-fidelite/cegid-retail-y2-fields-mapping.md).

### En un coup d'œil

Le connecteur utilise deux modèles d’intégration. Les appels de services web récupèrent ou mettent à jour les données à la demande, et les notifications métier signalent les événements qui doivent déclencher une actualisation. La plupart des services sont en SOAP ; la génération des reçus et les données de référence sont en REST.

### Client

Recherche, création et mise à jour de client, ainsi que les champs de consentement associés à l’enregistrement. Utilisé par chaque parcours Wallet impliquant un client identifié.

**Opérations :** rechercher des identifiants client, ajouter un nouveau client, mettre à jour un client.

### Fidélité

Cycle de vie des cartes et données du programme. Deux services sont impliqués : le service de fidélité pour les cartes rattachées à un client et le détail d’une carte individuelle, et le moteur de fidélité pour les programmes disponibles dans un magasin.

**Opérations :** lister les cartes d’un client, créer une carte, lire une carte, lister les programmes actifs pour la création de carte dans un magasin.

### Opérations de caisse

Bons, cartes cadeaux, certificats et dépôts rattachés à un client, ainsi que le solde disponible sur un instrument individuel.

**Opérations :** lister les instruments disponibles d’un client, lire le montant disponible d’un instrument.

### Documents de vente

Enregistrements de transaction, pour les parcours de reçu et de commande.

**Opérations :** lire par clé, lire par référence externe, lister les en-têtes de documents, créer un document.

### Rapport de vente

Génération de PDF de reçu, via REST plutôt que SOAP. La génération se déroule en trois étapes : demander le document, interroger jusqu’à ce qu’il soit prêt, le télécharger.

### Données de référence

Pays, régions, langues et civilités, lus via REST pour alimenter les options du formulaire d’inscription avec les valeurs reconnues par la propre base de données Cegid de la marque.

### Magasins et vendeurs

Le catalogue des magasins et les listes de vendeurs pour les mises en page affichant un conseiller.

**Opérations :** lister les magasins, lister les vendeurs.

### Abonnement aux notifications métier

Gestion de l’abonnement aux notifications décrit dans [Notifications métier](/connectors/fr/pos/cegid/evenements-et-operations/business-notifications.md).

**Opérations :** lire les abonnements actifs, créer, mettre à jour, supprimer.

### Tâches planifiées

Liste et déclenchement des tâches planifiées Cegid, pour les flux qui doivent en exécuter une dans le cadre de l’inscription.

### Commandes client

Données de commande, pour les parcours click-and-collect et similaires.

{% hint style="info" %}
Seuls les services prenant en charge les parcours concernés doivent être accordés. Un programme couvrant l’inscription et l’affichage de la fidélité, sans parcours de reçu, n’exige pas les documents de vente, le rapport de vente ni les commandes client.
{% endhint %}

### FAQ

<details>

<summary><strong>Le connecteur repose-t-il uniquement sur les notifications ?</strong></summary>

Non. Le connecteur utilise des appels directs aux services web pour lire et écrire les données, et des notifications métier uniquement pour réagir aux événements en temps quasi réel.

</details>

<details>

<summary><strong>Quel service génère les PDF de reçu ?</strong></summary>

Le service de rapport de vente génère le PDF. Le service des documents de vente est utilisé séparément pour récupérer les données du document et les listes de documents.

</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/reference-developpeur/cegid-retail-y2-apis.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.