Análise de Documentos¶

Em uma frase. Construtor de relatórios sobre as notas da conta: escolha campos, filtre, agrupe, some, veja em gráfico, exporte para Excel ou PDF — e apure os furos de numeração, inutilizando as faixas faltantes ali mesmo.

Quem usa: analista fiscal, controladoria, auditoria interna · Frequência: no fechamento do mês e sob demanda · Pré-requisitos: notas emitidas ou recebidas no app; para inutilizar faixas, permissão de transmissão e certificado da empresa ativo

Para que serve¶

As listagens de Documentos respondem "onde está a nota X?". A Análise responde perguntas sobre o conjunto: quanto foi emitido por CFOP no mês, quais destinatários concentram o faturamento, quanto de IBS/CBS saiu por CST, quantas notas foram canceladas nos últimos 90 dias, onde a numeração pulou um número.

A tela trabalha em quatro modos:

Modo	Uma linha é…	Base
Documentos	uma nota (emitida ou recebida)	Cabeçalho, emitente, destinatário, totais, transporte, cobrança
Detalhe (itens)	um item de nota	Os campos do cabeçalho mais os do item: produto, NCM, CFOP, ICMS, IPI, PIS/COFINS, IS, IBS/CBS
Inutilizações	um pedido de inutilização	Série, faixa, UF, status, cStat, protocolo, justificativa
Furos de numeração	uma faixa de números faltantes	Numeração das notas emitidas, por empresa, modelo, série e ambiente

Os três primeiros compartilham o mesmo construtor; o quarto é um relatório próprio.

Como chegar¶

No Hub, abra o app NF-e.
Selecione o tile Análise de Documentos.

A tela de consulta¶

Título Análise de Documentos, subtítulo «Monte análises livres ou agregadas sobre suas notas — filtros, agrupamentos, gráficos e exportação.»

Nada é consultado ao abrir. A tabela mostra «Pronto para consultar — Escolha um template ou monte a consulta e clique em "Atualizar".» A consulta só roda no botão Atualizar (ou ao escolher um template).

Barra do topo¶

Controle	O que faz
Chips de modo	Documentos · Detalhe (itens) · Inutilizações · Furos de numeração. Trocar de modo limpa a consulta montada: os campos de um modo não valem no outro
Seletor de template	Mostra o nome da análise atual («Nova análise» de início). Lista Meus templates e Predefinidos do modo ativo
Campos	Abre o painel «Campos exibidos» para escolher as colunas. Desabilitado quando há agrupamento
Salvar como…	Grava a consulta atual como template
Atualizar	Executa a consulta; mostra «Consultando…» enquanto roda

Empresa e período¶

Logo abaixo: Empresa (todas, ou uma), De e Até. O período abre no dia 1º do mês corrente até hoje. Nos modos Documentos e Detalhe, o período é pela data de emissão; em Inutilizações, pela data de registro do pedido.

Filtros¶

Linha Filtro: escolha o campo (agrupado por seção — Identificação, Emitente, Destinatário, Totais, Transporte, Cobrança, Item, Item — ICMS, …), o Operador e o Valor, e clique em + Filtro para virar uma etiqueta. As etiquetas se acumulam (todas precisam ser verdadeiras) e saem pelo x.

Tipo de campo	Operadores
Texto	`=`, `≠`, está em, não está em, contém, começa com, termina com, é vazio, não é vazio
Número e data	`=`, `≠`, `>`, `≥`, `<`, `≤`, entre, é vazio, não é vazio
Lista fechada (status, modelo, tipo)	`=`, `≠`, está em, não está em, é vazio, não é vazio

Em "está em" e "não está em", informe os valores separados por vírgula. Campo de lista fechada mostra as opções num seletor; status aparece com o rótulo em português.

Um filtro montado e ainda não adicionado também vale ao clicar em Atualizar — a tela avisa: «Este filtro será aplicado ao clicar em "Atualizar". Use "+ Filtro" para combinar vários.»

Agrupar e medir¶

