> 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).

# 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.

<details>

<summary><strong>Exemples concrets</strong></summary>

* 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.

</details>

### 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](/connectors/fr/pos/cegid/connect-with-cegid-retail-y2.md).
* Si vous devez vérifier quels champs client sont synchronisés, consultez [Cegid Retail Y2 fields mapping](/connectors/fr/pos/cegid/cegid-retail-y2-fields-mapping.md).

### Configuration

{% stepper %}
{% step %}

#### 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

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/apiKeys" class="button secondary" data-icon="chevrons-right">gestion des clés API</a><br></p>

2. Créez une nouvelle clé API avec le périmètre `tenant.y2.listener`.
3. 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.
{% endstep %}

{% step %}

#### 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`:

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

4. Créez ou mettez à jour les deux layouts référencés (`mobile_ls` et `mobile_livestore`).
   {% endstep %}

{% step %}

#### 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.

<div data-with-frame="true"><figure><img src="/files/bdf3fad0018d5ad837bc45f8dc463e0de5fcb4c7" alt="Cegid newpossettings scope selection showing Global, Country, and Store level configuration."><figcaption><p>Choisissez le périmètre dans lequel l'extension s'applique (global, country ou store).</p></figcaption></figure></div>

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

{% tabs %}
{% tab title="Production" %}

```yaml
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>
```

{% hint style="info" %}
N'oubliez pas de remplacer \<YOUR\_TENANTID> et \<YOUR\_API\_KEY> par la valeur associée
{% endhint %}

{% hint style="info" %}
Si vous avez configuré un domaine personnalisé, remplacez app.neostore.cloud par votre domaine personnalisé
{% endhint %}
{% endtab %}

{% tab title="Préproduction" %}

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

{% hint style="info" %}
N'oubliez pas de remplacer \<YOUR\_TENANTID> et \<YOUR\_API\_KEY> par la valeur associée
{% endhint %}
{% endtab %}
{% endtabs %}

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

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

{% endstep %}

{% step %}

#### 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.
{% endstep %}
{% endstepper %}

### 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 :

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

### FAQ

<details>

<summary><strong>Où dois-je configurer l'extension dans Live Store ?</strong></summary>

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

</details>

<details>

<summary><strong>Quelle URL dois-je utiliser pour <code>point de terminaison</code> et <code>apiEndpoint</code>?</strong></summary>

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.

</details>

<details>

<summary><strong>Puis-je réutiliser la même clé API pour le test et la production ?</strong></summary>

É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.

</details>

<details>

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

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.

</details>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/connectors/fr/pos/cegid/livestore.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.