API atual/Referência completa/Fiscal (NF-e e NFC-e)

Autonomia do assistente fiscal

Define se o assistente fiscal apenas observa, propõe correções ou age sozinho em casos seguros.

O nível de autonomia controla o quanto o assistente fiscal faz quando uma nota é rejeitada. Exigem o módulo focusnfe e o privilégio manage_nfe, manage_taxes ou manage_settings.

`autonomy`	Comportamento
`observe`	O assistente não registra nenhuma ação a partir de rejeições. Só você olha a fila.
`suggest`	Cada rejeição gera uma ação proposta que espera a sua aprovação. É o padrão.
`auto_safe`	Reservado para aplicar sozinho correções seguras. Hoje se comporta como `suggest`: toda ação ainda espera aprovação.

Ler a autonomia

GET/api/v1/admin/fiscal/agent/settingsAdmin

Lê o nível de autonomia do assistente fiscal

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/fiscal/agent/settings" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Autonomia devolvida

json

{ "autonomy": "suggest" }

Campos da resposta

autonomystring

observesuggestauto_safe

Nível atual. Uma loja que nunca configurou recebe suggest.

Erros

Status	Quando	Corpo
401	Sem token	`{"error":"missing authorization header"}`
403	Sem privilégio ou módulo desligado	`{"error":"insufficient privileges","privilege_required_any":["manage_nfe","manage_taxes","manage_settings"]}`

Gravar a autonomia

PUT/api/v1/admin/fiscal/agent/settingsAdmin

Grava o nível de autonomia do assistente fiscal

Corpo da requisição

autonomystringobrigatório

observesuggestauto_safe

Novo nível.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/fiscal/agent/settings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "autonomy": "suggest" }'

Resposta

200Autonomia gravada

json

{ "autonomy": "suggest" }

Erros

Status	Quando	Corpo
400	JSON inválido	`{"error":"invalid body","detail":"..."}`
500	Falha ao gravar	`{"error":"failed to save","detail":"..."}`

Veja também

Autonomia do assistente fiscal

Define se o assistente fiscal apenas observa, propõe correções ou age sozinho em casos seguros.

O nível de autonomia controla o quanto o assistente fiscal faz quando uma nota é rejeitada. Exigem o módulo focusnfe e o privilégio manage_nfe, manage_taxes ou manage_settings.

`autonomy`	Comportamento
`observe`	O assistente não registra nenhuma ação a partir de rejeições. Só você olha a fila.
`suggest`	Cada rejeição gera uma ação proposta que espera a sua aprovação. É o padrão.
`auto_safe`	Reservado para aplicar sozinho correções seguras. Hoje se comporta como `suggest`: toda ação ainda espera aprovação.

Ler a autonomia

GET/api/v1/admin/fiscal/agent/settingsAdmin

Lê o nível de autonomia do assistente fiscal

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/fiscal/agent/settings" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Autonomia devolvida

json

{ "autonomy": "suggest" }

Campos da resposta

autonomystring

observesuggestauto_safe

Nível atual. Uma loja que nunca configurou recebe suggest.

Erros

Status	Quando	Corpo
401	Sem token	`{"error":"missing authorization header"}`
403	Sem privilégio ou módulo desligado	`{"error":"insufficient privileges","privilege_required_any":["manage_nfe","manage_taxes","manage_settings"]}`

Gravar a autonomia

PUT/api/v1/admin/fiscal/agent/settingsAdmin

Grava o nível de autonomia do assistente fiscal

Corpo da requisição

autonomystringobrigatório

observesuggestauto_safe

Novo nível.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/fiscal/agent/settings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "autonomy": "suggest" }'

Resposta

200Autonomia gravada

json

{ "autonomy": "suggest" }

Erros

Status	Quando	Corpo
400	JSON inválido	`{"error":"invalid body","detail":"..."}`
500	Falha ao gravar	`{"error":"failed to save","detail":"..."}`