Livestore

Ce guide explique comment activer l' formulaire client externe extension dans Cegid Retail Live Store.

Une fois activé, LiveStore ouvre un formulaire d'inscription hébergé par The Wallet Crew lorsque le personnel crée ou modifie un client. Après soumission, le personnel est redirigé vers la page de détails du client LiveStore. Vous pouvez également activer un mode code QR afin que les clients puissent terminer l'inscription sur leur propre téléphone.

Exemples concrets

• Un vendeur crée un nouveau client fidélité dans Live Store. Le formulaire The Wallet Crew collecte les données et crée le client dans Cegid Y2.
• Un vendeur modifie un client existant. Le formulaire The Wallet Crew met à jour le client dans Cegid Y2, puis revient à la page de détails du client.
• Un magasin utilise une tablette à l'entrée. Un client scanne un code QR et termine l'inscription dans un parcours en libre-service.

Prérequis

Vous devez avoir accès pour configurer à la fois Live Store et The Wallet Crew.

Du côté de Cegid, vous devez avoir l'autorisation de modifier newpossettings au global, country, ou store niveau.

Du côté de The Wallet Crew, votre locataire doit avoir le connecteur Cegid Retail Y2 connector configuré et fonctionnel.

• Si vous n'avez pas encore connecté Y2, commencez par Connect with Cegid Retail Y2.
• Si vous devez vérifier quels champs client sont synchronisés, consultez Cegid Retail Y2 fields mapping.

Configuration

1

Créer une clé API dans The Wallet Crew

Créez une clé API que Live Store utilisera pour appeler les points de terminaison de The Wallet Crew.

1. Ouvrez la page de gestion des clés API

gestion des clés API

1. Créez une nouvelle clé API avec le périmètre tenant.y2.listener.
2. Copiez la valeur générée et stockez-la dans votre gestionnaire de secrets.

Vous l'utiliserez comme X-API-KEY en-tête dans la configuration de LiveStore.

2

Configurer The Wallet Crew (runtime)

Cette extension nécessite une configuration spécifique à LiveStore dans le runtime de votre locataire.

Mettez à jour votre configuration du runtime :

1. Dans la configuration avancée, dans le fichier security.yml, ajoutez un challenger de compte de type livestore.
2. Mettez à jour votre flux d'inscription pour ajouter un livestore élément de flux.
3. Créer server/livestore.yml:

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

1. Créez ou mettez à jour les deux layouts référencés (mobile_ls et mobile_livestore).

3

Configurer Live Store (newpossettings)

Ouvrez l'administration newpossettings dans votre environnement Live Store :

• Test : https://<your-tenant>-test-retail-ondemand.cegid.cloud/Y2/newpossettings/
• Prod : https://<your-tenant>-retail-ondemand.cegid.cloud/Y2/newpossettings/

Configurez l'extension au global, country, ou store niveau. Elle n'est pas disponible au niveau de la caisse.

Choisissez le périmètre dans lequel l'extension s'applique (global, country ou store).

Définissez l' LiveStore_Connector_ExternalCustomerForm avec les valeurs de votre locataire :

Production

apiEndpoint: https://app.neostore.cloud/api/<YOUR_TENANTID>/external/livestore/session
endpoint: https://app.neostore.cloud/api/<YOUR_TENANTID>/external/livestore
headerName: X-API-KEY
headerValue: <YOUR_API_KEY>

N'oubliez pas de remplacer <YOUR_TENANTID> et <YOUR_API_KEY> par la valeur associée

Si vous avez configuré un domaine personnalisé, remplacez app.neostore.cloud par votre domaine personnalisé

Préproduction

Si vous devez cibler un magasin spécifique, définissez l'extension au niveau du magasin et ajoutez storeId:

endpoint: https://app.neostore.cloud/api/<tenantId>/external/livestore?storeId=<storeId>

4

Valider le flux

Validez d'abord dans un environnement de test.

1. Dans Live Store, ouvrez l'écran de création ou de modification du client.
2. Confirmez que Live Store redirige vers le formulaire d'inscription.
3. Soumettez le formulaire avec des données de test.
4. Confirmez que vous êtes redirigé vers la page de détails du client Live Store.

Si vous obtenez une erreur d'autorisation, revérifiez la X-API-KEY valeur de l'en-tête et le périmètre de la clé API.

Optionnel : afficher un code QR pour l'inscription en libre-service

Utilisez cette option lorsqu'un magasin utilise une tablette et souhaite que les clients poursuivent sur leur propre téléphone.

Activez le mode tablette dans server/livestore.yml et pointez le layout de redirection vers un layout adapté aux mobiles :

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

FAQ

Où dois-je configurer l'extension dans Live Store ?

Utilisez newpossettings. Configurez-la au global, country, ou store niveau. Live Store ne prend pas en charge cette extension au niveau de la caisse.

Quelle URL dois-je utiliser pour point de terminaison et apiEndpoint?

Utilisez l'activité personnalisée https://app.neostore.cloud/api/<tenantId>/external/livestore de base et remplacez <tenantId> par votre ID de locataire dans The Wallet Crew.

Si votre projet utilise un environnement différent (préproduction, QA ou un domaine personnalisé), utilisez l'URL de base fournie par The Wallet Crew lors de la configuration.

Puis-je réutiliser la même clé API pour le test et la production ?

Évitez-le. Utilisez des clés API distinctes pour chaque environnement. Faites pivoter les clés si vous pensez qu'elles ont été exposées.

Live Store redirige, mais j'aboutis sur une page d'erreur. Que dois-je vérifier ?

Commencez par les bases. Confirmez que l' point de terminaison URL est accessible depuis le réseau Live Store. Confirmez que l' X-API-KEY en-tête est présent et correct. Puis confirmez que le connecteur Cegid Retail Y2 est activé dans The Wallet Crew et qu'il peut atteindre vos services Y2.