Dữ liệu nông trại của bạn, kết nối theo cách của bạn

Dữ liệu nông trại của bạn, kết nối theo cách của bạn

FairGrow API kết nối hồ sơ canh tác của bạn với hợp tác xã, kỹ thuật viên, phần mềm kế toán và các công cụ lập kế hoạch của bạn, nhưng chỉ với dữ liệu mà bạn đồng ý. Bạn quyết định theo từng đối tác và từng loại dữ liệu, và có thể tắt quyền truy cập bất cứ lúc nào chỉ với một lần nhấp.

Một kết nối trông như thế nào

Hồ sơ canh tác là trung tâm, dữ liệu của bạn chỉ chảy đến nơi bạn đã đồng ý

Hồ sơ canh tác là nơi mọi thông tin được gom lại. Một công cụ lập kế hoạch có thể đưa thẳng các công việc đã lên kế hoạch vào đó, và khi bạn ghi lại một lần phun thuốc, bạn chọn sản phẩm từ sổ đăng ký chính thức của quốc gia mình, nhờ đó số đăng ký sẽ được điền sẵn cho bạn, và liều lượng cùng thời gian cách ly cũng sẽ được đề xuất. Hóa đơn mua hàng được công cụ nhận diện hóa đơn của EasyData đọc sẽ được ghi vào dưới dạng tồn kho, kèm giá mua.

Từ đó, dữ liệu chỉ đi đến nơi bạn đã đồng ý. Phần mềm kế toán của bạn đọc giờ công, tồn kho và doanh số. Hợp tác xã của bạn thấy được các vụ thu hoạch và mã lô. Kỹ thuật viên của bạn đọc theo và ghi lại một ghi chú thực địa. Đối tác không có sự đồng ý sẽ không nhận được gì.

Ví dụ minh họa ở đây: sổ đăng ký sản phẩm, hóa đơn mua hàng và một công cụ lập kế hoạch cung cấp dữ liệu cho hồ sơ canh tác của bạn; hợp tác xã, kỹ thuật viên và phần mềm kế toán đã có sự đồng ý, người thu mua thì chưa. FairGrow không tự làm sổ sách kế toán cho bạn; nó chỉ kết nối với phần mềm bạn đang sử dụng.

17
quyền riêng biệt
1
lần nhấp để thu hồi quyền truy cập
7
ngày lưu lịch sử gọi
0
mật khẩu được chia sẻ
Cách hoạt động

Từ liên kết kết nối đến luồng dữ liệu, chỉ trong ba bước

Bạn không bao giờ phải đưa mật khẩu cho đối tác. Bạn cấp quyền ngay trong FairGrow, và có thể xem bất cứ lúc nào ai đang có quyền truy cập vào những gì.

BƯỚC 01

Đối tác gửi một liên kết

Hợp tác xã, kỹ thuật viên hoặc nhà cung cấp phần mềm của bạn gửi cho bạn một liên kết kết nối. Liên kết này mở FairGrow và cho bạn biết ai đang yêu cầu và họ muốn sử dụng dữ liệu nào.

BƯỚC 02

Bạn chọn những gì sẽ chia sẻ

Hãy chỉ tích chọn những quyền mà bạn thấy thoải mái, chẳng hạn như ruộng và công việc, nhưng không chọn doanh số hoặc giờ công. Sự đồng ý được áp dụng theo từng nông trại và từng loại dữ liệu.

BƯỚC 03

Dữ liệu được chia sẻ, bạn vẫn là người quyết định

Phần mềm của đối tác chỉ lấy đúng những gì bạn đã cho phép. Trong mục Kết nối (API) ở hồ sơ canh tác, bạn có thể thay đổi quyền, xem lại lịch sử hoặc thu hồi quyền truy cập.

Ai sẽ kết nối

Ít nhập liệu hơn, ít bảng tính hơn

