Dúvidas comuns referente ao uso do Broker

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Existe o array de objetos: search.businessItem.insurance.brokers:

"brokers": [ {
"sucursalCode": "{{sucursalCode}}",
"susepCode": "{{susepCode}}",
"isMain": true,
"percentageCommission": 10,
"percentageParticipation": 100
}],

Em sucursalCode e susepCode :

  • Devemos enviar o código do corretor que foi escolhido pelo cliente para esse seguro?

  • Será enviado um código de sucursal travado para o parceiro, ou será que acordo com cada
    corretor escolhido?

  • Devemos enviar apenas o objeto de um corretor, ou também algum identificando ao
    parceiro como prestador?

  • Caso seja necessário enviar informações para identificar o parceiro como prestador, como
    devemos enviar?

Resposta / Solução

  • Devemos enviar o código do corretor que foi escolhido pelo cliente para esse seguro?
    R: Sim

  • Será enviado um código de sucursal travado para o parceiro, ou será que acordo com cada
    corretor escolhido?
    R: Será de acordo com cada corretor escolher.

  • Devemos enviar apenas o objeto de um corretor, ou também algum identificando ao
    parceiro como prestador?
    R: Apenas o objeto do corretor.

  • Caso seja necessário enviar informações para identificar o parceiro como prestador, como
    devemos enviar?
    Não precisa enviar.
    Conseguimos identificar o parceiro pela APIkey.
    Hoje existe o campo X-Track-Id no header para identificação da cotação pela corretora.

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Gerar Ofertas/Cotação | Erro Unauthorized broker

Resposta / Solução

Este erro ocorre sempre que alguma destas informações estiverem erradas, ou, caso corretas, não estiverem vinculadas entre si:
sucursalCode:
susepCode:
X-User-Id:

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Poderiam fornecer os dados de um corretor para simularmos o cenário abaixo:
"Incluir um corretor na Co-Corretagem e efetivar com opção de carnê à vista".

Resposta / Solução

Nos casos de co-corretagem, não passamos dados de corretores, portanto, pode ser utilizado
os corretores vinculados aos parceiros.
Referente ao uso desta opção, deve-se informar os dois corretores com seus respectivos dados e
percentuais, conforme abaixo:

"broker": [
{
"sucursalCode": "001",
"typeCode": "C",
"susepCode": "00000111111111",
"isMain": true,
"percentageParticipation": 90
},
{
"sucursalCode": "045",
"typeCode": "C",
"susepCode": "00000222222222",
"isMain": false,
"percentageParticipation": 10
}
],

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Tentativa de efetivação Co-corretagem, estamos obtendo no retorno que a soma da participação
é maior que 100% , porém, estamos enviando participação da Susep 1 = 90% e Susep 2 = 10% .

Pode nos pontuar, por gentileza ?

Resposta / Solução

Quando ocorrerem erros referentes a co-corretagem, deve-se verificar os dois suseps
informados e ver se este não se encontra repetido, ou se o mesmo é válido.

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Favor verificarem o que ocorre na situação de co-corretor.
A API não está deixando nem calcular e nem transmitir, sempre gerando a mensagem de erro:

Data input not supplied or invalid
Inform Only One Main Broker

Testamos em SOAP e está funcionando normalmente, inclusive transmitindo.
(Anexo segue o PDF da Transmissão)

Nos exemplos de cálculo tem o envio
dos dois corretores. Se enviar apenas 1 corretor
com percentual de participação menor que 100%, retorna erro que a somatória precisa ser
100%, o que me indica que está sendo feito alguma validação de somatória de participação
que tem que ser 100% no total.

Então foi testado enviando 90% para o corretor principal e 10% para o corretor.

Resposta / Solução

Na Efetivação só pode informa 1 corretor principal.

Por favor alterar o "isMain" para false dos outros corretores.

exemplo:
"broker": [
{
"sucursalCode": "045",
"typeCode": "C",
"susepCode": "00000100196207",
"isMain": true,
"percentageParticipation": 90
},
{
"sucursalCode": "045",
"typeCode": "C",
"susepCode": "00000100195995",
"isMain": false,
"percentageParticipation": 10
}

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Como habilitar novos corretores?

Resposta / Solução

No caso, para novos corretores, deve-se solicitar o cadastro deles para a equipe comercial que atende o player.

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Como diferenciar os corretores C ou F

Resposta / Solução

Deve-se informar o mesmo através do campo typeCode. Veja o print abaixo.

Nome do Serviço

API de Oferta

Processo

Request

Dúvida / Problema

Precisamos definir como será enviado o codigo Broker (Corretor).

Hoje no SOAP tanto faz enviar com os zeros a esquerda ou não, é calculado, porem na API está
me obrigando a enviar zeros a esquerda. Isto me preocupa, pois se não enviar os zeros a
esquerda, retorna erro de Broker não autorizado e em nosso banco de dados, a grande maioria
está cadastrado sem zero a esquerda e funcionando em SOAP

Veja:

Se enviar 00000100203491 ou 100203491 em SOAP calcula, mas na API tem que enviar 00000100203491.
Logo, estou entendendo que sempre deverá ser um número com 14 posições para a API? A API
poderia aceitar o código SUSEP da mesma forma que é enviado no SOAP?

Resposta / Solução

Sim, o código Susep na API está formatado com 14 posições.