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).
TspdBoletoX.Consultar(WideString)
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:
.:: Consultar Título ::.
Mensagem: Consulta realizada com sucesso
Status: SUCESSO
ITEM: 1
IdIntegracao: rkUpe6xN7
Situacao: EMITIDO
Motivo:
CEDENTE:
Agencia: 1234
AgenciaDV:
Código Banco: 341
Carteira: 109
Conta: 12345
DV da conta: 6
Numero Convênio: 1234123456
SACADO:
CPFCNPJ: 01001001000113
Nome: SACADO DE TESTE
Telefone: 4433333333
Celular: 440000000
Email: sacado@teste.com.br
Endereço Número: 716
Endereço Bairro: Jd Washington
Endereço CEP: 87020025
Endereço Cidade: Maringa
Endereço Complemento:
Endereço Logradouro: AV. BRASIL
Endereço País: BRASIL
Endereço UF: PR
TÍTULO:
TítuloInstrucao 1:
TítuloInstrucao 2:
Número Documento: 00015
Origem Documento:
Linha Digitável: 34191.09008 00205.471238 41234.510000 4 76070000000101
Código de Barras: 34194760700000001011090000205471234123451000
Código Emissão Bloqueto:
Titulo Aceite:
Avalista:
Doc Espécie: 06
Nosso Número: 2054
Código para baixa ou devolução:
Prazo para baixa ou devolução:
Data Emissão: 21/07/2018 00:00:00
Forçar Fator Vencimento: False
Data Vencimento: 05/08/2018 00:00:00
Código de Desconto:
Data Desconto:
Valor Desconto: 0
Código de Desconto2:
Outras Deducoes:
Data Desconto:
Valor Desconto: 0
Código de Juros:
Data Juros:
Valor Juros: 0
Prazo Protesto:
Instrucoes: Teste Instrucoes: Desconto de 5% ate 26/07/2018
Mensagem 1: Mensagem linha 1
Mensagem 2: Mensagem linha 2
Mensagem 3: Mensagem linha 3
Informacoes Adicionais: Teste inf.Adcionais: Numero NF: 0
Local Pagamento:
Parcela:
Variacao Carteira:
Categoria:
Modalidade:
Cip:
Ios "utilizado apenas pelo Santander":
Cod Cliente "exclusivo para os bancos HSBC e Safra":
Valor: 1,01
Pagamento Minimo: 0
Data Crédito:
Valor Cobrado: 0
Título Pago: 0
Valor Crédito: 0
Valor Outros Acréscimos: 0
Valor Pago: 0
Valor Taxa Cobrança: 0
Valor Abatimento: 0
Valor Outras Despesas: 0
Valor IOF: 0
Código Multa:
Valor Multa: 0
Valor Multa Taxa: 0
Data Multa:
Data Pagamento:
Valor Outros Créditos: 0
Pagamento Valor Desconto: 0
Pagamento Valor Acréscimos: 0
Pagamento Valor Abatimento: 0
Impressão Visualizada: False
LISTA DE OCORRÊNCIAS:
------------
Exemplo de retorno com erro:
.:: Consultar Título ::.
Mensagem: Consulta não retornou itens
Status: SUCESSO
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
_ConsultarList := FBoletoX.Consultar(edtIdIntegracao.Text);
Clique aqui para baixar um exemplo completo.
Clique aqui para visualizar um exemplo completo.
C#
_ConsultarLista = boletox.Consultar(tBoxIdIntegracao.Text);
Clique aqui para baixar um exemplo completo.
Clique aqui para visualizar um exemplo completo.
Visual Basic 6
Set ConsultarList = FBoletoX.Consultar(txtIdIntegracao.Text)
Clique aqui para baixar um exemplo completo.
Clique aqui para visualizar um exemplo completo.
Fox Pro
ConsultarList = Boleto.Consultar(THISFORM.txtIdIntegracao.Value)
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.
Comentários
0 comentário
Por favor, entre para comentar.