Forum

Colegas membro do forum e em especial Pedro e Patricia.
MK-AUTH 26.02 :: TUX 6.12
 RAM: 66% CPU: 0% DISCO: 23%

Olá a todos,

Com apoio de ferramentas de IA, estou desenvolvendo um addon para gerar remessa e retorno de boletos do Itaú em CNAB 400 com suporte a BoleCode (PIX). O objetivo é habilitar o pagamento via PIX nos boletos, o que já está beneficiando nossos clientes.

O addon está funcionando parcialmente:

• ✅ Gera a remessa corretamente

• ✅ Processa o retorno

• ✅ Gera o QR Code PIX (BoleCode) e os clientes conseguem pagar por PIX

Porém, identificamos um bug que impede o funcionamento completo: o código de barras impresso no boleto pelo MK-Auth diverge do código de barras registrado pelo Itaú. Com isso, o cliente que tenta pagar pelo código de barras recebe a mensagem "boleto não registrado".

Como o problema está na geração do boleto (arquivo boleto.hhvm, que é compilado e não conseguimos alterar), precisamos da colaboração dos desenvolvedores do MK-Auth para uma correção definitiva.

📄 Solicitação técnica

Segue abaixo a solicitação técnica detalhada, elaborada com apoio de IA, para facilitar a análise de vocês.

Contexto

• Banco: Itaú

• Carteira: 109 (Direta - Emissão Beneficiário)

• Layout: CNAB 400 com BoleCode (PIX)

• Cadastro no MK-Auth:

  • Agência: 8694

  • Conta: 98405

  • DAC: 8

  • Carteira: 109

O que o MK-Auth grava no banco (correto)

Título 44353:

sis_lanc.nossonum = 109000443537  (12 dígitos)sis_lanc.linhadig = 34191.09008 04435.378692 49840.580002 1 15850000009056

Decomposição do nossonum:

• 109 = carteira

• 00044353 = ID do título (8 dígitos, ID puro com zeros)

• 7 = DAC

O que o Itaú registra (correto)

Código de barras do Itaú:

34191.09008 44353.728692 49840.580002 1 15850000009056            ^^^^^            Campo 2 do Itaú: 44353

O Itaú usa o ID do título puro (44353), não o nosso número do MK-Auth (04435).

O que o Itaú confirmou por telefone

1. Campo "Nosso Número" (063-070): "Apenas a numeração de 8 dígitos ID puro"

2. Campo 2 do código de barras (10-14 da linha digitável): "Nosso número sem o dígito verificador"

3. Base do código de barras: "Pega como base o restante do nosso número"

4. Campo "Uso da Empresa": "Dá para encaminhar alfanumérico"

O bug

Consequência: o cliente pega o boleto impresso pelo MK-Auth, tenta pagar pelo código de barras e o banco retorna "boleto não registrado". O pagamento só funciona via QR Code PIX.

O que já foi tentado

• ✅ Ajustamos o addon externo (remessa.php e lib/remessa_itau.php) para enviar o nosso número no formato correto (00044353 em vez de 00443537)

• ✅ Homologação no Itaú — remessa aceita

• ✅ PIX / BoleCode funcionando

• ❌ O boleto impresso pelo MK-Auth continua com o código de barras divergente

Onde está o problema

O arquivo boleto.hhvm é compilado (bytecode HHVM) e não conseguimos inspecionar nem alterar. Pela análise do comportamento:

1. O MK-Auth lê o nossonum do banco (109000443537)

2. Aplica uma regra interna para extrair o nosso número

3. Monta o campo 2 do código de barras com 04435

4. Mas o Itaú espera 44353 (ID puro do título)

Provável causa: o MK-Auth está usando o nosso número do banco (que tem o DAC no final) para compor o código de barras no CNAB 400 do Itaú, em vez do ID do título puro.

Comparação com o CNAB 240 Santander (que funciona)

No CNAB 240 do Santander, o MK-Auth envia:

Nosso Número (038-057): 37945  00000004328145Seu Número (063-072):   43281

O Santander usa um esquema próprio e o código de barras gerado pelo MK-Auth bate com o do banco.

Ou seja: no CNAB 240 o MK-Auth implementa corretamente para cada banco, mas no CNAB 400 do Itaú não.

Escopo da correção solicitada

Importante: solicitamos que a correção seja específica para o CNAB 400 do Itaú (carteira 109). O comportamento atual do CNAB 240 do Santander (e dos demais bancos) deve permanecer inalterado, pois está funcionando corretamente. Preferimos uma correção cirúrgica que não impacte outros fluxos.

Pedido

Solicitamos a correção do boleto.hhvm (ou do módulo de geração de boleto do Itaú) para que o campo 2 do código de barras seja gerado com o ID puro do título (44353), em vez do nosso número com DAC (04435).

Benefícios:

• ✅ Clientes poderão pagar pelo código de barras (não só por PIX)

• ✅ Boletos impressos pelo MK-Auth serão aceitos pelo Itaú

• ✅ Elimina a necessidade de enviar 2ª via do Itaú para cada cliente

Anexos

1. Arquivo de remessa CNAB 400 gerado pelo MK-Auth

2. Arquivo de remessa CNAB 400 gerado pelo addon (corrigido)

3. Comprovante de homologação do Itaú

4. PDF do boleto com o código de barras divergente

5. PDF do boleto do Itaú com o código de barras correto

🤝 Agradecimento

Conto com a colaboração de todos que puderem contribuir com ideias e, especialmente, com o Pedro e a Patrícia, para uma correção definitiva na aplicação, caso seja possível.

Qualquer dúvida ou necessidade de mais evidências, fico à disposição para enviar.

Muito obrigado pela atenção de todos!