Clients et cartes

Le référentiel

Compte (foyer, entreprise)
 └── Client (personne : profil, statut de fidélité, étiquettes, segments)
      └── Cartes (numéros de carte physiques ou virtuels)

Un client est retrouvé par n’importe lequel de ses identifiants : carte, compte web, wallet mobile, prospect, e-mail, téléphone, référence externe du CRM. En caisse, le premier identifiant reconnu l’emporte.

Carte inconnue en caisse : si l’option est active (par défaut), le moteur crée la carte et un client minimal, et le signale par l’avertissement customer_auto_created. Le ticket est traité normalement.

Deux modes par workspace

Mode	Maître des données	Ce que fait Remizo
Autonome	Remizo	Le studio crée et modifie les clients ; la caisse peut créer des cartes.
Synchronisé	Le CRM externe (par exemple Beone)	Remizo garde une copie locale des données utiles au calcul. Seuls les champs autorisés (`customers.editableFields`) sont modifiables dans le studio.

Connecteurs de synchronisation

Configurés dans le studio ou la console, par workspace :

Réception : le CRM pousse les données par API (lot JSON ou CSV) ou par webhook (un enregistrement par appel), sur POST /v1/public/sync/{ws}/{connectorId}, authentifié par l’en-tête X-Connector-Secret.
Collecte : Remizo va chercher les données par fichier (SFTP, dépôt Silo ou S3) ou par appel à l’API du CRM (pagination, authentification basic, bearer, clé d’API ou OAuth2), selon une tâche planifiée.

Chaque connecteur définit un mapping des champs (expressions CEL cible → expression sur la source), des contrôles, et produit un historique d’exécutions avec les rejets consultables (ligne, champ, raison, contenu). Une alerte est levée en cas d’échec ou si le taux de rejet dépasse le seuil.

La fiche client

Dans le studio : profil, cartes, soldes de chaque compteur, mouvements, coupons, tickets, événements. Actions :

geste commercial (ajout ou retrait de points) avec motif obligatoire ;
ajout ou blocage d’une carte ;
fusion de deux clients (les soldes sont transférés par des mouvements tracés) ;
anonymisation (droit à l’oubli) ;
envoi d’un événement client (déclenche les offres « événement »).

Imports

Chargement en masse de clients, comptes, cartes ou soldes initiaux (migration) par fichier : le traitement est asynchrone, avec rapport de rejets.

RGPD

L’anonymisation est irréversible : les données personnelles sont remplacées, les cartes bloquées, les coupons annulés ; le registre des points est conservé (sans lien avec la personne).
Les durées de conservation sont configurables par workspace ; la tâche gdpr.retention purge les données au-delà, et gdpr.anonymize_inactive anonymise les clients inactifs si la politique le prévoit.
Les journaux techniques ne contiennent jamais d’e-mail ou de téléphone en clair.