Nhiều nhà vườn phải lưu cùng một thông tin ở nhiều nơi khác nhau: cho người thu mua, cho hợp tác xã, cho tổ chức chứng nhận và cho kỹ thuật viên. Khi có kết nối, dữ liệu bạn đã lưu sẵn trong FairGrow sẽ tự động đến đúng nơi cần đến.

Hợp tác xã và người thu mua

Các vụ thu hoạch kèm mã lô, các lần trồng và sổ ghi phun thuốc luôn sẵn sàng cho việc kiểm tra chất lượng và truy xuất nguồn gốc, mà không cần gửi qua gửi lại tệp tin.

Kỹ thuật viên cây trồng

Kỹ thuật viên của bạn xem được ruộng, số liệu cảm biến và tín hiệu rủi ro, và có thể để lại một ghi chú thực địa vào hồ sơ của bạn sau mỗi lần thăm đồng.

Phần mềm kế toán và ERP

FairGrow không làm sổ sách kế toán cho bạn; phần mềm kế toán của bạn mới làm việc đó. Với sự đồng ý của bạn, phần mềm này đọc giờ công với đơn giá theo giờ của từng thành viên hoặc nhóm, tồn kho, doanh số, hóa đơn mua hàng và giá vốn theo từng loại cây trồng, nhờ đó giờ công và chi phí được chuyển vào sổ sách mà không cần nhập lại.

Công cụ lập kế hoạch

Lập kế hoạch công việc trong một mô-đun lập kế hoạch bên ngoài, và nó sẽ xuất hiện trong hồ sơ canh tác của bạn dưới dạng một công việc đã lên kế hoạch. Khi công việc hoàn tất, bạn hoàn thành nó trong FairGrow và nó sẽ được tính vào sổ ghi của bạn.

Những gì bạn có thể chia sẻ

17 quyền riêng biệt, mỗi quyền có nút bật tắt của riêng mình

Một đối tác không bao giờ nhận được “tất cả”. Mỗi loại dữ liệu là một quyền riêng, và đối tác chỉ có thể yêu cầu những quyền mà FairGrow đã phê duyệt cho họ.

Đọc dữ liệu

Thông tin nông trạiRuộng và ranh giớiCông việc và sổ ghi phun thuốcGhi chú thực địaThu hoạch và mã lôDoanh sốNhóm làm việcGiờ côngTồn kho sản phẩmSố liệu cảm biếnChỉ số thực vật từ vệ tinhTín hiệu rủi ro và cảnh báoChi phí, biên lợi nhuận và hóa đơn mua hàng

Quyền đọc chỉ cho phép đối tác xem dữ liệu. Họ không thể thay đổi bất cứ điều gì với quyền này.

Ghi dữ liệu và các quyền bổ sung

Tạo công việcThêm ghi chú thực địaThêm vụ thu hoạchĐịa chỉ email của thành viên nông trại

Đối tác chỉ có thể thay đổi những công việc do chính họ tạo ra. Địa chỉ email của nhóm bạn là một quyền riêng; nếu không có quyền này, đối tác chỉ thấy tên và vai trò. Một công việc phun thuốc đã hoàn thành do đối tác ghi lại sẽ được đưa thẳng vào sổ ghi của bạn, nhờ đó sổ ghi luôn đầy đủ.

Sổ ghi bảo vệ thực vật

