Este HTML é um gerador local (no seu navegador) que lê XML de NFe, cruza com
SPED (registro C100) e gera um TXT em layout fixo (padrão Prosoft) — com grid editável
e exportação em TXT e CSV.
1) O que o sistema faz (visão geral)
Você entrega para a ferramenta:
- XML(s) da NFe (um ou vários)
- SPED (arquivo texto com
|C100|...| contendo DT_E_S e IND_PGTO)
- opcionalmente tudo compactado em ZIP ou em uma pasta com subpastas
Ela:
- Extrai as duplicatas do XML (tag
cobr/dup) e monta registros de “faturas/duplicatas”.
- Associa cada NFe ao SPED pela chave 44 dígitos (
chNFe do XML ↔ campo “CHV_NFE” do C100).
-
Quando acha no SPED:
- troca a DATAENTRADA (escrituração) pela DT_E_S do SPED
- define DESDOB (0/1) conforme IND_PGTO do SPED
- Exibe tudo numa grid editável.
- Exporta: TXT (layout fixo) e CSV (auditoria/conferência).
2) Conceitos importantes (pra não errar)
2.1 XML “com duplicata” (cobr/dup)
- O padrão da ferramenta é considerar apenas XML que tenham duplicatas (
<cobr><dup>...</dup></cobr>).
- Se o XML não tiver duplicata, ele não entra na grid e não sai no TXT, a menos que você marque:
- “Incluir notas sem cobr/dup (gera 1 linha)”
2.2 SPED (C100) é quem “manda” na escrituração
O SPED (registro C100) é usado para:
- DT_E_S (Data de Entrada/Saída) → aqui tratada como data de escrituração
- IND_PGTO (0/1) → usado como desdobramento (DESDOB):
0 = sem desdobro (1 linha)1 = com desdobro (pode gerar 2 linhas: item 0 e item 1)
Na prática: o XML dá as duplicatas/valores e dados base; o SPED dá a data correta de escrituração e o indicador 0/1.
2.3 Por que usar XML + SPED juntos (e por que ZIP ajuda)
- XML sozinho pode ter vencimentos variados, incompletos, divergentes do que foi escriturado, ou faltar informação de “desdobro”.
- SPED é a base contábil/fiscal do período:
- garante data de escrituração consistente (DT_E_S)
- traz o indicador IND_PGTO (0/1)
- ZIP é a forma mais prática:
- junta XML + SPED do mesmo período
- processa tudo em lote
- reduz risco de esquecer arquivo e evita misturar períodos
3) Estrutura da tela (o que cada bloco significa)
3.1 Entrada (XML / SPED / ZIP / Pasta)
- Selecionar Entrada:
- Arquivos: seleciona XML/SPED/ZIP
- Pasta: pega uma pasta inteira (com subpastas)
- Contadores: XML, SPED, ZIP
- Botões:
- Processar: lê tudo e monta a grid
- Limpar Dados: zera seleção + grid
3.2 Saída (TXT Prosoft)
- COD PROSOFT: usado para montar o nome do arquivo de saída.
- Destino: nome final do arquivo (preenchido automaticamente).
3.3 Grid (duplicata)
- dataset final: permite editar dados antes de exportar
- mostra fonte, status de SPED e somatórios
4) Passo a passo de uso (fluxo recomendado)
Passo 1 — Defina o “Contexto da Nota”
Antes de processar, selecione:
- Compra / Entrada (Terceiro = Emitente): terceiro (fornecedor) sai do emitente do XML.
- Venda / Saída (Terceiro = Destinatário): terceiro sai do destinatário do XML.
Isso muda de onde vêm CNPJ/UF/IE do terceiro.
Passo 2 — Selecione arquivos
Clique em Selecionar Entrada e escolha XMLs, SPED, ZIP… ou a pasta do período.
Passo 3 — Clique em Processar
- Expandir ZIP (se houver) e classificar conteúdos
- Indexar SPED (
C100) por chave 44
- Ler XML e montar duplicatas
- Aplicar SPED (se marcado)
- Normalizar dados e renderizar a grid
Passo 4 — Confira validações e a grid
- Veja os pills de validação (CNPJ/UF/Chave)
- Se estiver usando SPED, confira SPED match e SPED missing
- Ajuste manualmente qualquer campo na grid
Passo 5 — Configure exportação e exporte
- Preencha COD PROSOFT
- Ajuste opções
- Clique em Exportar / TXT (ou CSV)
5) Como a associação com SPED funciona (detalhe técnico prático)
A ferramenta varre o SPED procurando linhas que começam com |C100|.
Ela lê:
- CHV_NFE: chave (44 dígitos)
- DT_E_S: data de escrituração (8 dígitos
ddmmaaaa)
- IND_PGTO:
0 ou 1 → vira DESDOB
Regras de casamento
- por chave 44 dígitos
- se repetir a chave no SPED, usa a primeira ocorrência
Efeito quando encontra SPED
- DATAENTRADA vira DT_E_S em
dd/mm/aaaa
- DESDOB:
0 se IND_PGTO != 1, 1 se IND_PGTO == 1
- marca
__spedMatched = true
Efeito quando NÃO encontra SPED
- registro fica como SPED missing
- se “Somente com SPED” estiver marcado, não exporta por padrão
6) Explicação de todas as opções (comportamento real)
6.1 “Anexar D no código (ex: 0001D)”
- altera o nome do arquivo “Destino”
- útil quando sua convenção exige sufixo
D
6.2 “Forçar 2 linhas por registro (0 e 1)”
- sempre gera item
0 e item 1
- ignora DESDOB que veio do SPED ou da grid
6.3 “Usar SPED (C100) para data de escrituração e desdobramento”
- habilita cruzamento por chave
- substitui DATAENTRADA
- define DESDOB via IND_PGTO
6.4 “Exportar somente se existir no SPED (padrão)”
- só atua se “Usar SPED” estiver ligado
- se marcado, registros “SPED missing” não saem no TXT/CSV
6.5 “Incluir notas sem cobr/dup”
- se XML não tiver
<cobr><dup>, por padrão é ignorado
- se marcar, gera 1 linha fallback usando
<fat> ou vNF
6.6 “Vencimento = +30 dias a partir da escrituração (DT_E_S) — padrão”
- ao exportar, o vencimento vira DATAENTRADA + 30 dias
- se SPED aplicado, DATAENTRADA = DT_E_S (perfeito)
- se desmarcar, usa
dVenc do XML (se existir) ou fica em branco
Importante: o cálculo acontece no momento da exportação; mesmo editando na grid, se estiver marcado ele recalcula.
6.7 “Consolidar faturas por terceiro (lista dinâmica de CNPJ/CPF)”
- você cola lista de CNPJ/CPF (um por linha ou por vírgula)
- se terceiro estiver na lista e a NF tiver mais de uma duplicata:
- soma os valores
- exporta apenas 1 linha
- mantém o menor vencimento
- aplica somente na exportação (grid não muda)
7) Como editar corretamente na grid (sem quebrar export)
Campos sensíveis:
- CHAVE: 44 dígitos
- CNPJCPF / CNPJFILIAL: 11 ou 14 dígitos
- UF: 2 letras
- DATAS: edite em
dd/mm/aaaa (export converte para ddmmaaaa)
- VALORBRUTOFAT: normaliza para 2 casas
Depois de editar, a validação inferior mostra alertas (pills).
8) Exportação (TXT e CSV) — regras que pegam
8.1 Exportar TXT
- linhas com tamanho fixo (pad/align)
- respeita filtros SPED, regra 2 linhas, vencimento +30 e consolidação
- nome usa “Destino” (montado por COD PROSOFT e opção do “D”)
8.2 Exportar CSV
- auditoria / abrir no Excel
- separador
;
- aplica filtro “somente com SPED”, consolidação e vencimento +30 (se marcados)
9) Boas práticas (para operação “sem dor”)
- Sempre trabalhe por período (pasta/zip por mês, ex:
2026-01)
- No ZIP, organize:
XML/ com as NFesSPED/ com o(s) arquivo(s) do período
- Antes de exportar em lote:
- confira SPED missing
- se tiver missing, corrija seleção/SPED ou desmarque “somente com SPED”
- Se usa “vencimento +30” (padrão), garanta SPED correto do período junto.
10) Solução de problemas (rápida e objetiva)
“Exportar” dá vazio / não sai nada
- Você está com “Usar SPED” + “Somente com SPED” ligados e tudo está como SPED missing.
- Solução: selecione o SPED correto (com C100/chaves) ou desmarque “Somente com SPED”.
ZIP não abre / dá erro de descompactação
- Precisa de suporte a
DecompressionStream. Use Chrome/Edge atualizados.
“SPED missing” para notas que você tem certeza que estão no SPED
- SPED não é do mesmo período/empresa
- chave no SPED está diferente (com lixo/espaços) — a ferramenta limpa, mas precisa ter a chave correta
- o arquivo selecionado não tem
|C100| (não é o SPED certo)
Vencimento “mudou” e você queria o do XML
- A opção “Vencimento +30” está marcada (padrão). Desmarque para usar
dVenc do XML.
Quero “juntar” duplicatas só para alguns terceiros
- Marque “Consolidar por terceiro”, cole a lista de CNPJ/CPF e exporte (só consolida no export).
