Liaison aux cartes de fidélité Fidelsys

Mercator 7.3 est compatible avec le système de carte de fidélité Fidelsys. En résumé, Fidelsys propose une carte de fidélité "standard" qui est attribuée à un client (appelé ici "membre Fidelsys") et qui peut être utilisée chez plusieurs commerçants. Ces commerçants n'étant pas liés les uns aux autres et pratiquant des systèmes de ristournes qui leur sont propres. Chaque commerçant peut, via une interface web, créer des règles (rules), par exemple :

  • 2% de remise systématique
  • 5% de remise à valoir sur le 11ème achat
  • 1 article gratuit après 10 articles achetés
  • ...

Mercator communique avec l'infrastucture de Fidelsys par l'intémédiaire d'un web service. Ceci est toutefois tout à fait transparent pour l'utilisateur, qui doit simplement disposer d'une liaison à Internet.

Pour pouvoir faire fonctionner cette liaison, il faut :

  • disposer d'une version 7.3 ou ultérieure de Mercator
  • disposer d'une version SQL de Mercator
  • placer dans le répertoire principal de Mercator le composant MercatorFidelsys.dll
  • disposer de l'option FDSYS dans les options du voucher Mercator
  • ajouter les champs suivants dans la base de données :
    • lignes_v.fdsys_rule C(30) : nom de la règle Fidelsys à utiliser
    • lignes_v.fdsys_tot N(15,5) : montant en EUR à passer à Fidelsys
    • lignes_v.fdsys_q N(10,0) : quantité de pièces à passer à Fidelsys
    • lignes_v.fdsys_auto L : champ indiquant que les lignes ont été ajoutées par le module Fidelsys
    • cli.c_fdsys_cn C(13) : numéro EAN de la carte Fidelsys pour ce client - à ajouter dans le paramétrage de signalétique
    • cli.c_naiss D : date de naissance du client (champ optionnel) - à ajouter dans le paramétrage de signalétique
    • stock.s_fdsys C(10) : clé correspondant au code renvoyé par Fidelsys lors de l'attribution d'un article gratuit - à ajouter dans le paramétrage de signalétique
  • Dans Outils / Options / Fidélité, compléter les options et ensuite redémarrer Mercator si l'une des 4 premières options a été modifiée
    • Fildelsys : cash register ID : fourni par Fidelsys
    • Fildelsys : nom utilisateur : fourni par Fidelsys
    • Fildelsys : mot de passe : fourni par Fidelsys
    • Fildelsys : chaîne de sécurité : fournie par Fidelsys
    • Fidelsys : article ristourne : S_ID d'un article à créer, et qui correspondra aux remises calculées par le système. Typiquement, cet article doit avoir un libellé du type "Votre ristourne grâce à votre carte de fidélité" et être lié à un compte général 708000 : remises accordées.
    • Fidelsys : interface de validation (voir ci-dessous)

1. Gestion des membres

La première partie de l'intégration consiste en la gestion des membres :

  • recherche d'un membre par son numéro de carte
  • recherche d'un membre par son adresse email (utilisée par Fidelsys comme identifiant unique)
  • recherche d'un membre ayant oublié sa carte
  • création d'un nouveau membre

Toute la gestion des membres se fait via la fonction ox_fidelsys.GetMember qui attend les paramètres suivants, qui sont tous optionnels :

  • numéro de carte
  • email
  • titre (Monsieur, Madame, Mademoiselle)
  • nom
  • prénom
  • date de naissance au format JJMMAAAA
  • rue
  • n°
  • boîte
  • code postal
  • ville
  • pays
  • langue
  • script à exécuter

Le fichier fidelsys_cli.prg (contenu dans le ZIP ci-joint), à placer dans le répertoire principal de Mercator, contient un exemple complet de l'utilisation de cette fonction. Ce code est destiné à être utilisé dans le signalétique clients, dans un bouton dont la commande est " do fidelsys_cli ". Ce bouton permettra la recherche/création d'un membre et ensuite l'affichage des règles disponibles pour ce membre.

fidelsys_membre

Pour rechercher un membre par son numéro de carte, il faut activer le champ texte à gauche du bouton "Par numéro de carte" et y scanner le code-barres de la carte Fidelsys. La recherche est ainsi directe.

Pour rechercher un membre par son adresse mail, il suffit de placer le curseur dans la zone à gauche de "Par adresse email", d'y saisir l'adresse mail complète et d'appuyer sur enter. Cela permet aussi une recherche directe.

Si le client a oublié sa carte et n'a pas d'adresse mail, il faut cliquer sur "Par nom, prénom, date de naissance et code postal" pour effectuer une recherche selon ses critères.

Le 4ème bouton permet de créer un nouveau membre. Notez que si le module PRG est bien conçu, les champs sont précomplétés avec les informations venant de Mercator.

Remarques :

  • il n'y a aucune obligation à ce que l'information transmise à Fidelsys corresponde aux données clients mémorisées dans Mercator
  • par défaut, le numéro de carte Fidelsys et l'adresse email sont renvoyés vers les données de la fiche client en cours

2. Visualisation des règles

Comme illustré par le module fidelsys_cli.prg documenté ci-dessus, la fonction ox_fidelsys.ShowRules affiche les différentes règles disponibles pour ce client. Cette fonction attend comme seul paramètre l'ID de membre renvoyé par GetMember.

