Configuration de la connexion Square
Ce guide vous explique comment connecter votre compte Square à LinkyFlow pour lire vos emplacements, votre catalogue, vos commandes et vos paiements dans Excel ou dans l'application web. Il n'y a aucune clé à copier, et LinkyFlow ne fait que lire.
Prérequis
- Un compte Square, et son identifiant
Étape 1 — Se connecter avec Square
- Dans Excel ou l'application web, ouvrez Connexions → Ajouter une connexion.
- Choisissez Square dans la liste des fournisseurs.
- Cliquez sur Connect with Square.
- Connectez-vous chez Square.
- Approuvez les quatre droits de lecture : articles, commandes, paiements et profil du marchand. Rien d'autre n'est demandé : LinkyFlow n'a aucun droit d'écriture.
De retour dans LinkyFlow, la connexion est prête. Elle reste sur l'environnement Square, production ou Sandbox, où vous l'avez approuvée. LinkyFlow renouvelle son accès tout seul : vous n'avez rien à faire quand un jeton expire.
Étape 2 — Charger votre première requête
- Insérez une requête LinkyFlow et choisissez le fournisseur Square.
- Choisissez Locations, sélectionnez votre connexion dans le champ Link, puis exécutez-la. Vous obtenez les IDs d'emplacement que demande Orders.
- Choisissez Payments ou Orders : les 100 premières lignes se chargent par défaut. Passez à la page suivante, ou choisissez Tous les résultats pour lire les pages à la suite.
Square ne compte rien : aucun total n'est donc affiché. Un curseur vit 5 minutes : une liste parcourue plus lentement recommence.
Étape 3 — Lire un montant
Un montant est un nombre entier dans les unités mineures de sa devise, à côté de cette devise : 1250 avec EUR vaut 12,50 EUR, et 1250 avec JPY vaut 1250 JPY.
Mettre fin à l'accès de LinkyFlow
Dans le Square Dashboard, allez dans Settings → App integrations, puis Disconnect App sur LinkyFlow : cela met fin à son accès, et la connexion vous demande de vous reconnecter à son prochain appel. Supprimer la connexion dans LinkyFlow demande aussi à Square de mettre fin à l'accès, et vous prévient si Square refuse. Si une autre connexion LinkyFlow utilise le même marchand, l'application reste autorisée pour elle.
LinkyFlow conserve les jetons côté serveur : ils ne sont jamais affichés, ni envoyés à un assistant IA.