Criar um token
Um token pertence à organização, não a uma pessoa. Ele começa com oag_.
Quem pode criar
Seção intitulada “Quem pode criar”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.
Passo a passo
Seção intitulada “Passo a passo”- No AGROs, abra Organização › API.
- Clique em Novo token.
- 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.
- Nome: para quem ou para que é o token, por exemplo
- Clique em Criar e copie o token.
O que cada domínio libera
Seção intitulada “O que cada domínio libera”| 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 e revogar
Seção intitulada “Girar e revogar”- 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.