Formats des données
Dernière mise à jour : 14 novembre 2026
Cette page décrit les données qu’un commerçant peut récupérer depuis Klanto, et dans quel format. Elle répond à l’article 26 du règlement européen sur les données (règlement (UE) 2023/2854) et complète l’article 17 de nos conditions générales. Elle est tenue à jour.
Normes utilisées
- CSV : une ligne par élément, valeurs séparées par un point-virgule, encodage UTF-8, première ligne avec le nom des colonnes. Le fichier s’ouvre directement dans Excel, Numbers ou Google Sheets.
- JSON : format ouvert (norme RFC 8259), encodage UTF-8.
- Dates : dans le CSV, « AAAA-MM-JJ HH:MM » à l’heure de Bruxelles ; dans le JSON, norme ISO 8601 en temps universel (UTC).
- Montants : en centimes d’euro (nombre entier) dans le JSON.
- Images (logo, bandeaux) : les fichiers PNG ou JPEG d’origine.
Aucun format propre à Klanto : tout se relit sans logiciel Klanto.
1. Liste des clients (CSV, à tout moment)
Le patron l’exporte lui-même depuis son espace Klanto, gratuitement. Une ligne par carte, avec ces colonnes :
- Prénom, Nom ;
- Code membre : le code de la carte, que le client peut donner au comptoir ;
- Solde : nombre de points ou de passages ;
- Statut : Récompense prête, Active, Inactive ou Suspendue ;
- Wallet : Apple ou Google ;
- Membre depuis : date de création de la carte ;
- Dernier passage ;
- Récompenses : nombre de récompenses obtenues ;
- E-mail, GSM : seulement si le client les a donnés ;
- Accord marketing : date à laquelle le client a accepté de recevoir vos offres par e-mail, vide sinon.
2. Fiche d’un client (JSON, à tout moment)
Pour répondre à une demande d’un client (droit d’accès ou de portabilité), le patron peut exporter la fiche complète d’une carte depuis son espace Klanto. Le fichier contient :
exportedAtetmerchantId: date de l’export et identifiant de votre programme ;customer: prénom, nom, e-mail, dates d’inscription, d’accord et de dernière activité, réduction personnelle ;wallet: la carte (code membre, solde, statut, Apple ou Google, dates) ;transactions: chaque passage, ajout ou retrait de points, avec la date, les points, le montant d’achat éventuel et l’établissement ;redemptions: les récompenses, avec leur code et leur statut ;scanAttempts: les scans de la carte, acceptés ou refusés (journal contre les abus) ;messages: les messages reçus sur la carte, avec la date et l’état de l’envoi ;gameEvents: ancien module de jeu, retiré, donc vide.
3. Export complet (CSV ou JSON, sur demande)
Pour changer de prestataire, ou pendant les 90 jours qui suivent la fin de l’abonnement, écrivez à contact@klanto.be. Vous recevez gratuitement un fichier par catégorie :
- clients : prénom, nom, e-mail, GSM, dates d’inscription et de dernière activité, accord marketing, réduction personnelle ;
- cartes : code membre, solde, statut, Apple ou Google, dates ;
- passages : date, carte, points ajoutés ou retirés, montant d’achat, motif, établissement, compte de l’équipe qui a scanné ;
- récompenses : date, carte, type, code, statut, date de remise ;
- messages : titre, texte, offre et ses dates, et pour chaque client la date et l’état de l’envoi ;
- programme : nom, adresse, couleurs, logo et bandeaux, mode de fidélité (tampons ou points), seuil et nom de la récompense, règles de points, textes affichés sur la carte ;
- catalogue de récompenses : nom, coût en points, ordre, actif ou non ;
- établissements : nom, adresse, coordonnées GPS, actif ou non ;
- équipe : e-mail, rôle, établissement rattaché.
4. Ce qui ne peut pas être transféré
Comme le prévoit l’article 17.4 des conditions générales : les cartes déjà installées dans les téléphones de vos clients (elles sont signées par les certificats Apple et Google de Klanto) et les identifiants techniques qui servent à les mettre à jour, les QR codes et liens propres à Klanto, le logiciel, et les données internes de sécurité (clés, mots de passe et codes du comptoir chiffrés).
Votre nouveau prestataire émet donc de nouvelles cartes. Grâce au code membre et au solde de chaque client, il peut reprendre les soldes là où ils en sont.