Criar Cotação
Criar Cotação
POST {{url_ambiente}}/{{version}}/quotation/contracting
Cria ou edita uma cotação.
Headers
Ocp-Apim-Subscription-Key*
key
chave de acesso da api.
{
"success": false,
"executed": "2023-05-22T20:10:41.1631988Z",
"errors": [
{
"code": "ANSWERS-NOT-EVALUATED",
"message": "One or more answers could not be evaluated.",
"properties": [
"INSURED-NAME"
]
}
]
}{
"success": false,
"executed": "2023-05-22T20:11:50.6875419Z",
"errors": [
{
"code": "INCORRECT-OR-NONEXISTENT"
},
{
"code": "TOKEN-ERROR"
}
]
}Request
Explicando campos de envio.
Field: OperationCode Tipo:
text❗ Campo Obrigatório.Campo usado para definir qual produto está sendo cotado. Neste caso, o produto é "Médicos", representado pelo operation code "MEDICAL-CIVIL-LIABILITY-PARTNER".
Field: RegisterNumber
Tipo:
text❗ Campo Obrigatório.
Campo usado para definir qual o SusepNumber da corretora está sendo cotada. Neste caso, o susep da corretora é "100000".
Field: Answers Tipo:
array<answer>❗ Campo Obrigatório.Campo usado para enviar perguntas gerais de uma cotação.
Field: PERSON-TYPE Tipo:
string❗ Campo Obrigatório.Campo usado para definir o tipo de pessoa, sendo possivel enviar:
NATURAL = Pessoa Fisíca
LEGAL = Pessoa Jurídica
Field: MEDICAL-EXPERT Tipo:
trueCampo usado para definir se é perito médico.
Field: CONGENER Tipo:
string❗ Campo Obrigatório.Campo usado para definir o tipo de cotação, sendo possivel enviar:
NEW = Cotação Nova.
RENEWAL = Renovação vinda de outra seguradora (renovação congênere).
Field: PREVIOUS-INSURER Tipo:
string❗ Campo Obrigatório caso CONGENER = RENEWAL.Campo usado para definir o cnpj que vem a cotação marcada com renovação congênere.
Field: PREVIOUS-INSURER-NAME Tipo:
string❗ Campo Obrigatório caso CONGENER = RENEWAL.Campo usado para definir o nome que vem a cotação marcada com renovação congênere.
Field: INSURED-SOCIAL-NAME Tipo:
stringPergunta usada para informar o nome social do segurado, caso o mesmo possua.
* Pergunta apenas permitida quando PERSON-TYPE for NATURAL.
Field: INSURED-SOCIAL-NAME-AGREEMENT Tipo:
string❗ Obrigatório caso segurado possuir nome social.Pergunta usada para definir "Permitir a utilização de nome social do segurado na cotação". Caso segurado possuir nome social, então este campo deverá obrigatoriamente receber a resposta "true".
Code: INSURED-ADDRESS-COMPLEMENT Tipo:
text\Pergunta usada para definir o número da moradia do segurado.
Code: INSURED-ADDRESS-NEIGHBORHOOD Tipo:
text❗ Obrigatório que esteja incluído no array.Pergunta usada para definir o bairro do segurado.
Code: INSURED-ADDRESS-CITY Tipo:
text❗ Obrigatório que esteja incluído no array.Pergunta usada para definir a cidade do segurado.
Code: INSURED-ADDRESS-STATE Tipo:
text❗Obrigatório que esteja incluído no array.Pergunta usada para definir o estado do segurado.
Code: BROKERAGE-COMMISSION Tipo:
decimal❗Obrigatório que esteja incluído Pergunta usada para definir a comissão.Pode ser enviado valores entre 1 e 30. Valor padrão é 20.00.
Code: GRIEVANCE-DISCOUNT Tipo:
decimalPergunta usada para definir Agravo (aumento de preço sobre o netValue* da cotação). O Padrão é 0. * Preço líquido do produto sem IOF.
Code: PROFESSIONAL-REGISTER Type:
text❗ Obrigatório que esteja incluído no array.Pergunta usada para definir o registro do profissional.
Code: CATEGORIES Type:
array<string>❗ Obrigatório que esteja incluído no array.Pergunta usada para definir a especialidade médica.
Pode-se enviar mais de uma resposta dentro desse array de string, sendo elas:
Code: RESIDENT Type:
text❗ Obrigatório que esteja incluído no array para pessoa física ou especialidade não for Cirurgião(ã) Plástico(a) (se o PERSON-TYPE for NATURAL ou se CATEGORIES for diferente de PLASTIC-SURGERY).Pergunta usada para definir se o profissional é residente ou não.
Code: PROCEDURES-ACTIVITIES Type:
array<string>Se atua com alguns desses procedimentos e/ou atividades. Pode-se enviar mais de uma resposta dentro desse array de string, sendo elas:
Code: RETROACTIVITY Type:
integerPergunta usada para definir a retroatividade. Os possíveis valores para esta pergunta são:
Code: RETROACTIVITY-DATE Type:
date (aaaa-mm-dd)Pergunta usada para definir a data de retroatividade para renovação congênere. Para esta pergunta é possivel enviar qualquer data, e pode enviar 'RETROACTIVITY' como 0 (a data de RETROACTIVITY vai ser sobreescrita caso envie algum valor, mas ainda sera necessário enviar retroactivity e a resposta para renovação congênere).
Code: RETROACTIVITY-AGREEMENT Type:
boolean❗ Obrigatório que esteja incluído no array caso tenha retroatividade (RETROACTIVITY for MAIOR que 0).Pergunta usada para definir "Entendimento e concordância de retroatividade". Se definida como true, indica que Estou ciente e de acordo que a confirmação da data de retroatividade ocorrerá apenas num eventual sinistro, sendo obrigatório apresentar as apólices anteriores para comprovação. A apólice anterior não pode ter sido cancelada ou ter tido interrupção de vigência."
Code: REVENUES Type:
text❗ Obrigatório que esteja incluído no array para pessoa jurídica (PERSON-TYPE for LEGAL).Pergunta usada para definir o Faturamento nos últimos 12 meses. Os possíveis valores para esta pergunta são:
Code: CLAIMS Type:
text❗ Obrigatório que esteja incluído no array.Pergunta usada para definir se houve sinistros nos últimos 24 meses Os valores possíveis para esta pergunta são:
0 = nenhum.
1 = 1 reclamação.
2 = 2 reclamações.
Code: CLAIM-EXPECTATION Type:
boolean❗ Obrigatório que esteja incluído no array.Pergunta usada para definir se o segurado tem conhecimento ou Expectativas de Sinistro (alguma circunstância que possa gerar um sinistro).
Code: CLAIM-EXPECTATION-THIRD-PARTY Type:
text❗ Obrigatório que esteja incluído no array (se CLAIM-EXPECTATION for TRUE).Pergunta usada para definir possíveis terceiros reclamantes de expectativas de sinistro.
Code: CLAIM-EXPECTATION-AGREEMENT Type:
boolean❗ Obrigatório que esteja incluído no array (se CLAIM-EXPECTATION for TRUE).Pergunta usada para definir "Entendimento e concordância de expectativas de sinistro". Se definida como true, indica que "Entendido e acordado que não haverá cobertura securitária para qualquer tipo de fato já conhecido pelo segurado."
Code: TERRITORIALITY Type:
text❗ Obrigatório que esteja incluído no array. Atualmente so atendemos corretores/corretoras que atendem no Brasil Pergunta usada para definir a Territorialidade. Os possíveis valores para esta pergunta são:
BR = Brasil
Code: SCOPE Type:
text❗ Obrigatório que esteja incluído no array. Atualmente só atender corretoras/corretores com trabalhos nacionais. Pergunta usada para definir o Âmbito de trabalho do corretor/corretora. Os possíveis valores para esta pergunta são:
NATIONAL = nacional
Code: LIMIT-DEDUCTIBLE Type:
array<array<answer>>❗ Obrigatório que esteja incluído no array.Campo para definir limite e franquia. Abordaremos mais detalhadamente a seguir.
Code: LIMIT Type:
decimal❗ Obrigatório que esteja incluído no array.Os valores possíveis para esta pergunta são:
Code: DEDUCTIBLE Type:
text❗ Obrigatório que esteja incluído no array. Essa é uma parte um pouco mais complicada\Pergunta usada para definir o tipo da franquia. Verifique abaixo como funciona a regra de franquias:
Response
Explicando campos de retorno
Field: success Type:
booleanIndica se a requisição foi feita com sucesso.
Field: executed Type:
dateData em que a requisição foi feita.
Field: errors Type:
arrayArray de erros ao fazer a requisição.
Field: item.quotationIdentifier Type:
guidIdentificador da cotação.
Field: item.status Type:
integerStatus da cotação.
Field: item.expiredAt Type:
dateData de expiração da cotação.
Field: item.quotationDocumentUrl Type:
textUrl do documento de cotação.
Field: item.pricing Type:
arrayRetorna as propriedades do item, taxas, valores, tipos de pagamentos. Array de items cotados. Ele pode retornar mais de 1 item também.
Field: item.pricing[].variantIdentifier Type:
guidIdentificador do item cotado.
Field: item.pricing[].underwriting.approved Type:
booleanRetorna true ou false referente as regras de subscrição do produto.
Field: item.pricing[].underwriting.evaluations Type:
arrayRetorna aviso referente as questões do questionário de risco do produto.
Field: item.pricing[].price.commission Type:
decimalComissão de corretagem.
Field: item.pricing[].price.grievanceDiscount Type:
decimalPorcentagem de agravo adicionada ao valor da cotação, onde os valores permitidos vão de 0% até 500%.
Field: item.pricing[].price.itemValue Type:
decimalValor do item.
Field: item.pricing[].price.netValue Type:
decimalValor de prêmio líquido sem o IOF.
Field: item.pricing[].price.interestValue Type:
decimalValor de juros (Por enquanto nenhum produto possui juros, nem para boleto e nem para cartão, mas futuramente terá para boleto).
Field: item.pricing[].price.taxValue Type:
decimalValor de IOF.
Field: item.pricing[].price.totalValue Type:
decimalValor de Prêmio Total, composto pelo prêmio líquido somado ao IOF.
Field: item.pricing[].price.limitDeductible Type:
objectLimites e franquias selecionadas.
Field: item.pricing[].price.limitDeductible.deductible.answer Type:
textTipo de franquia selecionada.
Field: item.pricing[].price.limitDeductible.deductible.answerText Type:
textTexto da franquia selecionada
Field: item.pricing[].price.limitDeductible.limits.answer Type:
decimalValor do limite selecionado.
Field: item.pricing[].price.limitDeductible.limits.answerText Type:
textTexto do limite selecionado.
Field: item.pricing[].price.policyLimit Type:
decimalValor de Limite da apólice.
Field: item.pricing[].price.rates Type:
arrayTrata-se de um array, que retornará todas as coberturas contratadas para o produto.
Field: item.pricing[].payment.financialType Type:
textTrata-se do tipo de financeiro que no caso é "Cobrança".
Field: item.pricing[].payment.paymentOptions Type:
arrayRetorna as opções de pagamento disponíveis que são: Boleto e Cartão de crédito.
Field: item.pricing[].price.rates[].code Type:
textExibe o código que identifica a ou as coberturas contratadas.
Field: item.pricing[].price.rates[].description Type:
textTrata-se do nome da cobertura em português.
Field: item.pricing[].price.rates[].limit Type:
decimalTrata-se do valor do limite da cobertura.
Field: item.pricing[].price.rates[].netValue Type:
decimalValor do prêmio específico de cada cobertura contratada.
Field: item.pricing[].price.rates[].deductible.code Type:
textTrata-se do código identificador de cada franquia.
Field: item.pricing[].price.rates[].deductible.text Type:
textNome da franquia selecionada em português - Ex: "Padrão".
Field: item.pricing[].price.rates[].deductible.description Type:
textDescrição da franquia.
Field: item.pricing[].payment.paymentOptions[].paymentMethod Type:
textRetorna o nome da forma de pagamento que pode ser: Ticket (Boleto) ou CreditCard (Cartão de Crédito).
Field: item.pricing[].payment.paymentOptions[].paymentType Type:
textForma de pagamento que pode ser escolhida: Boleto ou Cartão de crédito.
Field: item.pricing[].payment.paymentOptions[].installments Type:
arrayRetorna a quantidade de parcelas disponíveis para realizar o pagamento referente ao tipo de pagamento.
Field: item.pricing[].payment.paymentOptions[].installments[].identifier Type:
guidCódigo identificador da parcela. Esté é o código necessário enviar ao selecionar o método de pagamento.
Exemplo: Se foi selecionado cartão de crédito, enviar o identificador daquele meio de pagamento.
Field: item.pricing[].payment.paymentOptions[].installments[].number Type:
integerNúmero da respectiva parcela (2 parcela, número 2).
Field: item.pricing[].payment.paymentOptions[].installments[].commissionValue Type:
decimalValor de comissão de cada parcela.
Field: item.pricing[].payment.paymentOptions[].installments[].netValue Type:
decimalValor de prêmio líquido de cada parcela, ou seja, sem o IOF.
Field: item.pricing[].payment.paymentOptions[].installments[].interestValue Type:
decimalValor de juros de cada parcela.
Field: item.pricing[].payment.paymentOptions[].installments[].taxValue Type:
decimalIOF que implica em cada parcela.
Field: item.pricing[].payment.paymentOptions[].installments[].totalValue Type:
decimalValor total de cada parcela que é composto do valor líquido + IOF.
Field: item.pricing[].payment.paymentOptions[].installments[].installmentValue Type:
decimalValor total da parcela.
Field: item.pricing[].payment.paymentOptions[].installments[].installmentInterest Type:
decimalValor de juros da parcela.
Field: item.pricing[].payment.paymentOptions[].installments[].installmentTax Type:
decimalValor de IOF de cada parcela.
Field: item.pricing[].payment.paymentOptions[].installments[].dueDates Type:
array<string>Datas de vencimento da parcela caso a forma de pagamento seja boleto.
Last updated