Clients
Capacités customers.read et customers.write. Faits exigés au bonjour : customerPurchases et
customerLoyaltyBalance.
customer.upserted
{
"customerId": "c-2231",
"email": "camille@example.com",
"firstName": "Camille",
"lastName": "Martin",
"phone": "+33612345678",
"newsletter": true,
"partnerOptin": false,
"isGuest": false,
"active": true,
"createdAt": "2025-04-12T09:30:00+02:00"
}
| Champs | Sens |
|---|---|
customerId | obligatoire |
email, phone, mobile | ce qui permet de retrouver la personne dans le commerce |
firstName, lastName, company, birthday, gender | |
addressLine, postalCode, city, country, locale | |
newsletter, partnerOptin | les consentements, obligatoires : true seulement si la personne l'a donné |
isGuest, active, groups, createdAt | |
ordersCount, totalSpentCents, lastOrderAt | seulement si facts.customerPurchases vaut true |
Les achats du client
Déclarez customerPurchases: false, sauf si votre application renvoie le client à chaque
commande. Ses totaux viennent alors du journal des ventes, à jour dès que la partie Ventes est
active.
Comment Kult Lab range un client
Kult Lab retrouve une personne par son e-mail, puis par son téléphone, jamais par son nom. Il complète une fiche existante : un champ vide se remplit, un champ rempli reste tel quel. Un consentement donné chez vous s'ajoute ; un consentement retiré n'en retire aucun dans Kult Lab.
customer.deleted
{ "customerId": "c-2231" }
L'import
Kult Lab lit vos clients par la commande customer.export, quand le
commerçant lance l'import et choisit qui il importe : tous les clients, ou ceux qui ont un solde de
points.