Cegid Retail Live Store

Activez le formulaire client Cegid Retail Live Store afin que les équipes magasin puissent créer ou modifier des clients via les parcours d’inscription The Wallet Crew.

Cegid Retail Live Store est l'application de point de vente de Cegid. Son formulaire client externe ouvre un flux d'inscription The Wallet Crew lorsque les équipes du magasin créent ou modifient un client. Le flux les ramène ensuite à la fiche client. Une Carte peut également prendre en charge l'inscription en libre-service depuis le téléphone d'un client.

Exemples concrets

• Un conseiller crée un client dans Live Store ; le formulaire The Wallet Crew collecte les données et le profil est créé dans Cegid, avec une Carte émise immédiatement.

• Un conseiller modifie un client existant et le formulaire s'ouvre prérempli depuis Cegid.

• Un magasin utilise une tablette à l'entrée et les clients terminent l'inscription sur leur propre téléphone via un code affiché.

Prérequis

Le connecteur Cegid Retail Y2 doit déjà être configuré et fonctionner, car l'inscription Live Store écrit à travers lui. S'il ne l'est pas, commencez par Configurer le connecteur Cegid Retail Y2, et vérifiez quels champs client sont synchronisés dans Mappage des champs Cegid Retail Y2.

Du côté de Cegid, l'autorisation de modifier les paramètres du point de vente au niveau global, du pays ou du magasin est requise.

Configurer The Wallet Crew

Quatre éléments sont nécessaires, dont aucun ne se trouve sur la page de configuration de Cegid.

1

Créer une clé API

Créez une clé API pour que Live Store puisse appeler The Wallet Crew. Elle doit comporter l'autorisation d'accès Live Store, tenant.livestore.access. Copiez la valeur générée et stockez-la dans un gestionnaire de secrets ; elle est utilisée comme en-tête X-API-KEY dans la configuration Live Store.

La documentation antérieure indiquait une autorisation différente pour cette clé. Une clé sans tenant.livestore.access ne fonctionnera pas.

2

Ajouter le challenger de compte

Dans la configuration de sécurité, ajoutez un challenger de compte de type livestore . C'est ce qui permet à une session Live Store d'identifier le client en cours de modification.

3

Ajouter l'élément de flux

Ajouter un livestore élément de flux au flux d'inscription. Il gère le retour vers Cegid après soumission.

4

Créer la configuration Live Store

Créer server/livestore.yml, en indiquant la mise en page à afficher, si le mode tablette est utilisé, la mise en page vers laquelle rediriger en mode tablette, et si le fournisseur de client est Y2 ou UR.

layout: mobile_ls
useTabletMode: false
provider: y2
customerRedirectLayout: mobile_livestore

Créez ou mettez à jour les deux mises en page référencées.

Configurer Live Store

L'extension est configurée dans les paramètres de point de vente Live Store, au niveau global, du pays ou du magasin. Elle n'est pas disponible au niveau de la caisse.

Choisissez le périmètre auquel l'extension s'applique. Le niveau caisse n'est pas proposé.

Deux adresses sont saisies : l'une que Live Store appelle pour ouvrir une session, et l'autre vers laquelle le navigateur du conseiller est redirigé. Les deux sont spécifiques au tenant, et toutes deux diffèrent entre les environnements de production et de préproduction.

L'utilisation d'une clé de préproduction avec une adresse de production, ou l'inverse, produit un formulaire qui ne parvient pas à se charger. Des clés distinctes par environnement facilitent le diagnostic et permettent d'en révoquer une sans affecter l'autre.

Lorsqu'un seul magasin doit être épinglé, l'identifiant du magasin est ajouté à l'adresse de redirection comme paramètre. Lorsque le modèle d'adresse contient un espace réservé pour le code magasin, celui-ci doit être remplacé par la valeur réelle ; un espace réservé laissé en place produit un formulaire qui s'ouvre puis ne parvient pas à résoudre un magasin.

Fonctionnement de la session

Live Store ouvre une session en appelant The Wallet Crew avec sa clé API, en fournissant le client en cours de modification et une adresse de retour. The Wallet Crew conserve ce contexte pendant une heure et renvoie un identifiant de session. Live Store redirige ensuite le navigateur du conseiller vers le formulaire d'inscription, en transmettant cet identifiant.

L'adresse du formulaire n'est pas authentifiée par conception. Live Store ne peut pas joindre de clé API à une redirection de navigateur, donc l'adresse sur laquelle l'utilisateur arrive ne contient aucun identifiant autre que l'identifiant de session lui-même, et la possession de cet identifiant suffit pour ouvrir la session. Il est à durée de vie courte et impossible à deviner, mais il doit être traité comme un identifiant : les adresses qui en contiennent un ne doivent pas être partagées, consignées dans des journaux ni mises en favori.

Après soumission, le conseiller est renvoyé vers la fiche client dans Live Store. The Wallet Crew ne réécrit pas dans Live Store lui-même ; les données client sont écrites dans Cegid Retail Y2, depuis lequel Live Store les lit.

Inscription en libre-service sur une tablette

Lorsqu'un magasin utilise une tablette plutôt qu'un écran de caisse, le mode tablette affiche un code que le client scanne pour poursuivre l'inscription sur son propre téléphone. Il est activé dans la configuration Live Store, avec la mise en page mobile vers laquelle rediriger.

layout: pos
useTabletMode: true
provider: y2
customerRedirectLayout: mobile

Valider le flux

1. Validez d'abord dans un environnement de test, avec des clés de test et des adresses de test.

2. Ouvrez l'écran de création ou de modification du client dans Live Store et confirmez qu'il redirige vers le formulaire d'inscription.

3. Soumettez le formulaire avec des données de test.

4. Confirmez le retour à la fiche client Live Store, ainsi que l'enregistrement dans Cegid.

FAQ

Le formulaire s'ouvre mais n'affiche rien. Que faut-il vérifier ?

Le plus souvent, une clé API appartenant à un environnement différent de l'adresse appelée. La permission de la clé est la prochaine chose à vérifier, puis le fait que le challenger de compte soit configuré.

La même clé API peut-elle être réutilisée pour le test et la production ?

Ce ne devrait pas être le cas. Des clés distinctes par environnement permettent d'en révoquer une sans affecter l'autre.

Où l'extension est-elle configurée dans Live Store ?

Dans les paramètres de point de vente, au niveau global, du pays ou du magasin. Le niveau caisse n'est pas pris en charge.

Live Store redirige mais le flux se termine sur une page d'erreur. Que faut-il vérifier ?

Vérifiez que l'adresse est accessible depuis le réseau Live Store, que l'en-tête X-API-KEY est présent et correct, et que le connecteur Cegid Retail Y2 est configuré et peut joindre les services Y2.