Pular para o conteúdo principal

Solicitando a remessa de alteração

Luiz Rogério
Atualizado

A geração de remessas de alteração é feita de forma assíncrona, portanto a função FBoletoX.GerarRemessaAlteracao irá retornar um Protocolo e será necessário guardar este protocolo para que em seguida possa seja feita a consulta.

 

Método

 

Para solicitar uma remessa de alteração, como primeiro parâmetro do método GerarRemessaAlteracao é necessário informar qual será o tipo de alteração no segundo parâmetro deve ser informado o TX2 com as informações a serem alteradas (apenas para os tipos 0, 1, 2 e 7).

 

TspdBoletoX.GerarRemessaAlteracao(WideString)

 

Tipos de alterações aceitas:

 

Campo Tipo Descrição
Tipo string

Tipo da alteração que deseja gerar:

0 - Alteração na data de vencimento. (TituloDataVencimento)

1 - Alteração no valor do título. (TituloValor)

2 - Conceder abatimento. (TituloValorAbatimento)

3 - Cancelar abatimento concedido. (Nenhum campo)

4 - Pedido protesto. (Nenhum campo)

5 - Sustar protesto e baixar boleto. (Nenhum campo)

6 - Sustar protesto e manter em carteira. (Nenhum campo)

7 - Alteração de carteira. (TituloCarteira)

8 - Incluir negativação.

9 - Excluir negativação e manter carteira.

10 - Excluir negativação e baixar titulo.

 

Bancos disponíveis:

Banco tipo 0 tipo 1 tipo 2 tipo 3 tipo 4 tipo 5 tipo 6 tipo 7 tipo 8 tipo 9 tipo 10
Itaú ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ❌ ❌ ❌
Bradesco ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ❌ ❌ ❌
Banco do Brasil ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ❌ ❌ ❌
Santander* ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ❌ ❌ ❌
Daycoval* ✔️ ✔️ ✔️ ❌ ✔️ ✔️ ✔️ ❌ ❌ ❌ ❌
Safra ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ❌ ❌ ❌ ❌
CitiBank ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ❌ ❌ ❌ ❌
Sicredi* ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ❌ ✔️ ✔️ ✔️

Obs.: 
* Daycoval : Não disponível quando CNAB 240.

* Santander: Não disponível o tipo 7 quando CNAB 400.

* Sicredi: Não disponível o tipo 7 quando CNAB 400.

* Banco do Brasil: Não disponível o tipo 1 quando CNAB240.

* Alguns bancos costumam não aceitar remessas de alteração de valor para carteiras vinculadas. É importante verificar com sua instituição a possibilidade de uso.


Campos obrigatórios de acordo com o tipo

 

Tipo Campos obrigatórios Observações
0 TituloDataVencimento
  • Deve ser informado uma data posterior a data de vencimento atual,
  • Nova data não deve ser maior que 5 anos que a data atual.
  • Deve ser informada no formato (DD/MM/YYYY).
1 TituloValor
  • O novo valor do boleto deve ser informado no formato (1000,00).
2 TituloValorAbatimento
  • O valor do abatimento a ser concedido deve estar no formato (1000,00).
3 Nenhum campo
  • Nesse tipo não é necessário informar nenhum campo extra além do idintegracao.
4 Nenhum campo
  • Nesse tipo não é necessário informar nenhum campo extra, além do idintegracao.
5 Nenhum campo
  • Nesse tipo não é necessário informar nenhum campo extra, além do idintegracao.
  • Nos bancos Banco do Brasil no CNAB 240 e 400 e no Itaú CNAB 240 e 400 esse movimento não existe, sendo assim o comportamento desse tipo, será apenas de sustar protesto, caso necessite sustar protesto e baixar o título, é necessário gerar duas remessas separadas, um com o movimento de sustar protesto, e outro para baixar o boleto.
6 Nenhum campo
  • Nesse tipo não é necessário informar nenhum campo extra, além do idintegracao.
  • Nos bancos Banco do Brasil no CNAB 240 e 400 e no Itaú CNAB 240 e 400 esse movimento não existe, sendo assim irá para o banco a instrução de apenas sustar o protesto.
7 TituloCarteira
  • Nesse campo, o valor da nova carteira deve ser informado.
8 Nenhum campo
  • Incluir negativação.
9 Nenhum campo
  • Excluir negativação e manter carteira.
10 Nenhum campo
  • Excluir negativação e baixar titulo.

 

Exemplos de tx2 para cada tipo de alteração: 

 

Alteração de vencimento (tipo 0): 

INCLUIRALTERACAO

IdIntegracao=[id integração do boleto que deseja alterar]
TituloDataVencimento=15/06/2018

SALVARALTERACAO

 

Alteração de valor (tipo 1): 

INCLUIRALTERACAO

idintegracao=[id integração do boleto que deseja alterar]
TituloValor=6,85

SALVARALTERACAO

 

Informar abatimento (tipo 2): 

INCLUIRALTERACAO

idintegracao=[id integração do boleto que deseja alterar]
TituloValorAbatimento=1000,00

SALVARALTERACAO

 

Alteração de carteira (tipo 7): 

INCLUIRALTERACAO

idintegracao=[id integração do boleto que deseja alterar]
TituloCarteira=12

SALVARALTERACAO

 

Demais alterações (tipos 3,4,5,6,8,9,10):

INCLUIRALTERACAO

IdIntegracao=[id integração do boleto que deseja alterar]

SALVARALTERACAO

 Obs: Para os tipos citados acima, o tx2 precisa conter apenas o IdIntegracao.

  

É possível gerar uma remessa de alteração para mais de um boleto, mas para isso as alterações devem ser do mesmo tipo. Abaixo, segue um exemplo implementado de como solicitar a geração da remessa de alteração nas seguintes linguagens.

 

 

Exemplos de retorno

 

Exemplo de retorno com erro:

.:: Gerar alteração de Vencimento ::.
Mensagem: 'boletos': O campo idintegracao é obrigatório.

Status: ERRO
Protocolo: 
ErroClasse: VALIDACAO

 

 Exemplo de retorno com sucesso

 

.:: Gerar alteração de Vencimento ::.
Mensagem: Solicitação pendente de processamento
Status: SUCESSO
Protocolo: Hk6q4XqMN

 

Exemplos

 

Delphi

 

    _GerarResposta := FBoletoX.GerarRemessaAlteracao('0', mmoTX2.Text);

 

Clique aqui para baixar um exemplo completo.

Clique aqui para visualizar um exemplo completo.

 

C#

 

    _RemessaList = boletox.GerarRemessaAlteracao("1", tBoxIdIntegracao.Text);

 

Clique aqui para baixar um exemplo completo.

Clique aqui para visualizar um exemplo completo.

 

Visual Basic 6

 

    Set retornoLista = FBoletoX.GerarRemessaAlteracao("2", txtIdIntegracao.Text)

    Set retornoLista = FBoletoX.GerarRemessaAlteracao("1", txtIdIntegracao.Text)

 

Clique aqui para baixar um exemplo completo.

Clique aqui para visualizar um exemplo completo.

 

Fox Pro

 

    retornoLista = Boleto.GerarRemessaAlteracao("3", THISFORM.edtTx2.Value)

 

Clique aqui para baixar um exemplo completo.

Clique aqui para visualizar um exemplo completo.

 

 

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.