Tilasi tiedot, yhteydessä omilla ehdoillasi
FairGrow API yhdistää viljelytietosi osuuskuntaasi, neuvojaasi, kirjanpito-ohjelmistoosi ja suunnittelutyökaluihisi, mutta vain niiden tietojen osalta, jotka hyväksyt. Päätät kumppanikohtaisesti ja tietotyyppikohtaisesti, ja voit sulkea pääsyn taas yhdellä klikkauksella.
Viljelytietosi keskiössä, tietosi kulkee vain sinne, minne olet sanonut kyllä
Viljelytietosi on paikka, jossa kaikki yhdistyy. Suunnittelutyökalu voi viedä suunnitellut työt suoraan niihin, ja kun kirjaat ruiskutuksen, valitset tuotteen maasi virallisesta rekisteristä, jolloin hyväksyntänumero täyttyy puolestasi ja annostus sekä varoaika ehdotetaan. EasyDatan laskuntunnistuksen lukemat ostolaskut kirjautuvat varastoon ostohintoineen.
Siitä eteenpäin tieto kulkee vain sinne, minne olet antanut suostumuksen. Kirjanpito-ohjelmistosi lukee tunnit, varaston ja myynnin. Osuuskuntasi näkee sadot ja erätunnukset. Neuvojasi lukee mukana ja kirjoittaa peltomuistiinpanon takaisin. Kumppani, jolla ei ole suostumusta, ei saa mitään.
Tässä näkyvässä esimerkissä tuoterekisteri, ostolaskut ja suunnittelutyökalu syöttävät tietoa viljelytietoihisi; osuuskunnalla, neuvojalla ja kirjanpito-ohjelmistolla on suostumus, ostajalla ei. FairGrow ei itse hoida kirjanpitoasi, se yhdistyy ohjelmistoon, jota jo käytät.
suostumus · jobs:write · timesheets:read · inventory:read · harvests:read
Yhteyslinkistä tiedonkulkuun kolmessa vaiheessa
Et koskaan anna kumppanille salasanaasi. Annat luvan suoraan FairGrow’ssa, ja näet milloin tahansa, kenellä on pääsy mihinkin.
Kumppani lähettää linkin
Osuuskuntasi, neuvojasi tai ohjelmistotoimittajasi lähettää sinulle yhteyslinkin. Se avaa FairGrow’n ja näyttää, kuka kysyy ja mitä tietoja he haluavat käyttää.
Valitset, mitä jaat
Rastita juuri ne oikeudet, joiden kanssa olet tyytyväinen, esimerkiksi peltosi ja työt, mutta et myyntiäsi tai tuntikirjauksiasi. Suostumus koskee tilaa ja tietotyyppiä kerrallaan.
Tieto kulkee, sinä päätät
Kumppanin ohjelmisto hakee vain sen, minkä olet sallinut. Viljelytiedoissasi kohdassa Yhteydet (API) muutat oikeuksia, katsot historiaa tai peruutat pääsyn.
Vähemmän kirjoittamista, vähemmän taulukoita
Moni viljelijä pitää samoja tietoja yllä useassa paikassa: ostajalle, osuuskunnalle, sertifioijalle ja neuvojalle. Yhteyden avulla tiedot, jotka jo pidät yllä FairGrow’ssa, kulkevat oikeaan paikkaan itsestään.
Osuuskunnat ja ostajat
Sadot erätunnuksineen, istutukset ja kasvinsuojelujournaali valmiina laatutarkastuksiin ja jäljitettävyyteen ilman tiedostojen edestakaista lähettelyä.
Viljelyneuvojat
Neuvojasi näkee pellot, anturilukemat ja riskisignaalit, ja voi jättää peltomuistiinpanon tietoihisi käynnin jälkeen.
Kirjanpito- ja ERP-ohjelmistot
FairGrow ei hoida kirjanpitoasi, sen tekee kirjanpito-ohjelmistosi. Suostumuksellasi se lukee tuntikirjaukset, joissa näkyvät jäsen- tai tiimikohtaiset tuntihinnat, varaston, myynnin, ostolaskut ja kasvikohtaisen omakustannushinnan, jolloin tunnit ja kustannukset päätyvät kirjanpitoon kirjaamatta niitä uudelleen.
Suunnittelutyökalut
Suunnittele työsi ulkoisessa suunnittelumoduulissa, ja se päätyy viljelytietoihisi suunniteltuna työnä. Kun työ on tehty, merkitset sen valmiiksi FairGrow’ssa, ja se lasketaan journaaliisi.
Seitsemäntoista oikeutta, kullakin oma kytkimensä
Kumppani ei koskaan saa ”kaikkea”. Jokainen tietotyyppi on oma erillinen oikeutensa, ja kumppani voi pyytää vain niitä oikeuksia, jotka FairGrow on hyväksynyt sille.
Lukeminen
Lukuoikeudet antavat kumppanille mahdollisuuden nähdä tietoja. Niillä ei voi muuttaa mitään.
Kirjoittaminen ja lisät
Kumppani voi muuttaa vain itse luomiaan töitä. Tiimisi sähköpostiosoitteet ovat erillinen oikeus; ilman sitä kumppani näkee vain nimet ja roolit. Kumppanin kirjaama valmis kasvinsuojelutyö menee suoraan journaaliisi, joten se pysyy täydellisenä.
Virallisesta rekisteristä raporttiin, joka täyttää 2023/564:n vaatimukset
- Valitse tuote virallisesta rekisteristäFairGrow pitää ajan tasalla Saksan (BVL), Alankomaiden (Ctgb), Belgian, Ranskan, Sveitsin ja Suomen hyväksyntärekisterit. Hae nimellä, hyväksyntänumerolla tai tehoaineella, ja näet välittömästi, onko tuote hyväksytty, sillä on tilapäinen poikkeus, tai onko hyväksyntä vanhentunut. FairGrow ehdottaa sitten annostusta ja varoaikaa kasvillesi; vahvistat ne itse.
- Varoitus ennen kuin korjaat sadon liian aikaisinKirjaa sato lohkolle, jolla varoaika on vielä käynnissä, ja FairGrow varoittaa sinua sovelluksessa ja API:n kautta.
- Täydellinen, tai se jää luonnokseksiRuiskutuskirjaus lasketaan vasta, kun kaikki täytäntöönpanoasetuksen (EU) 2023/564 kentät on täytetty. Siihen asti se jää luonnokseksi, jotta journaaliisi ei päädy mitään puutteellista.
- Koneluettava, valmiina vuodelle 2027Vuodesta 2027 alkaen kirjaukset on pidettävä sähköisinä ja koneluettavina. FairGrow vie journaalin CSV-, XLSX- tai JSON-muodossa, sarakkeet asetuksen määräämässä järjestyksessä.
- Journaali pysyy sinullaKeskitettyä tietokantaa ei ole: pidät kirjauksia itse. FairGrow ei lähetä mitään viranomaisille omasta aloitteestaan. Päätät itse, milloin luovutat viennin, ja minkä kumppanin annat lukea journaalia API:n kautta.
Yksi ruiskutuskirjaus
Moderni REST API, rakennettu synkronointia varten
- Turvallinen kirjautuminenAPI-avain kumppania kohden, tai OAuth 2.0 PKCE:n kanssa, kun viljelijä yhdistää sovelluksestasi. Avaimet tallennetaan vain hash-muodossa.
- Nopea inkrementaalinen synkronointiLue kaikki kerran, ja pyydä sen jälkeen vain se, mikä on muuttunut edellisen synkronoinnin jälkeen. Listat käyttävät kursoripohjaista sivutusta.
- Webhookit pollauksen sijaanSaat allekirjoitetun viestin heti, kun työ luodaan tai valmistuu, sato kirjataan, peltomuistiinpano julkaistaan, hälytys laukeaa tai suostumus perutaan.
- Turvallinen toistaaJokaisessa kirjoituksessa on idempotenssiavain, joten verkkovirheen jälkeinen uusi yritys ei koskaan luo kaksoiskappaletta.
Tekniikka lyhyesti
Ryhdy API-kumppaniksi
FairGrow antaa API-pääsyn kumppaneille pyynnöstä. Kerro meille, kuka olet, mitä haluat rakentaa ja mitä tietoja tarvitset. Saat kumppanitilin, jossa on omat avaimet, webhookit ja yhteyslinkki lähetettäväksi viljelijöille. Täydellinen tekninen dokumentaatio tulee kumppanitilisi mukana.
Hyvä tietää
Voiko kumppani nähdä tietoni ilman lupaani?
Miten peruutan pääsyn?
Hoitaako FairGrow kirjanpitoni?
Lähetetäänkö kasvinsuojelujournaalini viranomaisille?
Mikä tilaus sisältää API-yhteydet?
Missä tietojani käsitellään?
Olen kehittäjä. Mistä löydän dokumentaation?
Pidä tietosi yhdessä paikassa, jaa niitä siellä missä niitä tarvitaan
Yhdistä FairGrow kumppaneihin, joiden kanssa jo teet yhteistyötä, ja päätä itse, mitä he saavat nähdä.