> 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/evenements-et-operations/troubleshooting.md).
# Dépannage
Résolvez les erreurs courantes du connecteur Cegid Retail Y2 concernant l’inscription client, les cartes de fidélité, le routage des magasins, les reçus et l’authentification.
Les problèmes d’intégration Cegid proviennent souvent de la configuration Cegid ou des données de référence. Cette page répertorie les symptômes courants, les causes probables et des remèdes pratiques.
### Où regarder en premier
L’outil de journaux du locataire dans la console d’administration est le point de départ de tout problème Cegid. Le filtrage sur le préfixe d’erreur Cegid isole les erreurs soulevées par Cegid lui-même, par opposition aux erreurs du connecteur.
{% hint style="warning" %}
Deux filtres induisent en erreur. Rechercher le préfixe d’erreur Cegid comme texte brut correspond aussi aux identifiants de Carte, ce qui peut gonfler d’un ordre de grandeur un nombre d’erreurs apparent. Rechercher le nom d’hôte Cegid correspond aux liens Wallet qui l’intègrent. Dans les deux cas, il faut restreindre le filtre à la catégorie de journal pertinente avant que les comptes aient le moindre sens.
{% endhint %}
### Défaillances courantes
| Symptôme | Cause | Remède |
| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Cegid signale un numéro de carte inconnu | Une carte référencée sur une Carte ne se résout plus dans Cegid. C’est la défaillance Cegid la plus fréquente en production. | Vérifiez que la carte existe toujours et est active dans Cegid. Sinon, supprimez l’identifiant de carte de la Carte afin que la carte actuelle du client soit utilisée. |
| Échec de la génération automatique d’un code client | Le compteur du magasin est épuisé, ou le magasin n’a pas de compteur. Ce n’est pas un problème d’identifiants, même si cela apparaît souvent avec un tel problème. | Étendez la plage du compteur dans Cegid pour ce magasin. Voir [Prérequis côté Cegid](/connectors/fr/pos/cegid/installation-et-configuration/cegid-side-prerequisites.md). |
| L’inscription réussit mais le client est attribué à un magasin inattendu | Le magasin n’a pas sa propre connexion, ou le nom de la connexion ne correspond pas exactement à l’identifiant du magasin, donc les identifiants de la connexion par défaut ont été utilisés. | Ajoutez une connexion nommée d’après le magasin, ou liez le magasin à la bonne connexion. Voir [Connexions et magasins](/connectors/fr/pos/cegid/installation-et-configuration/connections-and-stores.md). |
| Un client existant est associé de façon intermittente, ou le mauvais enregistrement est mis à jour | Plusieurs enregistrements Cegid correspondent à l’adresse e-mail ou au numéro de téléphone ; le plus récemment modifié est utilisé. | Résolvez les doublons dans Cegid. D’ici là, le comportement variera au fil des modifications des enregistrements. |
| Cegid signale plus d’un pays pour un code ISO | Des lignes de pays en double dans la table de référence Cegid partagent un même code ISO-2. | Dédupliquez la table des pays dans Cegid. |
| Cegid signale qu’aucun pays n’a été trouvé pour un code ISO | La ligne de pays du marché est absente de la table de référence Cegid, ou ne comporte pas de code ISO-2. | Ajoutez ou corrigez la ligne dans Cegid. |
| Un pays renvoyé par Cegid ne peut pas être associé | Cegid contient un identifiant de pays qui ne correspond pas à un code ISO reconnu. | Corrigez les données de référence. L’enregistrement est autrement traité ; seul le pays est ignoré. |
| Cegid signale que le programme n’est pas associé à une campagne pour le magasin | Il s’agit généralement d’une carte de fidélité désactivée référencée par une Carte, plutôt que d’un problème de campagne. Plus rarement, le magasin est réellement absent de la campagne. | Supprimez l’identifiant de carte de la Carte. Si le problème touche tous les clients d’un magasin, ajoutez le magasin à la campagne. |
| L’authentification est rejetée | Le mot de passe de l’utilisateur de service a expiré ou a été modifié, ou les identifiants d’un magasin retiré sont encore configurés. | Mettez à jour les identifiants, ou supprimez la connexion pour un magasin qui ne commercialise plus. |
| La génération du reçu échoue | Le modèle de reçu configuré n’existe pas, ou le document demandé est introuvable. | Vérifiez l’identifiant du modèle sur la connexion concernée, et que le document existe dans Cegid. |
| L’inscription échoue uniquement pour certains marchés | Cegid rejette certains caractères dans les champs d’adresse, même s’il les accepte ailleurs dans l’enregistrement. | Normalisez les champs concernés dans le script de mappage, en utilisant `ensureLatin` depuis le [Référence de script](/connectors/fr/pos/cegid/reference-developpeur/scripting-reference.md). |
| Un magasin peut se connecter depuis le siège mais pas depuis la boutique | Des tentatives de connexion répétées et infructueuses depuis l’adresse de la boutique ont déclenché un blocage de protection sur cette adresse. | Le compte lui-même n’est pas affecté. Le blocage se lève avec le temps ; les tentatives répétées le prolongent. |
### Problèmes de mappage
Lorsqu’un champ est renseigné mais n’apparaît jamais, ou apparaît au mauvais endroit, la cause est généralement l’une d’un petit ensemble d’erreurs de script répertoriées dans [Personnaliser le mappage](/connectors/fr/pos/cegid/donnees-client-et-fidelite/customise-the-mapping.md): un identifiant à base zéro lu comme à base un, `filter` utilisé là où `find` était prévu, ou d’une table de mappage qui n’est pas symétrique entre les deux directions.
Un symptôme mérite d’être souligné car il ressemble à un défaut de la plateforme. Si **aucune** personnalisation ne semble prendre effet, une erreur de syntaxe dans n’importe quel fichier de script, pas nécessairement le fichier de mappage, aura empêché le chargement de tous les scripts.
### Mises à jour du consentement
Les valeurs de consentement modifiées dans un formulaire peuvent ne pas mettre à jour un client Cegid existant qui possède déjà une valeur. Lorsque l’exactitude du consentement est critique, vérifiez le résultat dans Cegid après une mise à jour.
### FAQ
Où peut-on voir les erreurs Cegid sans accès à Cegid ?
L’outil de journaux du locataire dans la console d’administration enregistre l’erreur renvoyée par Cegid, y compris son propre code d’erreur, ce qui suffit généralement pour que l’administrateur Cegid agisse directement.
Une erreur est apparue une fois et ne s’est pas reproduite. Faut-il agir ?
Les erreurs isolées sur des enregistrements individuels sont généralement spécifiques aux données, comme un caractère inhabituel ou une valeur de référence manquante, et se résolvent avec l’enregistrement. C’est un schéma touchant tout un magasin ou marché qu’il faut faire remonter.
---
# 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/evenements-et-operations/troubleshooting.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.