Os dados da sua quinta, geridos nos seus termos
A API da FairGrow liga os seus registos de cultura à sua cooperativa, ao seu consultor, ao seu software de contabilidade e às suas ferramentas de planeamento, mas apenas para os dados que aprovar. A decisão é sua, por parceiro e por tipo de dado, e o acesso pode ser desligado a qualquer momento com um clique.
Os seus registos de cultura no centro, os seus dados só onde disse sim
Os seus registos de cultura são o ponto onde tudo se reúne. Uma ferramenta de planeamento pode colocar tarefas planeadas diretamente neles, e quando regista um tratamento escolhe o produto a partir do registo oficial do seu país, pelo que o número de autorização é preenchido automaticamente e são propostos a dose e o intervalo de segurança. As faturas de compra lidas pelo reconhecimento de faturas da EasyData chegam como existências, com o respetivo preço de compra.
A partir daí, os dados só seguem para onde deu consentimento. O seu software de contabilidade lê horas, existências e vendas. A sua cooperativa vê colheitas e códigos de lote. O seu consultor acompanha e regista uma nota de campo. Um parceiro sem consentimento não recebe nada.
Exemplo aqui mostrado: o registo de produtos, as faturas de compra e uma ferramenta de planeamento alimentam os seus registos de cultura; a cooperativa, o consultor e o software de contabilidade têm consentimento, o comprador não. A FairGrow não faz a sua contabilidade; liga-se ao programa que já utiliza.
consentimento · jobs:write · timesheets:read · inventory:read · harvests:read
Da ligação ao fluxo de dados em três passos
Nunca precisa de dar a sua palavra-passe a um parceiro. A permissão é dada na própria FairGrow, e pode ver a qualquer momento quem tem acesso a quê.
O parceiro envia uma ligação
A sua cooperativa, consultor ou fornecedor de software envia-lhe uma ligação. Esta abre a FairGrow e mostra quem está a pedir e que dados quer utilizar.
Escolha o que partilhar
Assinale exatamente as permissões com que se sente confortável, por exemplo os seus campos e tarefas, mas não as suas vendas ou registos de horas. O consentimento aplica-se por quinta e por tipo de dado.
Os dados fluem, o controlo é seu
O software do parceiro recolhe apenas o que autorizou. Em Ligações (API), nos seus registos de cultura, pode alterar permissões, consultar o histórico ou revogar o acesso.
Menos digitação, menos folhas de cálculo
Muitos agricultores mantêm os mesmos registos em vários sítios: para o comprador, a cooperativa, o certificador e o consultor. Com uma ligação, os dados que já mantém na FairGrow chegam sozinhos ao sítio certo.
Cooperativas e compradores
Colheitas com códigos de lote, plantações e o registo de tratamentos, prontos para controlos de qualidade e rastreabilidade sem trocar ficheiros constantemente.
Consultores agrícolas
O seu consultor vê campos, leituras de sensores e sinais de risco, e pode deixar uma nota de campo nos seus registos depois de uma visita.
Software de contabilidade e ERP
A FairGrow não faz a sua contabilidade; o seu software de contabilidade faz isso. Com o seu consentimento, lê registos de horas com as tarifas horárias por membro ou equipa, existências, vendas, faturas de compra e o preço de custo por cultura, para que as horas e os custos cheguem à contabilidade sem serem reintroduzidos.
Ferramentas de planeamento
Planeie o trabalho num módulo de planeamento externo e este chega aos seus registos de cultura como tarefa planeada. Depois de concluído o trabalho, conclui-o na FairGrow e este passa a contar para o seu registo.
Dezassete permissões, cada uma com o seu interruptor
Um parceiro nunca recebe «tudo». Cada tipo de dado é uma permissão distinta, e um parceiro só pode pedir as permissões que a FairGrow lhe aprovou.
Leitura
As permissões de leitura permitem que um parceiro veja dados. Não pode alterar nada com elas.
Escrita e extras
Um parceiro só pode alterar as tarefas que ele próprio criou. Os endereços de e-mail da sua equipa são uma permissão distinta; sem ela, um parceiro vê apenas nomes e funções. Um tratamento concluído e registado por um parceiro entra diretamente no seu registo, que assim se mantém completo.
Do registo oficial a um relatório conforme o 2023/564
- Escolha o produto a partir do registo oficialA FairGrow mantém atualizados os registos de autorização da Alemanha (BVL), dos Países Baixos (Ctgb), da Bélgica, da França, da Suíça e da Finlândia. Pesquise por nome, número de autorização ou substância ativa e vê de imediato se um produto está autorizado, tem uma isenção temporária ou já caducou. A FairGrow propõe depois a dose e o intervalo de segurança para a sua cultura, mas a confirmação final é sua.
- Um aviso antes de colher demasiado cedoAo registar uma colheita num campo onde ainda está em curso um intervalo de segurança, a FairGrow emite um aviso, na aplicação e através da API.
- Completo, ou fica em rascunhoUm registo de tratamento só conta depois de preenchidos todos os campos exigidos pelo Regulamento de Execução (UE) 2023/564. Até lá, fica em rascunho, para que nada incompleto entre no seu registo.
- Legível por máquina, pronto para 2027A partir de 2027 os registos têm de ser mantidos em formato eletrónico e legível por máquina. A FairGrow exporta o registo como CSV, XLSX ou JSON, com as colunas pela ordem definida no regulamento.
- O registo fica consigoNão existe uma base de dados central: é o próprio que mantém os registos. A FairGrow não envia nada às autoridades por iniciativa própria. Decide quando entrega uma exportação, e que parceiro pode ler o registo através da API.
Um registo de tratamento
Uma API REST moderna, construída para sincronização
- Início de sessão seguroUma API key por parceiro, ou OAuth 2.0 com PKCE quando o agricultor se liga a partir da sua aplicação. As chaves são guardadas apenas como hash.
- Sincronização incremental rápidaLeia tudo uma vez e depois peça apenas o que mudou desde a última sincronização. As listas usam paginação por cursor.
- Webhooks em vez de pollingReceba uma mensagem assinada assim que uma tarefa é criada ou concluída, uma colheita é registada, uma nota de campo é publicada, um alerta é gerado ou um consentimento é revogado.
- Seguro para repetirToda a escrita tem uma idempotency key, para que uma nova tentativa depois de um erro de rede nunca crie um duplicado.
Resumo técnico
Torne-se parceiro API
A FairGrow dá acesso à API a parceiros mediante pedido. Diga-nos quem é, o que quer construir e que dados precisa. Recebe uma conta de parceiro com as suas próprias chaves, webhooks e uma ligação para enviar aos agricultores. A documentação técnica completa é disponibilizada com a sua conta de parceiro.
Bom saber
Um parceiro pode ver os meus dados sem a minha permissão?
Como revogo o acesso?
A FairGrow faz a minha contabilidade?
O meu registo de tratamentos é enviado às autoridades?
Que subscrição inclui ligações API?
Onde são tratados os meus dados?
Sou programador. Onde encontro a documentação?
Mantenha os seus registos num só lugar, partilhe-os onde são precisos
Ligue a FairGrow aos parceiros com quem já trabalha, e decida o que podem ver.