Início
A etapa de precificação oferece duas operações, ambas calculadoras: nada é persistido e nenhum recurso é criado. A diferença está na pergunta que cada uma responde.
- A cotação (
POST /v1/insurance/quote) responde "quanto custa esta seleção?" — calcula o preço exato de uma seleção de produtos e coberturas para uma configuração de comissão específica (a enviada emcommission_data, ou o padrão do produto quando omitida). - A simulação (
POST /v1/insurance/simulate) responde "por quanto eu posso vender esta seleção?" — calcula a faixa de preço vendável de cada produto, variando apenas a comissão entre o mínimo e o máximo da sua faixa (commission_bounds). Por isso ela não aceitacommission_data: a faixa inteira é varrida.
Cotação vs. simulação
| Cotação | Simulação | |
|---|---|---|
| Responde | O preço exato da seleção. | O menor e o maior preço final possíveis por produto. |
| Comissão | Uma configuração específica (commission_data ou o padrão do produto). | Varre a faixa commission_bounds inteira — enviar commission_data é 400. |
| Retorna | gross_premium_amount por produto e por cobertura, com veredito de elegibilidade. | price_range por produto: piso e teto do prêmio, comissão em R$ e taxas nos extremos. |
| Use para | Exibir o preço de uma oferta fechada antes de submeter o pedido. | Montar ofertas com preço customizado: descobrir os limites antes de escolher um total_gross_premium_amount. |
Os dois requests usam a mesma lista products[] do pedido — a única diferença estrutural é a presença ou não de commission_data.
Fluxo típico
- Simule a seleção para descobrir a faixa de preço vendável de cada produto.
- Escolha o preço final dentro da faixa e cote com
commission_type: total_gross_premium_amountpara ver o preço exato e o veredito de elegibilidade. - Submeta o pedido com a mesma lista
products[]— ele é reprecificado com o mesmo motor no momento da submissão.
Preços são indicativos
Cotação e simulação rodam contra a configuração vigente — não há token de cotação, snapshot de tarifa nem prazo de validade. O preço calculado na submissão do pedido é o que vale.
Endpoints
| Endpoint | Descrição |
|---|---|
POST /v1/insurance/quote | Precifica uma seleção com uma configuração de comissão específica. |
POST /v1/insurance/simulate | Retorna a faixa de preço vendável de uma seleção, variando a comissão. |