Ocorrências

O que é o módulo Ocorrências

O módulo Ocorrências é o sistema central de auditoria e logs do Bunto ERP. Ele registra automaticamente eventos relevantes que acontecem no sistema: vendas concluídas, erros de integração, alterações de configuração, operações de exclusão, importações, emissões fiscais e tudo o que precisa ser rastreado para efeito de auditoria.

Por design, as ocorrências são imutáveis — a API não permite criar nem excluir registros diretamente. Apenas o sistema grava, e o usuário consulta.

Como acessar

No menu lateral, acesse Sistema → Ocorrências. Rota: /ocorrencias.

Dashboard

A página principal traz um painel com KPIs e gráficos:

• Total de ocorrências no período selecionado.
• Erros críticos.
• Avisos.
• Taxa de sucesso das operações.
• Última atualização.

Os gráficos incluem evolução diária do volume, distribuição por tipo (info, aviso, erro, sucesso, ação, auditoria) e top módulos com mais atividade. O filtro de período oferece hoje, sete dias, trinta dias e noventa dias.

Listagem

A tabela de ocorrências traz tipo (com badge colorida), módulo, categoria, título, data e hora, prioridade. Os filtros em abas rápidas mostram Todas, Erros, Avisos, Auditoria, Ações e Sucesso.

Tipos

• Info — evento informativo.
• Aviso — algo que merece atenção, mas não bloqueou.
• Erro — operação falhou, precisa de intervenção.
• Sucesso — operação concluída.
• Ação — ação explícita de um usuário.
• Auditoria — registro para efeito de compliance.

Menu de contexto

Ao clicar numa ocorrência, um painel lateral mostra todos os detalhes:

• Módulo, categoria, tipo, prioridade, status.
• Executor — quem ou o que gerou.
• Timestamps de criação.
• Observação pessoal — o único campo editável, usado para anotações internas que não afetam o log.
• Dados estruturados — objeto relacionado (tipo e ID).

Fluxo automático

Todos os módulos do ERP chamam o serviço interno registrar ocorrência quando acontece algo relevante. Isso garante que o log reflete de fato o que aconteceu, sem depender da boa vontade do usuário ou de ações manuais.

Uma rotina Celery limpa ocorrências antigas (por padrão, com mais de 90 dias) para manter a tabela saudável. O tempo de retenção é configurável.

Integrações com outros módulos

Praticamente todos os módulos (Vendas, Compras, Fiscal, Estoque, Finanças, RH, CRM, Restaurante, PDV, Distribuição DF-e) publicam eventos no módulo Ocorrências. Isso cria uma linha do tempo consolidada das operações da empresa, útil para investigação, suporte e conformidade regulatória.

Permissões

• Listar ocorrências.
• Visualizar detalhes.
• Editar observação pessoal.
• Visualizar estatísticas (dashboard).

Perguntas frequentes

Por que a API não permite criar ocorrências?

Por design. As ocorrências são imutáveis para garantir a integridade do log de auditoria. Apenas o sistema grava, via serviço interno — evitando registros manipulados por usuários.

Posso filtrar por objeto específico?

Sim. Os parâmetros de filtro permitem ver todas as ocorrências vinculadas a uma venda específica, a um cliente específico ou a qualquer outro objeto rastreado.

Quanto tempo as ocorrências ficam guardadas?

Por padrão, 90 dias. O valor é configurável pelo administrador do sistema — aumente se a sua atividade exigir retenção mais longa para conformidade.

Como investigo uma venda que deu errado?

Filtre por módulo Vendas e pelo objeto específico (ID da venda). O histórico mostra passo a passo o que aconteceu, com usuário e horário.

As ocorrências aparecem em tempo real?

Sim. Eventos críticos disparam notificações, e o dashboard é atualizado automaticamente.