Cobrança híbrida com id de boleto ou txid já existente na base de dados

Descrição do problema Ao registrar uma cobrança híbrida, é retornado o erro informando que já existe um boleto ou txid com os mesmos dados na base. Cobranca Híbrida com id de boleto ou txid já existente na base d...

Atualizado em 26 de mar. de 2026, 23:07

Problema

Descrição do problema

Ao registrar uma cobrança híbrida, é retornado o erro informando que já existe um boleto ou txid com os mesmos dados na base.

Cobranca Híbrida com id de boleto ou txid já existente na base de dados.

Esse erro ocorre quando os campos numeroNaEmpresa e/ou numeroNoBanco já foram utilizados anteriormente em outro boleto híbrido.

Solucao

Solução

Esse problema não está relacionado a instabilidade ou falha no sistema, mas sim a uma duplicidade de identificação do boleto.

Os campos abaixo devem ser únicos para cada cobrança:

{ 
    "numeroNaEmpresa": "2", 
    "numeroNoBanco": "00000002"
}

Se esses valores já foram utilizados anteriormente, o sistema irá bloquear o registro para evitar duplicidade.

✔ Gere uma nova numeração para o boleto que ainda não tenha sido utilizada anteriormente.

✔ Garanta que cada cobrança tenha identificadores únicos.

Após ajustar a numeração, o registro da cobrança deverá ocorrer normalmente.