Realizando a consulta de um boleto

Para realizar a consulta de um boleto é necessário informar um ou mais IdIntegracao dentro da função _ConsultarList := spdBoleto.Consultar(txtIdIntegracao.Text);" sendo possível consultar até 1000 boletos separados por vírgula ",".

A consulta possui um retorno tipado, onde podemos capturar algumas informações do boleto em forma de objetos, ficando mais simples para realizar tratamentos.

Caso a SITUACAO no retorno desta consulta venha diferente de SALVO, FALHA ou REJEITADO, o boleto está apto para ser impresso, exportado para PDF e/ou gerado na remessa.

 

 

Método

 

O método FBoletoX.Consultar possui apenas um parâmetro no formato WideString, nele deve ser informado o IdIntegracao do boleto que deseja consultar (Para consultar mais de um boleto basta separar os Idintegracao por vírgula).

 

 

Clique aqui para visualizar a definição de todos os campos que são disponibilizados no método de consulta.

 

Abaixo, segue um exemplo implementado de como consultar um boleto para as seguintes linguagens.

 

 Exemplos

 

 Exemplo de retorno:

 

 

Exemplo de retorno com erro:

 

 

O que são movimentos e ocorrências?

Os movimentos nada mais são do que a mensagem encaminhada pelo banco sobre um determinado boleto, com uma própria movimentação do título, como por exemplo.

O Boleto encontrava-se como EMITIDO e o status foi alterado para REGISTRADO, desta forma nos movimentos do título irá constar:

MOVIMENTOS:
Movimento Código: 02
Movimento Mensagem: Movimento: Entrada Confirmada
Movimento Data: 30/08/2021 00:00:00
Movimento Taxa: 1,59
OCORRÊNCIAS:
    Ocorrências Código: 76
    Ocorrências Mensagem: Pagador Eletrônico DDA- PRe motivo somente será disponibilizado no arquivo retorno para as empresas cadastradas nessa condição

Onde "02" seria referente ao código de movimento de entrada confirmada.

Porém ao verificarmos, dentro de um movimento consta uma ocorrência, que neste caso acabou sendo o código "76". Atualmente  nem todos os bancos acatam os mesmos códigos disponibilizados pela Febraban, pois os mesmos podem possuir alguns códigos disponibilizados particularmente pelo próprio banco.

Simplificando:

O Movimento é uma mensagem de mudança ou como próprio nome já diz, "Movimento" de algo do boleto (Registro, Alteração acatada ou rejeitada, Liquidação), enquanto a ocorrência deve-se ao motivo do mesmo.

Mas e quando ao consultar o boleto, não consta o código de ocorrência?

Conforme citamos acima, alguns bancos não possuem os mesmos códigos disponibilizados pela Febraban, portanto caso o banco tenha disponibilizado o arquivo de retorno onde consta uma ocorrência, porém a mesma acabou não sendo apresentada ao consultar o boleto, basta nos informar através dos canais de atendimento pois provavelmente o banco acabou atualizando o manual, e com isso iremos atualizar nossa aplicação.

Delphi

 

 

Clique aqui para baixar um exemplo completo.

Clique aqui para visualizar um exemplo completo.

 

C#

 

 

Clique aqui para baixar um exemplo completo.

Clique aqui para visualizar um exemplo completo.

 

Visual Basic 6

 

 

Clique aqui para baixar um exemplo completo.

Clique aqui para visualizar um exemplo completo.

 

Fox Pro

 

 

Clique aqui para baixar um exemplo completo.

Clique aqui para visualizar um exemplo completo.

 

Ao consultar o IdIntegracao, se a situação do boleto for retornada como EMITIDO, podemos seguir o fluxo de emissão, e ir para o próximo passo, onde realizaremos a impressão ou a geração do PDF.