Mappage des champs Cegid Retail Y2

Synchronisation des données client et fidélité

Création et mise à jour du compte client et des Cartes de fidélité dans Y2 via les formulaires d'inscription.

Mapping des champs : voici la liste des champs disponibles par défaut dans le connecteur :

Champs Wallet Crew     Champs Y2(WebService)
--------------------------------------------------------------------------
email                  EmailData.Email
consents_email         EmailData.EmailingAccepted
phoneNumber            PhoneData.CellularPhoneNumber
isProspect             IsProspect
firstName              FirstName
lastName               LastName
sex                    Sex
title                  TitleId
advisor                SalesPersonId
storeId                UsualStoreId
birthDate              BirthDateData
address                AddressData.AddressLine1
streetNumber           AddressData.AddressLine2
postcode / zipCode     AddressData.ZipCode
city                   AddressData.City
country                AddressData.CountryId
nationality            NationalityId
consents_email         OptinEmail(true = BrandOnly, false = DoNotUse)
consents_post          OptinPostal(true = BrandOnly, false = DoNotUse)
consents_sms           OptinMobile(true = BrandOnly, false = DoNotUse)
consents_emailReceipt  EmailData.SendReceiptByMail

Si vous souhaitez des champs supplémentaires, contactez votre administrateur Wallet Crew. Les libellés et les valeurs des champs à choix multiples doivent être renseignés et se trouvent dans le BackOffice Wallet Crew. Il en va de même pour les consentements et les autres textes légaux.

Personnalisation du mapping

Il est possible de personnaliser le mapping avec un script JavaScript personnalisé. Le script nécessite 2 méthodes : MapFromY2 et MapToY2. Vous trouverez ci-dessous le script minimal à utiliser pour le mapping personnalisé

// file server/scripts/y2.mapping.js

/**
 * Méthode utilisée pour convertir les informations du modèle de données Wallet Crew vers le modèle de données Y2.
 * Cette méthode sera appelée à chaque fois qu’un client est créé ou mis à jour dans Y2
 *
 * Cette méthode doit être implémentée si vous souhaitez envoyer des données spécifiques à Y2
 *
 * @param account dictionnaire des données provenant de Wallet Crew
 * @param data modèle de données client Y2 tel que défini dans CustomerWcfService
 */
const mapToY2 = function (account, data) {};

/**
 * Méthode utilisée pour convertir les informations de Y2 vers neostore.
 * Cette méthode sera appelée à chaque fois qu’un client est récupéré et affiché dans Wallet Crew :
 * lors de la modification d’un client existant via un formulaire d'inscription ou lors de l'affichage des informations sur une Carte
 *
 * @param data modèle de données client Y2 tel que défini dans CustomerWcfService
 * @param account dictionnaire des données à définir dans Wallet Crew
 */
const mapFromY2 = function (data, account) {};

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

Le modèle de données Y2 est défini comme suit :

Recettes

Textes libres Y2 - YTC_TEXTELIBRE

Dans Cegid, il est possible de définir jusqu’à 3 textes libres, ils sont stockés dans les colonnes YTC_TEXTELIBRE1, YTC_TEXTELIBRE2, YTC_TEXTELIBRE3. Les valeurs sont accessibles via UserDefinedTexts propriété.

Le mapping peut être effectué comme ceci :

// la bonne valeur d’Id doit être remplacée - 2 fois dans mapToY2 et 1 fois dans mapFromY2
// Id : 0 => YTC_TEXTELIBRE1
// Id : 1 => YTC_TEXTELIBRE2
// Id : 2 => YTC_TEXTELIBRE3

const mapToY2 = function (account, data) {
  // autre mapping de champ

  const comment = account["comment"];
  if (comment) {
    data.UserDefinedTexts = [
      ...(data.UserDefinedTexts || []).filter((udt) => udt?.Id != 0),
      { Id: 0, Value: comment },
    ];
  }
};

const mapFromY2 = function (data, account) {
  // autre mapping de champ

  account["comment"] = (data.UserDefinedTexts || []).find(
    (udt) => udt?.Id == 0,
  )?.Value;
};

Table libre Y2 - YTC_TABLELIBRETIERS

Dans Cegid, il est possible de définir jusqu’à 10 valeurs dans la table libre (table libre en français), elles sont stockées dans les colonnes YTC_TABLELIBRETIERS1, YTC_TABLELIBRETIERS2, YTC_TABLELIBRETIERS3, YTC_TABLELIBRETIERS4, YTC_TABLELIBRETIERS5, YTC_TABLELIBRETIERS6, YTC_TABLELIBRETIERS7, YTC_TABLELIBRETIERS8, YTC_TABLELIBRETIERS9, YTC_TABLELIBRETIERSA. Les valeurs sont accessibles via UserDefinedData propriété.

Attention aux WebServices Cegid : il existe un écart de 1 entre le nom dans la base de données et le nom dans le service web.

Le mapping peut être effectué comme ceci :

// Y2 a un écart de 1. UserDefinedTable0Value est YTC_TABLELIBRETIERS1, etc.
/*
 * UserDefinedTable0Value => YTC_TABLELIBRETIERS1
 * UserDefinedTable1Value => YTC_TABLELIBRETIERS2
 * UserDefinedTable2Value => YTC_TABLELIBRETIERS3
 * UserDefinedTable3Value => YTC_TABLELIBRETIERS4
 * UserDefinedTable4Value => YTC_TABLELIBRETIERS5
 * UserDefinedTable5Value => YTC_TABLELIBRETIERS6
 * UserDefinedTable6Value => YTC_TABLELIBRETIERS7
 * UserDefinedTable7Value => YTC_TABLELIBRETIERS8
 * UserDefinedTable8Value => YTC_TABLELIBRETIERS9
 * UserDefinedTable9Value => YTC_TABLELIBRETIERSA
 */

const mapToY2 = function (account, data) {
  // autre mapping de champ

  const preference = account["preference"];
  if (preference) {
    data.UserDefinedData = {
      ...(data.UserDefinedData || {}),
      UserDefinedTable1Value: preference,
    };
  }
};

const mapFromY2 = function (data, account) {
  // autre mapping de champ

  account["preference"] = data.UserDefinedData?.UserDefinedTable1Value;
};