Pular para o conteúdo principal

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 em commission_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 aceita commission_data: a faixa inteira é varrida.

Cotação vs. simulação

CotaçãoSimulação
RespondeO preço exato da seleção.O menor e o maior preço final possíveis por produto.
ComissãoUma configuração específica (commission_data ou o padrão do produto).Varre a faixa commission_bounds inteira — enviar commission_data é 400.
Retornagross_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 paraExibir 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

  1. Simule a seleção para descobrir a faixa de preço vendável de cada produto.
  2. Escolha o preço final dentro da faixa e cote com commission_type: total_gross_premium_amount para ver o preço exato e o veredito de elegibilidade.
  3. 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

EndpointDescrição
POST /v1/insurance/quotePrecifica uma seleção com uma configuração de comissão específica.
POST /v1/insurance/simulateRetorna a faixa de preço vendável de uma seleção, variando a comissão.