Vendite

Il negozio della tua fattoria vende online. I registri della tua fattoria continuano.

La scatola CSA è andata esaurita martedì sera mentre stavi pulendo i filtri. Buone notizie, tranne per il fatto che gli ordini vivono su Shopify e i registri della tua fattoria non ne sono ancora a conoscenza. Quale raccolto riempie quelle scatole? Che cosa ha effettivamente incassato la settimana nel negozio, nel mercato e nel commercio all'ingrosso? Finché qualcuno non copia gli ordini, il registro della fattoria è dietro la vetrina.

Un negozio che funziona mentre lavori è solo metà della vittoria. L'altra metà è un registro dell'azienda agricola che rimane aggiornato senza che tu agisca come corriere tra due sistemi.

Come funziona realmente

FarmHub importa gli ordini dal tuo negozio Shopify. Il flusso è in entrata, webhook-first e mirato al tuo negozio.

I webhook degli ordini sono il segnale principale. Quando un ordine viene creato o aggiornato in Shopify, Shopify invia a FarmHub un webhook. FarmHub verifica la firma del webhook prima di considerarla attendibile, quindi importa l'ordine come record di vendita.
Uno sweep di riconciliazione rileva ciò che manca ai webhook. FarmHub rilegge periodicamente gli ordini aggiornati di recente da Shopify, quindi un webhook abbandonato non diventa una vendita mancante.
La connessione è limitata al tuo negozio. Inserisci il tuo dominio myshopify.com al momento della connessione e autorizzi nella schermata OAuth del tuo negozio. Ogni chiamata API è radicata nel tuo negozio, in quello di nessun altro.
I prezzi vengono convertiti esattamente. Shopify invia importi decimali. FarmHub li converte in centesimi interi in modo che i totali degli ordini corrispondano al centesimo. Ciò presuppone una valuta a 2 decimali, l'impostazione predefinita per i negozi che FarmHub prende di mira oggi.

Gli ordini importati si uniscono al resto dell'operazione: rollup dei costi di raccolto, redditività per raccolto e voci contabili pulite a valle se colleghi anche QuickBooks o Xero.

SU COSA PUOI CONTARE

Su cosa puoi contare

Le parti di cui ti fidi, dichiarate chiaramente:

OAuth per negozio, credenziali crittografate. Autorizzi FarmHub sul tuo negozio con un ambito read_orders. Il token di accesso viene archiviato crittografato per connessione.
Webhook con firma verificata. Ogni evento di ordine in entrata viene verificato crittograficamente come proveniente da Shopify prima dell'importazione. I post contraffatti non entrano nel registro della tua azienda agricola.
Importazioni idempotenti. Un ordine visto due volte, tramite webhook e tramite scansione di riconciliazione, diventa un record di vendita. Gli aggiornamenti degli ordini rivedono il record esistente anziché duplicarlo.
Kill switch e righe di controllo concatenate tramite hash. Disabilita immediatamente la connessione se necessario. L'attività di importazione viene inserita in un registro di controllo le cui righe sono concatenate tramite hash e a prova di manomissione.

Cosa non facciamo

Cosa non facciamo:

FarmHub non scrive sul tuo negozio Shopify. Nessuna modifica al prodotto, nessuna variazione di prezzo, nessuna azione di adempimento. L'ambito è read_orders e il flusso è di sola importazione.
FarmHub non gestisce il conteggio dell'inventario della tua vetrina in Shopify.
FarmHub non è una piattaforma di e-commerce. Shopify mantiene quel lavoro e lo mantiene bene.

Configurazione, onestamente

Hai bisogno di un negozio Shopify e dell'autorizzazione per installarvi app.

In FarmHub, apri Integrazioni e scegli Shopify.
Inserisci il dominio del tuo negozio (tuo-negozio.myshopify.com).
Approva la connessione nella schermata OAuth del tuo negozio. FarmHub richiede l'accesso in lettura solo agli ordini.
Effettua o attendi un ordine e conferma che arrivi in FarmHub come record di vendita.

Domande che fanno gli agricoltori

A quali dati Shopify accede FarmHub?

Solo ordini. L'ambito OAuth è read_orders. FarmHub importa gli eventi degli ordini tramite webhook verificati e li supporta con una scansione periodica degli ordini aggiornati di recente.

FarmHub può modificare il mio negozio, i miei prodotti o i miei prezzi?

No. L'integrazione è di sola lettura verso Shopify. FarmHub non scrive mai sul tuo negozio.

Cosa succede quando un ordine viene modificato o annullato su Shopify?

I webhook di aggiornamento degli ordini modificano il record delle vendite FarmHub esistente anziché crearne un duplicato, in modo che il record della farm segua la vetrina.

Devo autorizzare nuovamente la connessione periodicamente?

No, oggi. Shopify emette token di accesso offline che non scadono secondo una pianificazione, quindi la connessione rimane attiva senza una schermata di nuovo consenso. Shopify ha annunciato modifiche al comportamento dei token offline per le app pubbliche a partire dal 1° gennaio 2027 e FarmHub seguirà tale guida quando arriverà. Il token viene archiviato crittografato e puoi revocare la connessione da entrambi i lati in qualsiasi momento.

In che modo i webhook rimangono affidabili?

Ogni webhook viene verificato tramite firma come autentico da Shopify prima che FarmHub importi qualsiasi cosa. I post non verificati vengono rifiutati.

PRONTO PER IL PROSSIMO TURNO

Lascia che il negozio e il registro dell'azienda agricola siano d'accordo

Collega il tuo negozio Shopify e ogni ordine online si archivia nel record della fattoria a cui appartiene. Cresci, il negozio vende, il record continua.

Inizia gratuitamente