Início
A apólice (policy) é o contrato de seguro individual — uma por produto vendido em um pedido emitido. Ela nasce na emissão do pedido, é registrada junto à seguradora e passa a ser a fonte da verdade sobre a cobertura: número de apólice na seguradora, vigência, coberturas efetivas, prêmio decomposto e trilha de eventos.
Ciclo de vida da apólice
Como ler o diagrama: contorno tracejado = status transitório que não gera webhook · azul = emissão confirmada (gera webhook) · verde = encerramento natural (não gera webhook) · vermelho = cancelada (gera webhook).
| Status | Significado |
|---|---|
issuance_requested | Apólice criada na emissão do pedido; a emissão foi solicitada à seguradora e aguarda confirmação. |
issued | A seguradora confirmou a emissão. O external_policy_number (número da apólice na seguradora) passa a estar disponível. A cobertura está em vigor. |
cancellation_requested | Um cancelamento foi solicitado e aguarda a confirmação da seguradora. A cobertura permanece em vigor enquanto o cancelamento não é confirmado. |
canceled | A seguradora confirmou o cancelamento. A devolução de prêmio, quando devida, é calculada e processada automaticamente. |
finished | A vigência da apólice chegou ao fim naturalmente (term.end_date). Status terminal, sem evento — o fim de vigência é conhecido desde a emissão. |
Devolução de prêmio no cancelamento
Quando um cancelamento é confirmado, a QI Tech determina a base de devolução e calcula o valor automaticamente, sobre o prêmio bruto (gross_premium_amount):
- Dentro de 7 dias corridos da confirmação da emissão (
issued) — direito de arrependimento: devolução integral do prêmio. - Após 7 dias: devolução proporcional ao período de cobertura não decorrido (pró-rata).
A devolução é calculada na confirmação do cancelamento e executada ao pagador pela própria QI Tech.
Endpoints
| Endpoint | Descrição |
|---|---|
GET /v1/insurance/policies/{policy_key} | Detalha uma apólice. |
GET /v1/insurance/policies?order_key= | Lista as apólices de um pedido emitido. |
POST /v1/insurance/policies/{policy_key}/cancel | Cancela uma apólice individualmente. |