Từ sổ đăng ký chính thức đến một báo cáo đáp ứng quy định 2023/564

  • Chọn sản phẩm từ sổ đăng ký chính thứcFairGrow luôn cập nhật các sổ đăng ký thuốc bảo vệ thực vật của Đức (BVL), Hà Lan (Ctgb), Bỉ, Pháp, Thụy Sĩ và Phần Lan. Tìm theo tên, số đăng ký hoặc hoạt chất, bạn sẽ biết ngay sản phẩm đó đã được cấp phép, đang trong thời gian miễn trừ tạm thời hay đã hết hạn. FairGrow cũng đề xuất liều lượng và thời gian cách ly cho cây trồng của bạn; bạn tự xác nhận.
  • Cảnh báo trước khi bạn thu hoạch quá sớmNếu bạn ghi nhận một vụ thu hoạch trên một ruộng vẫn còn trong thời gian cách ly, FairGrow sẽ cảnh báo bạn, cả trong ứng dụng và qua API.
  • Hoàn chỉnh, nếu không sẽ vẫn là bản nhápMột bản ghi phun thuốc chỉ được tính khi mọi trường thông tin theo Quy định thực thi (EU) 2023/564 đã được điền đầy đủ. Trước đó, nó vẫn chỉ là bản nháp, để không có gì chưa hoàn chỉnh lẫn vào sổ ghi của bạn.
  • Đọc được bằng máy, sẵn sàng cho năm 2027Từ năm 2027, các bản ghi phải được lưu giữ dưới dạng điện tử và đọc được bằng máy. FairGrow xuất sổ ghi dưới dạng CSV, XLSX hoặc JSON, với các cột theo đúng thứ tự mà quy định đưa ra.
  • Sổ ghi vẫn thuộc về bạnKhông có cơ sở dữ liệu trung tâm: bạn tự giữ các bản ghi. FairGrow không tự gửi chúng cho bất kỳ cơ quan nào. Bạn quyết định khi nào giao một bản xuất, và đối tác nào được đọc sổ ghi qua API.

Một bản ghi phun thuốc

Tên sản phẩmtừ sổ đăng ký
Số đăng kýtừ sổ đăng ký
Trạng thái cấp phépđã cấp phép
Cây trồng và ruộngtừ lô đất của bạn
Liều lượng và thời gian cách lyđược đề xuất, bạn xác nhận
Ngày và thời tiếtđã ghi nhận
Trạng thái sổ ghihoàn chỉnh
Dành cho nhà phát triển

Một REST API hiện đại, được xây dựng để đồng bộ dữ liệu

  • Đăng nhập an toànMỗi đối tác có một API key riêng, hoặc dùng OAuth 2.0 kèm PKCE khi nhà vườn kết nối từ ứng dụng của bạn. Các key chỉ được lưu dưới dạng hash.
  • Đồng bộ gia tăng, nhanh chóngĐọc toàn bộ dữ liệu một lần, sau đó chỉ cần hỏi những gì đã thay đổi kể từ lần đồng bộ trước. Các danh sách sử dụng phân trang dạng cursor.
  • Webhook thay cho pollingNhận ngay một thông báo đã ký ngay khi có công việc được tạo hoặc hoàn thành, một vụ thu hoạch được ghi nhận, một ghi chú thực địa được đăng, một cảnh báo được phát ra hoặc một sự đồng ý bị thu hồi.
  • An toàn khi thử lạiMỗi lần ghi dữ liệu đều mang một khóa idempotency, nên việc thử lại sau một lỗi mạng sẽ không bao giờ tạo ra dữ liệu trùng lặp.

Thông tin kỹ thuật tổng quan

KiểuREST + JSON
Xác thựcAPI key / OAuth 2.0 + PKCE
Token truy cậpcó hiệu lực 1 giờ
Giới hạn tốc độ120 lượt/phút cho mỗi key
Thời gianUTC, ISO 8601
Chữ ký webhookHMAC-SHA256
Mã cây trồng và sinh vật gây hạiEPPO
Lưu trữmáy chủ riêng, tại trung tâm dữ liệu ở Hà Lan
Đang xây dựng phần mềm cho nhà vườn?

Trở thành đối tác API

FairGrow cấp quyền truy cập API cho đối tác theo yêu cầu. Hãy cho chúng tôi biết bạn là ai, bạn muốn xây dựng gì và cần loại dữ liệu nào. Bạn sẽ nhận được một tài khoản đối tác với các key riêng, webhook và một liên kết kết nối để gửi cho nhà vườn. Tài liệu kỹ thuật đầy đủ sẽ đi kèm với tài khoản đối tác của bạn.

