你的农场数据,按你的方式连接
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,以及可以发送给种植户的连接链接。完整的技术文档会随合作伙伴账户一并提供。
