1

Pitch: Fiz um visualizador de arquivo CNAB 240 que roda 100% no navegador

Quem já precisou debugar integração bancária (boleto, remessa/retorno) conhece a dor: abrir um arquivo CNAB 240 no editor e ficar contando caractere na régua pra achar onde começa o "nosso número", o vencimento, o segmento P... Cada linha tem 240 posições fixas e, pra piorar, cada banco tem a sua variação.

Cansei disso e fiz uma ferramenta que faz o parsing e mostra os campos de forma legível:

https://utilpedia.com.br/visualizador-cnab-240

Como funciona

Você cola o conteúdo (ou abre o .rem/.ret) e ela:

  • detecta o banco (posições 1-3), a direção (remessa/retorno via posição 143 do header), o tipo de registro (posição 8) e o segmento (posição 14);
  • quebra cada linha em campos com posição + valor, identificando header de arquivo/lote, segmentos P/Q/R, trailers, etc.

Suporta os layouts de cobrança de Itaú, Bradesco, Banco do Brasil, Santander e Caixa.

Detalhes técnicos que talvez interessem

  • É 100% client-side (Next.js + parser em TypeScript). O arquivo não sai do navegador — nada é enviado pra servidor. Pra dados bancários, isso importa.
  • Os mapas de campo por banco eu não transcrevi na mão (seria fonte infinita de erro): gerei automaticamente a partir dos YAMLs do projeto open-source glauberportella/cnab-layouts (que transcreve os manuais oficiais dos bancos). Validei a integridade (campos contíguos de 1 a 240 nos registros-núcleo) e testei contra um arquivo de exemplo.

Limitações honestas (é um v1)

Cobre o layout de cobrança padrão; variações específicas de convênio podem divergir. Ainda não faz conversão remessa→retorno nem CNAB 400 — são os próximos passos.

Se alguém que mexe com isso puder testar e dar feedback (bug, banco faltando, campo em posição errada), agradeço demais.


Bônus, já que é assunto do momento: como a Receita vai adotar o CNPJ alfanumérico (com letras) em 2026, fiz também um gerador e validador do novo formato, com o dígito verificador calculado certinho (validei contra o exemplo oficial do Serpro): https://utilpedia.com.br/gerador-validador-cnpj-alfanumerico

Carregando publicação patrocinada...