Dashboard
Visão geral dos documentos fiscais
Período:
→
Compras (NF-e)
—
— notas recebidas
Vendas (NF-e)
—
— notas emitidas
Margem Bruta
—
vendas − compras
Frete Real (FOB)
—
Você é o tomador (FOB)
🔄 Transferências (entrada)
—
— notas · matriz↔filial
🔄 Transferências (saída)
—
— notas · sai do estoque
↩ Devoluções emitidas
—
— notas · você devolveu
↩ Devoluções recebidas
—
— notas · cliente devolveu
❌ NF-e canceladas (30 dias)
—
— total · R$ —
Última sincronização:
—
NSU: —
🌙
Modo Noturno — sincronização automática
Pronto. Limite: 19/hora por webservice (vs. 10 normal). Roda em loop até zerar a fila SEFAZ.
Limite SEFAZ — máx 10 consultas/hora por webservice
NF-e
—/15
CT-e
—/15
Últimas Notas
| Tipo | Número | Emitente | Data | Valor | Ações |
|---|
NF-e — Notas Fiscais Eletrônicas
| Dir | Número | Série | Emitente | CNPJ | Data | Valor | Ações |
|---|
CT-e — Conhecimentos de Transporte
| Número | Transportadora | CNPJ | Tomador | Destinatário | Nº NF-e Ref. | Data | Valor Frete | Ações |
|---|
Configuração
🏢 Empresas / Certificados
| CNPJ | Razão Social | UF | Ambiente | Certificado | Ativo | Ações |
|---|---|---|---|---|---|---|
| Carregando… | ||||||
🔐 Certificado Digital A1 (legado — use o card Empresas acima)
Caminho completo para o arquivo .pfx
🏢 Dados da Empresa
🔄 Regenerar PDFs Existentes
Atualiza todos os PDFs já baixados para o novo formato DANFE/DACTE + Consulta SEFAZ. Os XMLs permanecem intactos. Processo pode demorar alguns minutos dependendo do volume.
⚠️ Ações Avançadas
Zerar o NSU fará a próxima sincronização baixar todas as notas novamente desde o início.
🔑 Gestão de Acesso
IPs Permitidos
Carregando...
Meu IP:
—
Usuários
Carregando...
+ Criar usuário
⏱️ Agendador de Sincronização
Próxima varredura: —
· Última: —
Carregando...
🔄 Transferências entre Estabelecimentos
NF-e identificadas pelos CFOPs xxx151–156, xxx408–410 — circulação de mercadoria entre filiais (não conta como compra/venda)
Período:
→
📥 Entrada (você é destino)
—
— notas
📤 Saída (você é emitente)
—
— notas
Saldo (entrada − saída)
—
positivo = mais entrou em estoque
📥 Top Origens da Entrada
| Origem (filial) | CNPJ | Notas | Valor |
|---|
📤 Top Destinos da Saída
| Destino (filial) | CNPJ | Notas | Valor |
|---|
📥 Últimas Entradas 0
| Data | Nº | Origem | Valor |
|---|
📤 Últimas Saídas 0
| Data | Nº | Destino | Valor |
|---|
Como o sistema identifica? Pelos CFOPs dos itens da NF-e:
Entrada: 1151–1156, 2151–2156, 1408–1410, 2408–2410
Saída: 5151–5156, 6151–6156, 5408–5410, 6408–6410
São transferências de mercadoria entre estabelecimentos do mesmo titular (matriz↔filial). Não entram em compras/vendas pra evitar duplo cômputo.
Entrada: 1151–1156, 2151–2156, 1408–1410, 2408–2410
Saída: 5151–5156, 6151–6156, 5408–5410, 6408–6410
São transferências de mercadoria entre estabelecimentos do mesmo titular (matriz↔filial). Não entram em compras/vendas pra evitar duplo cômputo.
Importar XMLs
Aponte uma pasta local — sistema lê todos os XMLs, classifica em compras/vendas pelo seu CNPJ e organiza por mês
Pasta a importar
Pode ser uma pasta com vários níveis — vai varrer tudo recursivamente atrás de arquivos .xml
Como funciona
Cada XML é lido, parseado e comparado com seu CNPJ configurado:
- Você é o emitente (CNPJ no <emit>) → marca como vendas (direção =
emitida) - Você é o destinatário (CNPJ no <dest>) → marca como compras (direção =
recebida) - Os XMLs são organizados em
downloads/nfe-emitidas/AAAA/MM/oudownloads/nfe/AAAA/MM/ - NF-e duplicadas (mesma chave já no banco) são puladas — pode rodar várias vezes
- PDFs (DANFE+Consulta) são gerados automaticamente
Análise & Insights
Curva ABC, sazonalidade, conciliação e compliance
Período da análise:
→
NF-e
—
—
Frete FOB (você paga)
—
—
Frete CIF (ciência)
—
fornecedor paga
Ticket Médio
—
por NF-e
% Frete real
—
FOB / mercadoria
Canc. / CC-e
— / —
NF-e em alerta
Curva ABC de Fornecedores
Compras x Frete por Mês
Top 10 Transportadoras
UF de Origem (NF-e vs CT-e)
% Frete sobre Mercadoria — por Fornecedor (top 15) só FOB conta no %
| Fornecedor | NF-e | Mercadoria | Frete FOB | Frete CIF | % Frete |
|---|
📥 Top 15 Produtos Comprados
| Produto | Qtd | Valor |
|---|
📥 Top 10 NCM Comprados
| NCM | Linhas | Valor |
|---|
📥 CFOPs nas Compras visão do emitente
| CFOP | Linhas | Valor |
|---|
Conciliação NF-e ↔ CT-e
Com Frete
—
NF-e c/ CT-e
Sem Frete
—
retirada/SEDEX?
CT-e Órfãos
—
sem NF-e
Variação Mês-a-Mês (top 10 absoluto)
| Fornecedor | Anterior | Atual | Δ% |
|---|
NF-e Canceladas 0
| Nº | Emitente | Data | Valor |
|---|
NF-e sem Manifestação 0
| Nº | Emitente | Data | Valor |
|---|
Logs do Sistema
🧾 NFS-e — Notas Fiscais de Serviços (Padrão Nacional)
Consulta como tomador via API ADN — Sistema Nacional NFS-e (SEFAZ)
API ADN
Consultas / hora
—
Último NSU: —
| Nº NFS-e | Data | Prestador | CNPJ Prestador | Valor | Situação | Ações | |
|---|---|---|---|---|---|---|---|
| Clique em Sincronizar para buscar NFS-e no portal nacional, ou em Buscar para consultar o banco local. | |||||||
ℹ️ Como funciona a NFS-e Nacional
O sistema consulta o ADN — Ambiente de Distribuição Nacional da SEFAZ usando o mesmo certificado A1 configurado para NF-e / CT-e. Apenas municípios que aderiram ao Padrão Nacional NFS-e (vigente desde 01/09/2022, API em produção desde 01/10/2025) aparecem aqui. Municípios que ainda usam sistemas próprios (ex.: SIGISS, GISS, ISS.net) não são cobertos por esta integração.
O sistema consulta o ADN — Ambiente de Distribuição Nacional da SEFAZ usando o mesmo certificado A1 configurado para NF-e / CT-e. Apenas municípios que aderiram ao Padrão Nacional NFS-e (vigente desde 01/09/2022, API em produção desde 01/10/2025) aparecem aqui. Municípios que ainda usam sistemas próprios (ex.: SIGISS, GISS, ISS.net) não são cobertos por esta integração.
❌ NF-e Canceladas
Notas que o emissor (ou você) cancelou via evento SEFAZ — não devem ser escrituradas
Carregando…
| Tipo | Número | Data emissão | Emitente | Valor | Data cancelamento | Motivo | Ações |
|---|---|---|---|---|---|---|---|
| Clique em Buscar ou ajuste os filtros. | |||||||
ℹ️ Como o sistema detecta cancelamento
Quando o emissor cancela uma NF-e na SEFAZ, ele envia um evento de cancelamento (tpEvento 110111 ou 110112) que chega na mesma fila DF-e que você sincroniza. O sistema marca a nota como Cancelada automaticamente. Notas antigas que receberam cancelamento antes dessa atualização aparecem aqui só depois de você clicar em 🛠 Reconciliar Status uma vez.
Quando o emissor cancela uma NF-e na SEFAZ, ele envia um evento de cancelamento (tpEvento 110111 ou 110112) que chega na mesma fila DF-e que você sincroniza. O sistema marca a nota como Cancelada automaticamente. Notas antigas que receberam cancelamento antes dessa atualização aparecem aqui só depois de você clicar em 🛠 Reconciliar Status uma vez.
🕳 Saltos NSU — Auditoria de notas perdidas
Registros de quando o ponteiro NSU pulou (geralmente por 656 confirmado 3x). Cada salto pode esconder notas que a SEFAZ não entregou pelo DistDFe.
Carregando…
Recuperar uma nota por chave de acesso
Se você descobrir a chave de uma NF-e perdida (e-mail do fornecedor, contador, portal SEFAZ), cole aqui — o sistema consulta direto via consChNFe e baixa o XML/PDF.
| # | Quando | Tipo | NSU de → para | Pulados | Motivo | Recuperadas | Ações |
|---|---|---|---|---|---|---|---|
| Carregando… | |||||||
ℹ️ Por que isso acontece
O DistDFe entrega NF-e/CT-e por NSU sequencial. Em raros casos a SEFAZ retorna erro 656 "Consumo Indevido" com um
O DistDFe entrega NF-e/CT-e por NSU sequencial. Em raros casos a SEFAZ retorna erro 656 "Consumo Indevido" com um
ultNSU sugerido maior que o real — pulando documentos "em trânsito". A defesa nova exige 3 respostas 656 consecutivas com o mesmo ultNSU antes de pular, reduzindo bastante o risco. Quando o salto acontece mesmo assim, fica registrado aqui e você pode baixar individualmente cada nota perdida via consChNFe (acima).
📋 Protocolos de Entrega
Histórico de protocolos enviados à contabilidade — re-imprima ou exclua para liberar as notas vinculadas
Carregando…
| # | Gerado em | Tipo | Período | Documentos | Valor total | Ações |
|---|---|---|---|---|---|---|
| Carregando histórico… | ||||||
ℹ️ Como funciona
Toda vez que você clica em 🖨️ Protocolo nas abas de Notas Fiscais ou CT-e Fretes e confirma a marcação, o sistema:
Toda vez que você clica em 🖨️ Protocolo nas abas de Notas Fiscais ou CT-e Fretes e confirma a marcação, o sistema:
- Gera o PDF de protocolo de entrega;
- Salva uma cópia do PDF em
database/protocolos/<id>.pdf; - Registra o protocolo aqui e trava as notas vinculadas (o checkbox vira o badge ✓ Protocolada);
- Re-impressão devolve EXATAMENTE o PDF original (mesmo se a nota for cancelada/deletada depois);
- Excluir um protocolo libera os checkboxes das notas para nova marcação.