Dúvidas Gerais

Nome do Serviço

API de Oferta

Processo

Request

Dúvida/Problema

Renovação

Resposta/Solução

Para efetuar a renovação, deve-se informar o seguinte grupo de TAGs "previousPolicy ", onde é formado por:

  • code
  • congenerCode
  • expirationDate

Lembrando que, ao gerar a proposta, estes dados também serão informados no grupo de tag "previousPolicy " da API de Proposta

Nome do Serviço

API de Oferta

Processo

Request

Dúvida/Problema

Plano (coverageId): 4 - Valor Determinado

Resposta/Solução

Valor Determinado: Modalidade que garante ao Segurado, no caso de indenização integral, o pagamento de quantia fixa, em moeda corrente nacional, estipulada pelas partes no ato da contratação do seguro.

Nome do Serviço

API de Oferta

Processo

Request

Dúvida/Problema

Regra referente a Melhor Data

Resposta/Solução

Melhor Data (somente na forma de pagamento débito):

  • informar o installmentDay no cálculo, onde:
    - O mesmo só pode ser um dia com, no máximo, 15 dias corridos (contando o dia da vigência - campo effectiveDate) - Ex. Cotação vigência dia 01, melhor dia pode ser até dia 15;
    • No response do cálculo retornará o tipo de pagamento "débito - melhor data", onde ele vem marcado como melhor data true;

OBS1: Se não melhor data, não deve se informar o campo installmentDay.
OBS2: Quando citamos o dia, queremos dizer que este é o dia, efetivamente, do mês. Exemplo: dia 01, dia 15, dia 30, etc.

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Hoje temos em nosso formulário o campo "Isenção Fiscal (IPI/ICMS)" com as opções "Não
se aplica", "PCD com isenção" e "PCD sem isenção". Se selecionada pelo corretor alguma
das duas últimas opções, devo bloquear a cotação informando que não é possível calcular
esta modalidade na HDI? Pois não encontrei onde enviar esta informação na API.

Resposta / Solução

Nós (HDI) tratamos os casos com isenção fiscal utilizando o código FIPE, que passou a ser
tarifado na ponta no HDI Digital em 2018. Nesta situação, o sistema disponibiliza a contratação
normalmente, porém com redução do percentual Fipe para 80%. Essa redução ocorre devido ao
pagamento de impostos no caso de indenização integral, que é uma obrigação da seguradora.

No caso de um veículo adquirido com isenção fiscal anteriormente, mas que já passou o prazo
de isenção (4 anos) ou veículos adquiridos por pessoas sem deficiência, o seguro é tratado
caso a caso pois precisa de intervenção da filial, uma vez que pode ser contratado com 100%
Fipe.

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Dentro dos payloads da HDI temos identificados os produtos:

  • Auto Perfil
  • Colisão e Incêndio
  • Colisão, Incêndio, Roubo e Furto
  • Incêndio, Roubo e Furto
  • Colisão, Perda total, Incêndio, Roubo e Furto

A SUSEP classifica os tipos de seguro em:

  • Compreensiva
  • Proteção contra roubos e furtos
  • Cobertura em desastres
  • Indenização em perda total
  • Seguro de terceiros

Precisamos da ajuda de vocês para classificar os produtos de vocês dentro do que a SUSEP
permite de seguros, já sabemos que o Auto Perfil é o seguro compreensivo da HDI, mas e o resto?

Resposta / Solução;

