---
title: 7.3. Título Cedido
url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/7.%20Notifica%C3%A7%C3%B5es%20-%20WebHook/7.3.%20T%C3%ADtulo%20Cedido/
---
# 7.3. Título Cedido

## 🔔 Tipo de Notificação

| Campo        | Valor              |                                                                |
|--------------|--------------------|----------------------------------------------------------------|
| `tipoEvento` | `titulo.cedido`    | Título foi efetivamente cedido ao fundo                        |
| Id           | `5`                | 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 é efetivamente cedido a um FIDC**. O disparo ocorre no momento em que o registro `LoteTitulo` transiciona `Executado: false → true` em uma operação de **Cessão**.

Use este evento para:

- Atualizar o estoque de recebíveis no seu sistema (saída do estoque do cedente, entrada no estoque do fundo).
- Registrar o valor de aquisição efetivamente pago pelo fundo.
- Iniciar processos contábeis e fiscais relacionados à cessão.

---

## 📤 Payload Enviado

```json
{
  "idWebhook": "019e0892-8d99-778c-9fa5-47bd07cd9ffb",
  "tipoEvento": "titulo.cedido",
  "dataHora": "2026-05-08T14:23:11.512Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idTitulo": 2001,
    "numeroDocumento": "NF-000123",
    "especieTitulo": 2,
    "ocorrencia": 1,
    "idLote": 1001,
    "idLoteTitulo": 3001,
    "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": null,
    "dataConsultaValorAdministradora": null,
    "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 (NF, duplicata, CCB, etc.)                              |
| `especieTitulo`     | integer (enum) — null| Código da espécie do título (ver tabela abaixo)                             |
| `ocorrencia`        | integer (enum)      | Sempre `1` (`Cessao`) para este evento                                       |
| `idLote`            | integer             | Identificador do lote ao qual o título pertence                             |
| `idLoteTitulo`      | integer             | Identificador do registro de relação `lote × título`                        |
| `idCedente`         | integer — null      | Identificador do cedente (origem do recebível)                              |
| `documentoCedente`  | string — null       | CPF/CNPJ do cedente                                                         |
| `idSacado`          | integer — null      | Identificador do sacado (devedor do recebível)                              |
| `documentoSacado`   | string — null       | CPF/CNPJ do sacado                                                          |
| `dataVencimento`    | string (date) — null| Data de vencimento do título (formato `YYYY-MM-DD`)                         |
| `valorNominal`      | number — null       | Valor nominal do título (em reais)                                          |
| `valorAquisicao`    | number — null       | Valor de aquisição (líquido do deságio) que o fundo pagou                   |
| `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 cessão foi efetivada (UTC)                                 |
| `valorPago`         | number — null       | Sempre `null` neste evento (preenchido apenas em liquidações)               |
| `pagamentoParcial`  | boolean             | Sempre `false` neste evento                                                 |

---

### 🔢 Espécies de Título (`especieTitulo`)

O campo é enviado como **código numérico** do enum `EspecieTitulo`:

| Código | Nome                   | Significado                                    |
|--------|------------------------|------------------------------------------------|
| 2  | `DuplicataMercantil`   | Duplicata mercantil (mais comum)               |
| 3  | `UnidadeRecebivel`     | UR — Unidade de Recebível (cartão)             |
| 4  | `NotaFiscalServico`    | Nota Fiscal de Serviço                         |
| 5  | `NotaDeDebito`         | Nota de Débito                                 |
| 6  | `CCBPreDigital`        | Cédula de Crédito Bancário (CCB pré-digital)   |
| 8  | `NotaPromissoria`      | Nota Promissória                               |
| 9  | `NotaComercial`        | Nota Comercial                                 |
| 10 | `Contrato`             | Contrato                                       |
| 11 | `NotaFiscal`           | Nota Fiscal                                    |
| 12 | `CedulaProdutoRural`   | Cédula de Produto Rural                        |
| 13 | `CTE`                  | Conhecimento de Transporte Eletrônico (CT-e)   |
| 14 | `ConfissaoDivida`      | Confissão de Dívida                            |
| 15 | `AssuncaoDivida`       | Assunção de Dívida                             |
| 16 | `FaturaCartaoCredito`  | Fatura de cartão de crédito                    |
| 17 | `BloqueioAgendaPagamentoCartao` | Bloqueio de agenda de pagamento de cartão |

> Lista completa também disponível em `GET /public/v1/enumeracoes/especie-titulo`.

---

## 📪 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.cedido
X-Webhook-Signature: sha256=2f4a7b...

{
  "idWebhook": "019e0892-8d99-778c-9fa5-47bd07cd9ffb",
  "tipoEvento": "titulo.cedido",
  "dataHora": "2026-05-08T14:23:11.512Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idTitulo": 2001,
    "numeroDocumento": "NF-000123",
    "especieTitulo": 2,
    "ocorrencia": 1,
    "idLote": 1001,
    "idLoteTitulo": 3001,
    "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": null,
    "dataConsultaValorAdministradora": null,
    "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

- Este evento dispara **uma vez por título** quando o lote da cessão é efetivado. Para um lote com 100 títulos, serão enviadas 100 notificações.
- A `dataExecucao` corresponde ao momento da efetivação da cessão e é a referência oficial para fins contábeis.
- O `valorAquisicao` já reflete o **deságio** aplicado pelo gestor (taxa, despesas, TAC, conforme a operação).
- Se você precisa do **saldo agregado do lote**, escute também o evento `lote.status_alterado` com `statusAtual = 5` (`EnviadoAoFundo`) ou consulte `GET /public/v1/recebiveis/lotes/{idLote}`.