Pular para o conteúdo

Criar um token

Um token pertence à organização, não a uma pessoa. Ele começa com oag_.

Quem tem a permissão Tokens de API (grupo API e integrações) na organização, e só se a organização tiver o módulo OpenAGROs contratado. Sem a permissão, a aba não aparece.

  1. No AGROs, abra Organização › API.
  2. Clique em Novo token.
  3. Preencha:
    • Nome: para quem ou para que é o token, por exemplo Power BI diretoria.
    • Dados: os domínios que o token pode ler. Marque só os necessários.
    • Endereços IP (opcional): os IPs que podem usar o token, até 20. Vazio aceita qualquer endereço.
    • Validade (opcional): depois dessa data, o token deixa de valer.
  4. Clique em Criar e copie o token.
Dados Escopo Tabelas
Agricultura agriculture.read Agricultura e pessoas (sem documentos nem salário)
Pecuária livestock.read Rebanho, manejo, pesagens e fábrica de ração
Financeiro finance.read Títulos, rateios gerenciais e movimentos bancários
Financeiro: resultados (DRE) finance.results DRE e fluxo de caixa por mês (resultados_*); só quem é analista do Financeiro emite

Valores em reais só aparecem nas tabelas do financeiro. O Power BI só lista as tabelas que o token pode ler.

  • Girar gera um token novo no lugar do antigo. O antigo para de valer na hora, então troque a credencial no Power BI logo em seguida.
  • Revogar encerra o token de vez.

A organização pode ter até 50 tokens ativos. Prefira um token por uso (um por relatório ou por integração): assim dá para revogar um sem derrubar os outros.