Bolecode Itau - Retorno da consulta as vezes não retorna QRCode / EMV

[Fabricio Furtado]

Olá.

Fiz uma implementação utilizando o ACBR Boleto e funciona perfeitamente em situações normais, quando o boleto é registrado e faço o processamento do retorno e insiro no banco de dados.

Hoje eu tive um problema, após registrar um boleto ocorreu uma falha e eu não consegui inserir o EMV no meu banco de dados.

Utilizei a  consulta detalhada para obter o EMV,  passando as informações obrigatórias e o nosso numero como parametro, a API retorna o codigo de barras e outras informações do boleto, mas não retorna o bloco "qrcode_pix".

Consultei alguns outros boletos pelo nosso numero e em alguns casos obtive o retorno do QRCode e outros não.

Alguem pode me ajudar? 
Existe alguma outra forma de obter o EMV posteriormente?

  FiltrosAPI := Boleto.Configuracoes.WebService.Filtro;
  FiltrosAPI.Clear;
  FiltrosAPI.indicadorSituacao := isbNenhum;
  FiltrosAPI.indiceContinuidade := 0;

  Boleto.Configuracoes.WebService.Operacao := tpConsultaDetalhe;

  Titulo := Boleto.CriarTituloNaLista;
  Titulo.carteira := '109';
  Titulo.NossoNumero := nossoNumero;
  Boleto.Cedente.Agencia := '0000';
  Boleto.Cedente.Conta := '00000';
  Boleto.Cedente.ContaDigito := '0';

  Boleto.Enviar;

 

"qrcode_pix" : {
  "imagem_base64" : "...",
  "emv" : "..."
}

 

[Juliomar Marchetti]

Nestes casos só ocorre se o boleto não foi registrado como bolecode ou seja boleto hibrido.
pegou o log detalhado do componente para verificar?

[Fabricio Furtado]

Eu peguei o EMV no log, a API retornou ele no cadastro como acontece sempre, testei no banco e funcionou corretamente.
Mostrou o valor, codigo de barras e demais informações, mas a consulta detalhada não retorna, eu queria entender se é alguma falha na API.


 

[Juliomar Marchetti]

34 minutos atrás, Fabricio Furtado disse:

Eu peguei o EMV no log, a API retornou ele no cadastro como acontece sempre, testei no banco e funcionou corretamente.
Mostrou o valor, codigo de barras e demais informações, mas a consulta detalhada não retorna, eu queria entender se é alguma falha na API.


 

Eu posso estar enganado mas pode ser algo que está enviando errado em algum para esses titulos e dai não está conseguindo registrar correto e ao consultar ele não busca

[Fabricio Furtado]

Aparentemente o registro do titulo foi feito corretamente, consigo pagar pelo codigo de barras e QR, quando uso o QR, na tela de pagamento (Aplicativo BB) aparecem todos os dados do boleto quando clico em Mais informações (Codigo de barras, linha digitavel, nosso numero, mensagens...).

Existe um link entre o QR e o boleto, isso leva a crer que o registro foi correto e que se existir algum problema ele provavelmente é algum erro meu nos parametros da consulta ou na consulta da API do banco.

Segue o log, eu adicionei da inclusão e da consulta.
 

