Painel

O que este portal é

Um espelho local dos documentos fiscais eletrônicos emitidos contra os CNPJs da JS. Todas as noites o sistema pergunta à SEFAZ "o que chegou de novo para estes CNPJs?", guarda o XML em disco e indexa os campos num banco local. A tela só consulta esse banco.

As duas unidades — e cada uma no seu estado

Unidade	CNPJ	UF	cUFAutor
JS MATRIZ	22.577.871/0001-05	MS	50
JS GRAOS 3000	22.577.871/0003-77	MT	51

Cada unidade tem o seu próprio certificado A1. O nome "MATRIZ" engana: ela é a unidade de MS (Costa Rica, Chapadão do Sul, Campo Grande). A JS GRAOS 3000 é a de MT (Nova Mutum). Onde a tela mostra MS ou MT, é a UF da nossa unidade — não a do emitente da nota.

As quatro famílias de documento

Família	O que traz	Serviço de origem	Cota
NF-e	mercadoria: compras, devoluções, transferências	NFeDistribuicaoDFe	disputada
CT-e	frete: quem transportou, o que, quanto pesou, quanto custou	CTeDistribuicaoDFe	própria
NFS-e	serviços tomados e prestados, com ISS	ADN Nacional	própria
MDF-e	manifesto da viagem: veículo, percurso e os CT-e que ela leva	MDFeDistribuicaoDFe	própria

São quatro webservices independentes. Uma recusa em um deles não afeta os outros — é por isso que CT-e e NFS-e estão em dia enquanto a NF-e ainda recupera histórico.

Acesso e permissões

Cada pessoa entra com usuário próprio. Há dois perfis, e a diferença não é burocracia:

Perfil	Pode	Não pode
Administrador	tudo, inclusive disparar consulta à SEFAZ, sincronizar cadastro e desbloquear unidade	—
Somente leitura	consultar as quatro famílias, filtrar, ver detalhe, baixar XML, gerar PDF e exportar Excel	disparar qualquer coisa que fale com a SEFAZ

O motivo da restrição: cada consulta à SEFAZ consome cota do CNPJ, e essa cota é compartilhada com o ERP Nectar. Um clique em "Coletar agora" no meio da tarde atrapalharia o ERP inteiro. Por isso a leitura é ampla e a escrita é estreita — quem tem perfil de leitura nem vê a aba de coleta.

Relatórios em PDF

Ao lado dos botões de XML há os de PDF, com a mesma seleção:

• PDF (seleção) — só as notas marcadas nas caixinhas.
• PDF (todo o filtro) — tudo o que o filtro atual devolve, não apenas a página visível.

O relatório traz uma linha por documento, os filtros que foram aplicados (fica registrado no próprio papel) e os totais no fim: valor para NF-e; peso e frete para CT-e; ISS e valor de serviço para NFS-e. CT-e e NFS-e têm o botão de PDF nas suas próprias abas.

DANFE, DACTE e DANFSe

Além dos relatórios, o portal gera o documento auxiliar oficial de cada nota — aquele que se imprime e acompanha a mercadoria ou se anexa ao processo:

Família	Documento	Onde
NF-e	DANFE	coluna DANFE da lista, ou o botão Ver DANFE no detalhe da nota
CT-e	DACTE	coluna DACTE da lista de fretes
NFS-e	DANFSe	coluna DANFSe da lista de serviços

Clicar em abrir mostra o documento numa aba nova, pronto para imprimir ou salvar. Todos saem com o mesmo rodapé dos relatórios — powered by e o logo da JS Grãos no canto inferior direito de cada página.

Vários de uma vez

Os botões DANFE (seleção), DANFE (todo o filtro), DACTE (todo o filtro) e DANFSe (todo o filtro) montam um único PDF com todos os documentos, um por página. Útil para fechar o mês ou atender uma solicitação da contabilidade de uma vez.

O limite por lote é de 300 documentos. Se algum não puder ser gerado, o portal avisa quantos ficaram de fora e por quê — não entrega um PDF incompleto em silêncio.

Data e hora dos documentos

As listas mostram data e hora de emissão, e a exportação Excel traz as duas em colunas separadas (data_emissao e hora_emissao).

A hora exibida é a do emitente, exatamente como está no XML — não é convertida para o fuso de quem está olhando. Uma nota emitida 23:30 em Mato Grosso aparece 23:30 para todos. Isso é deliberado: converter mudaria a hora e, na virada do dia, mudaria a data do documento.

A janela de coleta: 20:00 às 05:00

O limite de consumo da SEFAZ é por CNPJ, não por sistema. Como o mesmo certificado é usado pelas áreas (pela web) e pelo ERP Nectar, consultar em horário comercial disputa cota com eles — e o resultado é recusa (cStat 656) para todos. Por isso a coleta de NF-e só roda das 20:00 às 05:00.

Fora desse horário, a etiqueta no topo mostra fora da janela e os botões que chamam a SEFAZ ficam desabilitados. Tudo o que não toca a SEFAZ continua liberado 24 horas: consultar, filtrar, ver detalhe, baixar XML já guardado e exportar.

Por que só a NF-e é restrita

CT-e e NFS-e já coletam 24 horas. São webservices distintos, com cota própria — uma recusa de NF-e não os afeta, e eles não consomem a cota que o Nectar usa. A janela vale apenas para a família NF-e, onde existe a disputa.

