Connecter ma caisse (Square, SumUp, Zettle, Shopify, HubRise, Hiboutik)

Une fois votre caisse connectée, chaque vente reconnaît le client, ajoute ses tampons ou ses points, met à jour sa carte Wallet et déclenche vos automatisations, sans rien saisir dans Fidélitas.

Connecter votre caisse

1. Ouvrez Intégrations (réservé au propriétaire), onglet Caisses.
2. Choisissez votre caisse. La fenêtre indique ce qui sera synchronisé, les limites et les accès demandés (toujours en lecture seule).
3. Cliquez sur Continuer vers (Square, SumUp…) et acceptez l'accès chez votre fournisseur. Pour Shopify, indiquez d'abord l'adresse de votre boutique (ma-boutique.myshopify.com).
4. De retour dans Fidélitas, l'import démarre et s'affiche en direct : vos clients, puis 90 jours de ventes. Vous pouvez fermer la fenêtre, il continue.

L'historique importé sert à vos statistiques : il ne crédite pas de points, pour ne pas offrir de récompenses d'un coup.

Hiboutik (épiceries, boutiques)

Hiboutik se connecte avec vos identifiants d'API (dans Hiboutik : Réglages › API — nom du compte, email, clé API), vérifiés tout de suite. Fidélitas vous donne ensuite une adresse à coller dans Hiboutik (Réglages › API › Webhooks, événement « vente clôturée ») : chaque vente arrive en quelques secondes. Le client est reconnu s'il est choisi sur la vente dans Hiboutik ; sinon, carte scannée juste avant ou « J'ai commandé ». Pas d'import de l'historique (quota d'appels Hiboutik), et les remboursements se corrigent depuis la fiche client.

Comment le client est reconnu

Dans l'ordre : le client déjà relié à la caisse, puis son email, puis son téléphone. Un client inconnu avec email ou téléphone est ajouté à votre base, sans accord marketing (sauf s'il l'a donné en caisse). Si l'email désigne un client et le téléphone un autre, Fidélitas vous propose de les fusionner (voir Profils en double) : rien n'est fusionné sans vous.

Les règles appliquées

• Une visite par jour : plusieurs achats le même jour comptent pour une visite (un seul tampon ; en mode points, les points s'ajoutent).
• Si la carte du client a été scannée juste avant, le montant est ajouté à cette visite : pas de double comptage.
• SumUp et Zettle ne transmettent pas le client : le paiement se rattache à la carte scannée dans les minutes qui précèdent, s'il n'y en a qu'une. Sinon la vente est enregistrée sans point.
• Un remboursement retire les points correspondants (jamais en dessous de zéro).

Ces réglages se changent dans le menu … de la caisse connectée, puis Réglages.

Plusieurs caisses ou bornes en même temps (rush)

Avec deux caisses côte à côte, « la carte scannée juste avant » devient ambiguë : Fidélitas ne devine pas, et la vente reste sans point. Deux remèdes, cumulables :

1. Nommez vos postes. Sur chaque tablette ou ordinateur qui scanne (Caisse ou appli Comptoir), menu … › Nom de ce poste (« Caisse 1 », « Borne entrée »). Puis, dans les Réglages de la caisse connectée, bloc Postes, associez l'identifiant de chaque appareil dans la caisse à ce nom. Un paiement n'est alors rattaché qu'à la carte scannée sur le même poste. Réduisez aussi le délai de rattachement à 2 ou 3 minutes.
2. Laissez le client rattacher son ticket. Paramètres › Commerce › Ticket rattaché par le client : sur sa carte, le client tape le numéro de commande imprimé sur son ticket (« J'ai commandé »). Dès que votre caisse nous transmet la vente portant ce numéro (tout de suite si elle est déjà arrivée, sinon sous 48 h), ses points sont ajoutés. Un ticket ne se rattache qu'une fois ; cinq essais par heure et par carte. C'est la solution pour les bornes de commande, sans rien y changer.

Le client identifié avant de payer reste le plus sûr : un champ « numéro de fidélité » sur la borne ou la caisse, où il tape le code de sa carte (« ACW-VHG »), et la vente arrive déjà rattachée.

Agir depuis la caisse, sans se connecter

Avec les codes caisse (onglet Depuis la caisse), un article ou une remise ajouté au ticket utilise la récompense du client, lui offre des points, lui envoie une campagne ou l'étiquette, sans ouvrir Fidélitas. Ce que permet chaque caisse : Déclencher Fidélitas depuis la caisse.

Suivre et corriger

• Chaque caisse affiche son état (Opérationnelle, Import en cours…, Reconnexion nécessaire…), le nombre de ventes et la part rattachée à un client.
• L'onglet Journal montre chaque événement reçu et ce que Fidélitas en a fait. En cas d'échec, Fidélitas réessaie seul ; le bouton Réessayer relance tout de suite.
• Déconnecter retire l'accès chez le fournisseur. Vos clients et l'historique restent.

Votre caisse n'est pas dans la liste ?

Lightspeed, Zelty ou L'Addition n'ont pas encore de connecteur direct (les caisses de restaurant passent souvent par HubRise). Toute caisse capable d'appeler une adresse web peut utiliser Autre caisse ; votre éditeur trouvera la documentation sur la page Développeurs. Sinon, Fidélitas fonctionne très bien à côté : carte scannée en Caisse, QR code, import de fichier.