Aegro API de Integrações

Última atualização: 17 de Janeiro de 2026

Com a API de Integrações da Aegro, você conecta o Aegro a outros sistemas e ferramentas — um painel de BI, um ERP, uma planilha automatizada ou um assistente de IA. A API permite que desenvolvedores e parceiros leiam e escrevam informações da fazenda de forma programática, criando soluções sob medida para a sua operação.

Neste artigo você vê o que dá para integrar, como gerar a chave de API da sua propriedade e como propor novas integrações.

Visão geral

A API é uma interface de programação: por meio dela, os sistemas conversam entre si, sem digitação manual. O acesso é controlado por uma chave de API, que você mesmo gera dentro do Aegro.

Três pontos definem como ela funciona:

  • Cada chave dá acesso a uma única propriedade. Para integrar mais de uma fazenda, gere uma chave para cada uma;
  • você escolhe as autorizações. Dá para liberar apenas leitura, sem permitir que o outro sistema crie ou altere nada;
  • você define por quanto tempo ela vale e pode revogá-la quando quiser.

A documentação técnica, com todas as operações disponíveis, fica na Plataforma de Integrações Aegro. É o material que a equipe de desenvolvimento do sistema parceiro vai consultar.

O que dá para integrar

Os dados da fazenda ficam disponíveis por área. Entre eles:

  • Financeiro: contas a pagar e a receber, parcelas, contas bancárias, movimentações e transferências bancárias, e categorias financeiras;
  • Custos e rateio: resumo de custos e rateios de safra;
  • Estoque: itens, locais de estoque e movimentações;
  • Compras: ordens de compra, requisições de compra e cadastro de empresas;
  • Comercial: contratos de venda, colheitas e descontos de colheita;
  • Produção: safras, talhões, atividades e registros climáticos;
  • Patrimônio: máquinas, equipamentos e eventos de patrimônio, como abastecimentos e manutenções;
  • Fiscal: notas fiscais, manifestos eletrônicos (MDF-e) e produtos fiscais;
  • Pecuária: lotes, pesagens, movimentações e baixas.

A lista completa e atualizada, com os campos de cada operação, está no Swagger da API.

Como gerar a chave de API

A chave é gerada por quem tem perfil de Proprietário ou Gerente na propriedade.

  1. No Aegro, clique na inicial do seu nome, no canto superior direito, e acesse Propriedades;
  2. localize a propriedade que deseja integrar, abra o menu de opções e clique em API de integração;
  3. clique em Nova chave de API.

O formulário pede três informações:

  • Nome — identifique o sistema parceiro, como “BI financeiro” ou o nome da empresa. Isso facilita revogar a chave certa depois;
  • Autorizações — marque apenas o que a integração precisa. As permissões são separadas entre leitura e criação/edição para cada tipo de dado, então é possível conceder um acesso somente de consulta. Para relatórios e BI, é o recomendado;
  • Válido por — 1 dia, 7 dias, 30 dias, 3 meses, 6 meses ou 1 ano.

Gerenciando as chaves

Na tela API de Integração você acompanha todas as chaves da propriedade, com o status de cada uma — Ativo, Expirado ou Revogado — e a data de expiração. No menu de cada chave estão as ações:

  • Ver detalhes — consulta as autorizações concedidas e a validade;
  • Criar cópia — gera uma nova chave a partir das configurações de uma existente, útil para ajustar permissões sem refazer tudo;
  • Revogar acesso — encerra o acesso na hora. A ação não pode ser desfeita.

Cuidados com a chave

A chave de API funciona como uma senha: quem a tem acessa os dados da propriedade dentro das autorizações concedidas.

  • Não use a mesma chave em várias integrações. Uma chave por parceiro permite revogar o acesso de um sem derrubar os outros;
  • conceda o mínimo necessário. Se o parceiro só precisa consultar, não libere criação e edição;
  • não envie a chave por e-mail, WhatsApp ou chat, nem para a equipe da Aegro. Se precisar repassá-la ao parceiro, combine um canal seguro com ele;
  • revogue o que não está em uso. Ao encerrar um contrato com um parceiro, revogue a chave correspondente.

Seus dados são disponibilizados apenas conforme cada chave configurada, para o parceiro com quem você está integrando. Eles não ficam públicos.

Como usar a chave

A chave é enviada no cabeçalho Aegro-Public-API-Key de cada chamada. Este é um exemplo de consulta:

curl -X GET 'https://app.aegro.com.br/pub/v1/farms' \
  -H 'Aegro-Public-API-Key: SUA_CHAVE'

A equipe técnica do sistema parceiro encontra os detalhes de cada operação — parâmetros, filtros e paginação — na documentação técnica.

Como propor novas integrações

A API está em evolução contínua. Se você é produtor e quer integrar o Aegro a outra ferramenta, encaminhe a documentação técnica ao desenvolvedor da ferramenta: ele consegue verificar quais dados estão disponíveis e como funciona o processo.

Se você é desenvolvedor ou parceiro, tem uma dúvida que não está na documentação ou quer propor melhorias na API, fale com o nosso time pelo suporte dentro do Aegro — no ícone de ajuda, no canto superior direito. Ajuda bastante já trazer:

  • o sistema que será integrado;
  • quem está propondo — empresa ou pessoa responsável;
  • o que a integração faz e qual benefício traz ao produtor;
  • quais dados você precisa ler ou escrever na plataforma.

Quanto mais claro o contexto, mais fácil para o time avaliar e priorizar.

Dúvidas frequentes

Preciso pedir a chave por e-mail? Não. A chave é gerada por você mesmo, dentro do Aegro, pelo caminho descrito acima.

A API avisa quando um dado muda? Não há notificações automáticas (webhooks). A prática recomendada é consultar a API periodicamente — uma carga diária costuma atender relatórios e BI.

Existe ambiente de testes? Não há ambiente separado. A validação é feita na própria conta, com uma chave de autorizações somente de leitura.

Há limite de chamadas? Não há um limite publicado. Use a API de forma responsável, preferindo as consultas com filtro a varreduras repetidas. Se a sua integração tiver volume alto ou contínuo, fale com o suporte para alinharmos.

Pronto! Agora você já sabe como integrar o Aegro a outras plataformas.

Este artigo foi útil?

Não encontrou o que procurava?