DEV Community

digbijoylabs
digbijoylabs

Posted on

Por que o COMP-3 do COBOL ainda derruba integrações com Pix e ISO 20022 (e uma ferramenta open-source)

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

  1. Conversão para float ou double: 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).
  2. Ponto decimal implícito (V): o V no PIC S9(5)V99 nã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.
  3. Interpretação incorreta do nibble de sinal: tratar 0xD como positivo ou falhar ao ler 0xF gera 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:

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)