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

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

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.

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.

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.

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

1

Enrôler un client de test

Remplissez un formulaire d'enrôlement avec des données de test.

2

Confirmer l'enregistrement dans Cegid

Vérifiez que le profil apparaît dans Cegid Retail Y2, attribué au magasin attendu.

3

Confirmer la Carte

Vérifiez que les données de fidélité ou l'avantage attendus apparaissent sur la Carte obtenue.

4

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.

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