Unit ACBrBoletoW_Asaas com a consulta tpConsultaDetalhe apontando para URL errada

[João Vitor Bogo]

Bom dia, eu vi que já subiram a unit do Asaas e fui fazer uns testes, atualmente estão montando a URL do tpConsultaDetalhada assim: 

Porém esse 'billinginfo' não retorna quase informação nenhuma do boleto:

Fazendo que quando passa pela classe de retorno a function TRetornoEnvio_Asaas.LerListaRetorno não consiga ler nenhuma informação como Valor, Estado do Título, etc... 

Acredito que a URL deva ser montada assim:

 

Pois faz com que o retorno seja assim:

A URL sendo montada com a  'billinginfo' é para consulta das informações de pagamento, não sobre os dados do boleto em si.

Ainda ficará faltando 1 ponto da unit (pois acredito que ela não está finalizada), que é agora sim sobre o retorno das informações do PIX, que deverão ser salvas nas tags  ARetornoWS.DadosRet.TituloRet.UrlPix, ARetornoWS.DadosRet.TituloRet.EMV e ARetornoWS.DadosRet.TituloRet.TxId (caso se aplique)

Segue unit com a alteração

ACBrBoletoW_Asaas.pas

 

Se puderem dar uma olhada e já validar, eu agradeço, também estou a disposição se precisarem de alguma conta em produção/sandbox para realizar os testes

Editado 11 Novembro, 2025 por João Vitor Bogo

[João Vitor Bogo]

Só um comentário, para funcionar (igual estava antes) a consulta do QR Code, eu adicionei temporariamente essa função dentro da unit de retorno (e chamei dentro da consulta detalhe):

Ela foge do padrão até então escrito, mas fiz o que era necessário para não quebrar os clientes que estão rodando, acredito que também seja necessário implementar algo parecido

[João Vitor Bogo]

