Square est la première caisse connectée à XPRIO. La connexion se fait avec votre propre compte Square, en quelques minutes, sans passer par une place de marché. Ce guide suppose que vous avez lu le principe général. Connecter ma caisse (POS) à XPRIO
Ce qu'il faut savoir
Square facture 1 % par commande payée hors Square, sur votre compte développeur Square, pas à XPRIO. C'est le tarif Square pour toute commande créée par une application tierce et payée ailleurs. XPRIO ne prend rien.
Square n'affiche une commande qu'une fois réglée. Une commande payée en ligne arrive donc marquée payée. Une commande en espèces ou carte à la livraison arrive marquée réglée dès l'envoi, avec la mention du moyen de paiement : vous encaissez le client sans la ressaisir. Le réglage « Laisser la caisse encaisser » n'existe pas avec Square.
Vos livraisons apparaissent comme des commandes « expédition » avec l'adresse du client, vos retraits comme des retraits avec l'heure prévue. Square réserve son type « livraison » à ses partenaires certifiés ; l'information est la même, seul le libellé change.
Les remboursements sont reflétés. Un remboursement total ou partiel fait dans XPRIO est enregistré dans Square pour exactement le même montant.
Les ruptures vont de Square vers XPRIO, pas l'inverse : « épuisé » se règle sur la caisse Square, l'API ne le permet pas depuis l'extérieur.
Un environnement de test existe : Square fournit un compte sandbox gratuit pour tout essayer sans toucher à votre vraie caisse.
Étape 1 : créer votre jeton d'accès Square
Connectez-vous sur developer.squareup.com avec votre compte Square habituel.
Cliquez sur + New application (ou ouvrez une application existante). Le nom est libre, par exemple « XPRIO ».
Dans l'application, ouvrez Credentials. En haut de la page, un interrupteur bascule entre Sandbox et Production : choisissez Production pour votre vraie caisse.
Copiez le Production Access Token (bouton Show puis copie). Ne le partagez avec personne ; XPRIO le chiffre et ne le réaffiche jamais.
Pour un essai sans conséquence, restez sur Sandbox : le jeton Sandbox Access Token se colle dans XPRIO avec l'interrupteur Mode test activé, et le tableau de bord de test se trouve dans developer.squareup.com, section Sandbox test accounts.
Étape 2 : connecter dans XPRIO
Menu Configuration App, Caisse (POS), choisissez l'établissement, puis Connecter sur la carte Square.
Activez Mode test (sandbox) si vous collez un jeton sandbox ; laissez-le désactivé pour votre vraie caisse.
Collez le jeton dans Jeton d'accès et cliquez sur Enregistrer et tester.
Choisissez le point de vente (location Square) de cet établissement, puis Activer.
XPRIO crée dans Square, une seule fois, ce dont il a besoin pour marquer les commandes payées, puis lit votre catalogue Square : articles, variations, listes de modificateurs, catégories.
Étape 3 : les articles
Suivez la boîte Étape suivante de la carte : import des articles Square dans XPRIO si votre carte n'y est pas encore, envoi de votre carte XPRIO dans Square si votre catalogue Square est vide, ou correspondance. Chez Square, la liaison se fait sur le SKU de chaque variation : mettez ce SKU en PLU de votre produit XPRIO et tout se lie seul. Correspondance des articles entre XPRIO et ma caisse
Deux particularités Square :
chaque article Square a au moins une variation, même sans taille ni parfum : un produit simple XPRIO se lie à cette variation unique, c'est normal ;
Square ne connaît pas les formules : une formule XPRIO se lie à un article Square « Menu » de votre choix, et ses composants apparaissent en modificateurs.
Étape 4 : commande de test, puis vraies commandes
Envoyer une commande de test crée dans Square une commande nommée « XPRIO » marquée test. Ouvrez Square (tableau de bord ou application Point de vente) : elle est dans les commandes, payée, avec sa note. Si elle apparaît, vos vraies commandes suivront le même chemin.
Dans Square, une commande XPRIO porte :
le nom du ticket XPRIO-numéro et le mode (retrait, livraison, sur place) ;
les lignes avec la variation liée, les modificateurs liés ou libres, les remises et les frais de livraison ;
le paiement, enregistré comme paiement externe « XPRIO » pour une commande payée en ligne, ou espèces pour une commande en espèces ;
pour un retrait, l'heure prévue et le nom du client ; pour une livraison, l'adresse complète.
Questions fréquentes
Le test de connexion échoue. Le plus souvent, un jeton sandbox collé sans le mode test, ou l'inverse ; ou un jeton copié avec un espace. Régénérez-le dans Credentials si le doute persiste.
La commande de test n'apparaît pas dans Square. Vérifiez que l'application Point de vente est connectée au même point de vente (location) que celui choisi dans XPRIO, et que la commande n'est pas filtrée : Square la range dans les commandes en cours, pas dans les ventes du jour tant qu'elle n'est pas terminée.
Puis-je garder mes ventes au comptoir comme avant ? Oui. XPRIO ne fait qu'ajouter des commandes et lire le catalogue. Rien ne change pour le reste de votre activité Square.
Comment déconnecter ? Bouton Déconnecter sur la carte. Les liens d'articles sont supprimés côté XPRIO ; rien n'est supprimé dans Square.
Articles liés