Auditoria

A trilha de auditoria da conta, com os eventos registrados em páginas de 50 (quem fez, o quê e em qual registro).

Para: Escritório, Integrador (API) · Atualizado em 13/10/2026

Para que serve

A tela Auditoria mostra a trilha de auditoria da sua conta: o registro das ações importantes feitas no sistema, como cadastrar ou alterar um cliente, enviar ou revogar um certificado, cancelar uma nota, convidar uma pessoa, mudar a configuração do fechamento ou criar uma cobrança.

Cada evento fica gravado com data e hora, quem fez e sobre qual registro. Os eventos são encadeados entre si, o que permite detectar se algum foi apagado ou alterado. Dados sensíveis (senhas, chaves, segredos) nunca entram na trilha.

Passo a passo

No menu, abra Configurações → Auditoria.
A tabela mostra os eventos do mais novo para o mais antigo, em páginas de 50. Use Carregar mais para consultar os anteriores.
Leia cada linha: Quando, Ator, Ação e Recurso.

A tela não tem filtros nem paginação. Para buscar eventos mais antigos ou filtrar por registro, use a API com um token de API que tenha o escopo audit:read (veja a documentação da API).

Colunas

Coluna	O que significa
Quando	Data e hora do evento, no horário do seu navegador.
Ator	Quem fez a ação: `user` (uma pessoa), `token` (uma integração por token de API), `system` (o próprio sistema, em rotinas automáticas) ou `platform` (a equipe da plataforma). Ao lado, os primeiros 8 caracteres do identificador do ator.
Ação	Código da ação, no formato `assunto.acao`. Exemplos abaixo.
Recurso	Tipo do registro afetado (por exemplo, `empresa`, `nfse`, `certificado`) e os primeiros 8 caracteres do identificador dele.

Exemplos de ações

Código	O que aconteceu
`empresa.created` / `empresa.updated`	Cliente cadastrado ou alterado.
`certificado.uploaded` / `certificado.revoked`	Certificado digital enviado ou revogado.
`nfse.cancel_requested`	Pedido de cancelamento de uma nota.
`nfse.email.sent`	Nota enviada por e-mail.
`convite.emitido` / `convite.aceito`	Convite enviado ou aceito.
`vinculo.criado` / `vinculo.revogado`	Acesso de uma pessoa à conta criado ou retirado.
`mfa.activated` / `mfa.disabled`	Verificação em duas etapas ligada ou desligada.
`fechamento_cliente.config_alterada`	Configuração do envio do fechamento ao cliente alterada.
`cobranca.criada` / `cobranca.cancelada`	Cobrança criada ou cancelada em Contas a receber.
`webhook.created`	Webhook cadastrado.
`plano.excedente_ativado` / `plano.excedente_desativado`	Excedente do plano ligado ou desligado em Plano e uso.

Quem vê esta tela

Quem tem permissão de ler a auditoria: os papéis Dono, Administrador e Auditor (somente leitura). Uma integração também pode ler a trilha por token com o escopo audit:read (por exemplo, para guardar num sistema de segurança).

Se o seu acesso é restrito a alguns clientes, você vê só os eventos desses clientes. Eventos gerais da conta (como convites para a equipe) ficam de fora.

Erros comuns e como resolver

A tabela está vazia. Pode não haver eventos ainda, ou a lista não carregou. Recarregue a página. Se você tem acesso restrito a clientes, só aparecem eventos desses clientes.
Não encontro um evento antigo. Use Carregar mais para continuar até o evento desejado. A API também permite filtrar por recurso e registro, com limit de 1 a 200 e paginação por cursor.
O ator aparece só como um código. A tela mostra o identificador abreviado. Para saber quem é, compare com Pessoas e acessos ou Tokens de API.

Veja também

Termos usados

Trilha de auditoria: Registro das ações importantes feitas na conta: quem fez, o quê, quando e em qual registro.
Conta: O espaço de um escritório ou empresa no sistema, com seus clientes, pessoas, plano e notas.
Token de API: Chave secreta que permite a outro sistema emitir e consultar notas pela API, sem login de pessoa.
Escopo: Permissão específica de um token ou papel (ex.: nfse:write para emitir notas).
Cliente (do escritório): Empresa ou profissional que emite notas pelo sistema — o prestador do serviço.

Mais em Conta, pessoas e segurança

Entrar e recuperar a senhaComo entrar com e-mail e senha ou com o Google, informar o código do MFA e redefinir a senha esquecida.
Criar contaComo criar uma conta grátis (com e-mail ou Google), confirmar o e-mail e criar outra conta com o mesmo login.
Contas e vínculos (trocar de conta)Como um mesmo login acessa várias contas, como trocar de conta e abrir outra conta em nova aba.
Aceitar um conviteComo aceitar o convite para entrar numa conta como equipe, cliente do portal ou contador — com senha nova, com o seu login atual ou com o Google.
Pessoas e acessosConvide equipe, clientes do portal e contadores, defina papéis e clientes liberados, e suspenda, reative ou remova acessos.
Segurança da conta (exigir MFA)Exija a verificação em dois fatores de todas as pessoas com acesso à conta e veja quantas ainda não ativaram.
ContadoresDê ao contador externo acesso somente leitura aos clientes escolhidos e envie o fechamento do mês por e-mail, automático ou na hora.
Segurança: senha, MFA e GoogleAltere a senha, ative ou desative a verificação em dois fatores (MFA) com um aplicativo autenticador e vincule ou desvincule o login com Google.
NotificaçõesEscolha quais e-mails do sistema você quer receber; a escolha é só sua e vale em todas as suas contas.
O filtro de cliente (topo da tela)Como funciona o filtro "Cliente:" do topo, em quais telas ele aparece, o atalho Ctrl+K e a diferença entre trocar de cliente e trocar de conta.
Plano e usoSeu plano atual (mensal ou pré-pago por créditos), o teste grátis, a franquia de notas, a opção de excedente (ativar ou não), os CNPJs contratados, a previsão do mês e como contratar ou trocar de plano.