> 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/installation-et-configuration/connect-with-cegid-retail-y2.md).
# Configurer le connecteur Cegid Retail Y2
Configurez le connecteur Cegid Retail Y2 pour les workflows client, fidélité, reçus, notifications, limitation de débit et cache.
Le connecteur est configuré depuis une page dédiée dans la console d'administration. Cette page couvre les paramètres standard d'une intégration Wallet Cegid Retail Y2.
Avant de commencer, confirmez que les éléments de [Prérequis côté Cegid](/connectors/fr/pos/cegid/installation-et-configuration/cegid-side-prerequisites.md) sont en place. Un connecteur configuré dans un environnement Cegid non préparé se sauvegardera correctement puis échouera lors du premier enrôlement.
### Où se trouvent les paramètres
La page de configuration Cegid est accessible depuis **Intégrations → CRM → Cegid** dans la console d'administration. Elle comporte deux onglets : **Configuration**, abordé sur cette page, et **onglet Mapping**, qui contient le script de personnalisation décrit dans [Personnaliser le mappage](/connectors/fr/pos/cegid/donnees-client-et-fidelite/customise-the-mapping.md).
Les paramètres prennent effet à l'appel suivant à Cegid. Aucun redémarrage ni redéploiement n'est nécessaire.
### Paramètres de connexion
Une connexion correspond à un ensemble d'identifiants pour une base de données Cegid. Chaque locataire en possède au moins une, et la page s'ouvre dessus.
| Champ | Que saisir |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **URL du service** | L'adresse de base hébergeant les services Web Y2. Un slash final `/` est ajouté automatiquement lorsqu'il manque. |
| **Nom** | Une étiquette pour la connexion. Avec une seule connexion, c'est généralement `par défaut`. Avec plusieurs, le nom compte — voir [Connexions et magasins](/connectors/fr/pos/cegid/installation-et-configuration/connections-and-stores.md). |
| **ID de la base de données** | L'identifiant de la base de données Cegid Y2. Il est également envoyé comme identifiant de dossier sur les points de terminaison REST utilisés pour les reçus. |
| **Nom d'utilisateur** | L'utilisateur dédié des services Web Y2. |
| **Mot de passe** | Le mot de passe de cet utilisateur. |
Le connecteur s'authentifie en HTTP Basic, en présentant le nom d'utilisateur qualifié par la base de données. Les deux champs sont combinés automatiquement, donc le nom d'utilisateur doit être saisi seul.
L'identifiant de base de données est le nom de la base de données Cegid Y2, et non l'adresse du service.
### Configuration des reçus
Les paramètres des reçus ne sont pertinents que lorsqu'un parcours Wallet expose des reçus générés par Cegid. **ID du modèle** sélectionne le modèle de reçu Cegid ; le laisser vide utilise la valeur par défaut Cegid. **Duplicata** demande un duplicata d'un reçu déjà émis, et est désactivé sauf si un parcours en a spécifiquement besoin.
{% hint style="warning" %}
Lorsqu'il existe plusieurs connexions, les paramètres des reçus s'appliquent par connexion. Les configurer pour certaines et pas pour d'autres produit des reçus qui diffèrent silencieusement selon le magasin.
{% endhint %}
### Notifications métier
Le **Écouter les notifications métier** interrupteur, ainsi que le nom d'utilisateur et le mot de passe situés en dessous, contrôlent si The Wallet Crew s'enregistre comme abonné aux notifications de Cegid.
{% hint style="danger" %}
Cegid Retail Y2 prend en charge un seul abonnement aux notifications métier. L'activation de ce paramètre remplace l'abonnement actuellement configuré dans Cegid, ce qui interrompra silencieusement tout autre système qui en dépend. Confirmez d'abord à qui il appartient avec l'administrateur Cegid.
{% endhint %}
La distinction entre ce paramètre et le point de terminaison de notification lui-même est importante, et elle est expliquée dans [Notifications métier](/connectors/fr/pos/cegid/evenements-et-operations/business-notifications.md): l'interrupteur gère l'abonnement, pas le point de terminaison.
### Paramètres avancés
Le panneau avancé contient des paramètres qui protègent l'environnement Cegid plutôt que de le décrire. **Limitation de débit** plafonne le nombre de requêtes que le connecteur effectuera dans la fenêtre Cegid. **Cache** des durées, en secondes, conservent brièvement les réponses Cegid afin d'éviter de répéter des lectures identiques. **Mettre à jour le client lors du changement d'installation de la Carte** contrôle si l'installation ou la suppression d'une Carte met à jour l'enregistrement client dans Cegid.
Les valeurs à définir pour chacun, et la raison, sont expliquées dans [Configuration avancée](/connectors/fr/pos/cegid/installation-et-configuration/advanced-configuration.md). Les valeurs par défaut sont sûres : limitation de débit activée, cache désactivé, réécriture à l'installation activée.
### Valider la configuration
L'enregistrement ne confirme pas que les identifiants fonctionnent. Le test de configuration dans la console d'administration effectue une véritable recherche client sur chaque connexion configurée et renvoie le résultat pour chacune, de sorte qu'une seule connexion défectueuse dans une longue liste est identifiée par son nom plutôt que par déduction.
Une fois le test réussi, validez la configuration de bout en bout avec un enregistrement contrôlé.
{% stepper %}
{% step %}
#### Enrôler un client de test
Remplissez un formulaire d'enrôlement avec des données de test.
{% endstep %}
{% step %}
#### Confirmer l'enregistrement dans Cegid
Vérifiez que le profil apparaît dans Cegid Retail Y2, attribué au magasin attendu.
{% endstep %}
{% step %}
#### Confirmer la Carte
Vérifiez que les données de fidélité ou l'avantage attendus apparaissent sur la Carte obtenue.
{% endstep %}
{% step %}
#### Confirmer les mises à jour en temps réel
Lorsque les notifications métier sont activées, modifiez le solde de fidélité dans Cegid et confirmez que la Carte se met à jour.
{% endstep %}
{% endstepper %}
La consommation de requêtes Cegid mérite d'être surveillée pendant cette période, en particulier lorsque d'autres intégrations partagent le même environnement.
### FAQ
Pourquoi le connecteur a-t-il cessé de fonctionner après plusieurs mois ?
Un mot de passe expiré de l'utilisateur de service Cegid est la cause la plus courante. Le renouveler dans Cegid et mettre à jour la connexion rétablit le service. Lorsque le compte ne peut pas être exempté de l'expiration, la date de renouvellement doit être suivie.
La limitation de débit doit-elle être désactivée ?
Non. Elle existe pour maintenir le connecteur dans la capacité autorisée par Cegid. La désactiver déplace l'échec d'un délai géré côté Wallet Crew vers des requêtes rejetées côté Cegid, ce qui affecte aussi les caisses.
Plusieurs bases de données Cegid peuvent-elles être configurées ?
Oui. Les connexions sont ajoutées, supprimées et définies par défaut depuis la barre d'outils de connexion sur cette page. [Connexions et magasins](/connectors/fr/pos/cegid/installation-et-configuration/connections-and-stores.md) couvre quand cela est nécessaire et comment une connexion est sélectionnée.
Les paramètres peuvent-ils être modifiés sous forme de fichier à la place ?
Oui. La configuration est stockée en YAML et peut être modifiée directement dans l'espace de travail de configuration, ce qui est utile pour les quelques paramètres que le formulaire n'expose pas. Il est sûr de combiner les deux approches — voir [Configuration avancée](/connectors/fr/pos/cegid/installation-et-configuration/advanced-configuration.md).
---
# 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/installation-et-configuration/connect-with-cegid-retail-y2.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.