10/07/25 17:15:58:698 -03:00 - Comando Enviar: TBoletoW_Itau_API
10/07/25 17:15:58:705 -03:00 - Comando Enviar: {"etapa_processo_boleto":"efetivacao","beneficiario":{"id_beneficiario":"<BENEFICIARIO>"},"dado_boleto":{"descricao_instrumento_cobranca":"boleto_pix","tipo_boleto":"a vista","codigo_carteira":109,"valor_total_titulo":"00000000000123456","codigo_especie":"01","valor_abatimento":"00000000000000000","data_emissao":"2025-12-10","indicador_pagamento_parcial":true,"quantidade_maximo_parcial":1,"desconto_expresso":"False","pagador":{"pessoa":{"nome_pessoa":"NOME CLIENTE","tipo_pessoa":{"codigo_tipo_pessoa":"J","numero_cadastro_nacional_pessoa_juridica":"<CNPJ_CLIENTE>"}},"endereco":{"nome_logradouro":"LOGRADOURO ","nome_bairro":"","nome_cidade":"CIDADE","sigla_UF":"UF","numero_CEP":"32123123"}},"dados_individuais_boleto":[{"numero_nosso_numero":"<NOSSO_NUMERO>","data_vencimento":"2025-12-09","valor_titulo":"00000000000012345","texto_uso_beneficiario":"0","texto_seu_numero":"<NOSSO_NUMERO>","data_limite_pagamento":"2025-12-18"}],"multa":{"codigo_tipo_multa":"03"},"juros":{"codigo_tipo_juros":"93","quantidade_dias_juros":-45878,"valor_juros":"00000000000000379"},"recebimento_divergente":{"codigo_tipo_autorizacao":"03","codigo_tipo_recebimento":"P"}},"dados_qrcode":{"chave":"<CNPJ>"}}
10/07/25 17:15:58:712 -03:00 - URL: [POST] https://secure.api.itau/pix_recebimentos_conciliacoes/v2/boletos_pix
10/07/25 17:15:58:719 -03:00 - Header:
Authorization: Bearer 
x-itau-apikey: 
x-itau-correlationID: 

10/07/25 17:16:00:171 -03:00 - Retorno Envio: TBoletoW_Itau_API
10/07/25 17:16:00:171 -03:00 - Código do Envio: 200 1.1 OK
10/07/25 17:16:00:186 -03:00 - Retorno Envio: {
  "data" : {
    "codigo_canal_operacao" : "API",
    "codigo_operador" : "<AGENCIA_CONTA>",
    "etapa_processo_boleto" : "efetivacao",
    "beneficiario" : {
      "id_beneficiario" : "<BENEFICIARIO>",
      "nome_cobranca" : "<NOME>",
      "tipo_pessoa" : {
        "codigo_tipo_pessoa" : "J",
        "numero_cadastro_nacional_pessoa_juridica" : "<CNPJ>"
      },
      "endereco" : {
        "nome_logradouro" : "LOGRADOURO",
        "nome_bairro" : "BAIRRO",
        "nome_cidade" : "CIDADE",
        "sigla_UF" : "UF",
        "numero_CEP" : "32123123",
        "numero" : "123",
        "complemento" : ""
      }
    },
    "dado_boleto" : {
      "descricao_instrumento_cobranca" : "boleto_pix",
      "tipo_boleto" : "a vista",
      "valor_abatimento" : "00000000000000000",
      "codigo_carteira" : "109",
      "valor_total_titulo" : "00000000000123456",
      "codigo_especie" : "01",
      "data_emissao" : "2025-12-10",
      "pagador" : {
        "pessoa" : {
          "nome_pessoa" : "NOME CLIENTE",
          "tipo_pessoa" : {
            "codigo_tipo_pessoa" : "J",
            "numero_cadastro_nacional_pessoa_juridica" : "<CNPJ_CLIENTE>"
          }
        },
        "endereco" : {
          "nome_logradouro" : "LOGRADOURO",
          "nome_bairro" : "",
          "nome_cidade" : "CIDADE",
          "sigla_UF" : "UF",
          "numero_CEP" : "32123123"
        },
        "pagador_eletronico_DDA" : false,
        "praca_protesto" : false
      },
      "dados_individuais_boleto" : [ {
        "id_boleto_individual" : "ID BOLETO",
        "numero_nosso_numero" : "<NOSSO_NUMERO>",
        "dac_titulo" : "9",
        "data_vencimento" : "2025-12-09",
        "valor_titulo" : "00000000000012345",
        "texto_seu_numero" : "<NOSSO_NUMERO>",
        "codigo_barras" : "<CODIGO_BARRAS>",
        "numero_linha_digitavel" : "<LINHA_DIGITAVEL>",
        "data_limite_pagamento" : "2025-12-18",
        "lista_mensagens_cobranca" : [ {
          "mensagem" : "APÓS 1 DIA(S) CORRIDO(S) DO VENCIMENTO COBRAR JUROS DE......... R$3,79 AO DIA"
        } ],
        "texto_uso_beneficiario" : "0"
      } ],
      "codigo_tipo_vencimento" : 3,
      "data_limite_pagamento" : "2025-12-18",
      "pagamento_parcial" : false,
      "quantidade_maximo_parcial" : "0",
      "recebimento_divergente" : {
        "codigo_tipo_autorizacao" : "03",
        "codigo_tipo_recebimento" : "P"
      },
      "desconto_expresso" : false,
      "juros" : {
        "data_juros" : "2025-12-10",
        "codigo_tipo_juros" : "01",
        "valor_juros" : "00000000000000379",
        "percentual_juros" : "00000000000800010"
      },
      "multa" : {
        "data_multa" : "2025-12-10",
        "codigo_tipo_multa" : "03"
      }
    },
    "dados_qrcode" : {
      "chave" : "<CNPJ>",
      "emv" : "EMV_RETORNADO",
      "base64" : "BASE_64_RETORNADO",
      "txid" : "TXID__RETORNADO",
      "id_location" : "RETORNO...",
      "location" : "api.itau/pix/qr/v2/",
      "tipo_cobranca" : "cob"
    }
  }
}








