Passer au contenu

Exploitation agricole indépendante / construite pour le prochain quart de travail

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.
  • Un balayage de réconciliation détecte ce qui manque aux webhooks. 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 OAuth 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 :

  • OAuth par boutique, identifiants cryptés. Vous autorisez FarmHub sur votre propre boutique avec une portée read_orders. Le jeton d'accès est stocké crypté par connexion.
  • Webhooks avec signature vérifiée. Chaque événement de commande entrante est vérifié cryptographiquement comme provenant de Shopify avant l'importation. Les messages falsifiés n'entrent pas dans votre dossier agricole.
  • Importations idempotentes. Une commande vue deux fois, par webhook et par balayage de rapprochement, devient un enregistrement de vente. Les mises à jour des commandes révisent le dossier existant plutôt que de le dupliquer.
  • Kill switch et lignes d'audit chaînées par hachage. Désactivez la connexion instantanément si nécessaire. L’activité d’importation atterrit dans un journal d’audit dont les lignes sont chaînées par hachage et inviolables.

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 OAuth 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 ?

La signature de chaque webhook est vérifiée comme étant authentiquement celle de Shopify avant que FarmHub n'importe quoi que ce soit. Les messages non vérifiés sont rejetés.

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