Yêu cầu quyền truy cập đối tác → Hoặc gửi email đến welkom@easydata.nl
Câu hỏi thường gặp

Những điều nên biết

Đối tác có thể xem dữ liệu của tôi mà không cần tôi cho phép không?
Không. Mọi yêu cầu đều được kiểm tra dựa trên sự đồng ý của bạn đối với đối tác đó, nông trại đó và loại dữ liệu đó. Nếu không có sự đồng ý, đối tác sẽ không nhận được gì cả.
Làm thế nào để thu hồi quyền truy cập?
Mở hồ sơ canh tác của bạn và vào mục Kết nối (API). Ở đó bạn sẽ thấy mọi đối tác đang có quyền truy cập, những quyền họ đang có và số lần họ đã gọi trong bảy ngày qua. Chỉ cần nhấp vào Thu hồi quyền truy cập, đối tác sẽ không còn đọc hoặc ghi được gì nữa. Đối tác cũng sẽ nhận được thông báo rằng sự đồng ý đã bị thu hồi.
FairGrow có làm sổ sách kế toán cho tôi không?
Không. FairGrow không phải là phần mềm kế toán. Phần mềm kế toán hoặc ERP của bạn kết nối qua API và, với sự đồng ý của bạn, đọc giờ công, tồn kho và doanh số. Nhờ vậy, giờ công và chi phí từ hồ sơ canh tác của bạn được chuyển vào sổ sách mà không cần nhập lại hai lần. Ngược lại, hóa đơn mua hàng được công cụ nhận diện hóa đơn của EasyData đọc sẽ được ghi vào dưới dạng tồn kho, và giá mua của chúng sẽ xuất hiện trong tổng quan chi phí của bạn.
Sổ ghi phun thuốc của tôi có được gửi cho cơ quan chức năng không?
Không. Theo quy định EU 2023/564, bạn tự giữ các bản ghi, và FairGrow không tự gửi chúng đi đâu cả. Khi một thanh tra viên hoặc tổ chức chứng nhận yêu cầu, bạn xuất sổ ghi dưới dạng CSV, XLSX hoặc JSON, hoặc cho phép một đối tác đọc nó qua API.
Gói đăng ký nào bao gồm kết nối API?
Kết nối với các hệ thống khác là một phần của gói đăng ký Estate. Chỉ chủ sở hữu nông trại mới có thể cấp hoặc thu hồi quyền truy cập; các thành viên khác trong nhóm không thể làm điều này.
Dữ liệu của tôi được xử lý ở đâu?
Toàn bộ dữ liệu được xử lý trên các máy chủ riêng của chúng tôi, đặt tại một trung tâm dữ liệu ở Hà Lan, và chúng tôi đạt chứng nhận ISO 27001. Mọi lệnh gọi API đều được ghi lại trong bảy ngày, kèm thông tin về đối tác, endpoint, nông trại, trạng thái và thời gian, nhờ đó luôn rõ ràng ai đã lấy dữ liệu gì. Tìm hiểu thêm về ai sở hữu dữ liệu của bạn.
Tôi là nhà phát triển. Tôi có thể tìm tài liệu ở đâu?
Tài liệu tham chiếu API đầy đủ và hướng dẫn bắt đầu sử dụng chỉ dành cho các đối tác đã được chấp thuận. Liên hệ với chúng tôi cùng thông tin công ty và mục đích sử dụng của bạn, chúng tôi sẽ thiết lập một tài khoản đối tác cho bạn.

Lưu trữ hồ sơ của bạn ở một nơi, chia sẻ đến nơi cần thiết

Kết nối FairGrow với những đối tác bạn đang hợp tác, và tự mình quyết định những gì họ được xem.

✓

Cảm ơn bạn!

Chúng tôi đã nhận được yêu cầu và sẽ liên hệ sớm.

➤ Liên hệ trực tiếp trong vòng 1 ngày làm việc

➤ Đề xuất dựa trên tình hình của bạn