Mappage des données

Référence des champs client et magasin exposés par le connecteur Comarch aux cartes Wallet.

Le mappage Comarch détermine quelles données de fidélité deviennent visibles sur la Carte. Cette page répertorie les champs exposés par le connecteur et explique quand ils sont disponibles.

Exemples concrets

• Une carte de fidélité affiche les points, le niveau et le numéro de membre provenant de Comarch.
• Une Carte magasin affiche le magasin préféré capturé lors de l'inscription.
• Une Carte clienteling affiche ensemble les données du profil client et le contexte du magasin.

Champs client

Le connecteur lit les données client depuis le Comarch CLM profil/clients API.

Les champs ci-dessous sont disponibles par défaut dans la Carte.

Champ Wallet	Source Comarch	Notes
firstName	Prénom du client	Champ client standard
lastName	Nom de famille du client	Champ client standard
e-mail	E-mail de connexion ou e-mail de l'adresse	Utilise l'e-mail trouvé dans le profil
numéro de téléphone	Mobile ou téléphone de l'adresse	Utilise le numéro de téléphone trouvé dans le profil
comarch.customer.loyaltyPointsBalance	Solde principal de points	Disponible par défaut
comarch.customer.mainIdentifier	Numéro principal de carte de fidélité	Utile pour afficher des numéros de membre visibles
comarch.customer.statusName	Libellé du statut d'adhésion	Souvent utilisé pour l'affichage du niveau
comarch.customer.waitingToBookPoints	Solde de points en attente	Disponible uniquement lorsque la récupération du solde des transactions est activée

La charge utile client complète est également disponible sous debug.comarch.customer.

Option des points en attente

Par défaut, le connecteur lit uniquement le solde principal de points.

Activer Récupérer le solde des transactions client lorsque les points en attente sont également nécessaires. Cela ajoute un appel supplémentaire à l'API Comarch lors de l'actualisation.

Champs magasin

Les données du magasin ne sont récupérées que lorsque la Carte ou le flux d'inscription fournit storeId.

Le connecteur lit ensuite l'emplacement correspondant depuis l'API partenaire Comarch.

Champ Wallet	Source Comarch	Notes
comarch.store.code	Code de l'emplacement	Généralement la originale storeId valeur
comarch.store.name	Nom de l'emplacement	Nom affiché du magasin
comarch.store.address	Rue	Adresse principale
comarch.store.city	Ville	Ville du magasin
comarch.store.postalCode	Code postal	Code postal du magasin
comarch.store.country	Pays	Pays du magasin
comarch.store.latitude	Latitude GPS	Coordonnée d'emplacement facultative
comarch.store.longitude	Longitude GPS	Coordonnée d'emplacement facultative

La charge utile complète du magasin est également disponible sous debug.comarch.store.

Utilisez les champs dans un modèle de Carte

Définissez le modèle de Carte Fournisseur client à comarch.customer.

Définissez l' Fournisseur magasin à comarch.store lorsque des données de magasin sont nécessaires.

Les expressions de modèle typiques incluent :

• {{ comarch.customer.loyaltyPointsBalance }}
• {{ comarch.customer.statusName }}
• {{ comarch.store.name }}

Personnaliser le mappage

Le mappage par défaut couvre les cas d'utilisation les plus courants liés à la fidélité et au magasin.

Lorsqu'un projet nécessite une structure de champs différente, des champs supplémentaires ou une logique de transformation personnalisée, le mappage peut être adapté grâce à l'extensibilité.

Cela permet de remodeler les données Comarch avant qu'elles ne soient exposées à la Carte.

Voir Extensibilité pour le modèle de personnalisation.

Notes de mappage

Gardez la première version de la Carte simple.

La plupart des projets commencent avec le numéro de membre, les points, le niveau et un champ magasin. Des champs supplémentaires peuvent suivre une fois que le chemin d'actualisation de base est validé.

FAQ

Le mappage Comarch par défaut peut-il être personnalisé ?

Oui. Le mappage par défaut peut être adapté grâce à l'extensibilité lorsqu'un projet nécessite des champs personnalisés, des champs renommés ou des règles de transformation spécifiques.

Voir Extensibilité pour l'approche de mise en œuvre.

Tous les champs Comarch sont-ils exposés par défaut ?

Non. Cette page répertorie les champs par défaut exposés par le connecteur.

Des champs supplémentaires peuvent être ajoutés lorsque la charge utile Comarch les contient et que le mappage du projet est étendu en conséquence.

Quand les données du magasin sont-elles disponibles sur la Carte ?

Les données du magasin sont disponibles uniquement lorsqu'un storeId est fourni dans le flux de Carte ou d'inscription.

Sans cette valeur, le connecteur n'effectue pas la recherche du magasin.