> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/pos/cegid/livestore.md). # 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](/connectors/fr/pos/cegid/installation-et-configuration/connect-with-cegid-retail-y2.md), et vérifiez quels champs client sont synchronisés dans [Mappage des champs Cegid Retail Y2](/connectors/fr/pos/cegid/donnees-client-et-fidelite/cegid-retail-y2-fields-mapping.md). 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. {% stepper %} {% step %} #### 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. {% hint style="danger" %} La documentation antérieure indiquait une autorisation différente pour cette clé. Une clé sans `tenant.livestore.access` ne fonctionnera pas. {% endhint %} {% endstep %} {% step %} #### 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. {% endstep %} {% step %} #### 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. {% endstep %} {% step %} #### 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. ```yaml layout: mobile_ls useTabletMode: false provider: y2 customerRedirectLayout: mobile_livestore ``` Créez ou mettez à jour les deux mises en page référencées. {% endstep %} {% endstepper %} ### 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.
The Cegid point-of-sale settings scope selector, showing the global, country, and store levels.

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. {% hint style="warning" %} 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. {% endhint %} 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. ```mermaid sequenceDiagram autonumber participant LS as Live Store participant Browser as navigateur du conseiller participant TWC as The Wallet Crew participant Y2 as Cegid Retail Y2 LS->>TWC: Ouvrir la session (clé API, contexte client, adresse de retour) Note over LS,TWC: La clé API n'est utilisée que sur ce saut TWC-->>LS: Identifiant de session, valable une heure LS->>Browser: Rediriger vers le formulaire d'inscription (identifiant de session uniquement) Browser->>TWC: Ouvrir le formulaire d'inscription TWC-->>Browser: Formulaire, prérempli à partir du contexte de session Browser->>TWC: Soumettre l'inscription TWC->>Y2: Écrire les données client TWC-->>Browser: Rediriger vers l'adresse de retour Browser->>LS: De retour sur la fiche client LS->>Y2: Lire les données client ``` {% hint style="danger" %} 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. {% endhint %} 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. ```yaml 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.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.thewalletcrew.io/connectors/fr/pos/cegid/livestore.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.