> 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/developers-guides/fr/scripting/extensions/cegid-y2.md).

# Scripts Cegid Y2

Référence des scripts de mappage Cegid Retail Y2, de référentiel conseiller et d’intercepteur de connexion : enregistrement, gestionnaires, copie des en-têtes et exemples.

Trois scripts ajustent le connecteur Cegid Retail Y2. Le mappeur associe les données client entre Cegid et le compte Wallet, au-delà du mappage par défaut. Le référentiel des conseillers restreint et remodèle la liste des vendeurs renvoyée par Cegid. L’intercepteur de connexion voit chaque appel que le connecteur effectue vers Cegid. Cette page est la référence pour `extensions.cegid.y2.mapper`, `extensions.cegid.y2.advisorRepository` et `extensions.cegid.y2.connectionInterceptor`. Le connecteur, l’objet client Cegid et les recettes pour les champs libres se trouvent sur les [pages du connecteur Cegid](https://docs.thewalletcrew.io/connectors/fr/pos/cegid/developer-reference/scripting-reference.md); les règles partagées par chaque script de connecteur se trouvent dans [Scripts du connecteur](https://docs.thewalletcrew.io/developers-guides/fr/scripting/extensions.md).

<details>

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

* Un détaillant inscrit l’état d’installation du Wallet de chaque client dans une table libre de la fiche client Cegid.
* Une marque associe la langue du compte au code de langue de sa propre base de données Cegid, et inversement.
* Une marque masque les comptes techniques de vendeurs de la liste des conseillers.
* Une marque place une passerelle devant Cegid et réécrit l’URL de la requête.

</details>

## Enregistrement

| Clé                                         | Fichier des slots                   | Méthodes (obligatoires en **gras**)         |
| ------------------------------------------- | ----------------------------------- | ------------------------------------------- |
| `extensions.cegid.y2.mapper`                | `cegid.y2.mapper.js`                | **`MapFromY2`**, **`MapToY2`**              |
| `extensions.cegid.y2.advisorRepository`     | `cegid.y2.advisorRepository.js`     | **`Filtre`**, `Projet`                      |
| `extensions.cegid.y2.connectionInterceptor` | `cegid.y2.connectionInterceptor.js` | **`OnBeforeRequest`**, **`OnAfterRequest`** |

Les fichiers se trouvent dans `server/scripts/`. Le mappeur et le référentiel des conseillers sont modifiés dans l’onglet **onglet Avancé** de la page Cegid Y2 (**Mappage client** et **Conseillers** scripts). L’intercepteur dispose d’un fichier d’emplacement et d’une API, mais d’aucun onglet ; il est donc modifié dans la configuration avancée. Les emplacements sont lus et écrits avec `GET` et `PUT /api/{tenantId}/admin/extensions/cegid/y2/scripts`.

Lorsqu’aucun script n’est enregistré pour une clé, le comportement par défaut s’applique et rien n’échoue.

## Quand il s’exécute

| Script                              | S'exécute                                                                                                                                                                 |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MapFromY2`                         | Après la lecture d’un client Cegid et l’application du mappage standard                                                                                                   |
| `MapToY2`                           | Après le mappage des consentements, avant l’écriture du client. Une création ou une mise à jour exécute les deux méthodes, car l’enregistrement est relu après l’écriture |
| `Filtre`, `Projet`                  | Pour chaque vendeur, à chaque demande de liste de conseillers, après que le connecteur a conservé uniquement les vendeurs actifs du magasin demandé                       |
| `OnBeforeRequest`, `OnAfterRequest` | À chaque appel à Cegid ; tout élément lent dans ces scripts ralentit donc l’ensemble du connecteur                                                                        |

Une création ou une mise à jour exécute les deux mappeurs, dans cet ordre :

```mermaid
flowchart LR
  A[Compte Wallet] --> B[Mappage par défaut]
  B --> C[MapToY2]
  C --> D[Écriture dans Cegid]
  D --> E[Relecture]
  E --> F[Mappage par défaut]
  F --> G[MapFromY2]
  G --> H[Compte Wallet]
```

## Gestionnaires

| Méthode           | Paramètres                   | Retours                                                   | Obligatoire | Synchrone ou asynchrone          |
| ----------------- | ---------------------------- | --------------------------------------------------------- | ----------- | -------------------------------- |
| `MapFromY2`       | `données`, `compte`          | rien                                                      | Obligatoire | Synchrone                        |
| `MapToY2`         | `compte`, `données`          | rien                                                      | Obligatoire | Synchrone                        |
| `Filtre`          | `conseiller`                 | `vrai` pour conserver le vendeur                          | Obligatoire | Synchrone                        |
| `Projet`          | `conseiller`                 | un conseiller, ou `null` pour la valeur par défaut        | Facultatif  | Synchrone                        |
| `OnBeforeRequest` | `url`, `en-têtes`, `contenu` | une promesse de `{ Url, Headers, Content }`               | Obligatoire | Asynchrone : déclarez-le `async` |
| `OnAfterRequest`  | `soapAction`, `contenu`      | une promesse du corps de la réponse, sous forme de chaîne | Obligatoire | Asynchrone : déclarez-le `async` |

* **Mappeur.** `données` est le client Cegid (`CustomerData`), avec des membres en PascalCase tels que `data.EmailData.Email`; `compte` est le compte Wallet plat. Les méthodes modifient leurs arguments sur place et ne renvoient rien. Les deux sont obligatoires : enregistrez une fonction vide pour la direction que le script n’utilise pas. Un `async` le mapper n’est pas attendu, donc les modifications effectuées après un `await` sont perdues.
* **Entrées nulles.** Les entrées nulles que le script ajoute à `UserDefinedBooleans`, `UserDefinedDates`, `UserDefinedTexts`, `UserDefinedValues` ou `UserFields` sont supprimées avant l’envoi du client. Les autres tableaux sont envoyés tels quels.
* **Référentiel des conseillers.** `conseiller` est le vendeur Cegid, avec des membres tels que `Id`, `FirstName`, `LastName` et `StoreId`. `Filtre` renvoie un booléen. `Projet` est facultatif et renvoie `{ AdvisorId, DisplayName }`; en renvoyant `null` conserve la projection par défaut, celle du vendeur `Id` et `Prénom Nom`.
* **Intercepteur.** `OnBeforeRequest` doit renvoyer `{ Url, Headers, Content }`. Le connecteur **remplace l’URL et tous les en-têtes** par ce qu’il renvoie, donc le script copie les en-têtes reçus, modifie ce qu’il doit et conserve `SOAPAction`. `OnAfterRequest` renvoie le corps de la réponse sous forme de chaîne.

La réponse brute de Cegid est disponible lors de l’écriture d’un mapping sous `debug.y2.customer`, avec des équivalents pour la fidélité, les documents de vente et les opérations de caisse. Ces clés constituent une aide au développement et ne peuvent pas être utilisées dans un modèle de Carte.

## Erreurs et cas limites

* **Une méthode requise est manquante**: l'appel échoue avec `méthode <Name> manquante` lorsque le connecteur l’atteint. Un mapper qui enregistre une seule direction échoue pour l’autre.
* **Un bloc imbriqué est absent**: des blocs que le mappage par défaut ne remplit pas, comme `UserDefinedData`, sont absents : créez-les avant d’y écrire, sinon l’enregistrement entier échoue. `MapToY2` reçoit un nouvel enregistrement construit à partir du compte, et non de celui stocké dans Cegid.
* **L’intercepteur supprime un en-tête**: l’en-tête est retiré de l’appel. Sans `SOAPAction`, la requête est envoyée sans lui et l’appel échoue alors avec une erreur, car l’étape de réponse lit cet en-tête.
* **Un script lève**: l’erreur atteint l’opération du connecteur qui l’a appelée.

## Exemple

Le mapper écrit l’état d’installation des cartes Wallet dans une table libre de l’enregistrement client, avec un indicateur explicite `000` lorsqu’aucune Carte n’est installée, et mappe la langue à travers une table utilisée dans les deux sens.

```js
// La table libre 3 contient l’état d’installation du Wallet : les libellés Cegid commencent à 1, les identifiants à 0.
const INSTALL_SLOT = 'UserDefinedTable2Value';

const LANGUAGES = { fr: 'FRA', en: 'ANG', es: 'ESP' };
const DEFAULT_LANGUAGE = 'ANG';
const LANGUAGES_REVERSE = {};
for (const locale of Object.keys(LANGUAGES)) {
  LANGUAGES_REVERSE[LANGUAGES[locale]] = locale;
}

function installCode(account) {
  // "Uninstalled" est une chaîne truthy : comparez avec l’état littéral.
  const apple = account['neo.pass.Apple.state'] === 'Installed';
  const google = account['neo.carte.Google.state'] === 'Installed';
  si (apple && google) {
    return '003';
  }
  return apple ? '001' : google ? '002' : '000';
}

function mapToY2(account, data) {
  data.UserDefinedData = data.UserDefinedData || {};
  data.UserDefinedData[INSTALL_SLOT] = installCode(account);

  const locale = String(account['neo.lng'] ?? '').toLowerCase().split('-')[0];
  data.LanguageId = LANGUAGES[locale] || DEFAULT_LANGUAGE;
}

function mapFromY2(data, account) {
  const locale = LANGUAGES_REVERSE[data.LanguageId];
  if (locale) {
    account['language'] = locale;
  }
}

export default function (context) {
  context.register('extensions.cegid.y2.mapper', {
    MapToY2: mapToY2,
    MapFromY2: mapFromY2
  });
}
```

L'entité est plate : la langue est la clé `neo.lng`, lu avec des crochets, pas `account.neo?.lng`. Les clés d’installation `neo.carte.Apple.état` et `neo.Carte.Google.state` existent seulement lorsque le connecteur réécrit lors d’un changement d’installation, ce qui est le **Mettre à jour le client lors de l’ajout / suppression d’une Carte** paramètre (**Événements de Carte**, activé par défaut) de la [configuration avancée Cegid](https://docs.thewalletcrew.io/connectors/fr/pos/cegid/setup-and-configuration/advanced-configuration.md). Les codes de langue Cegid sont définis par base de données Cegid : ceux ci-dessus sont des espaces réservés. Le préfixe `neostore` est l'ancien nom de la plateforme et est conservé dans les identifiants techniques.

L’intercepteur de connexion ci-dessous injecte un en-tête et conserve tous les en-têtes qu’il a reçus, y compris `SOAPAction`:

```js
async function onBeforeRequest(url, headers, content) {
  const copy = { ...headers, 'X-Gateway-Source': 'wallet' };
  return { Url: url, Headers: copy, Content: content };
}

async function onAfterRequest(soapAction, content) {
  return content;
}

export default function (context) {
  context.register('extensions.cegid.y2.connectionInterceptor', {
    OnBeforeRequest: onBeforeRequest,
    OnAfterRequest: onAfterRequest
  });
}
```

Le connecteur ne conserve déjà que les vendeurs du magasin demandé. Le référentiel des conseillers ci-dessous masque également les comptes techniques dont l'identifiant commence par `WEB`:

```js
function filter(advisor) {
  return !String(advisor?.Id ?? '').startsWith('WEB');
}

export default function (context) {
  context.register('extensions.cegid.y2.advisorRepository', {
    Filtre: filter,
    Projet: (advisor) => null
  });
}
```

## Pièges courants

* Les identifiants Cegid commencent à 0 tandis que les libellés qu'un utilisateur Cegid voit commencent à 1 : `Id: 0` est le premier champ libre.
* Les valeurs de consentement sont `0` à `3`, et non des booléens.
* Un intercepteur qui renvoie de nouveaux en-têtes sans copier ceux reçus supprime `SOAPAction`.
* Un mappeur écrit dans un bloc absent chez un nouveau client.

## FAQ

<details>

<summary><strong>Le mappeur peut-il appeler un service externe ?</strong></summary>

Non : les méthodes du mappeur sont synchrones, et un `async` gestionnaire n'est pas attendu. Les données d'un autre système sont mieux lues par un [fournisseur de données de Carte](https://docs.thewalletcrew.io/developers-guides/fr/scripting/endpoints/pass-data-provider.md). L'intercepteur est asynchrone, mais il s'exécute à chaque appel.

</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/developers-guides/fr/scripting/extensions/cegid-y2.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.
