您的農場資料,由您說了算的連接方式
FairGrow API 把您的田間記錄連接到您的合作社、顧問、會計軟體和規劃工具,但僅限於您核准的資料。您可以按合作夥伴與資料類型分別決定,並可以隨時一鍵重新關閉存取權限。
田間記錄居中,資料只流向您同意的地方
您的田間記錄是一切匯整的地方。規劃工具可以把排定的作業直接寫入其中,當您記錄一次噴藥時,從您所在國家的官方登記冊中選擇產品,核准號碼就會自動為您填好,並會為您建議用量和安全採收期,由您自己確認。經 EasyData 發票辨識讀取的採購發票會以庫存入帳,並附上採購價格。
從這裡開始,資料只流向您同意的地方。您的會計軟體讀取工時、庫存和銷售。您的合作社看到收穫記錄和批號。您的顧問可以查看,並寫回一則田間記錄。沒有同意的合作夥伴什麼都得不到。
這裡的範例:產品登記冊、採購發票和一個規劃工具把資料輸入您的田間記錄;合作社、顧問和會計軟體獲得了同意,買家沒有。FairGrow 本身不做您的帳務,它只是連接您已經在用的軟體。
同意 · jobs:write · timesheets:read · inventory:read · harvests:read
三步驟,從連接連結到資料流動
您永遠不需要把密碼交給合作夥伴。您是在 FairGrow 中直接授予權限,並且隨時可以查看誰擁有什麼存取權限。
合作夥伴傳送連結
您的合作社、顧問或軟體供應商會傳送一個連接連結給您。點擊後會開啟 FairGrow,顯示是誰在請求,以及他們想使用哪些資料。
您選擇要分享的內容
只勾選您放心的權限,例如您的田區和作業,但不包含您的銷售或工時記錄。同意會按農場和資料類型分別生效。
資料開始流動,主導權仍在您手上
合作夥伴的軟體只會取得您允許的資料。在您田間記錄中的「連接 (API)」下,您可以變更權限、檢視歷史記錄或撤銷存取權限。
少打字,少用試算表
許多農友要在好幾個地方重複記錄同樣的資訊:給買家的、給合作社的、給驗證機構的、給顧問的。有了連接,您已經在 FairGrow 中記錄的資料會自動送到正確的地方。
合作社與買家
附批號的收穫記錄、種植記錄和噴藥登記,隨時可用於品質檢查與可追溯性,不必再來回傳送檔案。
作物顧問
您的顧問可以查看田區、感測器讀數和風險訊號,並在拜訪後在您的記錄中留下田間記錄。
會計與 ERP 軟體
FairGrow 不做您的帳務,您的會計軟體才做。在您同意的情況下,它會讀取附有每位成員或團隊時薪的工時記錄、庫存、銷售和採購發票,以及每種作物的成本價,讓工時和成本自動進入您的帳本,不必重複輸入。
規劃工具
在外部規劃模組中安排您的工作,它會以排定作業的形式進入您的田間記錄。工作完成後,您在 FairGrow 中完成它,就會計入您的登記。
十七項權限,各有專屬開關
合作夥伴永遠不會取得「全部」權限。每一種資料類型都是獨立的權限,合作夥伴只能請求 FairGrow 已為其核准的權限。
讀取
讀取權限讓合作夥伴可以看到資料,但無法用它變更任何內容。
寫入與其他
合作夥伴只能變更自己建立的作業。團隊成員的電子郵件地址是獨立的權限,沒有這項權限,合作夥伴只能看到姓名和角色。合作夥伴寫入的已完成噴藥作業會直接進入您的登記,確保記錄完整。
從官方登記冊到符合 2023/564 的報告
- 從官方登記冊中選擇產品FairGrow 持續更新德國 (BVL)、荷蘭 (Ctgb)、比利時、法國、瑞士和芬蘭的登記冊。按名稱、核准號碼或有效成分搜尋,您可以立即看到一款產品是否獲准、是否有臨時豁免,或是否已過期。FairGrow 隨後會為您的作物建議用量和安全採收期;由您自己確認。
- 提早採收前的提醒如果您在安全採收期仍未結束的田區記錄收穫,FairGrow 會在應用程式內和透過 API 提醒您。
- 填寫完整,否則仍是草稿只有填完《歐盟實施法規》2023/564 要求的每一個欄位,噴藥記錄才算完成。在那之前它仍是草稿,確保不完整的內容不會混入您的登記。
- 機器可讀,為 2027 年做好準備從 2027 年起,記錄必須以電子方式保存並且機器可讀。FairGrow 會依法規規定的欄位順序,將登記匯出為 CSV、XLSX 或 JSON。
- 登記始終由您保管沒有中央資料庫:記錄由您自己保管。FairGrow 不會主動把任何內容傳送給主管機關。您自己決定何時提交匯出檔案,以及哪個合作夥伴可以透過 API 讀取登記。
一筆噴藥記錄
現代化的 REST API,為同步而生
- 安全登入每個合作夥伴一組 API key,或在農友從您的應用程式連接時使用帶 PKCE 的 OAuth 2.0。金鑰僅以雜湊值儲存。
- 快速增量同步先完整讀取一次,之後只要求上次同步以來變動的內容。清單使用游標分頁。
- 用 Webhook 取代輪詢當作業建立或完成、收穫登記、田間記錄發布、警示觸發或同意被撤銷時,立即收到一則已簽署的訊息。
- 可安全重試每次寫入都帶有冪等金鑰,因此網路錯誤後的重試絕不會產生重複資料。
技術概覽
成為 API 合作夥伴
FairGrow 會依申請開放 API 存取權給合作夥伴。告訴我們您是誰、想打造什麼,以及需要哪些資料。您將取得一個合作夥伴帳戶,擁有自己的金鑰、webhook,以及可以傳送給農友的連接連結。完整的技術文件會隨合作夥伴帳戶一併提供。
