Passer au contenu

Exploitation agricole indépendante

Ventes

Votre magasin à la ferme vend en ligne. Vos registres agricoles suivent le rythme.

La boîte CSA s'est vendue mardi soir pendant que vous nettoyiez les filtres. Bonne nouvelle, sauf que les commandes sont en direct dans Shopify et que vos registres agricoles ne les connaissent pas encore. Quelle récolte remplit ces cases ? Qu'est-ce qui a réellement rapporté la semaine dans le magasin, le marché et le commerce de gros ? Jusqu'à ce que quelqu'un copie les commandes, le registre de la ferme reste derrière la devanture du magasin.

Un magasin qui fonctionne pendant que vous travaillez ne représente que la moitié du gain. L'autre moitié est un dossier agricole qui reste à jour sans que vous agissant comme messager entre deux systèmes.

Comment ça marche réellement

FarmHub importe les commandes de votre boutique Shopify. Le flux est entrant, basé sur le webhook, et limité à votre boutique.

  • Les webhooks de commande sont le signal principal. Lorsqu'une commande est créée ou mise à jour dans Shopify, Shopify envoie un webhook à FarmHub. FarmHub vérifie la signature du webhook avant de lui faire confiance, puis importe la commande en tant qu'enregistrement de ventes.
  • Les commandes manquées sont à nouveau vérifiées. FarmHub relit périodiquement les commandes récemment mises à jour de Shopify, afin qu'un webhook abandonné ne devienne pas une vente manquante.
  • La connexion est limitée à votre boutique. Vous entrez votre domaine myshopify.com au moment de la connexion et autorisez sur l'écran de connexion de votre propre boutique. Chaque appel API est enraciné dans votre boutique, et dans celle de personne d'autre.
  • Les prix sont convertis exactement. Shopify envoie des montants décimaux. FarmHub les convertit en centimes entiers afin que les totaux des commandes correspondent au centime. Cela suppose une devise à 2 décimales, la valeur par défaut pour les vitrines que FarmHub cible aujourd'hui.

Les commandes importées rejoignent le reste de l'opération : cumul des coûts de récolte, rentabilité par culture et écritures comptables propres en aval si vous connectez également QuickBooks ou Xero.

SUR QUOI VOUS POUVEZ COMPTER

Sur quoi vous pouvez compter

Les pièces auxquelles vous faites confiance indiquent clairement :

  • Connexion sécurisée à votre boutique. Vous autorisez FarmHub sur votre propre boutique avec une portée read_orders. Le jeton d'accès est stocké crypté par connexion.
  • Commandes vérifiées avant importation. FarmHub vérifie que chaque mise à jour de commande provient de Shopify avant de l'ajouter à vos enregistrements.
  • Importations idempotentes. Une commande vue deux fois, par webhook et par le contrôle des commandes manquées, devient un record de vente. Les mises à jour des commandes révisent le dossier existant plutôt que de le dupliquer.
  • Faites une pause à tout moment. Revoyez l’historique. Désactivez la connexion instantanément si nécessaire. L'activité d'importation apparaît dans un journal d'activité qui permet de détecter les modifications ultérieures.

Ce que nous ne faisons pas

Ce que nous ne faisons pas :

  • FarmHub n'écrit pas dans votre boutique Shopify. Aucune modification de produit, aucun changement de prix, aucune action d'exécution. La portée est read_orders et le flux est uniquement destiné à l'importation.
  • FarmHub ne gère pas le décompte des stocks de votre vitrine dans Shopify.
  • FarmHub n'est pas une plateforme de commerce électronique. Shopify conserve ce travail et le conserve bien.

Configuration, honnêtement

Vous avez besoin d'une boutique Shopify et de l'autorisation pour y installer des applications.

  1. Dans FarmHub, ouvrez Intégrations et choisissez Shopify.
  2. Entrez le domaine de votre boutique (votre-store.myshopify.com).
  3. Approuvez la connexion sur l'écran de connexion de votre boutique. FarmHub demande un accès en lecture aux commandes uniquement.
  4. Passez ou attendez une commande et confirmez qu'elle arrive dans FarmHub comme enregistrement de vente.

Questions posées par les agriculteurs

À quelles données Shopify FarmHub accède-t-il ?

Commandes uniquement. La portée OAuth est read_orders. FarmHub importe les événements de commande à l'aide d'un webhook vérifié et les sauvegarde avec un balayage périodique des commandes récemment mises à jour.

FarmHub peut-il modifier mon magasin, mes produits ou mes prix ?

Non. L'intégration est en lecture seule vers Shopify. FarmHub n'écrit jamais sur votre vitrine.

Que se passe-t-il lorsqu'une commande est modifiée ou annulée dans Shopify ?

Les webhooks de mise à jour des commandes révisent le dossier de ventes FarmHub existant plutôt que de créer un doublon, de sorte que le dossier de la ferme suit la vitrine.

Dois-je réautoriser la connexion périodiquement ?

Non, aujourd'hui. Shopify émet des jetons d'accès hors ligne qui n'expirent pas selon un calendrier, de sorte que la connexion reste active sans écran de nouveau consentement. Shopify a annoncé des modifications au comportement des jetons hors ligne pour les applications publiques à compter du 1er janvier 2027, et FarmHub suivra ces directives lors de son arrivée. Le jeton est stocké crypté et vous pouvez révoquer la connexion des deux côtés à tout moment.

Comment les webhooks restent-ils dignes de confiance ?

FarmHub vérifie que les mises à jour de commande proviennent de Shopify et rejette les mises à jour qui échouent à cette vérification.

PRÊT POUR LE PROCHAIN ​​CHANGEMENT

Laissez le magasin et le registre agricole s'entendre

Connectez votre boutique Shopify et chaque commande en ligne est enregistrée dans le dossier agricole auquel elle appartient. Vous grandissez, le magasin vend, le record se maintient.

Commencez gratuitement