11/07/25 17:23:29:140 -03:00 - Comando Enviar: TBoletoW_Itau_API
11/07/25 17:23:29:148 -03:00 - Comando Enviar: 
11/07/25 17:23:29:156 -03:00 - URL: [GET] https://secure.api.cloud.itau.com.br/boletoscash/v2/boletos?id_beneficiario=<BENEFICIARIO>&codigo_carteira=109&nosso_numero=<NOSSO_NUMERO>&view=specific
11/07/25 17:23:29:162 -03:00 - Header:
Authorization: Bearer 
x-itau-apikey: 
x-itau-correlationID: 

11/07/25 17:23:29:477 -03:00 - Retorno Envio: TBoletoW_Itau_API
11/07/25 17:23:29:478 -03:00 - Código do Envio: 200 1.1 OK
11/07/25 17:23:29:498 -03:00 - Retorno Envio: {
  "data" : [
    {
      "id_boleto" : "",
      "beneficiario" : {
        "id_beneficiario" : "<BENEFICIARIO>",
        "nome_cobranca" : "NOME",
        "tipo_pessoa" : {
          "codigo_tipo_pessoa" : "J",
          "numero_cadastro_nacional_pessoa_juridica" : "00000000000000"
        },
        "endereco" : {
          "nome_logradouro" : "RUA X, 999",
          "nome_bairro" : "BAIRRO",
          "nome_cidade" : "CIDADE",
          "sigla_UF" : "UF",
          "numero_CEP" : "32123123"
        }
      },
      "dado_boleto" : {
        "descricao_instrumento_cobranca" : "BoleCode",
        "forma_envio" : "impressão",
        "tipo_boleto" : "a vista",
        "quantidade_parcelas" : 0,
        "pagador" : {
          "pessoa" : {
            "nome_pessoa" : "<NOME_CLIENTE>",
            "tipo_pessoa" : {
              "codigo_tipo_pessoa" : "J",
              "numero_cadastro_nacional_pessoa_juridica" : "<CNPJ_CLIENTE>"
            }
          },
          "endereco" : {
            "nome_logradouro" : "Nome Cliente",
            "nome_cidade" : "Cidade",
            "sigla_UF" : "UF",
            "numero_CEP" : "32123123"
          },
          "pagador_eletronico_DDA" : false,
          "praca_protesto" : false
        },
        "codigo_carteira" : "109",
        "dados_individuais_boleto" : [
          {
            "situacao_geral_boleto" : "Em Aberto",
            "status_vencimento" : "A vencer",
            "numero_nosso_numero" : "<NOSSO_NUMERO>",
            "data_vencimento" : "2025-12-12",
            "valor_titulo" : "1234.56",
            "texto_seu_numero" : "<NOSSO_NUMERO>",
            "dac_titulo" : 9,
            "codigo_barras" : "<CODIGO_BARRAS>",
            "numero_linha_digitavel" : "<LINHA_DIGITAVEL>",
            "data_limite_pagamento" : "2025-12-31",
            "mensagens_cobranca" : [
              {
                "mensagem" : "APÓS 1 DIA(S) CORRIDO(S) DO VENCIMENTO COBRAR JUROS DE......... R$3,79 AO DIA"
              }
            ]
          }
        ],
        "codigo_especie" : "01",
        "descricao_especie" : "DM - Duplicata Mercantil",
        "codigo_aceite" : "S",
        "data_emissao" : "2025-12-10",
        "pagamento_parcial" : false,
        "quantidade_maximo_parcial" : 0,
        "juros" : {
          "codigo_tipo_juros" : "01",
          "quantidade_dias_juros" : 1,
          "valor_juros" : "0000000000003.79",
          "percentual_juros" : "0000008.00010"
        },
        "negativacao" : { },
        "codigo_tipo_vencimento" : 3,
        "texto_uso_beneficiario" : "0",
        "historico" : [
          {
            "data" : "2025-12-10",
            "operacao" : "ENTRADA TITULO",
            "comandado_por" : "<AGENCIA_CONTA>",
            "canal_origem" : "API",
            "descricao_canal_origem" : "API"
          }
        ],
        "recebimento_divergente" : {
          "codigo_tipo_autorizacao" : "03",
          "codigo_tipo_recebimento" : "P",
          "valor_minimo" : "0.00",
          "percentual_minimo" : "0.00000",
          "valor_maximo" : "0.00",
          "percentual_maximo" : "0.00000"
        },
        "indicador_bloqueio" : "N",
        "indicador_descontado" : false
      },
      "acoes_permitidas" : {
        "emitir_segunda_via" : true,
        "comandar_instrucao_alterar_dados_cobranca" : true
      }
    }
  ],
  "page" : {
    "links" : {
      "first" : "/prod/boletoscash/v2/boletos?codigo_carteira=109&id_beneficiario=<BENEFICIARIO>&nosso_numero=<NOSSO_NUMERO>&view=specific&page_size=20&page=0&order_by=data_vencimento&order=ASC",
      "last" : "/prod/boletoscash/v2/boletos?codigo_carteira=109&id_beneficiario=<BENEFICIARIO>&nosso_numero=<NOSSO_NUMERO>&view=specific&page_size=20&page=0&order_by=data_vencimento&order=ASC",
      "previous" : "/prod/boletoscash/v2/boletos?codigo_carteira=109&id_beneficiario=<BENEFICIARIO>&nosso_numero=<NOSSO_NUMERO>&view=specific&page_size=20&page=0&order_by=data_vencimento&order=ASC",
      "next" : "/prod/boletoscash/v2/boletos?codigo_carteira=109&id_beneficiario=<BENEFICIARIO>&nosso_numero=<NOSSO_NUMERO>&view=specific&page_size=20&page=0&order_by=data_vencimento&order=ASC"
    },
    "page" : 0,
    "total_pages" : 0,
    "total_elements" : 1,
    "page_size" : 20
  }
}
11/07/25 17:23:29:517 -03:00 - Cookies:
11/07/25 17:23:29:544 -03:00 - 
11/07/25 17:23:29:557 -03:00 - CERT.crt
11/07/25 17:23:29:570 -03:00 - CHAVE.key
11/07/25 17:23:29:579 -03:00 - Header:
11/07/25 17:23:29:586 -03:00 - HTTP/1.1 200 OK
x-amzn-RequestId: 
x-amzn-Remapped-x-amzn-RequestId: 
x-xss-protection: 1; mode=block
x-itau-correlationid: 
x-amzn-Remapped-Content-Length: 4396
x-frame-options: SAMEORIGIN
content-security-policy: script-src 'self';
x-amzn-Remapped-x-amzn-Remapped-Date: Fri, 11 Jul 2025 20:23:30 GMT
x-amzn-Remapped-Connection: keep-alive
x-amz-apigw-id: 
vary: Origin
vary: Access-Control-Request-Method
vary: Access-Control-Request-Headers
x-amzn-Remapped-Server: Server
x-content-type-options: nosniff
x-amzn-Remapped-x-amzn-Remapped-Content-Length: 4396
X-Amzn-Trace-Id: Root=
x-amzn-Remapped-x-amzn-Remapped-Connection: keep-alive
x-amzn-Remapped-Date: Fri, 11 Jul 2025 20:23:30 GMT
x-itau-apikey: 
content-type: application/json;charset=UTF-8
content-length: 4396
date: Fri, 11 Jul 2025 20:23:30 GMT

 

