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": "001", "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 | C: Corretor F: Filial 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. |