Para a NF-e, liberar as 24 horas foi avaliado e descartado: nossa taxa de sucesso na varredura é praticamente a mesma de dia (5,0%) e de noite (2,3%) — ou seja, não ganharíamos documentos —, mas cada consulta nossa em horário comercial aumenta a chance de o ERP Nectar levar recusa. Trocar o funcionamento do ERP por um ganho que os dados não confirmam não se justifica. O que traz os documentos hoje é a recuperação NSU por NSU, limitada pela cota por hora, não pelo relógio.

Aba por aba

Painel

Abre com Documentos fiscais capturados: as três famílias, quantos documentos, valor, e se a coleta de cada uma está em dia ou ainda coletando. Abaixo, os indicadores de NF-e e os maiores emitentes.

NF-e — notas

A busca varre chave, número, emitente, CNPJ e natureza da operação. Fluxo separa entrada de saída; Registro separa nota completa de resumo. Clicar na linha abre o detalhe com os itens, os impostos e o caminho do XML. A coluna XML baixa o arquivo.

CT-e — fretes

Cada linha é um conhecimento de transporte: trecho, tomador, produto, peso e valor. A coluna NF-e mostra quantas notas aquele frete carregou — passe o mouse para ver as chaves. É por aqui que se amarra frete à mercadoria.

NFS-e — serviços

Começa filtrada em Serviço tomado, que é o caso normal. Troque para Serviço prestado quando o assunto for nota que a JS emitiu. Misturar os dois falseia qualquer total.

MDF-e — manifestos

O MDF-e não é nota: é o manifesto da viagem. Amarra veículo, motorista e percurso a um conjunto de CT-e e NF-e. O total da tela é o do frete contratado, nunca o da carga — o valor da mercadoria já está contado na NF-e, e somar os dois contaria a mesma coisa duas vezes. O filtro Viagem: Em aberto mostra os manifestos que ninguém encerrou: é pendência de operação, não de fisco.

Impressão de XML

Para quem já tem a chave de acesso em mãos e quer o XML: cole a chave e clique em Localizar. Pontos e espaços são ignorados, então dá para colar do jeito que veio. O contador embaixo do campo confere o dígito verificador enquanto você digita — erro de digitação aparece na hora, sem ida ao servidor. Funciona para as quatro famílias: 44 dígitos (NF-e, CT-e, MDF-e) ou 50 (NFS-e). Achando, dá para ver na tela, Imprimir, Baixar XML e, quando existe gerador, abrir o DANFE/DACTE/DANFSe.

CNPJs monitorados

Saúde de cada unidade: até onde a leitura chegou (NSU), última e próxima consulta, se o certificado está no lugar e se a senha está configurada. As unidades e os certificados são cadastrados no config.py — nunca pela tela, para nenhuma senha de certificado passar pelo navegador.

Coleta & processamento

Os botões de operação, com log ao vivo. Coletar agora busca o que há de novo; Processar XMLs pendentes é local e não gasta cota; Recuperar NSU pendentes busca, um por um, os documentos que a SEFAZ pulou. No dia a dia não é preciso mexer aqui — a tarefa noturna já faz tudo.

Auditoria

Toda consulta enviada à SEFAZ, com o código de resposta: 138 documento localizado, 137 nada novo, 656 consumo indevido. É aqui que se descobre por que algo não veio.

Exportar

Gera o .xlsx de NF-e do período, com uma aba "Todas" e uma aba por UF (MS e MT separadas).

Receitas para as perguntas do dia a dia

Glossário

Chave de acesso

Os 44 dígitos que identificam o documento em todo o Brasil. É o campo que liga NF-e, CT-e e o romaneio do MES.

NSU

Número sequencial da SEFAZ. Funciona como a numeração de uma caixa de entrada: guardamos até onde já lemos e pedimos "o que veio depois". Cada família tem a sua sequência.

cStat

Código de resposta da SEFAZ. 138 = documento localizado, 137 = nada novo, 100 = autorizado, 101 = cancelado, 656 = consumo indevido.

cStat 656 (consumo indevido)

A SEFAZ pedindo para esperar. Acontece quando se consulta demais ou quando outro sistema já consumiu a fila do CNPJ. Não é erro nosso — o sistema recua sozinho e volta depois.

Resumo (resNFe) x NFe completa

Por padrão a SEFAZ entrega ao destinatário um resumo: chave, emitente, data e valor. O XML completo (itens e impostos) é baixado numa segunda consulta, por chave. Por isso uma nota pode aparecer antes de o XML completo existir.

Manifestação do destinatário

Confirmar, dar ciência ou desconhecer uma operação perante a SEFAZ. Ainda não é feita por este portal — continue usando o portal do fornecedor atual para isso.

DF-e / ADN

DF-e é o serviço de "distribuição de documentos de interesse" da SEFAZ. ADN é o Ambiente de Dados Nacional, equivalente para NFS-e.

Limites que vale conhecer

• Manifestação não implementada. Exige assinar digitalmente o evento; está fora do que o portal faz hoje.
• NF-e ainda recuperando histórico. Enquanto o certificado for compartilhado, parte das notas chega pela fila de recuperação, algumas noites depois.
• NFS-e só do padrão nacional. Municípios que não aderiram ao Sistema Nacional não publicam no ADN e não aparecem aqui.
• A base é do fechamento da última noite. A coleta roda entre 20:00 e 05:00; o que foi emitido hoje aparece amanhã.

Se algo parecer errado

Comece por Auditoria — ela mostra o que a SEFAZ respondeu e quando. Depois CNPJs monitorados, que mostra se alguma unidade está em espera ou com certificado faltando. Esses dois lugares explicam quase tudo, e nenhum deles consome cota.