Comment fonctionne le connecteur Cegid Retail Y2

Comprenez comment le connecteur Cegid Retail Y2 échange les données client, de fidélité, de voucher et de ventes avec The Wallet Crew.

Deux principes expliquent le comportement du connecteur : Cegid reste le système de référence, et le connecteur lit les données à la demande.

Cegid détient les données, The Wallet Crew détient la carte

Le connecteur ne se comporte pas comme une base de données client Cegid distincte. Lorsqu'un formulaire d'inscription est soumis, le profil est écrit dans Cegid Retail Y2 puis relu. Lorsqu'une carte est générée, ses données client, de fidélité et de bons sont récupérées depuis Cegid. The Wallet Crew conserve la carte et les identifiants nécessaires pour la relier à l'enregistrement Cegid correspondant.

Si un enregistrement client est écrasé ou corrompu dans Cegid, The Wallet Crew ne peut pas le restaurer. Il n'existe pas de seconde copie. La récupération relève de Cegid, via sa propre piste d'audit.

Les deux sens du trafic

Les données circulent entre les deux systèmes de deux façons très différentes, et les confondre est une source fréquente de malentendus.

Appels sortants transportent presque tout le trafic. Le connecteur appelle les services web Y2 pour rechercher un client, créer ou mettre à jour un profil, créer une carte de fidélité, lister les bons ou récupérer un document de vente. Ces appels se produisent lorsqu'un formulaire est soumis puis à nouveau chaque fois qu'une carte est générée. Comme Apple Wallet et Google Wallet interrogent les mises à jour de carte selon leur propre calendrier, un seul client peut générer de nombreuses lectures sur une journée, d'où l'existence de la mise en cache et de la limitation du débit. Les deux sont abordées dans Configuration avancée.

Notifications métier entrantes sont facultatives et transportent très peu de données. Cegid peut être configuré pour notifier The Wallet Crew lorsqu'un client est créé ou mis à jour, qu'un reçu est créé ou qu'une opération sur carte de fidélité se produit. La notification transporte des identifiants, pas du contenu : le connecteur réagit en relisant l'enregistrement concerné depuis Cegid et en actualisant les cartes pertinentes.

Comme les notifications déclenchent des lectures plutôt qu'elles ne les remplacent, activer les notifications métier augmente le trafic vers Cegid au lieu de le réduire. L'avantage est la fraîcheur, pas l'efficacité.

Ce qui se retrouve sur une carte

Lorsque le connecteur identifie un client, il écrit un petit ensemble d'identifiants sur la carte afin que les lectures ultérieures aillent directement au bon enregistrement Cegid au lieu de rechercher à nouveau. L'identifiant client Cegid est stocké sous la forme id.y2.customerId, et une carte de fidélité associée sous la forme y2.loyaltyCardId. Les cartes cadeau, les certificats et les dépôts reçoivent chacun leur propre identifiant dans la même famille.

Les valeurs de fidélité sont exposées pour être utilisées dans les modèles de carte sous un loyalty. préfixe : le nom du programme, les dates d'activation et d'expiration, le solde de points, et pour les produits à valeur stockée, un montant et une devise.

Le connecteur place aussi la réponse brute de Cegid sur le compte sous des clés commençant debug.y2.. Ce sont des et non champs de modèle de carte. Ils existent dans les données transmises à un script de mappage, afin d'aider à écrire et à déboguer les mappages, et sont décrits dans Personnaliser le mappage.

Les éléments en jeu

Trois types de composants constituent le connecteur, et la configuration du tenant les désigne par leur nom.

Fournisseurs client lisent dans Cegid lorsqu'une carte ou un formulaire a besoin de données. Le y2 récupère le profil client, y2.loyalty récupère les cartes de fidélité, y2.customerCashOperations et y2.cashOperations récupèrent les bons et la valeur stockée, et y2.tickets récupère les documents de vente.

Éléments de flux sont les étapes d'un flux d'inscription ou de mise à jour qui écrivent dans Cegid. Le y2Customer crée ou met à jour le profil, y2Loyalty crée une carte de fidélité, y2PendingTicket génère un reçu en attente, et y2ExecuteScheduledTask déclenche une tâche planifiée Cegid.

Travaux planifiés s'exécute selon son propre calendrier. La cegid.newOrderWalletUpdate tâche actualise les cartes affectées par les commandes récentes, en remontant par défaut sur une heure.

FAQ

The Wallet Crew stocke-t-il les données personnelles des clients de Cegid ?

Le connecteur lit les données client depuis Cegid lorsqu'il est nécessaire de générer ou mettre à jour une carte. Il ne maintient pas de base de données client Cegid distincte.

Pourquoi un seul client génère-t-il autant d'appels à Cegid ?

Apple Wallet et Google Wallet interrogent les mises à jour de carte indépendamment de toute action utilisateur, et chaque interrogation qui entraîne la reconstruction d'une carte lit les données depuis Cegid. La mise en cache, décrite dans Configuration avancée, est la solution prévue.

Les notifications métier sont-elles nécessaires ?

Non. Sans elles, les données Wallet se rafraîchissent toujours chaque fois qu'une carte est reconstruite. Les notifications permettent que ce rafraîchissement se produise rapidement après une activité en magasin plutôt que selon leur propre calendrier.