Quem trabalha com engenharia de backend em bancos, adquirentes ou fintechs no Brasil conhece bem um contraste curioso: na ponta do cliente, o sistema liquida transações em segundos via Pix e troca mensagens estruturadas em XML/JSON no padrão ISO 20022; no núcleo contábil, porém, uma parcela enorme das instituições ainda processa saldos e lotes em mainframes COBOL.
O ponto de fratura mais silencioso nessa ponte não costuma ser a latência da API, e sim a tradução de dados binários — em especial o formato COMP-3 (Packed Decimal).
O que é o COMP-3 na prática?
Em vez de armazenar dígitos em ASCII/UTF-8 (1 byte por dígito) ou usar ponto flutuante IEEE 754 (que introduz erros de arredondamento inaceitáveis em centavos), o COBOL armazena dois dígitos decimais por byte — um em cada nibble (4 bits) — e reserva o último nibble do último byte para o sinal:
-
0xC: positivo -
0xD: negativo -
0xF: sem sinal (unsigned)
Por exemplo, o valor +12345.67 definido como PIC S9(5)V99 COMP-3 ocupa exatamente 4 bytes em disco ou na fila de mensageria: 12 34 56 7C (7 dígitos + 1 nibble de sinal).
Três bugs comuns em integrações Pix / ISO 20022
-
Conversão para
floatoudouble: qualquer passagem intermediária por ponto flutuante binário pode corromper frações de centavo na reconciliação de fim de dia. Use sempre precisão fixa (BigDecimal,Decimal, ou inteiros em centavos). -
Ponto decimal implícito (
V): oVnoPIC S9(5)V99não ocupa espaço em byte. Se o parser errar a escala implícita, R$ 100,00 viram R$ 10.000,00 ou R$ 1,00. -
Interpretação incorreta do nibble de sinal: tratar
0xDcomo positivo ou falhar ao ler0xFgera lançamentos invertidos que só aparecem no batimento contábil.
Ferramenta open-source para depurar direto no navegador
Na Digbijoy Labs construímos um inspetor open-source que roda 100% no navegador (sem backend e sem envio de dados) para codificar, decodificar e visualizar payloads COMP-3 nibble a nibble:
- Inspetor online (zero instalação): https://digbijoylabs.github.io/iron-silicon-bridge/
- Código-fonte no GitHub: https://github.com/digbijoylabs/iron-silicon-bridge
- Referência técnica aberta (CERN Zenodo DOI): https://doi.org/10.5281/zenodo.24243905
- Livro técnico (The Iron–Silicon Bridge): https://digbijoylabs.com/books/the-iron-silicon-bridge/
Para quem já trabalhou com modernização de legado ou integração de core bancário com Pix: qual foi o bug mais traiçoeiro de encoding ou paridade de dados que vocês enfrentaram?
Top comments (0)