Classificação SUSEP dos tipos de seguros:

  • Compreensiva
    1 - HDI AUTO PERFIL
    - Plano (coverageId): 3 - Valor de Mercado Referenciado
    - Plano (coverageId): 4 - Valor Determinado
  • Proteção contra roubos e furtos [430, 431 e 436]
    1 - HDI AUTO PERFIL
    - Plano (coverageId): 3 - Valor de Mercado Referenciado
    - Plano (coverageId): 4 - Valor Determinado
    2 - HDI FIT
    - Plano (coverageId): 5 - Incêndio, Roubo e Furto
    - Plano (coverageId): 6 - Incêndio, Roubo, Furto e PT colisão
    3 - HDI FLEX
    - Plano (coverageId): 8 - Colisão, Incêndio, Roubo e Furto
  • Cobertura em desastres Natural [alagamentos, fortes chuvas, vendaval, chuva de granizo,
    terremoto, queda de árvores]
    - SEM PRODUTOS INFORMADOS
    Não tratado nas APIs do OpenInsurance
  • Indenização em perda total [431 e 430]
    1 - HDI AUTO PERFIL
    - Plano (coverageId): 3 - Valor de Mercado Referenciado
    - Plano (coverageId): 4 - Valor Determinado
    2 - HDI FIT
    - Plano (coverageId): 6 - Incêndio, Roubo, Furto e PT colisão
  • Seguro de terceiros
    1 - HDI AUTO PERFIL
    - Plano (coverageId): 3 - Responsabilidade Civil

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

A API aceita dois condutores?

Resposta / Solução

Caso sejam informados dois corretores, realmente o procajusta realizou a tarefa de
excluir um dos condutores corretamente.
A impressão deve apresentar somente um de acordo com a regra: "Informe o Condutor
Principal que utiliza o veículo por 2 (duas) ou mais vezes na semana. Na impossibilidade de
medir o tempo, indique o condutor mais jovem"

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Atualmente efetuamos cotações via robô na HDI para moto (435 - HDI MOTO) e caminhões (131 -
HDI AUTO), porém estes produtos ainda não estão disponíveis via API. Também utilizamos o
produto 131 para efetuar cotações PJ com perfil indeterminado (sem condutor principal). Existe
uma possibilidade de estes produtos entrarem no roadmap desta API?

Resposta / Solução

Os produtos: Moto, caminhão e frota estão em desenvolvimento, assim como todos os produtos
que temos na HDI, como, por exemplo, o residencial.
Sobre os demais produtos e funcionalidades, tanto para atender o pré e o pós venda, estão
em nosso roadMap aguando a priorização de nossa área de negócio.

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

O sistema não esta aceitando data de vigência retroativa com mais de 5 dias, no caso de renovações.

Resposta / Solução

A HDI não aceita renovação com data retroativa com mais de 5 dias.
Ex: Se dia 8/02/2021 é permitido cotar limitado até o dia 03/02/2021.

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Quando envio o seguinte array na rota de cotação, recebo o erro dizendo que o CPF (Que
no caso é RG) está inválido

Request Body:

"documents": [{
"type": {
"id": 1
},
"number": "45608246810"
},{
"type": {
"id": 3
},
"number": "372218994"
}],

Response Body:

{
"errors": [
{
"message": "CPF-CNPJ Inválido. (372218994)",
"nativeMessage": "S"
},
{
"message": "Erro na execucao das consistencia da Cotacao.",
"nativeMessage": "ERROCONSISTE"
},
{
"message": "CPF-CNPJ Inválido. (372218994)",
"nativeMessage": "S"
},
{
"message": "Erro na execucao das consistencia da Cotacao.",
"nativeMessage": "ERROCONSISTE"
},
{
"message": "CPF-CNPJ Inválido. (372218994)",
"nativeMessage": "S"
},
{
"message": "Erro na execucao das consistencia da Cotacao.",
"nativeMessage": "ERROCONSISTE"
},
{
"message": "CPF-CNPJ Inválido. (372218994)",
"nativeMessage": "S"
},
{
"message": "Erro na execucao das consistencia da Cotacao.",
"nativeMessage": "ERROCONSISTE"
}
]
}

Resposta / Solução

No offer você deve informa apenas o CPF.
O RG você preenche na API de efetivação.

Nome do Serviço

API de Oferta

Processo

Response

Dúvida/Problema

Regra referente a Melhor Data

Resposta/Solução

Melhor Data (somente na forma de pagamento débito):

  • informar o installmentDay no cálculo, onde:
    • O mesmo só pode ser um dia com, no máximo, 15 dias corridos (contando o dia da vigência - campo effectiveDate) - Ex. Cotação vigência dia 01, melhor dia pode ser até dia 15;
      - No response do cálculo retornará o tipo de pagamento "débito - melhor data", onde ele vem marcado como melhor data true;

