I dati della tua azienda agricola, connessi alle tue condizioni
L’API di FairGrow collega i tuoi registri colturali alla tua cooperativa, al tuo consulente, al tuo software di contabilità e ai tuoi strumenti di pianificazione, ma solo per i dati che approvi. Decidi tu, partner per partner e tipo di dato per tipo di dato, e puoi disattivare l’accesso in qualsiasi momento con un clic.
I tuoi registri colturali al centro, i tuoi dati solo dove hai detto sì
I tuoi registri colturali sono il punto in cui tutto converge. Uno strumento di pianificazione può inserire direttamente le attività pianificate, e quando registri un trattamento scegli il prodotto dal registro ufficiale del tuo paese, così il numero di autorizzazione viene compilato per te e vengono proposti la dose e l’intervallo di sicurezza. Le fatture di acquisto lette dal riconoscimento fatture di EasyData arrivano come giacenza, con il relativo prezzo di acquisto.
Da lì, i dati vanno solo dove hai dato il consenso. Il tuo software di contabilità legge ore, giacenze e vendite. La tua cooperativa vede raccolti e codici lotto. Il tuo consulente legge e scrive una nota di campo. Un partner senza consenso non riceve nulla.
Esempio mostrato qui: il registro prodotti, le fatture di acquisto e uno strumento di pianificazione alimentano i tuoi registri colturali; la cooperativa, il consulente e il software di contabilità hanno il consenso, l’acquirente no. FairGrow non fa la tua contabilità; si collega al programma che già usi.
consenso · jobs:write · timesheets:read · inventory:read · harvests:read
Dal link di collegamento al flusso di dati in tre passaggi
Non dai mai la tua password a un partner. Dai il permesso direttamente in FairGrow, e puoi vedere in qualsiasi momento chi ha accesso a cosa.
Il partner invia un link
La tua cooperativa, il tuo consulente o il tuo fornitore di software ti invia un link di collegamento. Il link apre FairGrow e ti mostra chi lo chiede e quali dati vuole usare.
Scegli cosa condividere
Seleziona esattamente i permessi con cui ti senti a tuo agio, ad esempio i tuoi campi e le tue attività, ma non le tue vendite o le ore registrate. Il consenso vale per azienda e per tipo di dato.
I dati scorrono, il controllo resta tuo
Il software del partner recupera solo ciò che hai consentito. In Connessioni (API), nei tuoi registri colturali, modifichi i permessi, consulti la cronologia o revochi l’accesso.
Meno digitazione, meno fogli di calcolo
Molti agricoltori tengono gli stessi registri in più posti: per l’acquirente, la cooperativa, l’ente di certificazione e il consulente. Con un collegamento, i dati che tieni già in FairGrow arrivano da soli al posto giusto.
Cooperative e acquirenti
Raccolti con codici lotto, impianti e registro dei trattamenti, pronti per i controlli di qualità e la tracciabilità senza scambiarsi file avanti e indietro.
Consulenti agronomici
Il tuo consulente vede campi, letture dei sensori e segnali di rischio, e può lasciare una nota di campo nei tuoi registri dopo una visita.
Software di contabilità ed ERP
FairGrow non fa la tua contabilità; lo fa il tuo software di contabilità. Con il tuo consenso legge ore registrate con le tariffe orarie per membro o team, giacenze, vendite, fatture di acquisto e il prezzo di costo per coltura, così ore e costi arrivano alla contabilità senza doverli digitare di nuovo.
Strumenti di pianificazione
Pianifica il lavoro in un modulo di pianificazione esterno e questo arriva nei tuoi registri colturali come attività pianificata. Una volta completato il lavoro, lo completi in FairGrow e conta per il tuo registro.
Diciassette permessi, ognuno con il proprio interruttore
Un partner non riceve mai «tutto». Ogni tipo di dato è un permesso separato, e un partner può chiedere solo i permessi che FairGrow gli ha approvato.
Lettura
I permessi di lettura permettono a un partner di vedere i dati. Non può modificare nulla con questi permessi.
Scrittura ed extra
Un partner può modificare solo le attività che ha creato lui stesso. Gli indirizzi e-mail del tuo team sono un permesso separato; senza di esso, un partner vede solo nomi e ruoli. Un trattamento completato scritto da un partner finisce direttamente nel tuo registro, che resta così completo.
Dal registro ufficiale a un rapporto conforme al 2023/564
- Scegli il prodotto dal registro ufficialeFairGrow mantiene aggiornati i registri di autorizzazione di Germania (BVL), Paesi Bassi (Ctgb), Belgio, Francia, Svizzera e Finlandia. Cerca per nome, numero di autorizzazione o sostanza attiva e vedi subito se un prodotto è autorizzato, ha una deroga temporanea o è scaduto. FairGrow propone quindi la dose e l’intervallo di sicurezza per la tua coltura; sei tu a confermarli.
- Un avviso prima di raccogliere troppo prestoSe registri un raccolto su un campo dove l’intervallo di sicurezza è ancora in corso, FairGrow ti avvisa, nell’app e tramite l’API.
- Completo, altrimenti resta una bozzaUn trattamento conta solo quando sono compilati tutti i campi previsti dal Regolamento di esecuzione (UE) 2023/564. Fino a quel momento resta in bozza, così nel tuo registro non entra nulla di incompleto.
- Leggibile da una macchina, pronto per il 2027Dal 2027 i registri dovranno essere tenuti in formato elettronico e leggibile da una macchina. FairGrow esporta il registro come CSV, XLSX o JSON, con le colonne nell’ordine previsto dal regolamento.
- Il registro resta tuoNon esiste un database centrale: sei tu a tenere i registri. FairGrow non invia nulla alle autorità di propria iniziativa. Decidi tu quando consegnare un’esportazione, e quale partner può leggere il registro tramite l’API.
Un trattamento registrato
Un’API REST moderna, pensata per la sincronizzazione
- Accesso sicuroUna API key per partner, oppure OAuth 2.0 con PKCE quando l’agricoltore si collega dalla tua app. Le chiavi sono conservate solo come hash.
- Sincronizzazione incrementale veloceLeggi tutto una volta, poi chiedi solo cosa è cambiato dall’ultima sincronizzazione. Gli elenchi usano la paginazione a cursore.
- Webhook invece del pollingRicevi un messaggio firmato non appena un’attività viene creata o completata, un raccolto viene registrato, una nota di campo viene pubblicata, un avviso viene generato o un consenso viene revocato.
- Sicuro da ripetereOgni scrittura porta una idempotency key, così un nuovo tentativo dopo un errore di rete non crea mai un duplicato.
Dati tecnici in breve
Diventa partner API
FairGrow concede l’accesso API ai partner su richiesta. Raccontaci chi sei, cosa vuoi costruire e di quali dati hai bisogno. Ricevi un account partner con le tue chiavi, i webhook e un link di collegamento da inviare agli agricoltori. La documentazione tecnica completa arriva insieme al tuo account partner.
Da sapere
Un partner può vedere i miei dati senza il mio permesso?
Come revoco l’accesso?
FairGrow si occupa della mia contabilità?
Il mio registro dei trattamenti viene inviato alle autorità?
Quale abbonamento include le connessioni API?
Dove vengono trattati i miei dati?
Sono uno sviluppatore. Dove trovo la documentazione?
Tieni i tuoi registri in un unico posto, condividili dove servono
Collega FairGrow ai partner con cui già lavori, e decidi tu cosa possono vedere.