Shopify
Agent de synchronisation financière Shopify
L'agent LinkyFlow de synchronisation financière Shopify tient une copie normalisée des données financières d'une boutique Shopify : commandes, transactions, remboursements, versements et mouvements de solde Shopify Payments, litiges. Il lit l'historique une fois, puis ce qui a changé chaque heure, et garde une ligne par élément, avec le brut, la taxe, les frais et le net à part, dans la devise indiquée par la source. Il est en lecture seule : il ne change jamais rien dans Shopify.
Connectez-vous ou créez votre compte LinkyFlow, puis configurez cet agent.
Comment fonctionne le workflow
Ce que fait cet agent
Lit
- Tout l'historique une fois, par les opérations bulk de Shopify quand la lecture le permet
- Puis ce qui a changé, chaque heure, là où il s'était arrêté
- Une source qu'il n'a pas le droit de lire est signalée et n'arrête pas les autres
Garde
- Une ligne par élément, quel que soit le nombre de lectures
- Brut, taxe, frais, net et devise à part
- Une colonne que la source n'indique pas reste vide
Relie
- Les identifiants de commande, versement, transaction, remboursement et litige de chaque ligne
- La référence du prestataire de paiement d'une transaction
- Où et quand chaque ligne a été lue
Exemples
Ce que l'agent renvoie dans des situations réelles
1. Un mouvement sur le solde
SYNCED
- Brut
- 120,00 EUR
- Frais
- 3,50 EUR
- Net
- 116,50 EUR
Une ligne, reliée à sa commande et à son versement. Relue sans changement, elle reste une seule ligne.
2. Un droit que la boutique n'a pas accordé
NOT_GRANTED
- Source
- Versements Shopify Payments
- Droit
- read_shopify_payments_payouts
Cette source est signalée, et redemandée une fois les droits de la connexion synchronisés. Les autres continuent.
3. Une boutique sans Shopify Payments
NOT_ON_SHOPIFY_PAYMENTS
- Source
- Versements Shopify Payments
- Lignes
- 0
Le run dit que la boutique n'a pas ces lignes, plutôt que de laisser une liste vide s'expliquer toute seule.
Tous les résultats possibles
| Résultat | Ce que cela veut dire |
|---|---|
| SYNCED | La source a été lue jusqu'au bout de sa fenêtre. Ses lignes sont à jour à la date de ce run. |
| IN_PROGRESS | La source n'est pas terminée, et rien ne va mal : Shopify prépare encore une lecture bulk, ou le run a atteint son budget de temps. Le run suivant reprend là où celui-ci s'est arrêté. |
| THROTTLED | Shopify ou le quota du plan a demandé d'attendre. La source garde sa place et sera relue par un run ultérieur. |
| DEFERRED | La source n'a pas été interrogée dans ce run : sa dernière lecture a échoué, et elle est retentée après un délai croissant. |
| NOT_GRANTED | La connexion n'a pas le droit Shopify de cette source. Elle est redemandée une fois les droits de la connexion synchronisés. |
| NOT_ON_SHOPIFY_PAYMENTS | La boutique n'a pas de compte Shopify Payments, et n'a donc pas ces lignes. |
| READ_FAILED | La lecture a échoué. Elle est retentée après un délai croissant, et les lignes déjà lues restent. |
Ce que vous pouvez faire des résultats
Du résultat à l’action
Ouvrir dans Excel
Consultez les lignes financières actuelles, les runs et le détail d'un run passé dans un classeur connecté.
Relancer maintenant
Lancez un run à la demande, après avoir accordé un droit par exemple.
Demander à un assistant
Demandez à ChatGPT ou Claude où en est chaque source, ou la liste de ce qu'un run a trouvé.
Lecture seule
Cet agent ne change rien chez Shopify : il n'a aucune écriture. Il stocke ce que la boutique indique et ne calcule aucun montant. Il ne détient aucun document : Shopify ne publie aucune facture d'abonnement en PDF, et aucune n'est inventée.
Capacités
- Lecture seule
- Tourne toutes les heures
- Exécution à la demande
- Incrémental : ne relit que ce qui a changé
- Vues Excel en direct
- ChatGPT et Claude, via MCP
Qu'est-ce que l'agent de synchronisation financière Shopify ?
Il garde les données financières d'une boutique Shopify en lignes lisibles dans une feuille : une ligne par commande, transaction, remboursement, versement Shopify Payments, mouvement de solde et litige, avec les montants à part et les identifiants qui relient chaque ligne aux autres.
Ce qu'il lit
Le premier run lit tout l'historique de chaque source : par les opérations bulk de Shopify pour les commandes,
transactions, remboursements et litiges, par pages pour les versements et les mouvements de solde. La profondeur des
commandes dépend de ce que Shopify sert à la connexion : 60 jours sans le droit read_all_orders. Chaque run suivant
lit ce qui a changé depuis le précédent, avec un léger chevauchement, pour qu'une mise à jour tardive ne soit pas
manquée.
Ce qu'il ne fait pas
Il n'écrit rien chez Shopify et ne calcule aucun montant. Il ne décide rien sur vos ventes : c'est le travail d'un rapprochement. Il ne détient aucun PDF, car Shopify n'en publie aucun pour ses factures d'abonnement.
Questions fréquentes
Rapproche-t-il mes ventes ?
Non. Il garde les lignes dont un rapprochement a besoin, avec les montants à part et les identifiants qui les relient. Il ne décide rien et n'ouvre aucun cas.
Pourquoi des frais ou un net sont-ils vides sur certaines lignes ?
Parce que cette source ne les indique pas. Un mouvement de solde indique le montant, les frais et le net ; une commande, son total et sa taxe ; un versement, le brut et le net. Une colonne vide veut dire que Shopify n'a rien dit, jamais zéro.
Dans quelle devise sont les montants ?
Celle qu'indique la source. Sur une commande, une transaction et un remboursement, ce que l'acheteur a payé, avec la devise de la boutique à côté quand elle diffère. Sur un mouvement Shopify Payments, la devise du solde. Rien n'est converti.
À quelle fréquence tourne-t-il ?
Une fois par heure, et à la demande. Le statut d'un versement, le versement que rejoint un mouvement et l'issue d'un litige changent sans date sur laquelle filtrer : ils sont relus une fois par jour.
Combien de temps prend le premier run ?
Sur une petite boutique, quelques minutes. Sur une grande, plusieurs heures : Shopify prépare chaque lecture bulk à son rythme, une à la fois par boutique, et l'agent regarde de nouveau au run suivant. Entre-temps, un export bulk lancé sur la même boutique attend qu'elle se termine, et réciproquement.
Détient-il des factures ou des PDF ?
Non. Shopify ne publie aucune facture d'abonnement sous forme de document : l'agent n'en détient aucune et n'en invente aucune.
Combien de temps les lignes sont-elles conservées ?
Une ligne qui n'a pas changé depuis 180 jours expire. Le détail de chaque run est conservé 30 jours.
Je suis partenaire Shopify. Lit-il mes revenus ?
Avec une connexion Shopify Partner, oui : vos transactions et les événements qui indiquent un montant, en lignes de même forme. Elle est facultative, et les lignes de la boutique n'en dépendent pas.
Agents associés
- Shopify
Stripe
Agent de rapprochement Shopify + Stripe
Rapproche chaque transaction Shopify payée via Stripe du vrai paiement Stripe, de ses frais et de son montant net — et signale ce qui ne colle pas.
- Paiements Stripe introuvables
- Écarts de montant et de devise
- Remboursements absents de Shopify
Lancer cet agent
Ajoutez-le à votre compte LinkyFlow en quelques étapes. Il démarre dès que sa configuration est complète.