Controle	Regra
Agrupar por (máx. 4)	Cada campo escolhido vira uma coluna de agrupamento; a etiqueta sai pelo `x`
Medidas (máx. 8)	Campo + operação: Σ Soma, μ Média, Mín., Máx. (números e datas), # Qtde e # Distintos (qualquer campo)

Com agrupamento, a tabela passa a mostrar uma linha por grupo e o contador diz "N grupos". Sem medida, a tela lembra: «Adicione ao menos uma medida para agregar.»

Resultado¶

Contador: "N linhas" (detalhado) ou "N grupos" (agrupado)
Paginação de 10, 20, 50 ou 100 linhas (padrão 50)
Sem colunas escolhidas, o modo Documentos mostra data de emissão, série, número, nome do emitente, nome do destinatário, valor total e status; o modo itens acrescenta nº do item, descrição, CFOP e valor bruto; Inutilizações mostra data de registro, série, número inicial e final, modelo, UF, status, protocolo e justificativa
Valores em moeda e percentual alinhados à direita; datas em DD/MM/AAAA HH:mm

Detalhe do grupo. No modo agrupado, clicar numa linha abre «Detalhe do grupo» com as notas (ou itens) que formam aquele grupo — as 100 primeiras, com as colunas padrão.

Ver gráfico / Ver tabela. Com agrupamento, alterna para gráfico de Barras (várias medidas) ou Pizza (só com uma medida). O gráfico mostra os 30 primeiros grupos e avisa quando há mais.

Exportar¶

Exportar ▸ Excel (.xlsx) ou PDF, habilitado depois da primeira consulta. O arquivo leva a consulta inteira, não só a página: mesmos filtros, período, empresa, colunas, agrupamentos e medidas.

Formato	Limite	Nome do arquivo
Excel	10.000 linhas	`analise_nfe_AAAAMMDD_HHMM.xlsx`
PDF	2.000 linhas	`analise_nfe_AAAAMMDD_HHMM.pdf` — com título «Análise de NF-e» e a descrição dos filtros

Templates¶

Predefinidos (fixos, do produto):

Template	Modo	O que traz
Notas — visão geral (mês atual)	Documentos	Notas do mês, mais recentes primeiro
Notas canceladas (últimos 90 dias)	Documentos	Status Cancelada
Itens por CFOP (mês atual)	Itens	Agrupa por CFOP, com contagem e somas
Top destinatários do mês	Documentos	Agrupa por CPF/CNPJ e nome do destinatário, ordena por valor
Reforma — IBS/CBS por CST (mês atual)	Itens	Agrupa por CST de IBS/CBS, com base e valores
PIS/COFINS por CST (últimos 60 dias)	Itens	Agrupa por CST de PIS e de COFINS
Notas por UF do destinatário (mês atual)	Documentos	Contagem e valor por UF
Notas por status (mês atual)	Documentos	Contagem e valor por status
Inutilizações (últimos 90 dias)	Inutilizações	Pedidos registrados no período

Escolher um template preenche período, empresa, filtros, agrupamentos e medidas, e já executa a consulta. Os predefinidos usam datas relativas ("mês atual", "últimos 90 dias"), resolvidas no dia em que são abertos.

Salvar como… abre «Salvar template»: Nome (obrigatório, até 120 caracteres) e Visibilidade — Privado (só eu) ou Compartilhado com a empresa (todos os usuários da conta veem). O template salvo aparece em Meus templates do mesmo modo.

Furos de numeração¶

O quarto modo apura, nas notas emitidas, os números que faltam na sequência de cada combinação empresa · modelo · série · ambiente dentro do período.

Filtros¶

Filtro	Valores	Padrão
Empresa	Todas ou uma	Todas
Modelo	Todos · NF-e (55) · NFC-e (65)	Todos
Série	Número, ou vazio para todas	Todas
Ambiente	Produção · Homologação	Produção
De / Até	Data de emissão	1º do mês até hoje

Clique em Atualizar para apurar. O período é limitado a 12 meses.

O que a lista mostra¶

