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¶

{
  "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 no VeHub
`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)

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

📪 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.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/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}.