Renegociar Seguro
Registra a renegociação do contrato de crédito (CCB) de uma apólice ativa. A renegociação ocorre, por exemplo, quando o tomador troca de empregador e o contrato de crédito subjacente é substituído por um novo.
O seguro não muda
A cobertura, o prêmio e a apólice permanecem idênticos — apenas o identificador do contrato de
crédito é atualizado. O creditContractId original é preservado como referência da 1ª contratação, e
o novo valor passa a ser o currentCreditContractId da proposta. Cada renegociação é registrada no
histórico (veja Listar Renegociações) e gera um documento próprio (veja
Documento da Renegociação).
Requisição
Endpoint
- Metodo: POST
- Endpoint:
/v2/policies/{policyId}/renegotiate
Parâmetros (Path)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| policyId | string (uuid) | ✅ | Identificador da apólice |
Parâmetros (Body)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| newCreditContractId | string | ✅ | Novo identificador do contrato de crédito |
Exemplo de corpo
{
"newCreditContractId": "CCB-2025-0099"
}
Exemplo de requisição
POST /v2/policies/3fa85f64-5717-4562-b3fc-2c963f66afa6/renegotiate
Authorization: Bearer ...
Content-Type: application/json
{
"newCreditContractId": "CCB-2025-0099"
}
Resposta
Campos da resposta (200)
| Parâmetro | Tipo | Descrição |
|---|---|---|
| id | string (uuid) | Identificador da renegociação |
| proposalId | string (uuid) | Identificador da proposta renegociada |
| sequence | integer | Posição na cadeia de renegociações da proposta (1 = primeira) |
| oldCreditContractId | string | Contrato de crédito em vigor imediatamente antes desta renegociação |
| newCreditContractId | string | Novo contrato de crédito em vigor |
| createdAt | string (date-time) | Data da renegociação |
Exemplo (200)
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa7",
"proposalId": "3fa85f64-5717-4562-b3fc-2c963f66afa4",
"sequence": 1,
"oldCreditContractId": "CCB-2024-0012",
"newCreditContractId": "CCB-2025-0099",
"createdAt": "2026-06-15T19:51:30.000Z"
}
Erros
| Código | HTTP | Descrição |
|---|---|---|
NOT_FOUND | 404 | Apólice não encontrada. |
INVALID_CONTRACT_ID | 422 | newCreditContractId ausente ou vazio. |
POLICY_NOT_ACTIVE | 422 | Apólice cancelada — apenas apólices ativas podem ser renegociadas. |
CONTRACT_ID_UNCHANGED | 422 | newCreditContractId é igual ao contrato de crédito atual. |