> 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/installation-et-configuration/connections-and-stores.md).

# Connexions et magasins

Configurez plusieurs connexions Cegid Retail Y2, acheminez chaque magasin vers les bons identifiants et maintenez les intégrations multi-magasins.

Le connecteur peut utiliser une seule connexion Cegid ou des connexions distinctes pour chaque magasin. Cette page explique quand plusieurs connexions sont nécessaires, comment le connecteur en sélectionne une, et ce qui nécessite une maintenance continue.

### Quand plusieurs connexions sont nécessaires

Une seule connexion suffit dès lors qu’un seul jeu d’identifiants Cegid peut voir et agir sur chaque client couvert par le programme Wallet. Cela couvre la grande majorité des implémentations, y compris la plupart des déploiements multi-marchés, car les marchés sont généralement séparés par magasin plutôt que par identifiants.

Plusieurs connexions deviennent nécessaires dans deux situations. La première est celle de bases de données Cegid réellement distinctes : une marque exploitant des environnements Cegid séparés pour différentes régions ou enseignes. La seconde, et la plus courante en pratique, est une base de données unique dans laquelle chaque magasin a son propre utilisateur de service web, de sorte que les enregistrements créés par ce magasin portent leur propre préfixe d’identifiant de magasin et consomment le compteur de ce magasin.

{% hint style="info" %}
Les identifiants par magasin offrent une attribution précise dans Cegid, au prix d’une entrée de configuration par magasin qui doit être créée à chaque ouverture et maintenue à chaque changement de mot de passe. Les marques exploitant des parcs de ce type devraient lire [Runbooks d’exploitation](/connectors/fr/pos/cegid/evenements-et-operations/operations-runbooks.md) en complément de cette page.
{% endhint %}

### Ajouter et supprimer des connexions

Les connexions sont gérées depuis la barre d’outils des connexions en haut de la page de configuration Cegid. Le sélecteur répertorie chaque connexion avec son identifiant de base de données, en marquant la valeur par défaut. À côté se trouvent les actions permettant d’ajouter une connexion, de supprimer celle sélectionnée et de la définir comme connexion par défaut.

Une nouvelle connexion est créée avec, préremplies, l’URL du service et les identifiants de la connexion par défaut, de sorte que dans le cas courant — l’ajout d’un nouveau magasin dans une base existante — seul le nom, ainsi que le nom d’utilisateur et le mot de passe propres au magasin, doivent être modifiés.

### Comment une connexion est choisie

Lorsqu’une requête concerne un magasin particulier, le connecteur sélectionne une connexion selon un ordre fixe :

1. La connexion explicitement liée à ce magasin, si elle est configurée.
2. Une connexion dont le **nom est exactement l’identifiant du magasin**.
3. La connexion par défaut.

```mermaid
flowchart TD
  A["La requête concerne le magasin 0431"] --> B{"Une connexion est-elle explicitement liée au magasin 0431 ?"}
  B -- Oui --> C["Utiliser la connexion liée"]
  B -- Non --> D{"Existe-t-il une connexion nommée exactement 0431 ?"}
  D -- Oui --> E["Utiliser cette connexion"]
  D -- Non --> F["Revenir à la connexion par défaut"]
  F --> G["Aucune erreur n’est signalée à l’opérateur.<br/>Le client est créé avec le préfixe de magasin de la<br/>connexion par défaut."]
```

La deuxième règle est celle sur laquelle reposent la plupart des parcs, et c’est pourquoi le nommage des connexions n’est pas purement cosmétique : nommer chaque connexion d’après l’identifiant de son magasin est ce qui permet de faire appliquer les identifiants propres au magasin sans aucune configuration supplémentaire.

{% hint style="warning" %}
Une seule connexion doit être marquée comme connexion par défaut. Lorsqu’elles sont plusieurs à porter cet indicateur, celle qui est traitée comme par défaut n’est pas définie, et les magasins qui y aboutissent peuvent s’authentifier de manière incohérente.
{% endhint %}

