Clients et fidélité

Une boutique conserve ses clients, et peut proposer un programme de fidélité : les clients gagnent des points, et débloquent des récompenses avec. Cette page explique comment ces entités s'articulent. Chaque champ est décrit dans le schéma GraphQL.

Clients

Un Customer est un client d'une boutique, de l'un des deux types suivants (kind) :

• CONSUMER : un particulier.
• BUSINESS : une entreprise. companyName est requis, et le client peut avoir des informations de facturation comme siret ou intraCommunityVAT.

Un client a des coordonnées (email, phoneNumber…), des adresses (locations, avec une adresse de facturation et une adresse de livraison par défaut), et peut avoir un prix (price).

L'API peut créer, modifier, archiver et désarchiver des clients (createCustomer, updateCustomer, archiveCustomer, unarchiveCustomer). Contrairement à la plupart des listes, customers renvoie aussi les clients archivés : ajoutez filterBy: { archived: EXCLUDED } pour les masquer.

Programme de fidélité

Le programme de fidélité est en lecture seule dans l'API.

• hasSubscribedToLoyaltyProgram indique si le client y participe. loyalty.points donne son solde actuel.
• Chaque changement du solde est une LoyaltyActivity : GAIN ajoute des points, LOSS retire des points, RESET fixe le solde.

Récompenses et bons

• Une Reward est ce que le programme propose : un produit offert (OFFERED_PRODUCT) ou une remise (DISCOUNT), généralement débloqué avec un nombre de points (pointsToUnlock).
• Un Voucher est une récompense remise à un client. Son status est LOCKED (pas encore débloqué), UNLOCKED (prêt à l'emploi) ou USED. Les bons d'un client sont dans lockedVouchers et unlockedVouchers.