Coluna	Conteúdo
Emitente	CNPJ e UF
Modelo	NF-e ou NFC-e
Série	Número da série
Ambiente	Produção ou Homologação
Faixa faltante	Número único ou "inicial – final"
Qtde	Quantidade de números na faixa
Situação	Sem nota — nenhum documento com aquele número · Não autorizado — só há nota rejeitada, denegada, com erro ou ainda em processamento

O contador diz "N faixas com furo". Sem furos: «Nenhum furo encontrado — A numeração está contínua no período/filtros informados.»

Inutilizar a partir do furo¶

Inutilizar na linha abre o formulário de nova inutilização já preenchido com empresa, modelo, série, faixa e ano — o mesmo formulário da tela Inutilização por Faixa.
Para várias faixas, marque as caixas e use Inutilizar selecionadas (N). Abre «Inutilizar em massa»: lista as faixas e pede uma justificativa para todas (mínimo 15, máximo 255 caracteres). O resultado mostra, por faixa, o status (Homologada, Rejeitada ou erro), o cStat e o motivo devolvido pela SEFAZ, e um resumo «N homologada(s), N rejeitada(s), N erro(s) de N.»
Faixa sem empresa, CNPJ ou UF identificados não pode ser marcada («Faixa sem empresa/CNPJ — não inutilizável»).
Ao concluir, a apuração roda de novo: faixas homologadas deixam de aparecer.

Exportar gera furos_numeracao_AAAAMMDD_HHMM.xlsx ou .pdf, com os mesmos limites de linhas da análise.

Regras de negócio¶

RN-ANL-001 — Toda consulta de notas tem início de período. Se nenhum filtro dá limite inferior à data de emissão, o sistema aplica a partir do dia 1º do mês corrente. Apagar o campo De não traz "todo o histórico": traz o mês atual.
RN-ANL-002 — Documentos inclui emitidas e recebidas. Sem filtro de Tipo (Emitida/Recebida), a consulta mistura as duas. Para somar só o faturamento, filtre Tipo = Emitida.
RN-ANL-003 — Trocar de modo recomeça a consulta. Campos de itens não existem em Inutilizações, e vice-versa; por isso a troca manual limpa filtros, agrupamentos e medidas e volta o período ao mês corrente.
RN-ANL-004 — Limites do agrupamento. No máximo 4 agrupadores, 8 medidas e 50.000 grupos por resultado. Soma, média, mínimo e máximo só valem para campos numéricos (mínimo e máximo também para datas).
RN-ANL-005 — Exportação tem teto. 10.000 linhas em Excel e 2.000 em PDF. Acima disso a exportação é recusada — nada é cortado em silêncio.
RN-ANL-006 — Nome de template é único por usuário. A comparação ignora maiúsculas e minúsculas. Usuários diferentes podem ter templates de mesmo nome.
RN-ANL-007 — Template salvo guarda datas fixas. Ao salvar, o período vai como as datas que estavam na tela. Só os predefinidos têm datas relativas.
RN-ANL-008 — Template compartilhado é visível, não editável. Todos da conta veem e usam; só o dono (ou um super-administrador) pode alterá-lo ou removê-lo.
RN-ANL-009 — Furo é o que falta entre o menor e o maior número emitido no período. Contam como número válido as notas autorizadas, canceladas e inutilizadas. Faixas cobertas por inutilização homologada não são furo.
RN-ANL-010 — Furo só em notas emitidas, num ambiente por vez. Produção e homologação têm numerações independentes e não se misturam.
RN-ANL-011 — Furos: no máximo 12 meses por apuração.

O que esta tela não faz¶

Não altera nota. É somente leitura — a única ação com efeito é a inutilização, que segue as regras da tela Inutilização por Faixa.
Não detecta furo antes do primeiro nem depois do último número do período. Se a sequência parou em 1.000 no mês anterior e recomeçou em 1.005 neste mês, os números 1.001 a 1.004 só aparecem numa apuração que cubra os dois meses.
Não edita nem remove template pela tela. O painel permite criar; alteração e remoção existem só pela API.
Não agenda nem envia relatório. A exportação é imediata e baixada no navegador.
Não ordena pela tela. A ordem vem dos predefinidos; nas consultas livres, a ordem das linhas não é garantida.

