--- title: 7.7. Título Resolvido url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/7.%20Notifica%C3%A7%C3%B5es%20-%20WebHook/7.7.%20T%C3%ADtulo%20Resolvido/ --- # 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 ```json { "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": 2, "ocorrencia": 4, "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, "valorAbertoAtualizadoAdministradora": null, "dataConsultaValorAdministradora": null, "dataExecucao": "2026-09-12T16:42:00.000Z", "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) | Sempre `4` (`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) | | `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 resolução foi efetivada (UTC) | | `valorPago` | number — null | Sempre `null` neste evento | | `pagamentoParcial` | boolean | Sempre `false` neste evento | --- ## 📪 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.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": 2, "ocorrencia": 4, "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, "valorAbertoAtualizadoAdministradora": null, "dataConsultaValorAdministradora": null, "dataExecucao": "2026-09-12T16:42:00.000Z", "valorPago": null, "pagamentoParcial": false }, "etiquetas": null } ``` ### Resposta esperada ```http 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 /public/v1/recebiveis/titulos/{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**.