Je bedrijfsgegevens, verbonden op jouw voorwaarden
De FairGrow API koppelt je teeltregistratie aan je coöperatie, je adviseur, je boekhoudsoftware en je planningstools, maar alleen voor de gegevens die jij goedkeurt. Je bepaalt per partner en per type gegevens, en je schakelt toegang met één klik weer uit.
Je teeltregistratie centraal, je gegevens alleen waar jij ja hebt gezegd
Je teeltregistratie is de plek waar alles samenkomt. Een planningstool kan geplande taken er direct in zetten, en wanneer je een bespuiting registreert, kies je het middel uit het officiële register van je land, zodat het toelatingsnummer automatisch wordt ingevuld en de dosering en veiligheidstermijn worden voorgesteld. Inkoopfacturen die de EasyData-factuurherkenning heeft gelezen, komen binnen als voorraad, met de inkoopprijs erbij.
Van daaruit gaan gegevens alleen naartoe waar jij toestemming voor hebt gegeven. Je boekhoudsoftware leest uren, voorraad en verkopen. Je coöperatie ziet oogsten en partijcodes. Je adviseur kijkt mee en schrijft een veldnotitie terug. Een partner zonder toestemming krijgt niets.
Voorbeeld hierboven: het productregister, inkoopfacturen en een planningstool voeden je teeltregistratie; de coöperatie, de adviseur en de boekhoudsoftware hebben toestemming, de afnemer niet. FairGrow doet niet zelf je boekhouding, maar koppelt met het pakket dat je al gebruikt.
toestemming · jobs:write · timesheets:read · inventory:read · harvests:read
Van koppelingslink naar datastroom in drie stappen
Je geeft een partner nooit je wachtwoord. Je geeft toestemming, in FairGrow zelf, en je ziet altijd wie waartoe toegang heeft.
De partner stuurt een link
Je coöperatie, adviseur of softwareleverancier stuurt je een koppelingslink. Die opent FairGrow en laat zien wie het vraagt en welke gegevens diegene wil gebruiken.
Jij kiest wat je deelt
Vink precies de rechten aan waar jij je prettig bij voelt, bijvoorbeeld je percelen en taken, maar niet je verkopen of urenregistratie. Toestemming geldt per bedrijf en per type gegevens.
De gegevens stromen, jij houdt de regie
De software van de partner haalt alleen op wat jij hebt toegestaan. Onder Verbindingen (API) in je teeltregistratie wijzig je rechten, bekijk je de geschiedenis of trek je toegang in.
Minder typen, minder spreadsheets
Veel telers houden dezelfde gegevens op meerdere plekken bij: voor de afnemer, de coöperatie, de certificeerder en de adviseur. Met een koppeling komen de gegevens die je al in FairGrow bijhoudt vanzelf op de juiste plek terecht.
Coöperaties en afnemers
Oogsten met partijcodes, beplantingen en het spuitregister, klaar voor kwaliteitscontroles en traceerbaarheid zonder bestanden heen en weer te sturen.
Teeltadviseurs
Je adviseur ziet percelen, sensorwaarden en risicosignalen, en kan na een bezoek een veldnotitie achterlaten in je registratie.
Boekhoud- en ERP-software
FairGrow doet niet je boekhouding, dat doet je boekhoudpakket. Met jouw toestemming leest het urenregistratie met uurtarieven per medewerker of team, voorraad, verkopen, inkoopfacturen en de kostprijs per teelt, zodat uren en kosten in je boeken terechtkomen zonder dubbel invoeren.
Planningstools
Plan je werk in een externe planningsmodule en het komt als geplande taak in je teeltregistratie terecht. Zodra het werk is gedaan, rond je het af in FairGrow en telt het mee voor je register.
Zeventien rechten, elk met een eigen schakelaar
Een partner krijgt nooit ‘alles’. Elk type gegevens is een apart recht, en een partner kan alleen de rechten aanvragen die FairGrow voor diegene heeft goedgekeurd.
Lezen
Met leesrechten kan een partner gegevens zien. Diegene kan er niets mee wijzigen.
Schrijven en extra’s
Een partner kan alleen taken wijzigen die diegene zelf heeft aangemaakt. E-mailadressen van je team zijn een apart recht; zonder dat recht ziet een partner alleen namen en rollen. Een voltooide spuittaak die een partner wegschrijft, komt direct in je register terecht, zodat het compleet blijft.
Van het officiële register naar een rapport dat voldoet aan 2023/564
- Kies het middel uit het officiële registerFairGrow houdt de toelatingsregisters van Duitsland (BVL), Nederland (Ctgb), België, Frankrijk, Zwitserland en Finland actueel bij. Zoek op naam, toelatingsnummer of werkzame stof en je ziet direct of een middel is toegelaten, een tijdelijke vrijstelling heeft of is verlopen. FairGrow stelt vervolgens de dosering en veiligheidstermijn voor je teelt voor; die bevestig je zelf.
- Een waarschuwing voordat je te vroeg oogstRegistreer je een oogst op een perceel waar nog een veiligheidstermijn loopt, dan waarschuwt FairGrow je, in de app en via de API.
- Compleet, of het blijft een conceptEen spuitregistratie telt pas zodra elk veld uit Uitvoeringsverordening (EU) 2023/564 is ingevuld. Tot die tijd blijft het een concept, zodat er niets onvolledigs in je register terechtkomt.
- Machineleesbaar, klaar voor 2027Vanaf 2027 moet de registratie elektronisch en machineleesbaar worden bijgehouden. FairGrow exporteert het register als CSV, XLSX of JSON, met de kolommen in de volgorde die de verordening voorschrijft.
- Het register blijft bij jouEr is geen centrale database: je houdt de registratie zelf bij. FairGrow stuurt niets op eigen initiatief naar de overheid. Jij bepaalt wanneer je een export afgeeft, en welke partner het register via de API mag lezen.
Eén spuitregistratie
Een moderne REST API, gebouwd voor synchronisatie
- Veilig inloggenEen API-sleutel per partner, of OAuth 2.0 met PKCE wanneer de teler vanuit jouw app koppelt. Sleutels worden alleen als hash opgeslagen.
- Snelle incrementele synchronisatieLees alles één keer, en vraag daarna alleen wat er is veranderd sinds je laatste synchronisatie. Lijsten gebruiken cursor-paginering.
- Webhooks in plaats van pollenOntvang een ondertekend bericht zodra een taak wordt aangemaakt of voltooid, een oogst wordt geregistreerd, een veldnotitie wordt gepubliceerd, een melding wordt afgegeven of toestemming wordt ingetrokken.
- Veilig te herhalenElke schrijfactie draagt een idempotency-sleutel, zodat een nieuwe poging na een netwerkfout nooit een duplicaat aanmaakt.
Technisch in het kort
Word API-partner
FairGrow geeft op aanvraag API-toegang aan partners. Vertel ons wie je bent, wat je wilt bouwen en welke gegevens je nodig hebt. Je krijgt een partneraccount met je eigen sleutels, webhooks en een koppelingslink om naar telers te sturen. De volledige technische documentatie krijg je bij je partneraccount.
Goed om te weten
Kan een partner mijn gegevens zien zonder mijn toestemming?
Hoe trek ik toegang in?
Doet FairGrow mijn boekhouding?
Wordt mijn spuitregister naar de overheid gestuurd?
Welk abonnement bevat API-koppelingen?
Waar worden mijn gegevens verwerkt?
Ik ben ontwikkelaar. Waar vind ik de documentatie?
Houd je registratie op één plek, deel hem waar nodig
Koppel FairGrow aan de partners waar je al mee werkt, en bepaal zelf wat zij mogen zien.