--- title: 7.4. Título Recomprado url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/7.%20Notifica%C3%A7%C3%B5es%20-%20WebHook/7.4.%20T%C3%ADtulo%20Recomprado/ --- # 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 ```json { "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 na plataforma | | `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 ```http 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 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.