Erros e mensagens¶

Mensagem	Quando aparece	O que fazer
«Erro ao executar a consulta.» (ou o detalhe devolvido)	Consulta recusada	Leia o detalhe: campo indisponível no modo, operador incompatível, valor numérico inválido
«resultado tem N grupos (> 50000). Refine os agrupadores.»	Agrupamento muito granular	Tire um agrupador ou restrinja o período
«agregação 'sum' incompatível com o campo …»	Soma/média pedida em campo de texto	Escolha # Qtde ou # Distintos para esse campo
«operador 'between' espera lista [min, max]»	Operador entre com um valor só	Use dois filtros, `≥` e `≤`
«A exportação em XLSX é limitada a 10.000 linhas; restrinja o período ou os filtros.»	Exportação acima do teto	Restrinja; em PDF o teto é 2.000
«Informe um nome.»	Salvar template sem nome	Preencha o nome
«Já existe um template com o nome '…'.»	Nome repetido para o mesmo usuário	Use outro nome
«O período do relatório é limitado a 12 meses.»	Furos com período maior	Divida a apuração
«emissao_fim deve ser maior ou igual a emissao_inicio.»	Até antes de De, em Furos	Corrija as datas
«Justificativa: mínimo 15 caracteres.»	Inutilização em massa com justificativa curta	Complete a justificativa
«Não foi possível processar a inutilização em massa.»	Falha no envio	Verifique a permissão e o certificado da empresa

Relação com a NF-e / SEFAZ / EFD¶

Elemento	Relação
Campos do catálogo	Espelham o leiaute da NF-e: `finNFe` (Finalidade), `tpNF` (Entrada/Saída), `idDest`, `tpImp`, `cMunFG`, `vNF`, `vTotTrib`, `vNFTot`, CST de ICMS/IPI/PIS/COFINS, e os grupos da Reforma (IBS UF, IBS Município, CBS, IS)
Inutilização a partir do furo	Pedido de inutilização de numeração na SEFAZ, com retorno de cStat, motivo e protocolo por faixa
EFD-ICMS/IPI — C100	Documento cancelado é escriturado só com os campos de identificação e a chave [Guia Prático EFD-ICMS/IPI 3.2.3, p. 63]. Denegados e inutilizados deixaram de ser de informação obrigatória desde 01/12/2021, e os códigos de situação 04 e 05 só são aceitos para documentos até 31/12/2022 [Guia Prático EFD-ICMS/IPI 3.2.3, p. 63 e p. 67]

Por que apurar furo antes de fechar o mês. Número sem nota e sem inutilização homologada é o que o fisco pergunta primeiro. A apuração aqui mostra as faixas e permite inutilizá-las sem sair da tela.

Perguntas frequentes¶

Limpei a data "De" e continuo vendo só o mês atual. É a RN-ANL-001. Informe a data inicial desejada.

O total de valor por status não bate com o Dashboard. A Análise mistura emitidas e recebidas (RN-ANL-002) e respeita o período escolhido; o Dashboard mostra só emitidas. Filtre Tipo = Emitida.

Salvei um template "do mês" e em outubro ele ainda traz setembro. Template salvo guarda datas fixas (RN-ANL-007). Ajuste o período depois de abri-lo.

Pedi uma medida e veio erro de "incompatível". Soma e média só existem para campos numéricos. Troque a operação para # Qtde ou # Distintos.

O furo aparece como "Não autorizado". Posso inutilizar? A nota daquele número foi rejeitada ou não chegou à autorização. Se ela não será reenviada, inutilize; se será, corrija e reenvie a nota em Documentos ▸ Emitidos.

Por que a coluna Empresa mostra um código? O campo Empresa guarda o identificador interno. Para ver o CNPJ, use CNPJ emitente ou CPF/CNPJ destinatário.