{% hint style="danger" %}
Un magasin qui ne correspond à aucune des deux premières règles retombe sur la connexion par défaut sans qu’aucune erreur soit signalée à l’opérateur. L’inscription réussit, avec les identifiants du mauvais magasin, et le client résultant porte le mauvais préfixe d’identifiant. Lorsque des clients apparaissent dans Cegid attribués à un magasin inattendu, une connexion dont le nom ne correspond pas est la première chose à vérifier.
{% endhint %}

### Lier un magasin à une connexion nommée

Lorsqu’une connexion ne peut pas être nommée d’après le magasin — parce qu’une seule connexion sert plusieurs magasins, par exemple — le magasin peut être lié explicitement à une connexion nommée. Ce lien est défini sur l’enregistrement du magasin dans la configuration du tenant et n’a pas d’équivalent sur la page du connecteur, c’est donc l’un des rares paramètres qui nécessite l’espace de travail de configuration décrit dans [Configuration avancée](/connectors/fr/pos/cegid/installation-et-configuration/advanced-configuration.md).

### Magasin d’attache et magasin de création

Cegid distingue le magasin auquel un client est rattaché du magasin où l’enregistrement a été créé. Le connecteur écrit le magasin d’attache, et le relit en priorité par rapport au magasin de création, ne revenant à la création que lorsque l’attache est vide.

Le magasin de création est défini par Cegid lui-même à partir des identifiants utilisés, ce qui constitue le mécanisme derrière les préfixes d’identifiant. Il ne peut pas être choisi via le service web avec lequel le connecteur écrit, donc un enregistrement créé avec les identifiants d’un magasin porte définitivement le préfixe de ce magasin.

{% hint style="warning" %}
L’attribution du magasin enregistrée sur une Carte reflète le magasin d’attache au moment où la Carte a été créée, et n’est pas révisée par la suite. Lorsqu’un magasin ferme ou qu’un client transfère, les Cartes historiques continuent d’indiquer le magasin d’origine.
{% endhint %}

### Modèles à éviter

Trois habitudes reviennent dans les configurations multi-connexions de longue durée, et chacune provoque un problème caractéristique.

**Commenter et décommenter des connexions** comme moyen de désactiver des magasins laisse une configuration dans laquelle les entrées actives et retirées sont entremêlées, et rend facile à manquer une faute de frappe dans une entrée active. La suppression de la connexion est préférable.

**Magasins retirés laissés configurés** continuent d’être testés à chaque contrôle de configuration, produisant des erreurs persistantes qui apprennent aux opérateurs à ignorer le résultat du test.

**Paramètres de reçu appliqués à certaines connexions seulement** produisent des reçus qui diffèrent d’un magasin à l’autre sans cause évidente.

### FAQ

<details>

<summary><strong>Pourquoi un client a-t-il obtenu un identifiant avec le mauvais préfixe de magasin ?</strong></summary>

L’enregistrement a été créé à l’aide d’identifiants appartenant à un autre magasin. Soit le magasin n’a pas sa propre connexion et la requête est retombée sur la connexion par défaut, soit le nom de la connexion ne correspond pas exactement à l’identifiant du magasin.

</details>

<details>

<summary><strong>Peut-on corriger après coup un préfixe d’identifiant ?</strong></summary>

Pas par The Wallet Crew, car l’identifiant est attribué par Cegid. Lorsque Cegid réémet des identifiants, les Cartes peuvent être mises à jour pour pointer vers les nouveaux identifiants, à condition de disposer du mappage entre les anciens et les nouveaux.

</details>

<details>

<summary><strong>Y a-t-il une limite au nombre de connexions ?</strong></summary>

Non, aucune limite fixe. Des parcs comptant plusieurs dizaines de connexions sont exploités en production. Au-delà de quelques-unes, c’est la charge de maintenance plutôt que la plateforme qui devient la contrainte.

</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 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/installation-et-configuration/connections-and-stores.md?ask=<question>&goal=<user_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.