농장 데이터를 스스로 정한 조건으로 연결합니다
FairGrow API는 작물 기록을 협동조합, 작물 컨설턴트, 회계 소프트웨어, 작업 계획 도구에 연결합니다. 단, 승인한 데이터만 연결됩니다. 파트너별, 데이터 유형별로 공유 범위를 직접 정할 수 있으며, 클릭 한 번으로 언제든 접근을 해제할 수 있습니다.
작물 기록을 중심에 두고, 데이터는 동의한 곳으로만 흐릅니다
작물 기록은 모든 정보가 모이는 곳입니다. 작업 계획 도구는 예정된 작업을 바로 그 안에 넣을 수 있고, 방제 작업을 기록할 때는 해당 국가의 공식 등록부에서 제품을 선택하기만 하면 인증 번호가 자동으로 입력되고, 사용량과 수확 전 대기 기간(PHI)도 제안됩니다. EasyData의 인보이스 인식이 읽어 들인 매입 인보이스는 매입가와 함께 재고로 등록됩니다.
그 다음부터는 동의한 곳으로만 데이터가 전달됩니다. 회계 소프트웨어는 근무 기록, 재고, 매출을 읽습니다. 협동조합은 수확과 로트 코드를 확인합니다. 컨설턴트는 기록을 함께 보고 포장 메모를 다시 기록합니다. 동의하지 않은 파트너는 아무것도 받지 못합니다.
여기 보이는 예시: 제품 등록부, 매입 인보이스, 작업 계획 도구가 작물 기록에 정보를 제공합니다. 협동조합, 컨설턴트, 회계 소프트웨어는 동의를 받았지만, 구매처는 받지 못했습니다. FairGrow는 직접 회계 처리를 하지 않으며, 이미 사용 중인 소프트웨어와 연결됩니다.
동의 · jobs:write · timesheets:read · inventory:read · harvests:read
연결 링크에서 데이터 흐름까지, 세 단계
파트너에게 비밀번호를 알려줄 필요는 전혀 없습니다. FairGrow 안에서 권한을 부여하며, 누가 무엇에 접근할 수 있는지 언제든 확인할 수 있습니다.
파트너가 링크를 보냅니다
협동조합, 컨설턴트 또는 소프트웨어 공급업체가 연결 링크를 보냅니다. 링크를 열면 FairGrow에서 누가 요청했는지, 어떤 데이터를 사용하려는지 보여줍니다.
공유할 항목을 선택합니다
편하게 공유할 수 있는 권한만 선택합니다. 예를 들어 포장과 작업은 공유하되 매출이나 근무 기록은 공유하지 않을 수 있습니다. 동의는 농장별, 데이터 유형별로 적용됩니다.
데이터가 흐르는 동안에도 주도권은 농장에 있습니다
파트너의 소프트웨어는 승인한 범위의 데이터만 가져갑니다. 작물 기록의 연결(API)에서 권한을 변경하거나, 이력을 확인하거나, 접근을 해제할 수 있습니다.
입력은 줄이고, 스프레드시트는 없애세요
많은 농가가 구매처, 협동조합, 인증기관, 컨설턴트 등 여러 곳에 같은 기록을 중복으로 관리합니다. 연결을 설정하면 이미 FairGrow에 있는 데이터가 자동으로 필요한 곳에 전달됩니다.
협동조합과 구매처
로트 코드가 있는 수확 기록, 재배 정보, 방제 기록을 파일을 주고받지 않고도 품질 검사와 이력 추적에 바로 사용할 수 있습니다.
작물 컨설턴트
컨설턴트는 포장, 센서 측정값, 위험 신호를 확인하고, 방문 후에는 농장 기록에 포장 메모를 남길 수 있습니다.
회계 및 ERP 소프트웨어
FairGrow는 회계 처리를 하지 않습니다. 그 일은 회계 소프트웨어가 합니다. 동의가 있으면 구성원 또는 팀별 시급을 포함한 근무 기록, 재고, 매출, 매입 인보이스, 작물별 원가를 읽어, 다시 입력하지 않고도 작업 시간과 비용이 장부에 반영됩니다.
계획 도구
외부 계획 모듈에서 작업을 계획하면 예정 작업으로 작물 기록에 반영됩니다. 작업이 끝나면 FairGrow에서 완료 처리하면 그대로 기록으로 남습니다.
17가지 권한, 각각 별도로 켜고 끌 수 있습니다
파트너가 ‘모든 것’을 받는 일은 없습니다. 데이터 유형마다 별도의 권한이 있으며, 파트너는 FairGrow가 승인한 권한만 요청할 수 있습니다.
읽기
읽기 권한이 있으면 파트너가 데이터를 볼 수 있습니다. 이 권한만으로는 아무것도 변경할 수 없습니다.
쓰기 및 기타
파트너는 자신이 생성한 작업만 수정할 수 있습니다. 팀 구성원의 이메일 주소는 별도 권한이며, 이 권한이 없으면 파트너는 이름과 역할만 볼 수 있습니다. 파트너가 기록한 완료된 방제 작업은 그대로 농장 기록에 반영되어 기록이 항상 완전하게 유지됩니다.
공식 등록부에서 2023/564에 맞는 기록까지
- 공식 등록부에서 제품 선택FairGrow는 독일(BVL), 네덜란드(Ctgb), 벨기에, 프랑스, 스위스, 핀란드의 인증 등록부를 항상 최신 상태로 유지합니다. 이름, 인증 번호, 유효 성분으로 검색하면 제품이 인증되었는지, 임시 예외 상태인지, 만료되었는지 바로 확인할 수 있습니다. FairGrow는 이어서 해당 작물의 사용량과 수확 전 대기 기간(PHI)을 제안하며, 최종 확인은 직접 합니다.
- 너무 일찍 수확하기 전에 보내는 경고수확 전 대기 기간(PHI)이 아직 끝나지 않은 포장에서 수확을 기록하면, FairGrow가 앱과 API 양쪽에서 경고합니다.
- 완료되기 전까지는 임시 저장 상태방제 기록은 시행규정(EU) 2023/564가 요구하는 모든 항목이 입력되어야 비로소 유효해집니다. 그 전까지는 임시 저장 상태로 남아, 불완전한 기록이 등록부에 들어가지 않습니다.
- 기계 판독 가능, 2027년 대비 완료2027년부터 기록은 전자적으로, 기계 판독이 가능한 형태로 보관해야 합니다. FairGrow는 등록부를 CSV, XLSX, JSON 형식으로, 규정이 정한 순서의 열 구성으로 내보냅니다.
- 등록부는 직접 보관합니다중앙 데이터베이스는 없으며, 기록은 스스로 보관합니다. FairGrow가 당국에 직접 자료를 보내는 일은 없습니다. 언제 내보내기를 제공할지, 어떤 파트너가 API로 등록부를 읽을 수 있는지는 직접 결정합니다.
방제 기록 한 건
동기화를 염두에 두고 만든 현대적인 REST API
- 안전한 로그인파트너별 API 키를 사용하거나, 농가가 앱에서 직접 연결할 때는 PKCE를 적용한 OAuth 2.0을 사용합니다. 키는 해시 형태로만 저장됩니다.
- 빠른 증분 동기화처음 한 번 전체를 읽은 뒤에는 마지막 동기화 이후 변경된 내용만 요청하면 됩니다. 목록은 커서 기반 페이지네이션을 사용합니다.
- 폴링 대신 웹훅작업이 생성되거나 완료되는 즉시, 수확이 등록되거나, 포장 메모가 게시되거나, 경보가 발생하거나, 동의가 철회되는 즉시 서명된 메시지를 받습니다.
- 재시도해도 안전모든 쓰기 요청에는 idempotency 키가 포함되어, 네트워크 오류 후 재시도해도 중복이 생기지 않습니다.
기술 요약
API 파트너가 되어보세요
FairGrow는 신청을 받아 파트너에게 API 접근 권한을 제공합니다. 어떤 분인지, 무엇을 만들고 싶은지, 어떤 데이터가 필요한지 알려 주십시오. 고유한 키, 웹훅, 농가에 보낼 연결 링크가 포함된 파트너 계정을 받으실 수 있습니다. 전체 기술 문서는 파트너 계정과 함께 제공됩니다.
알아두면 좋은 정보
제 허락 없이 파트너가 데이터를 볼 수 있나요?
접근 권한은 어떻게 해제하나요?
FairGrow가 회계 처리를 해주나요?
제 방제 기록이 당국에 전송되나요?
어떤 요금제에 API 연결이 포함되나요?
제 데이터는 어디에서 처리되나요?
개발자입니다. 문서는 어디에서 찾을 수 있나요?
기록은 한 곳에 모으고, 필요한 곳에만 공유하세요
이미 협력 중인 파트너와 FairGrow를 연결하고, 무엇을 보여줄지 직접 정하세요.