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.

Prérequis côté Cegid

Préparez Cegid Retail Y2 pour The Wallet Crew avec l’accès aux services, les chronos, les campagnes de fidélité, les données de référence et la capacité de requêtes.

Une intégration Cegid Retail Y2 dépend du fait que l’accès Cegid, les données de référence et la capacité soient prêts avant le démarrage de la configuration du connecteur. Cette page fournit à l’administrateur Cegid une liste de contrôle de préparation.

Exemples concrets
  • Une nouvelle boutique ouvre, son chrono est actif mais presque épuisé, et l’enrôlement échoue à la caisse le deuxième jour d’exploitation.

  • Deux lignes de pays partagent le code ISO-2 d’un même marché, et chaque enrôlement provenant de ce marché échoue jusqu’à ce que le doublon soit supprimé dans Cegid.

  • Le mot de passe d’un compte de service expire dans le cadre d’une politique de sécurité habituelle, et chaque boutique cesse de s’enrôler simultanément.

Un utilisateur dédié aux services web

Le connecteur s’authentifie auprès de Y2 en tant qu’utilisateur Cegid nommé. Ce compte doit être créé pour The Wallet Crew plutôt que réutilisé depuis une autre intégration, et ne se voir accorder que les permissions de service web et l’accès aux données requis par les parcours Wallet visés. API Cegid Retail Y2 répertorie les services concernés, afin que les permissions puissent être définies avec précision.

Deux propriétés du compte comptent davantage qu’il n’y paraît. Son mot de passe ne doit pas expirer, sinon le connecteur cesse de fonctionner sans avertissement à une date que personne n’a consignée. Lorsque la politique Cegid le permet, le compte doit être exempté d’expiration ; sinon, la date d’expiration doit être suivie et le connecteur mis à jour avant qu’elle ne soit dépassée. Et les boutiques auxquelles le compte est rattaché déterminent quels clients il peut voir, ainsi que la boutique à laquelle un client nouvellement créé est attribué.

Chronos avec marge

Cegid utilise des compteurs, appelés chronos, pour attribuer des identifiants aux nouveaux enregistrements. Chaque boutique pour laquelle le connecteur créera des clients a besoin d’un chrono actif, mais l’activation seule ne suffit pas. Un chrono a une plage finie, et une boutique qui a consommé sa plage cesse d’attribuer des identifiants.

Adhésion au programme de fidélité

Lorsque le programme Wallet émet des cartes de fidélité, chaque boutique qui les créera doit appartenir à la campagne de fidélité Cegid concernée. Une boutique absente de la campagne ne peut pas avoir de cartes créées pour elle, et le connecteur indique qu’aucune campagne de fidélité n’a pu être trouvée.

Données de référence propres

Le connecteur fait correspondre les pays entre les identifiants propres à Cegid et les codes ISO. Ce mappage suppose que les tables de référence Cegid sont non ambiguës, et en pratique elles ne le sont souvent pas. Des lignes de pays dupliquées partageant un code ISO-2, ou des entrées de nationalité pointant vers le mauvais territoire, sont des cas courants et anciens.

Ces défauts se traduisent par des erreurs à l’enrôlement, et ils ne peuvent pas être corrigés depuis The Wallet Crew. La table de référence doit être dédupliquée dans Cegid. Vérifier les tables des pays et des nationalités avant la mise en service est bien moins coûteux que diagnostiquer ensuite les erreurs qui en résultent.

Capacité de requêtes

Cegid applique un plafond au nombre de requêtes de service web qu’un environnement peut effectuer dans une fenêtre glissante. Cette capacité est partagée avec toutes les autres applications qui appellent le même environnement Cegid, et n’est pas réservée à The Wallet Crew.

Avant la mise en service, l’administrateur Cegid doit confirmer à quel forfait l’environnement est rattaché et quelle part de sa capacité est déjà consommée par d’autres intégrations. Le reste est ce qui doit être configuré comme limite du connecteur, comme décrit dans Configuration avancée.

Liste de contrôle

Élément
Responsable
Vérifié par

Utilisateur Y2 de service web dédié créé, avec les permissions requises

Administrateur Cegid

Test de connexion dans la console d’administration

Expiration du mot de passe désactivée, ou date d’expiration consignée

Administrateur Cegid

Politique utilisateur Cegid

Chrono actif sur chaque boutique qui s’enrôle, avec de la plage restante

Administrateur Cegid

Configuration du compteur Cegid

Chaque boutique qui s’enrôle est présente dans la campagne de fidélité

Marque, avec Cegid

Création d’une carte de fidélité de test

Tables de référence des pays et des nationalités sans doublons

Administrateur Cegid

Un enrôlement de test par marché

Capacité de requêtes confirmée et répartie

Administrateur Cegid

Documentation du forfait Cegid

FAQ

Un seul utilisateur de service web peut-il servir toutes les boutiques ?

Oui, et la plupart des marques fonctionnent exactement ainsi. Un utilisateur distinct par boutique n’est nécessaire que lorsque les boutiques doivent être distinguées par les identifiants utilisés. Connexions et magasins explique ce que cela change et ce que cela coûte à maintenir.

Le connecteur fonctionne-t-il avec Cegid Retail Y2 sur site ?

Oui, à condition que The Wallet Crew puisse accéder au réseau aux services web Y2 requis.

Que se passe-t-il si un chrono arrive à expiration après la mise en service ?

L’enrôlement dans cette boutique échoue jusqu’à ce que la plage soit étendue dans Cegid. Les clients déjà enrôlés ne sont pas affectés, et aucune donnée n’est perdue ; la boutique ne peut simplement pas créer de nouveaux enregistrements entre-temps.

Mis à jour