Integra

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, CSV e SPED atualizado (C140/C141).

0) Requisitos e preparação

Navegador atualizado: recomendado Chrome/Edge (para ZIP via DecompressionStream).
Arquivos do período correto: use XML e SPED do mesmo mês/empresa para evitar “SPED missing”.
Organização sugerida:
- XML/ com as NF-es do período
- SPED/ com o(s) arquivo(s) do período
- opcionalmente compactados em um único ZIP
Sem instalação: tudo roda localmente no navegador (sem enviar arquivos).

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 Importação Legado (TXT/CSV | pipe)

Arquivo legado: selecione um TXT/CSV com colunas separadas por |.
Carregar / Importar: gera as duplicatas direto do arquivo legado.
Conferência opcional: se marcado, compara com XML/SPED já processados.
Limpar importação legado: remove apenas o que veio do legado (não apaga XML/SPED).
Preview: mostra total de notas/parcelas, inconsistências e divergências.

3.3 Saída (TXT Prosoft)

COD PROSOFT: usado para montar o nome do arquivo de saída.
Destino: nome final do arquivo (preenchido automaticamente).

3.4 Grid (duplicata)

dataset final: permite editar dados antes de exportar
mostra fonte, status de SPED e somatórios

3.5 Validações e indicadores

Pills de validação: mostram alertas de CNPJ/UF/Chave e consistências.
SPED match/missing: quantidade de notas com ou sem correspondência no SPED.
Log de processamento: diagnósticos por arquivo quando algo não é reconhecido.

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 gerais e, se necessário, as opções de Exportação SPED (C140/C141)
Clique em Exportar TXT (ou CSV)
Se for gerar SPED atualizado, clique em Exportar SPED Atualizado (C140/C141)

4.1) Importar Legado TXT/CSV (pipe) — guia completo

A importação legado serve quando você já tem as faturas prontas e conferidas em um TXT/CSV. Nesse modo, não é necessário XML/SPED para gerar as duplicatas — mas você pode usar XML/SPED carregados apenas para conferência opcional.

Formato aceito (colunas e exemplo)

Ordem das colunas (separadas por |):

CNPJ EMITENTE | UF | IE | serie nf | ignorar | NF Num | DT Escrit | parcela | DT VENC | VL NF | VL Fatura | IGNORAR...

CNPJ EMITENTE |UF| IE     |serie nf    |ignorar |NF Num |DT Escrit|parcela     |DT VENC | VL NF  |VL Fatura| IGNORAR  | IGNORAR  |IGNORAR|IGNORAR|
02129836000116|BA|47230068|1           |        |1184728|06/01/26 |0001184728-1|26/01/26|6.022,37|2.007,47 |30/12/1899|30/12/1899|0,00   |N|
02129836000116|BA|47230068|1           |        |1184728|06/01/26 |0001184728-2|03/02/26|6.022,37|2.007,45 |30/12/1899|30/12/1899|0,00   |N|
02129836000116|BA|47230068|1           |        |1184728|06/01/26 |0001184728-3|08/02/26|6.022,37|2.007,45 |30/12/1899|30/12/1899|0,00   |N|

Passo a passo (legado)

Abra a seção “Importar Faturas (LEGADO TXT/CSV | pipe)”.
Selecione o arquivo TXT/CSV (pipe) no campo de arquivo.
Se preferir, arraste e solte o arquivo na área de drop.
Preencha o CNPJ da filial (ou clique em Pegar da entrada XML/SPED).
(Opcional) Marque “Usar XML/SPED carregados para conferir” se já tiver processado XML/SPED.
Clique em Carregar / Importar.
Confira o preview de notas/parcelas e as inconsistências.
Revise a grid e exporte normalmente.

Regras de agrupamento

Cada linha é uma parcela (duplicata). As parcelas são agrupadas por: CNPJ_EMITENTE + SERIE_NF + NF_NUM + DT_ESCRIT.

Conferência opcional com XML/SPED

Se houver XML processado, a ferramenta compara total e vencimentos por NF.
Se houver SPED processado, tenta conferir número + série + CNPJ e a data de escrituração.
As divergências geram avisos, mas não bloqueiam a geração.

Alertas e divergências (como interpretar)

Linhas inválidas: CNPJ/datas/valores fora do padrão são ignorados.
Valores divergentes: diferença entre total do legado e XML/SPED.
Vencimentos divergentes: datas de parcelas diferentes do XML.

Dicas de formatação

Datas: dd/mm/aa ou dd/mm/aaaa (ex: 06/01/26 = 2026-01-06).
Valores: aceita 6.022,37, 6022,37 ou 6022.37.
Pipes finais: são aceitos e tratados como coluna vazia.
CNPJ: somente números e exatamente 14 dígitos.
CNPJ da filial: usado para preencher a coluna CNPJFILIAL nas duplicatas.

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)

6.8 “Considerar IE do SPED como padrão (registro 0150)”

usa o SPED 0150 para ajustar a IE do terceiro.
se desmarcado, só substitui quando a IE do XML está vazia ou com quantidade de dígitos diferente.

6.9 “Incluir faturas no SPED (C140/C141) ao exportar SPED”

habilita a geração dos registros C140/C141 no SPED atualizado.
sem esta opção, a exportação SPED é bloqueada por segurança.

6.10 “Recriar C140/C141 se já existir (substituir)”

remove os C140/C141 existentes no SPED e recria com base nas duplicatas.
use quando o SPED do período já possui parcelas, mas você precisa atualizar.

6.11 “Modo de parcelas / Regras por fornecedor”

Respeitar XML: mantém o parcelamento conforme cobr/dup.
Forçar geral: aplica a quantidade definida em “Qtd. parcelas (geral)”.
Forçar por fornecedor: usa a lista CNPJ=NUM_PARC para definir parcelas por fornecedor.

6.12 “Intervalo padrão / Dias por parcela”

Intervalo padrão define a distância entre parcelas quando o XML não traz vencimentos.
Dias por parcela permite uma sequência específica (ex.: 30,45,60).

6.13 “Multi-SPED” e “Consolidação interna por NF-e”

Atualizar individual: gera um SPED atualizado por arquivo carregado.
Consolidar: só consolida quando CNPJ/IE/UF/DT_INI/DT_FIN são compatíveis.
Misto: gera o individual + um consolidado (se compatível).
Consolidação interna por NF-e: controla como parcelas viram C141 por NF-e (não altera a grid).

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, CSV e SPED) — 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)

8.3 Exportar SPED Atualizado (C140/C141)

disponível apenas para Compra/Entrada
exige SPED carregado e XML processado
marque “Incluir faturas no SPED (C140/C141)” para habilitar a geração
se necessário, marque “Recriar C140/C141” para substituir registros existentes
use Multi-SPED para atualizar individualmente ou consolidar (quando compatível)

8.4 Ordem recomendada para exportar SPED atualizado

Confirme Contexto = Compra/Entrada.
Carregue XML + SPED do período.
Processar → confira SPED match/missing.
Marque Incluir faturas no SPED (e, se necessário, Recriar C140/C141).
Escolha Modo de parcelas e regras de vencimento.
Exportar SPED Atualizado (C140/C141).

8.5 Resultado gerado

Arquivo(s) _C140C141.txt por SPED atualizado.
Consolidado opcional quando o modo Consolidar é compatível.
Log detalha total de C100 e quantos foram atualizados/ignorados.

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 NFes
- SPED/ 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).