OBS: Quando citamos o dia, queremos dizer que este é o dia, efetivamente, do mês. Exemplo: dia 01, dia 15, dia 30, etc.

Nome do Serviço

API de Oferta

Processo

Response

Dúvida / Problema

Demais produtos da HDI.
Como identificamos o Retorno dos demais produtos de Auto? (ex: Flex)

Resposta / Solução

Na documentação da API de "Gera Ofertas/Cotação", no response, você pode
diferenciar o produto no atributo:

offers[]."items"[]."segment"[]."components"[]."compositions"[*]."description"

A documentação das APIs encontram-se em:
https://developers.hdi.com.br/

Nome do Serviço

API de Oferta

Processo

Response

Dúvida / Problema

O X-Track-Id vocês retornam no Header do responde da chamada de Cálculo, porém, para
nós pegarmos esse id, teríamos que mexer em toda a infrasestrutura do nosso servidor de
cálculos que opera hoje, poderia por gentiliza avaliar alimentar esse ID no JSON de retorno do
cálculo, pois assim fariamos a tratativa direto no response do cáculo para poder consumir na
transmissão, pdf etc....

Resposta / Solução

Referente ao X-Track-Id trata-se de um dado de identificação do response e funcionado como o
agrupador das ofertas apresentadas.
Esta implementação está de acordo com a
definição RESTFUL, é utilizado para outras etapas do processo de cotação como citados
por você, impressão, transmissão e etc. E este parâmetro também utilizado para identificação
do negócio nos logs das APIs.
Como sugestão, alguns parceiros estão
construindo um novo objeto a ser tratado pela aplicação, onde neste é feito o agrupamento dos
dados de header e body do response.
{
header: {
server: "istio-envoy"
date: "Mon, 01 Jun 2020 19:53:12 GMT"
content-type: "application/json;charset=UTF-8"
x-track-id: "cc938776-e9a8-47af-a903-de9e0f64b4a2"
x-envoy-upstream-service-time: "29180"
},
body: {
"offers": [
{...},
{...},
{...},
]
}
}

Nome do Serviço

API de Oferta

Processo

Response

Dúvida / Problema

O que é o businessNotification?

Resposta / Solução

O campo chamado "businessNotification" no retorno das ofertas, conterá as informações de
ajustes feitas pela própria HDI para adequar as opções de cobertura naquele determinado
cálculo.
A mesma retornará um bloco (vide Json exemplo em anexo), com as mensagens informativas
Exemplo_businessNotifications.json e, caso ocorram, ajustes.
Em "description" estará a descrição e em "type" o tipo.

            "businessNotifications": [
                {
                    "description": "Ajuste do valor determinado. De 0,00 para 12.621,65 (variacao minima de 85% Tabela FIPE)",
                    "type": "Info"
                },
                {
                    "description": "Cotação sem análise, sujeita a aprovação da CIA.",
                    "type": "Info"
                }
            ],

Nome do Serviço

API de Oferta

Processo

Response

Dúvida / Problema

Quando a HDI não retornar nas ofertas uma oferta com o mesmo composition e ID da
cobertura solicitados no cálculo, aqui no multicálculo iremos apresentar uma mensagem
no retorno do "produto principal" informando o corretor de que não houve oferta com as
coberturas que ele selecionou no formulário, porém exibiremos as demais ofertas (por mais
que tenham outras coberturas) como sendo "produtos adicionais". Nesse caso, gostaríamos
de saber se a HDI deseja que seja exibida uma mensagem específica para estes casos e qual
seria esta mensagem.

Resposta / Solução

Da forma que a nossa plataforma está estruturada para funcionar hoje, são somente
apresentados ao corretor "produtos adicionais" ou ofertas adicionais) quando o "produto
principal" (ou oferta principal, a qual as coberturas são exatamente as solicitadas pelo
corretor no cálculo) é retornado com sucesso, ou seja, com o prêmio.

Nome do Serviço

API de Oferta

Processo

Request
Response

Dúvida / Problema

Qual o tempo médio para retorno da cotação em produção?

Resposta / Solução

O tempo de calculo médio de calculo é menor de 1 seg.
Pode chegar em momentos de grande movimento a cerca de 4 segs.