Livestore

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

Une fois activée, LiveStore ouvre un formulaire d'inscription hébergé par The Wallet Crew lorsque le personnel crée ou modifie un client. Après la soumission, le personnel est redirigé vers la page des détails du client dans LiveStore. Vous pouvez également activer un mode QR code afin que les clients puissent compléter 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 retourne à la page de détail du client.

• Un magasin utilise une tablette à l'entrée. Un client scanne un QR code et complète l'inscription en libre-service.

Prérequis

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

Côté Cegid, vous devez avoir la permission de modifier newpossettings au niveau, pays, ou magasin niveau.

Côté The Wallet Crew, votre locataire doit disposer du connecteur Cegid Retail Y2 configuré et opérationnel.

• Si vous n'avez pas encore connecté Y2, commencez par Se connecter à Cegid Retail Y2.

• Si vous devez vérifier quels champs client sont synchronisés, consultez mappage des champs Cegid Retail Y2.

Configuration

1

Créer une clé API dans The Wallet Crew

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

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

Gestion des clés API

1. Créez une nouvelle clé API avec le scope 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 LiveStore.

2

Configurer The Wallet Crew (runtime)

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

Mettez à jour la configuration de votre runtime :

1. Dans Configuration Avancée, sur 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. Create 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 niveau, pays, ou magasin niveau. Elle n'est pas disponible au niveau de la caisse.

Choisissez la portée où l'extension s'applique (global, pays ou magasin).

Définissez les LiveStore_Connector_ExternalCustomerForm entrée 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 les valeurs associées

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

Staging

Si vous devez épingler 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 des détails du client dans Live Store.

Si vous obtenez une erreur d'autorisation, vérifiez à nouveau la X-API-KEY valeur de l'en-tête et le scope de la clé API.

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

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

Activez le mode tablette dans server/livestore.yml et pointez la mise en page de redirection vers une mise en page adaptée aux mobiles :

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

FAQ

Où configurer l'extension dans Live Store ?

Utilisation newpossettings. Configurez-la au niveau, pays, ou magasin niveau. Live Store ne prend pas en charge cette extension au niveau de la caisse.

Quelle URL dois-je utiliser pour endpoint et apiEndpoint?

Utilisez le https://app.neostore.cloud/api/<tenantId>/external/livestore base et remplacez <tenantId> par votre ID de locataire dans The Wallet Crew.

Si votre projet utilise un environnement différent (staging, 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 les tests et la production ?

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

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

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