Editado 11 Julho, 2025 por Fabricio Furtado

[Fabricio Furtado]

Alguem já passou pelo mesmo problema?

 

[Juliomar Marchetti]

eu não cheguei a pesquisar aqui antes de tentar lhe ajudar mas chegou a validar e ver nos tópicos se não houve o mesmo problema com alguém?

[Fabricio Furtado]

Pesquisei, mas vou continuar pesquisando.
Tambem vou verificar com o suporte do Itau.

[SISBLU Software]

Boa tarde, tudo bem?

[SISBLU Software]

Boa tarde, tudo bem?

Estou com o mesmo problema, mesmo ao ENVIAR e dar certo o BOLETO com QRCODE, quando clico em CONSULTAR, o boleto não traz o QRCODE na CONSULTA.

Isso é um problema, pq as vezes o BOLETO é registrado, mas ná erro se tento enviar novamente. E se consulto não trás o QRCODE

Ao consultar trás as informações que preciso:

RetornoDetalhe.DadosRet.TituloRet.CodBarras

RetornoDetalhe.DadosRet.TituloRet.LinhaDig

RetornoDetalhe.DadosRet.IDBoleto.NossoNum

Esse não retorna: RetornoDetalhe.DadosRet.TituloRet.EMV 

[Juliomar Marchetti]

