Introdução

A troca de titularidade de boletos (tombamento) consiste no processo de alteração da carteira de cobrança e da conta de liquidação associadas aos boletos já registrados.

Em uma troca de titularidade, sempre existirão uma conta e uma carteira de cobrança de origem e uma conta e uma carteira de cobrança de destino.

• A conta e carteira de origem são aquelas em que os boletos foram originalmente registrados.

• A conta e carteira de destino são aquelas para as quais os boletos serão transferidos (tombados).

O que é alterado?

• Carteira de cobrança
• Conta de liquidação

O que NÃO é alterado?

• Dados do beneficiário da cobrança
• Linha digitável para pagamento
• QR Code Pix para pagamento (nos casos de BolePix)

Casos de Uso

Composição de garantia

Os boletos de cobrança de uma carteira podem ser utilizados na composição de garantia de uma operação de crédito. Nesse cenário, o titular da conta de destino tomba os boletos da sua carteira de cobrança simples para a carteira de cobrança vinculada à conta de garantia da operação.

Cessão de direito creditório

Nos casos em que o boleto de cobrança esteja vinculado a um direito creditório antecipado, é possível — após a conclusão da antecipação — tombar os boletos para a carteira do novo credor do direito antecipado.

Atenção!

A API de troca de titularidade de boletos não formaliza a cessão fiduciária ou a antecipação do direito creditório. Ela apenas reflete o que deve acontecer com o fluxo financeiro do ativo vinculado ao boleto de cobrança tombado.

Fluxo do Processo

O tombamento de boletos é o processo de transferência de titularidade dos boletos registrados de uma carteira para outra. Esse fluxo é composto por quatro etapas principais, que devem ser executadas em sequência por meio de chamadas à API.

A seguir, descrevemos o funcionamento de cada uma delas.

1. Abertura de lote

O primeiro passo consiste na criação de um lote de tombamento, que agrupará todos os boletos que serão transferidos. Assim que o lote é criado, ele é retornado com o status inicial opened. Nessa etapa, devem ser informadas as chaves da conta de origem, da carteira de destino e a nova chave Pix associada.

2. Inclusão de boletos no lote

Com o lote aberto, é possível adicionar os boletos que serão incluídos na troca de titularidade. Durante essa etapa, o status do lote permanece opened, indicando que ele ainda está em preparação e pode receber novos boletos.

3. Envio dos boletos

Após a inclusão de todos os boletos desejados, é necessário enviar o lote para processamento. No momento em que o envio é realizado, o status do lote é atualizado para sent, e um webhook é disparado para informar a alteração de status. Esse envio marca o início do fluxo operacional do tombamento.

4. Aprovação do tombamento

Por fim, a aprovação do lote deve ser realizada pela conta de destino, confirmando a transferência de titularidade dos boletos. Após a aprovação, o status do lote muda para processing, indicando que o tombamento está em andamento. Quando o processo é concluído com sucesso, o sistema envia um webhook final com o status approved, confirmando que a troca de titularidade foi finalizada.

Compartilhamos a seguir o link que apresenta um organograma do fluxo completo, incluindo os endpoints associados e as respectivas mudanças de status em cada etapa do processo: