Dashboard de Documentos Eletrônicos
Dashboard de Documentos Eletrônicos
Painel de indicadores e monitoramento que reúne, em um único lugar, a emissão de documentos fiscais eletrônicos da filial: NF-e, NFC-e, CT-e, MDF-e e NFS-e.
O que é esta rotina
Painel de indicadores e monitoramento que reúne, em um único lugar, a emissão de documentos fiscais eletrônicos da filial: NF-e, NFC-e, CT-e, MDF-e e NFS-e. Nele o usuário acompanha quantos documentos foram emitidos, quantos foram autorizados ou rejeitados pela SEFAZ, quais os motivos de rejeição mais comuns e se há alguma divergência entre o Pedido de Venda e a Nota Fiscal emitida a partir dele.
Ganho: antes o usuário precisava abrir telas separadas (Transmissão de NF-e, Transmissão de NFS-e, etc.) para montar esse panorama manualmente. Agora tudo aparece consolidado, com filtros comuns de filial e período, e o usuário pode agir diretamente sobre um documento com problema — reenviar à SEFAZ, baixar o XML/DANFE, avisar o cliente por e-mail — sem sair do painel.
A rotina pertence ao módulo Faturamento e fica disponível pelo menu “Dashboard de Documentos Eletrônicos” (área de Documentos Eletrônicos / DFe).
O que verificar antes de usar
- Seu usuário precisa ter acesso a esta tela liberado pelo administrador do sistema.
- É necessário informar a Filial e o Período antes de qualquer informação aparecer na tela.
- O período consultado não pode ultrapassar 7 dias — se for informado um intervalo maior, o sistema impede a consulta.
Como usar — passo a passo
Passo 1: Acesse a rotina No módulo Faturamento, acesse “Dashboard de Documentos Eletrônicos”.
Passo 2: Informe os filtros obrigatórios Selecione a Filial e o Período (Data Inicial e Data Final, no máximo 7 dias de intervalo). Se quiser, restrinja também por Tipo de Documento (NF-e, NFS-e, CT-e, NFC-e ou MDF-e) ou por Status.
Passo 3: Clique em Filtrar O sistema carrega os indicadores e as listas das quatro abas do painel: “Visão Geral”, “Monitor de Transmissão”, “Rejeições / Erros” e “Comparativo Pedido × Nota”.
Passo 4: Navegue pelas abas Cada aba mostra uma visão diferente do mesmo período filtrado — detalhadas a seguir.
Passo 5 (quando necessário): Aja sobre um documento com problema Nas abas “Monitor de Transmissão” e “Rejeições / Erros”, use os botões da linha do documento — ou marque várias linhas e use os botões em lote — para reenviar o documento à SEFAZ, baixar o XML/DANFE ou enviar por e-mail ao cliente.
Campos e botões da tela
Filtros (aparecem no topo, valem para as quatro abas)
| Campo/Botão | Para que serve |
|---|---|
| Filial * | Filial cujos documentos serão consultados. Obrigatório. |
| Período Inicial / Período Final * | Intervalo de datas de emissão a consultar. Obrigatório, máximo de 7 dias. |
| Tipo de Documento | Restringe a consulta a um tipo específico (NF-e, NFS-e, CT-e, NFC-e ou MDF-e). Deixe em “Todos” para ver tudo. |
| Status | Restringe a consulta a uma situação específica (Autorizado, Rejeitado, Em Processamento, Cancelado, Contingência ou Denegado). |
| Filtrar | Atualiza as quatro abas com os filtros informados. |
Aba “Visão Geral”
| Item | Para que serve |
|---|---|
| Total Emitidos / Autorizados / Rejeitados / Em Processamento / Valor Total | Cartões com a contagem e o valor total de documentos do período filtrado. |
| Distribuição por Tipo de Documento | Gráfico de pizza com a quantidade de documentos por tipo (NF-e, NFS-e etc.). |
| Emissões por Dia — Últimos 7 Dias | Gráfico de barras mostrando, dia a dia, quantos documentos foram autorizados, rejeitados ou ainda estão em processamento. |
| Taxa de Autorização por Tipo | Percentual de documentos autorizados dentro de cada tipo de documento — abaixo de 90% aparece destacado em vermelho, entre 90% e 95% em amarelo. |
| Status do Webservice SEFAZ | Indica se o serviço da SEFAZ está Online, com Lentidão ou Indisponível no momento (hoje disponível só para NF-e). |
| Top Motivos de Rejeição | As 5 causas de rejeição mais frequentes no período. |
Aba “Monitor de Transmissão”
| Item | Para que serve |
|---|---|
| Total no Período / Autorizados SEFAZ / Em Processamento / Cancelados | Cartões de totalização do período filtrado. |
| Botões Todos / Autorizado / Rejeitado / Processando / Cancelado / Contingência | Filtro rápido por status, sem precisar voltar ao topo da tela. |
| Grade de documentos (Tipo, Número/Série, Chave de Acesso, Emitente/Destinatário, Emissão, Valor, Status Processo, Status SEFAZ) | Lista todos os documentos do período com sua situação atual. |
| Botão XML (na linha do documento) | Baixa o arquivo XML do documento (disponível para documentos Autorizados ou Cancelados). |
| Botão DANFE (na linha do documento) | Baixa o PDF do documento (disponível para documentos Autorizados). |
| Botão Enviar E-mail (na linha do documento) | Envia o documento por e-mail ao cliente (disponível para documentos Autorizados). |
| Botão Reenviar para SEFAZ (na linha do documento) | Tenta transmitir novamente o documento à SEFAZ (disponível para documentos Rejeitados ou ainda em Processamento). |
| Reenviar Selecionados / Enviar E-mail para Cliente | Repetem as ações acima para todas as linhas marcadas de uma vez. Ficam habilitados só quando há pelo menos uma linha selecionada. |
| Exportar | Baixa em CSV os documentos que atendem ao filtro atual (limite de 10.000 linhas por exportação). |
Aba “Rejeições / Erros”
| Item | Para que serve |
|---|---|
| Documentos Rejeitados / Em Processamento / Denegados / Valor em Risco | Cartões de totalização — “Valor em Risco” soma o valor dos documentos Rejeitados e Denegados. |
| Rejeições por Código | Lista os códigos de rejeição da SEFAZ ocorridos no período, com a descrição do motivo, a quantidade de documentos e o valor total afetado. |
| Botão “Ver Docs” (na linha da rejeição) | Leva para a aba “Monitor de Transmissão” já filtrada pelo código de rejeição clicado. |
| Documentos Pendentes de Resolução | Lista consolidada dos documentos Rejeitados ou ainda em Processamento, com botões para reenviar ou notificar o cliente por e-mail (individualmente ou em lote, selecionando várias linhas). |
Aba “Comparativo Pedido × Nota”
| Item | Para que serve |
|---|---|
| Divergência de Valor / Divergência de Itens / CFOP Divergente / Nota Sem Pedido | Cartões com a contagem de cada tipo de divergência encontrada no período. |
| Pedidos Sem Nota | Ainda não disponível nesta versão do painel (aparece sempre como “—”). |
| Botões Todos / Valor / Itens / CFOP / Sem Pedido | Filtro rápido por tipo de divergência. |
| Grade comparativa (Pedido, Nota Fiscal, Cliente, Data Pedido, Valor Pedido, Valor NF, Diferença, Tipo Divergência) | Lista as Notas Fiscais em que o sistema encontrou alguma divergência em relação ao Pedido de origem. |
| Exportar Relatório | Baixa em CSV a lista filtrada. |
Avisos que podem aparecer
- “Preencha os filtros obrigatórios (Filial e Período).” — o usuário clicou em Filtrar sem informar Filial, Data Inicial ou Data Final.
- “O período final não pode ser anterior ao período inicial.” — a Data Final informada é anterior à Data Inicial.
- “O período máximo permitido é de 7 dias. Ajuste as datas e tente novamente.” — o intervalo entre Data Inicial e Data Final ultrapassa 7 dias.
- “Selecione ao menos um documento.” — o usuário tentou reenviar ou enviar e-mail em lote sem marcar nenhuma linha na grade.
- “Não foi possível gerar o arquivo.” — falha ao baixar o XML ou o DANFE de um documento.
- “Não há registros para exportar com os filtros atuais.” — o botão Exportar foi acionado, mas o filtro atual não retornou nenhum documento.
- “Exportação limitada a 10.000 de um total de N.” — o filtro atual retornou mais documentos do que o limite de exportação; o arquivo é gerado apenas com os primeiros 10.000.
Coisas importantes de saber
- O painel considera apenas documentos fiscais eletrônicos emitidos pela própria empresa (NF-e, CT-e, MDF-e, NFC-e e NFS-e) — não entram documentos de terceiros recebidos, nem modelos fiscais fora do escopo eletrônico (nota física, nota de produtor, NF3-e, CT-e OS e SAT-CFe).
- A situação de cada documento (Autorizado, Rejeitado, Em Processamento, Denegado, Cancelado ou Contingência) é calculada automaticamente a partir do último retorno da SEFAZ — um documento que ainda não teve retorno aparece como “Em Processamento”.
- Na aba “Comparativo Pedido × Nota”, o sistema aponta apenas 1 tipo de divergência por Nota, verificando nesta ordem: primeiro se os itens do Romaneio batem exatamente com os da Nota (mesmo produto, mesma quantidade); se baterem, se o valor unitário de algum item mudou entre o Pedido e a Nota; se não houver diferença de valor, se o CFOP da Nota é compatível com o estado da filial e do cliente; e, se a Nota não tiver nenhum Pedido na origem, ela é sinalizada como “Nota Sem Pedido”. Não há tolerância: qualquer diferença, por menor que seja, já é sinalizada.
- Hoje o indicador “Status do Webservice SEFAZ” só está disponível para NF-e — os demais tipos de documento ainda não têm essa verificação.
- Os botões Reenviar, Enviar E-mail, XML e DANFE reaproveitam a mesma rotina já usada na tela de Transmissão de NF-e — ou seja, agem sobre o documento real, não é uma simulação.
Atenção — recurso em fase de testes
Esta rotina foi implementada recentemente e ainda está em fase de testes (chamado Redmine #77761, status “Aguardando Teste”, 80% concluído em 10/09/2026). Antes de considerá-la liberada para uso geral, vale confirmar com a equipe de desenvolvimento:
- O controle de permissões de acesso a esta tela e a cada uma das quatro abas ainda está sendo configurado — na versão atual, todas as abas ficam visíveis para qualquer usuário autenticado, sem distinção por perfil de acesso.
- O indicador “Pedidos Sem Nota” (aba Comparativo Pedido × Nota) ainda não foi implementado e sempre aparece como “—”.