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).

 

 

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): 

 

Alteração de valor (tipo 1): 

 

Informar abatimento (tipo 2): 

 

Alteração de carteira (tipo 7): 

 

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

 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

 

 

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.