7.4. Título Recomprado¶

🔔 Tipo de Notificação¶

Campo	Valor
`tipoEvento`	`titulo.recomprado`	Título foi recomprado pelo cedente
Id	`6`	Identificador do tipo de evento na tabela `tipo_evento_webhook`

🧾 Descrição¶

Esta notificação é enviada via POST para o endpoint configurado quando um título é recomprado pelo cedente — ou seja, sai do estoque do fundo e volta para o cedente. Cobre as duas modalidades de recompra:

RecompraComAdiantamento — cedente paga o título antes do vencimento e o retoma.
RecompraComSubstituicao — cedente substitui o título por outros recebíveis elegíveis equivalentes.

Use este evento para:

Registrar a saída do título do estoque do fundo.
Reconciliar o pagamento do cedente (no caso de adiantamento).
Atualizar contratos e termos de cessão.

📤 Payload Enviado¶

{
  "idWebhook": "019e0892-8d99-778c-9fa5-47bd07cd9ffb",
  "tipoEvento": "titulo.recomprado",
  "dataHora": "2026-05-08T14:23:11.512Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idTitulo": 2001,
    "numeroDocumento": "NF-000123",
    "especieTitulo": 2,
    "ocorrencia": 3,
    "idLote": 1042,
    "idLoteTitulo": 3201,
    "idCedente": 301,
    "documentoCedente": "12.345.678/0001-90",
    "idSacado": 401,
    "documentoSacado": "98.765.432/0001-10",
    "dataVencimento": "2026-06-07",
    "valorNominal": 50000.00,
    "valorAquisicao": 48750.00,
    "valorAbertoAtualizadoAdministradora": 49100.00,
    "dataConsultaValorAdministradora": "2026-05-08T06:00:00Z",
    "dataExecucao": "2026-05-08T14:23:11.444Z",
    "valorPago": null,
    "pagamentoParcial": false
  },
  "etiquetas": null
}

🧾 Detalhamento dos Campos de `dados`¶

Campo	Tipo	Descrição
`idTitulo`	integer	Identificador do título no VeHub
`numeroDocumento`	string — null	Número do documento
`especieTitulo`	integer (enum) — null	Código da espécie do título (ver tabela em 7.3. Título Cedido)
`ocorrencia`	integer (enum)	`3` (`RecompraComAdiantamento`) ou `7` (`RecompraComSubstituicao`)
`idLote`	integer	Identificador do lote de recompra (lote de saída do título)
`idLoteTitulo`	integer	Identificador do registro `lote × título` referente à recompra
`idCedente`	integer — null	Identificador do cedente que está recomprando
`documentoCedente`	string — null	CPF/CNPJ do cedente
`idSacado`	integer — null	Identificador do sacado (devedor original)
`documentoSacado`	string — null	CPF/CNPJ do sacado
`dataVencimento`	string (date) — null	Data de vencimento original do título
`valorNominal`	number — null	Valor nominal do título
`valorAquisicao`	number — null	Valor de aquisição registrado na cessão original (referência histórica)
`valorAbertoAtualizadoAdministradora`	number — null	Valor em aberto atualizado informado pela administradora na última conciliação. `null` quando ainda não consultado
`dataConsultaValorAdministradora`	string (ISO 8601) — null	Data/hora (UTC) da última consulta do valor atualizado na administradora
`dataExecucao`	string (ISO 8601)	Momento em que a recompra foi efetivada (UTC)
`valorPago`	number — null	Sempre `null` neste evento (use `lote.valorRecompraTotal` para totais)
`pagamentoParcial`	boolean	Sempre `false` neste evento

🔢 Diferenciando as duas modalidades¶

`ocorrencia`	Cedente paga o fundo?	Substitui por outros títulos?
`3` (`RecompraComAdiantamento`)	✅ Sim	❌ Não
`7` (`RecompraComSubstituicao`)	❌ Não	✅ Sim

Em RecompraComSubstituicao, espere também notificações titulo.cedido para os títulos novos que entraram no fundo em troca dos recomprados.

📪 Exemplo de envio¶

POST /webhook/vehub HTTP/1.1
Host: app.cliente.com.br
Content-Type: application/json; charset=utf-8
X-Idempotency-Key: 019e0892-8d99-778c-9fa5-47bd07cd9ffb
X-Event-Type: titulo.recomprado
X-Webhook-Signature: sha256=8c1e2a...

{
  "idWebhook": "019e0892-8d99-778c-9fa5-47bd07cd9ffb",
  "tipoEvento": "titulo.recomprado",
  "dataHora": "2026-05-08T14:23:11.512Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idTitulo": 2001,
    "numeroDocumento": "NF-000123",
    "especieTitulo": 2,
    "ocorrencia": 3,
    "idLote": 1042,
    "idLoteTitulo": 3201,
    "idCedente": 301,
    "documentoCedente": "12.345.678/0001-90",
    "idSacado": 401,
    "documentoSacado": "98.765.432/0001-10",
    "dataVencimento": "2026-06-07",
    "valorNominal": 50000.00,
    "valorAquisicao": 48750.00,
    "valorAbertoAtualizadoAdministradora": 49100.00,
    "dataConsultaValorAdministradora": "2026-05-08T06:00:00Z",
    "dataExecucao": "2026-05-08T14:23:11.444Z",
    "valorPago": null,
    "pagamentoParcial": false
  },
  "etiquetas": null
}

Resposta esperada¶

HTTP/1.1 200 OK
Content-Type: application/json

{ "received": true }

🕒 Observações¶

O idLote aqui é o lote de recompra — não o lote original em que o título foi cedido. Para localizar o lote da cessão original, consulte GET /public/v1/recebiveis/titulos/{id} que retorna o histórico completo.
Em RecompraComSubstituicao, a recompra e a substituição acontecem na mesma operação, mas geram eventos separados (titulo.recomprado para os antigos + titulo.cedido para os novos).
Esta notificação dispara uma vez por título recomprado. Lotes com muitos títulos geram muitos eventos — use a chave de idempotência para tratar duplicidades.