Está usando a consulta detalhe?

[Fabricio Furtado]

10 horas atrás, SISBLU Software disse:

Boa tarde, tudo bem?

Estou com o mesmo problema, mesmo ao ENVIAR e dar certo o BOLETO com QRCODE, quando clico em CONSULTAR, o boleto não traz o QRCODE na CONSULTA.

Isso é um problema, pq as vezes o BOLETO é registrado, mas ná erro se tento enviar novamente. E se consulto não trás o QRCODE

Ao consultar trás as informações que preciso:

RetornoDetalhe.DadosRet.TituloRet.CodBarras

RetornoDetalhe.DadosRet.TituloRet.LinhaDig

RetornoDetalhe.DadosRet.IDBoleto.NossoNum

Esse não retorna: RetornoDetalhe.DadosRet.TituloRet.EMV 

No meu o envio também funciona normalmente e tem retornado todos emv, eles também estão nos nos logs do componente, isso que me salvou, pois no dia que implantei não consegui pegar o retorno, porque interrompi sem querer, fiz uma rotina para recuperar caso isso acontecesse, mas falhou.

Falhou e continua falhando ao tentar recuperar o EMV pela consulta detalhada, passando nosso número como parâmetro.

Eu espero que seja algum erro meu, porque eu tenho tido dificuldade para falar com o Itaú, o sistema de chamado deles é ruim.

Editado 9 Agosto, 2025 por Fabricio Furtado

[SISBLU Software]

Bom dia! Sim consulta DETALHADA.

Ao consultar o boleto mesmo que ele tenha EMV gerado ( quando faço a inclusão ).. Na consulta não trás o EMV.