fidelsys_regles

L'écran présentant la liste des règles permet une sélection multiple et le copiage du contenu par clik-droit.

3. Transactions Fidelsys

Pour activer la mécanique Fidelsys sur une vente, il faut au préalable cocher la case "Fidelsys" dans l'onglet "Evènements" de la séquence correspondante.

3.1. Identification du membre en vue d'une transaction

Ensuite, il faut associer un membre Fidelsys à la vente en cours. Cela se fait typiquement dans un module "avant validation" défini au niveau de la séquence. Le fichier ZIP ci-joint contient un exemple complet : fidelsys_vente.prg.

Si la vente est nominative, Mercator pourra récupérer l'information permettant d'indentifier le membre Fidelsys dans la fiche du client liée à la vente en cours. Si cette information n'existe pas, la liaison sera faite par ox_fidelsys.GetMember et, par défaut, le numéro de carte Fidelsys et l'adresse email seront sauvegardés pour une prochaine utilisation.

Si par contre, la vente est effectuée sur le client comptoir, il suffira de scanner la carte Fidelsys ou d'utiliser un autre critère de recherche lors de l'appel de ox_fidelsys.GetMember pour associer cette vente au membre Fidelsys ad hoc, tout en la laissant dans Mercator sur le client comptoir.

Remarques :

  • Il est aussi possible de scanner directement la carte Fidelsys dans les articles de la vente en cours. Mercator mémorisera cette information et ne demandera plus de rechercher le membre Fidelsys lors de la validation.
  • Il n'y a jamais de "redescente" d'information client de Fidelsys vers Mercator.
  • Considérant la remarque ci-dessus relative au client comptoir, il est dès lors tout à fait possible avec ce système de gérer des cartes de fidélité nominatives sans pour autant devoir encombrer la base de données de Mercator avec des fiches clients individuelles.
  • Etant donné la souplesse de la fonction ox_fidelsys.GetMember, il est bien entendu possible de créer un membre Fidelsys lors de la validation d'une vente.

3.2. Envoi des données à Fidelsys

Une fois le membre identifié, Mercator va effectuer une liaison au web service de Fidelsys en envoyant un ou plusieurs groupes d'information, chaque groupe comprenant :

  • une règle
  • un montant en EUR
  • un nombre de pièces (quantité) - valeur optionnelle

Pour alimenter ces groupes d'information, il est impératif de placer un module "avant validation" au niveau de la séquence. Ce module aura notamment pour objet de compléter les champs correspondants dans la table temporaire lignes_v_tmp :

  • lignes_v_tmp.fdsys_rule
  • lignes_v_tmp.fdsys_tot
  • lignes_v_tmp.fdsys_q

Mercator va transmettre ces informations à Fidelsys après les avoir regroupées et totalisées par règle.

3.3. Réception du résultat de la transaction Fidelsys

En réponse à cette sollicitation, Mercator va recevoir de Fidelsys un ou plusieurs retours qui peuvent être :

  • soit un montant de ristourne en EUR
  • soit un "cadeau" sous forme d'un article gratuit. (Dans pareil cas, un article cadeau dont S_FDSYS est égal à cette valeur renvoyée doit exister dans le catalogue article de Mercator)
  • soit aucune répercussion

Ceci se matérialise sous la forme de cet écran, qui donne un aperçu des lignes qui seront ajoutées dans la vente en cours :

fidelsys_transaction

Notez que les champs "Désignation", "Q." et "Prix Unit." sont éditables. Par ailleurs, il est possible de supprimer une ou plusieurs lignes pour ne pas appliquer la ristourne correspondante.

L'apparition de cet écran peut être définie dans "Outils / Options / Fidelité : interface de validation". Cette option accepte 3 valeurs :

  • 1 : toujours
  • 2 : uniquement si la vente produit une ristourne ou un article cadeau
  • 3 : jamais

Cet écran est bien entendu présenté avant la saisie des modes de paiements. Ainsi, le montant à payer tient compte de l'éventuelle ristourne Fidelsys.

Si la vente est par la suite annulée, Mercator se charge d'informer Fidelsys de l'annulation des transactions.

Liaison avec le terminal de paiements

Il est aussi possible de tirer avantage de la liaison avec les terminaux de paiements de Banksys. En effet, partout où la liaison entre Mercator et Fidelsys utilise un numéro de carte, on peut renseigner un numéro de carte Maestro (sur 17 positions). Par défaut, toute carte Bancontact/Mister Cash classique est compatible Maestro et comprend donc ce numéro.

Ce numéro peut être lu facilement avec avec le terminal de paiement en cliquant sur le bouton illustré ci-dessous et situé à droite de tout champ permettant la saisie d'un numéro de carte.

fidelsys_banksys

Association de cartes supplémentaires

Si le compte du membre Fidelsys a été crée en ligne et n'est associé à aucune carte, alors le système présentera automatiquement une boîte de dialogue permettant d'associer une carte à ce compte. Cette carte peut être une carte Fidelsys ou une carte Maestro.

Si le membre souhaite spontanément ajouter une carte à son compte, cela peut être fait dans Mercator en cochant "Lier carte" qui est diponible pour une recherche par adresse mail ou par nom, prénom, ...



A télécharger : 0000001854.zip (4440 Kb - 17/06/2011)