Tive que fazer mais alterações, agora relacionado ao 'valorpago' que estava analisando outro campo, em vez do que realmente foi pago, segue a unit completa (com a alteração correta na leitura do json e com a procedure temporária para consultar o QRCode  ACBrBoletoRet_Asaas.pas

[Victor H. Gonzales - Panda]

21 horas atrás, João Vitor Bogo disse:

Bom dia, eu vi que já subiram a unit do Asaas e fui fazer uns testes, atualmente estão montando a URL do tpConsultaDetalhada assim: 

Porém esse 'billinginfo' não retorna quase informação nenhuma do boleto:

Fazendo que quando passa pela classe de retorno a function TRetornoEnvio_Asaas.LerListaRetorno não consiga ler nenhuma informação como Valor, Estado do Título, etc... 

Acredito que a URL deva ser montada assim:

 

Pois faz com que o retorno seja assim:

A URL sendo montada com a  'billinginfo' é para consulta das informações de pagamento, não sobre os dados do boleto em si.

Ainda ficará faltando 1 ponto da unit (pois acredito que ela não está finalizada), que é agora sim sobre o retorno das informações do PIX, que deverão ser salvas nas tags  ARetornoWS.DadosRet.TituloRet.UrlPix, ARetornoWS.DadosRet.TituloRet.EMV e ARetornoWS.DadosRet.TituloRet.TxId (caso se aplique)

Segue unit com a alteração

ACBrBoletoW_Asaas.pas 16.08 kB · 0 downloads

 

Se puderem dar uma olhada e já validar, eu agradeço, também estou a disposição se precisarem de alguma conta em produção/sandbox para realizar os testes

bom dia, onde está na documentação essa consulta? pode informar o link?

[João Vitor Bogo]

16 minutos atrás, Victor H. Gonzales - Panda disse:

bom dia, onde está na documentação essa consulta? pode informar o link?

Bom dia, segue link https://docs.asaas.com/reference/recuperar-uma-unica-cobranca

Editado 12 Novembro, 2025 por João Vitor Bogo

[João Vitor Bogo]

Boa tarde, só queria adicionar um comentário à respeito da consulta detalhe da unit de retorno

Atualmente, só existe no 'tpCancelar' tratando a informação se o título foi 'deleted' ou não.

Isso também deve ser analisado no 'tpConsultaDetalhe' pois essa informação também vem no JSON de retorno (pois o cliente pode fazer isso direto pelo banco)

Editado 13 Novembro, 2025 por João Vitor Bogo

[DevSR]

Bom dia,

Fui quem fez a implementação. Baseada na necessidade e tambem alguns detalhes pra ficar para a comunidade. Faltava realmente alguns datalhes mas que pela urgencia não tinha sido implementado e alguns Endpoint não testado por completos para ser feitos posteriomente. Se o amigo João Vitor Bogo ajudar tbm eh bom.

Só teve uma alteração que nao entendi aqui nos arquivos que foi a Propriedade ID no ACBrTitulo que não tem mais e ela a gente usava aqui pra acessar os endpoints de consulta de cada boleto gerado. Alterou o nome ou tirou? como ficou 

[Renato Rubinho]

5 horas atrás, DevSR disse:

Só teve uma alteração que nao entendi aqui nos arquivos que foi a Propriedade ID no ACBrTitulo que não tem mais e ela a gente usava aqui pra acessar os endpoints de consulta de cada boleto gerado. Alterou o nome ou tirou? como ficou

O ID está sendo retornado em ARetornoWS.DadosRet.TituloRet.NossoNumeroCorrespondente

function TRetornoEnvio_Asaas.LerRetorno(const ARetornoWS: TACBrBoletoRetornoWS): Boolean;
.
.
.

if (ARetornoWS.ListaRejeicao.Count = 0) then
        begin
          case TipoOperacao of
            tpInclui,
            tpAltera :
              begin
                ARetornoWS.DadosRet.TituloRet.SeuNumero   := LJson.AsString['externalReference'];
                ARetornoWS.DadosRet.IDBoleto.IDBoleto     := LJson.AsString['id'];
                ARetornoWS.DadosRet.TituloRet.NossoNumeroCorrespondente := LJson.AsString['id'];
               

 

[Victor H. Gonzales - Panda]

teve várias mudanças no commit Completed: At revision: 43078  

[DevSR]

Como vejo essa  At revision: 43078  ? Pode colocar um link ? perdoe a ignorancia sou novo aqui

 

Editado 24 Novembro, 2025 por DevSR

[Victor H. Gonzales - Panda]

11 minutos atrás, DevSR disse:

Como vejo essa  At revision: 43078  ? Pode colocar um link ? perdoe a ignorancia sou novo aqui

 

só atualizar o componente pela ultima versão do SVN, que já contempla, depois reinstalar o componente

[João Vitor Bogo]

Bom dia, já vou atualizar os fontes para fazer os testes, mas já adianto que pelas modificações que eu vi, ainda não foi postado nada referente ao seguinte bloco que eu comentei sobre a instrução 'deleted' que vem no JSON de consulta detalhe

Em 13/11/2025 at 14:54, João Vitor Bogo disse:

Boa tarde, só queria adicionar um comentário à respeito da consulta detalhe da unit de retorno

Atualmente, só existe no 'tpCancelar' tratando a informação se o título foi 'deleted' ou não.

Isso também deve ser analisado no 'tpConsultaDetalhe' pois essa informação também vem no JSON de retorno (pois o cliente pode fazer isso direto pelo banco)

 

Outro detalhe, ao consultar um título, a informação referente ao campo 'ValorPago' está incorreta (no meu ponto de vista), está pegando o 'originalValue', que na teoria é o valor original do título quando foi enviado ao banco, ao invés do que foi realmente pago (que deveria ser o netValue)

 

Vou agora atualizar os componentes e realizar mais alguns testes, volto no final da tarde caso tenha mais alguma coisa pra adicionar 

[João Vitor Bogo]

Outro detalhe que encontramos foi que, a unit ACBrBancoAsaas, estava com o tamanho máximo da conta com 6 digitos, porém a nossa própria conta bancária aqui da empresa possui 7 dígitos, então foi necessário fazer uma alteração tanto na unit de 6 para 7 no tamanho da conta, e também de '12' para '11' a quantidade de zeros na função 'DefineCampoLivreCodigoBarras'

Segue anexo com a alteração ACBrBancoAsaas.pas

[Renato Rubinho]

1 hora atrás, João Vitor Bogo disse:

e também de '12' para '11' a quantidade de zeros na função 'DefineCampoLivreCodigoBarras'

Qual o motivo de mudar o Campo Livre se a conta não faz parte da composição dele?

Para análise, por favor envie por mensagem privada ou para [email protected]:
* PDF do Boleto emitido em produção
* JSON da consultaPIX, trazendo o código de barras e linha digitável
* JSON da consultaDetalhe, trazendo todos os dados do título

[João Vitor Bogo]

38 minutos atrás, Renato Rubinho disse:

Qual o motivo de mudar o Campo Livre se a conta não faz parte da composição dele?

Para análise, por favor envie por mensagem privada ou para [email protected]:
* PDF do Boleto emitido em produção
* JSON da consultaPIX, trazendo o código de barras e linha digitável
* JSON da consultaDetalhe, trazendo todos os dados do título

por quê foi dessa maneira que bateu com o código de barras que foi gerado pelo proprio Asaas, vou encaminhar os detalhes em privado

[Renato Rubinho]

Foram enviadas correções ao SVN que devem resolver o problema relatado, Rev-43208
Por favor atualize os fontes, reinstale os componentes, verifique se o problema foi resolvido e, se possível, nos informe se foi o resultado esperado.

1. "netValue" aparentemente é o valor recebido pelo correntista, não necessariamente o valor líquido pago.
* Este valor está sendo atribuído à propriedade ValorRecebido 
* Para o ValorPago, considerada chave "value" 
* Para o ValorDocumento, considerada chave "value" quando "originalValue" não possuir valor
* A documentação não deixa claro a que se refere cada chave, caso restem dúvidas, favor questionar o banco e informar o posicionamento oficial deles caso ainda sejam necessários ajustes em algum dos campos

2. "deleted"
* Quando houver a marcação do título excluído, será considerado como cancelado

3. Campo livre
* O problema era o nosso número que foi previsto com tamanho máximo de 8 dígitos e o seu possui 9.
* Corrigida geração do campo livre para considerar o tamanho máximo do nosso número.
 

[DevSR]

6 hours ago, João Vitor Bogo said:

analisando os valores recebidos eu só esse valor que vinha no pagamento. o netValue pelo que vi na doc era quando tinha juros e/ou multa que ele alterava valor.. então me pela a analise do resultado o valor pago tava nesse campo. 

[Renato Rubinho]

57 minutos atrás, DevSR disse:

então me pela a analise do resultado o valor pago tava nesse campo. 

Em testes pelo Sandbox, esse valor retornou descontando "taxa de boleto", podendo ser analisado no extrato da conta, sendo assim o valor líquido a entrar na conta, não necessariamente o valor pago no boleto.

[João Vitor Bogo]

1 hora atrás, Renato Rubinho disse:

Foram enviadas correções ao SVN que devem resolver o problema relatado, Rev-43208
Por favor atualize os fontes, reinstale os componentes, verifique se o problema foi resolvido e, se possível, nos informe se foi o resultado esperado.

1. "netValue" aparentemente é o valor recebido pelo correntista, não necessariamente o valor líquido pago.
* Este valor está sendo atribuído à propriedade ValorRecebido 
* Para o ValorPago, considerada chave "value" 
* Para o ValorDocumento, considerada chave "value" quando "originalValue" não possuir valor
* A documentação não deixa claro a que se refere cada chave, caso restem dúvidas, favor questionar o banco e informar o posicionamento oficial deles caso ainda sejam necessários ajustes em algum dos campos

2. "deleted"
* Quando houver a marcação do título excluído, será considerado como cancelado

3. Campo livre
* O problema era o nosso número que foi previsto com tamanho máximo de 8 dígitos e o seu possui 9.
* Corrigida geração do campo livre para considerar o tamanho máximo do nosso número.
 

Boa tarde, atualizei os fontes e agora pelo que eu testei aparentemente está tudo correto

[Renato Rubinho]

Obrigado por reportar.

Fechando. Para novas dúvidas, criar um novo tópico.