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¶

{
  "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¶

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