7.7. Título Resolvido¶

🔔 Tipo de Notificação¶

Campo	Valor
`tipoEvento`	`titulo.resolvido`	Cessão do título foi resolvida (desfeita)
Id	`9`	Identificador do tipo de evento na tabela `tipo_evento_webhook`

🧾 Descrição¶

Esta notificação é enviada via POST para o endpoint configurado quando a cessão de um título é resolvida — isto é, desfeita por algum motivo (geralmente inadimplência irrecuperável, contestação aceita, ou erro operacional). Ao contrário da recompra, a resolução desfaz a cessão sem que o cedente recompense o fundo: o título simplesmente sai do estoque do fundo e o lançamento é estornado.

Use este evento para:

Reverter movimentações contábeis registradas na cessão original.
Atualizar o cedente sobre a perda da cessão (caso seu sistema notifique cedentes).
Disparar workflows internos de cobrança alternativa.

📤 Payload Enviado¶

{
  "idWebhook": "019e0892-8d99-778c-9fa5-47bd07cd9ffb",
  "tipoEvento": "titulo.resolvido",
  "dataHora": "2026-09-12T16:42:00.123Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idTitulo": 2001,
    "numeroDocumento": "NF-000123",
    "especieTitulo": "DuplicataMercantil",
    "ocorrencia": "Resolucao",
    "idLote": 1180,
    "idLoteTitulo": 3801,
    "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,
    "dataExecucao": "2026-09-12T16:42:00.000Z",
    "valorPago": null,
    "pagamentoParcial": false
  },
  "etiquetas": {
    "isTeste": "false",
    "origem": "vhub"
  }
}

🧾 Detalhamento dos Campos de `dados`¶

Campo	Tipo	Descrição
`idTitulo`	integer	Identificador do título no VHub
`numeroDocumento`	string — null	Número do documento
`especieTitulo`	string (enum) — null	Espécie do título
`ocorrencia`	string (enum)	Sempre `Resolucao` para este evento
`idLote`	integer	Identificador do lote de resolução
`idLoteTitulo`	integer	Identificador do registro `lote × título`
`idCedente`	integer — null	Identificador do cedente original
`documentoCedente`	string — null	CPF/CNPJ do cedente
`idSacado`	integer — null	Identificador do sacado
`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)
`dataExecucao`	string (ISO 8601)	Momento em que a resolução foi efetivada (UTC)
`valorPago`	number — null	Sempre `null` neste evento
`pagamentoParcial`	boolean	Sempre `false` neste evento

📪 Exemplo de envio¶

POST /webhook/vhub 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.resolvido
X-Webhook-Signature: sha256=9e5c3a...

{
  "idWebhook": "019e0892-8d99-778c-9fa5-47bd07cd9ffb",
  "tipoEvento": "titulo.resolvido",
  "dataHora": "2026-09-12T16:42:00.123Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idTitulo": 2001,
    "numeroDocumento": "NF-000123",
    "especieTitulo": "DuplicataMercantil",
    "ocorrencia": "Resolucao",
    "idLote": 1180,
    "idLoteTitulo": 3801,
    "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,
    "dataExecucao": "2026-09-12T16:42:00.000Z",
    "valorPago": null,
    "pagamentoParcial": false
  },
  "etiquetas": {
    "isTeste": "false",
    "origem": "vhub"
  }
}

Resposta esperada¶

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

{ "received": true }

🕒 Observações¶

Resolução é diferente de recompra: na recompra o cedente paga o fundo (com adiantamento) ou substitui o título (com substituição); na resolução o fundo simplesmente devolve o título sem contraprestação.
Geralmente envolve decisões manuais do gestor — eventos de resolução costumam ser raros comparados a titulo.cedido.
O idLote aqui é o lote de resolução — para localizar o lote da cessão original, consulte GET /api/v1/titulo/{id} que retorna o histórico completo.
Se sua aplicação contabilizou a entrada do título no estoque do fundo, este evento sinaliza que deve ser estornada.