--- title: 7.9. Título Prorrogado url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/7.%20Notifica%C3%A7%C3%B5es%20-%20WebHook/7.9.%20T%C3%ADtulo%20Prorrogado/ --- # 7.9. Título Prorrogado ## 🔔 Tipo de Notificação | Campo | Valor | | |--------------|-----------------------|-----------------------------------------------------------------| | `tipoEvento` | `titulo.prorrogado` | O vencimento do título foi prorrogado | | Id | `11` | Identificador do tipo de evento | --- ## 🧾 Descrição Esta notificação é enviada via **POST** para o endpoint configurado **quando a prorrogação de um título é efetivada** num lote de **Prorrogação** (`ocorrencia = 8`). A prorrogação estende o vencimento do título mediante um encargo financeiro; o título **continua em aberto** no estoque do fundo. Use este evento para: - Atualizar o vencimento do título na sua base. - Registrar o encargo cobrado pelo prazo adicional. - Recalcular a agenda de recebimentos e o aging da carteira. --- ## 📤 Payload Enviado ```json { "idWebhook": "019e0892-8d99-778c-9fa5-47bd07cd9ffd", "tipoEvento": "titulo.prorrogado", "dataHora": "2026-07-15T13:02:10.318Z", "grupoEconomico": "MeuGrupo", "dados": { "idTitulo": 2001, "numeroDocumento": "NF-000123", "especieTitulo": 2, "ocorrencia": 8, "idLote": 1150, "idLoteTitulo": 3480, "idCedente": 301, "documentoCedente": "12345678000195", "idSacado": 401, "documentoSacado": "98765432000198", "dataVencimento": "2026-08-14", "valorNominal": 50000.00, "valorAquisicao": 48750.00, "valorAbertoAtualizadoAdministradora": 50000.00, "dataConsultaValorAdministradora": "2026-07-15T06:00:00Z", "dataExecucao": "2026-07-15T13:02:09.000Z", "valorPago": 412.50, "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 `8` (`Prorrogacao`) para este evento | | `idLote` | integer | Identificador do lote de prorrogação | | `idLoteTitulo` | integer | Identificador do registro `lote × título` da prorrogação | | `idCedente` | integer — null | Identificador do cedente | | `documentoCedente` | string — null | CPF/CNPJ do cedente | | `idSacado` | integer — null | Identificador do sacado | | `documentoSacado` | string — null | CPF/CNPJ do sacado | | `dataVencimento` | string (date) — null| **Novo vencimento** do título, já prorrogado (formato `YYYY-MM-DD`) | | `valorNominal` | number — null | Valor nominal do título depois da prorrogação | | `valorAquisicao` | number — null | Valor de aquisição registrado no lote de prorrogação (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 prorrogação foi efetivada (UTC) | | `valorPago` | number — null | Valor do **encargo** cobrado pelo prazo adicional. Não baixa o título | | `pagamentoParcial` | boolean | Sem significado na prorrogação | --- ## 📪 Exemplo de envio ```http POST /webhook/recebiveis HTTP/1.1 Host: app.cliente.com.br Content-Type: application/json; charset=utf-8 X-Idempotency-Key: 019e0892-8d99-778c-9fa5-47bd07cd9ffd X-Event-Type: titulo.prorrogado X-Webhook-Signature: sha256=9b1d0e... { "idWebhook": "019e0892-8d99-778c-9fa5-47bd07cd9ffd", "tipoEvento": "titulo.prorrogado", "dataHora": "2026-07-15T13:02:10.318Z", "grupoEconomico": "MeuGrupo", "dados": { "idTitulo": 2001, "numeroDocumento": "NF-000123", "especieTitulo": 2, "ocorrencia": 8, "idLote": 1150, "idLoteTitulo": 3480, "idCedente": 301, "documentoCedente": "12345678000195", "idSacado": 401, "documentoSacado": "98765432000198", "dataVencimento": "2026-08-14", "valorNominal": 50000.00, "valorAquisicao": 48750.00, "valorAbertoAtualizadoAdministradora": 50000.00, "dataConsultaValorAdministradora": "2026-07-15T06:00:00Z", "dataExecucao": "2026-07-15T13:02:09.000Z", "valorPago": 412.50, "pagamentoParcial": false }, "etiquetas": null } ``` ### Resposta esperada ```http HTTP/1.1 200 OK Content-Type: application/json { "received": true } ``` --- ## 🕒 Observações - O evento é enviado **uma vez por título** de cada lote de prorrogação, para cada configuração de webhook inscrita nele. - O `dataVencimento` é o vencimento contratual novo. O vencimento ajustado para dia útil, que governa prazo e aging, está em `dataVencimentoAjustada` na consulta `GET /public/v1/recebiveis/titulos/{id}`. - A prorrogação **não** tira o título do estoque do fundo: depois dela ainda podem chegar `titulo.liquidado`, `titulo.recomprado` e os demais eventos do título. - Para acompanhar o lote de prorrogação como um todo, use `lote.status_alterado` com `tipoOcorrencia = 8`.