> 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/advanced-configuration.md).
# Configuration avancée
Gérez la limitation du débit Cegid Retail Y2, la mise en cache, les mises à jour d’installation et les paramètres du connecteur basés sur des fichiers.
La limitation de débit et la mise en cache protègent l’environnement Cegid du volume généré par un programme de portefeuille. Un petit nombre de paramètres supplémentaires ne sont disponibles qu’en tant qu’entrées du fichier de configuration. Cette page couvre les deux, ainsi que la manière dont les deux voies de modification sont liées.
### Limitation de débit
Cegid impose un plafond de requêtes sur une fenêtre glissante pour l’ensemble de l’environnement. Le dépasser entraîne des requêtes rejetées, qui affectent toutes les applications partageant cet environnement, y compris les caisses du point de vente. Le connecteur applique donc d’abord sa propre limite, délibérément inférieure à celle de Cegid, afin que l’excès de trafic soit retardé côté Wallet Crew plutôt que refusé côté Cegid.
La limitation de débit est activée par défaut. La limite à configurer correspond à la part de la capacité Cegid allouée à The Wallet Crew, et non au plafond complet du plan, sauf si aucune autre application n’utilise l’environnement.
| Paramètre | Par défaut | Signification |
| --------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Activé | Activé | Indique si le limiteur s’applique. |
| Limite de requêtes autorisées | 4980 | Requêtes autorisées par fenêtre. |
| Fenêtre *(fichier uniquement)* | 300 s | La fenêtre glissante, conforme à celle de Cegid. |
| Réessayer après *(fichier uniquement)* | 60 s | Combien de temps le travail différé attend avant une nouvelle tentative, lorsque Cegid ne fournit pas de consigne propre. |
| Délai d’attente de la file *(fichier uniquement)* | 0 s | Combien de temps une requête attend une autorisation. Zéro signifie qu’elle est différée immédiatement plutôt que mise en attente. |
| Délai de nouvelle tentative dans la file *(fichier uniquement)* | 1 s | Intervalle entre les tentatives d’obtention d’une autorisation pendant la mise en file d’attente. |
{% hint style="warning" %}
**La limite est par hôte Cegid, et non par tenant.** Le limiteur comptabilise les requêtes sur l’hôte Cegid appelé. Lorsque plusieurs tenants Wallet Crew pointent vers le même environnement Cegid, par exemple un groupe exploitant plusieurs marques à partir d’une seule instance Y2, ils partagent un même budget. La limite configurée de chaque tenant doit refléter sa part de l’environnement, et non l’ensemble, sinon le groupe dépassera collectivement ce que Cegid autorise.
{% endhint %}
Lorsque la limite est atteinte, le travail qui peut être différé est replanifié plutôt que mis en échec, puis retenté après l’intervalle indiqué par Cegid lorsqu’il en fournit un. Les modifications de la limite s’appliquent dès l’appel suivant ; aucun redéploiement n’est nécessaire.
#### Dimensionnement de la limite
Le trafic de rafraîchissement de Carte est facile à sous-estimer. Chaque rafraîchissement peut appeler plusieurs services Cegid. Planifiez les gros rafraîchissements en fonction du même budget de requêtes que celui utilisé par les applications de magasin et tierces.
### Mise en cache
La mise en cache conserve les réponses Cegid pendant une courte période afin que les lectures identiques répétées, le plus souvent causées par des plateformes de wallet interrogeant la même Carte, ne deviennent pas chacune un appel à Cegid.
Quatre durées indépendantes sont disponibles pour les profils clients, les données de fidélité, les documents de vente et les opérations de caisse. Toutes sont exprimées en secondes, et **toutes sont désactivées par défaut**: la mise en cache est facultative, et non quelque chose que l’on réduit à partir d’un réglage par défaut.
| Cache | Conservation | Point à considérer |
| -------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| Client | Profils clients | De courtes durées suffisent généralement, car le trafic supprimé correspond à des lectures répétées à quelques secondes d’intervalle. |
| Fidélité | Cartes, programmes, soldes de points | Le plus visible pour les utilisateurs finaux : un solde qui tarde à se mettre à jour après un achat se remarque. |
| Documents de vente | Reçus et listes de documents | Des données historiques, donc tolèrent des durées plus longues. |
| Opérations de caisse | Bons, cartes-cadeaux, valeur stockée | Les soldes changent en caisse ; confirmez les exigences de fraîcheur avant d’allonger. |
Les écritures invalident ce qu’elles affectent : la mise à jour d’un client efface le profil mis en cache de ce client, et la création d’une carte de fidélité efface la liste de cartes mise en cache. Des durées de quelques secondes suffisent déjà à éliminer la majeure partie du trafic en double, car le schéma supprimé correspond à des rafales plutôt qu’à des lectures continues.
### Mise à jour du client lors de l’installation de la Carte
Lorsqu’elle est activée, ce qui est le cas par défaut, l’installation ou la suppression d’une carte réécrit la fiche client dans Cegid. C’est ce qui permet à une marque de voir l’adoption du wallet dans son propre CRM, à condition que le mapping écrive un état d’installation dans un champ Cegid. La procédure pour le faire se trouve dans [Personnaliser le mappage](/connectors/fr/pos/cegid/donnees-client-et-fidelite/customise-the-mapping.md).
Lorsque la marque n’enregistre pas l’état d’installation dans Cegid, le paramètre peut être désactivé pour supprimer le trafic correspondant.
### Modification directe du fichier de configuration
Les paramètres du connecteur sont stockés sous forme de fichier YAML dans le magasin de configuration du tenant, et ce fichier peut être modifié directement dans l’espace de travail de configuration, qui offre une arborescence de fichiers, une validation de schéma, un panneau des problèmes, l’historique des versions et la comparaison entre versions.
Cela vaut la peine pour les paramètres que la page du connecteur n’expose pas : la fenêtre de limitation de débit et les intervalles de nouvelle tentative ci-dessus, les durées de cache supérieures à un jour, ainsi que l’association d’un magasin à une connexion nommée, qui n’a pas d’équivalent dans le formulaire.
{% hint style="success" %}
Mélanger les deux voies est sans danger. L’enregistrement depuis la page de configuration conserve les paramètres qu’elle n’affiche pas elle-même, donc une valeur définie à la main dans le fichier n’est pas perdue lorsqu’une modification ultérieure est effectuée via le formulaire.
{% endhint %}
{% hint style="warning" %}
Les valeurs ne sont pas converties de force. Une valeur qui ne correspond pas au type attendu n’est pas appliquée, et l’intention se perd silencieusement — un booléen écrit avec une capitalisation inattendue, par exemple, est lu comme du texte plutôt que comme un booléen. Lorsqu’une modification de fichier semble n’avoir aucun effet, la forme de la valeur est la première chose à vérifier.
{% endhint %}
### FAQ
Quelle durée de cache faut-il utiliser ?
Commencez avec quelques secondes pour les données clients et de fidélité, ce qui élimine la majeure partie du trafic de sondage en double sans délai visible, et allongez seulement si la consommation Cegid reste élevée. Des durées plus longues échangent la fraîcheur contre le volume, et ce sont les soldes de fidélité que les utilisateurs finaux remarquent.
Une modification de la limitation de débit nécessite-t-elle un redéploiement ?
Non. La nouvelle valeur s’applique dès l’appel suivant à Cegid.
Où la configuration actuelle peut-elle être consultée dans son ensemble ?
L’espace de configuration affiche le fichier dans son intégralité, avec son historique des modifications, ce qui constitue aussi le moyen le plus rapide de voir ce qui a changé et quand à la suite d’un changement de comportement inattendu.
---
# 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/advanced-configuration.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.