Simular faixa de preço

Retorna a faixa de preço vendável de uma seleção — o menor e o maior preço final possíveis para cada produto, variando apenas a comissão dentro da sua faixa (commission_bounds). Use-a para montar ofertas com preço customizado: o valor enviado em commission_data com commission_type: total_gross_premium_amount no pedido deve estar dentro dessa faixa.

Assim como a cotação, a simulação é uma calculadora: nada é persistido.

Request

ENDPOINT

/v1/insurance/simulate

MÉTODO

POST

O request usa a mesma lista products[] da cotação — sem commission_data: a simulação varre a faixa de comissão inteira, então enviar uma comissão é 400.

Request Body
{
  "products": [
    {
      "product_key": "9d1f8c7a-3b21-4e60-8a2f-1c5d7e9b0a44",
      "term": {
        "start_date": "2026-07-16",
        "end_date": "2028-07-15"
      },
      "services": [
        {
          "service_key": "0a3c5e7f-2b4d-4a6c-8e0f-1a3b5c7d9e2f",
          "insured_amount_basis": "monetary_amount",
          "insured_amount": 50000.00
        }
      ],
      "risk_object": {
        "type": "credit_operation",
        "insurable_value": 50000.00,
        "attributes": {
          "installment_amount": 1050.00,
          "number_of_installments": 48
        }
      }
    }
  ],
  "customer": {
    "date_of_birth": "1987-03-22",
    "occupation_code": "211205"
  }
}

Response

STATUS

200

Response Body
{
  "total_order_floor_amount": 583.10,
  "total_order_ceiling_amount": 686.42,
  "products": [
    {
      "product_key": "9d1f8c7a-3b21-4e60-8a2f-1c5d7e9b0a44",
      "result": "priced",
      "name": "Prestamista Master",
      "provider_name": "QI Seguradora",
      "product_category": "insurance",
      "insurance_class": {
        "name": "credit_life",
        "class_number": "0977",
        "group_number": "09"
      },
      "contract_instrument_type": "ticket",
      "regulator_registration": "15414.900388/2015-21",
      "term": {
        "start_date": "2026-07-16",
        "end_date": "2028-07-15"
      },
      "price_range": {
        "floor_gross_premium_amount": 583.10,
        "ceiling_gross_premium_amount": 686.42,
        "floor_requester_amount": 29.16,
        "ceiling_requester_amount": 137.28,
        "minimum_requester_rate": 0.0500,
        "maximum_requester_rate": 0.2000
      },
      "services": [
        {
          "service_key": "0a3c5e7f-2b4d-4a6c-8e0f-1a3b5c7d9e2f",
          "service_type": {
            "code": "credit_life",
            "name": "Prestamista (Credit Life)"
          },
          "service_category": "insurance",
          "regulator_registration": null,
          "insured_amount": 50000.00,
          "unit_amount": null,
          "unit_count": null,
          "deductible_data": {
            "deductible_type": "monetary_amount",
            "value": 1500.00
          },
          "waiting_period_days": 30,
          "service_attributes": {}
        }
      ]
    }
  ],
  "eligibility": "eligible"
}

Atributos da resposta

Campo	Tipo	Descrição
`total_order_floor_amount`	number	Menor valor total possível do pedido (todas as comissões na taxa mínima).
`total_order_ceiling_amount`	number	Maior valor total possível do pedido (todas as comissões na taxa máxima).
`products`	array	Uma linha por produto solicitado, na ordem do request. Linhas rejeitadas são byte a byte idênticas às da cotação — `product_key`, `result: "rejected"` e `decline_reasons` — porque foram recusadas pelo mesmo motivo, no mesmo estágio.
`eligibility`	string	Veredito de elegibilidade da simulação: `eligible`, `declined` ou `not_evaluated`.

Objeto em `products` (linha precificada)

A linha da simulação é a linha da cotação com todos os campos de prêmio substituídos por uma única faixa: mesma identidade, mesma classificação, mesmo term ecoado, mesmas coberturas realizadas — só o dinheiro muda. Ela traz product_key, result, name, provider_name, product_category, insurance_class, contract_instrument_type, regulator_registration, term, price_range e services[].

services[] tem exatamente a forma da cotação menos o gross_premium_amount da cobertura: um prêmio por cobertura é uma decomposição no grão que a faixa deliberadamente não fixa. Todo o resto — importância segurada resolvida, par por unidade, franquia, carência e atributos — permanece, porque é o que você está vendendo.

Objeto `price_range`

Campo	Tipo	Descrição
`floor_gross_premium_amount`	number	Menor preço final possível do produto (comissão na taxa mínima).
`ceiling_gross_premium_amount`	number	Maior preço final possível do produto (comissão na taxa máxima).
`floor_requester_amount`	number	A sua comissão em R$ no piso da faixa.
`ceiling_requester_amount`	number	A sua comissão em R$ no teto da faixa.
`minimum_requester_rate`	number	Taxa mínima da sua faixa de comissão para o produto.
`maximum_requester_rate`	number	Taxa máxima da sua faixa de comissão para o produto.

Um total_gross_premium_amount igual ao piso ou ao teto da faixa usa exatamente a taxa minimum_requester_rate/maximum_requester_rate, sem arredondamento intermediário.

Não há prêmio na simulação

A simulação não devolve gross_premium_amount, iof_amount nem net_premium_amount, em nenhum nível. Os extremos da faixa são os únicos valores de prêmio desta superfície. Para o preço fechado e decomposto, use a cotação.

Possíveis erros

Todo erro (non-2xx) retorna o corpo padrão { "title", "description", "translation", "code" } — trate programaticamente apenas o campo code.

Status	Código	Descrição
`400`	`QIT000001`	Requisição malformada — inclusive `commission_data` presente em alguma linha.
`401` / `403`	—	Falha de autenticação ou autorização.
`429`	—	Limite de requisições excedido — repita com backoff.
`503`	—	Motor de precificação indisponível. Repita a chamada.

Request​

Response​

Atributos da resposta​

Objeto em products (linha precificada)​

Objeto price_range​

Possíveis erros​