This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

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.

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.

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: 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.

Mis à jour