FAQ - Integrações
- Jean Schulz
- Ranniêr Reis
Esta documentação abrange a área de troubleshooting, essencial para resolver problemas técnicos e manter sistemas funcionando adequadamente. Exploraremos a abordagem sistemática de análise de sintomas, testes e diagnóstico, além de destacar a importância da colaboração e compartilhamento de conhecimento. O guia fornece informações valiosas para aprimorar habilidades técnicas e enfrentar desafios com confiança, garantindo a eficiência operacional. Mantenha-se atualizado com as últimas tendências nesse campo em constante evolução.
Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial
Como analisar retornos de APIs usando o painel do Mosia Omnichannel?
Contexto: Inúmeros clientes tem dificuldades de analisar situações de falha nas APIs. Muitas vezes, relatos de usuários do app para a operadora indicam que “beneficíario não consegue verificar seu extrato de autorização”, por exemplo. A operadora tem condições de realizar uma análise completa, usando o painel público
Como?
Acesse o painel público com seu usuário/senha e siga conforme esses passos: Segurança => Central de logs. Selecione as datas e horários das tentativas e filtre se desejar por Operação → Extrato de autorização.
Clique no evento e verifique os logs. Uma tela será demonstrada. O JSON de retorno conterá informações sobre o request. Para analisar o RESPONSE da API (que deve conter informações sobre o problema) vá até o fim do log, ou utilize o botão de “copiar”. A partir daí, basta colar o conteúdo em uma aplicação que indentará o JSON, tornando-o mais legível.
De acordo com o caso acima, é possível perceber que a API não devolve o resultado esperado (conteúdos válidos para exibição). Um status 400 indica que existe uma falha na obtenção de dados, e o detalhamento do erro indica que, por algum motivo, sua API não está sendo capaz de obter informações do seu ERP de saúde. Nesses casos, você deverá analisar sua API ou barramento OMNILINK para corrigir o problema.
Uma requisição bem sucedida deve ter status 200, e conteúdos compatíveis com as documentações de API. Para maiores detalhes sobre integrações usando APIs, verifique esta documentação técnica: Para integrar via API RESTFUL
Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial
Não consigo visualizar multi-cartões em meu app
Situação: Validador não critica payload de login mas mesmo assim não consigo visualizar multi-cartões no meu app.
Solução: Nosso validador de integração checa erros de integridade no payload das requisições, regras de negócio são específicos de cada Operadora com isso não sendo possível criticar todos as possíveis regras de negócio que são implementadas na Operadora.
Para que seja exibido o beneficiário em contratos distintos é necessário que:
o array
beneficiarioso objeto que contenha o beneficiário possua com o objetodadosDoContrato>numeroContratoestejam iguais ao arraycontrato>numeroContratoestejam iguaisNo exemplo de payload abaixo temos:
chaveUnica: 11111111111; numeroContrato: 999999
chaveUnica: 22222222222; numeroContrato: 888888
"beneficiarios": [
{
"chaveUnica": "11111111111",
"integracao": {
"chaveBeneficiario": ""
},
"dadosPessoais": {
"nome": "",
"sexo": {
"codigo": "",
"descricao": ""
},
"dataNascimento": "",
"contato": {
"email": "",
"telefoneCelular": "",
"telefoneFixo": ""
},
"cpf": "",
"estadoCivil": {
"codigo": "",
"descricao": ""
}
},
"dadosDoContrato": {
"numeroContrato": "999999"
},
"dadosDoPlano": {
"beneficiario": "",
"idPlano": "",
"descricao": "",
"registroAns": "",
"segmentacao": "",
"acomodacao": "",
"tipoContratacao": "",
"regulamentacao": "",
"abrangencia": "",
"modalidadeCobranca": "",
"padraoConforto": "",
"participativo": "",
"dataInicioVigenciaPlano": "",
"dataFinalCpt": "",
"dataInclusao": "",
"matricula": "",
"matriculaAntiga": "",
"matriculaFuncionario": "",
"tipoUsuario": {
"codigo": "",
"descricao": ""
},
"grauParentesco": {
"codigo": "",
"descricao": ""
},
"redeAtendimento": "",
"carencia": [
{
"tipoServico": "",
"carencia": ""
}
]
},
"cartao": {
"modeloCartao": "",
"numeroCartao": "",
"validade": "",
"via": ,
"numeroCns": "",
"apresentaCartaoVirtual": ,
"nomeCartao": "",
"convenioAbrangenciaVerso": ""
},
"custom": {}
},
{
"chaveUnica": "22222222222",
"integracao": {
"chaveBeneficiario": ""
},
"dadosPessoais": {
"nome": "",
"sexo": {
"codigo": "",
"descricao": ""
},
"dataNascimento": "",
"contato": {
"email": "",
"telefoneCelular": "",
"telefoneFixo": ""
},
"cpf": "",
"estadoCivil": {
"codigo": "",
"descricao": ""
}
},
"dadosDoContrato": {
"numeroContrato": "888888"
},
"dadosDoPlano": {
"beneficiario": "",
"idPlano": "",
"descricao": "",
"registroAns": "",
"segmentacao": "",
"acomodacao": "",
"tipoContratacao": "",
"regulamentacao": "",
"abrangencia": "",
"modalidadeCobranca": "",
"padraoConforto": "",
"participativo": "",
"dataInicioVigenciaPlano": "",
"dataFinalCpt": "",
"dataInclusao": "",
"matricula": "",
"matriculaAntiga": "",
"matriculaFuncionario": "",
"tipoUsuario": {
"codigo": "",
"descricao": ""
},
"grauParentesco": {
"codigo": "",
"descricao": ""
},
"redeAtendimento": "",
"carencia": [
{
"tipoServico": "",
"carencia": ""
}
]
},
"cartao": {
"modeloCartao": "",
"numeroCartao": "",
"validade": "",
"via": ,
"numeroCns": "",
"apresentaCartaoVirtual": ,
"nomeCartao": "",
"convenioAbrangenciaVerso": ""
},
"custom": {}
}
}
Precisam os atributos
dadosDoContrato>numeroContratoprecisam esta de acordo com o arraycontrato>numeroContratono payload abaixo:
{
"contratos": [
{
"descricaoContrato": "CONTRATO 1",
"numeroContrato": "999999",
"empresaContratante": {
"codigo": "",
"descricao": ""
},
"tipoPessoa": {
"codigo": "",
"descricao": ""
},
"tipoRelacionamento": {
"codigo": "",
"descricao": ""
},
"tipoContratante": {
"codigo": "",
"descricao": ""
},
"dataInicioVigenciaContrato": "",
"dadosTitular": {
"matricula": "",
"nome": ""
}
},
{
"descricaoContrato": "CONTRATO 2",
"numeroContrato": "888888",
"empresaContratante": {
"codigo": "",
"descricao": ""
},
"tipoPessoa": {
"codigo": "",
"descricao": ""
},
"tipoRelacionamento": {
"codigo": "",
"descricao": ""
},
"tipoContratante": {
"codigo": "",
"descricao": ""
},
"dataInicioVigenciaContrato": "",
"dadosTitular": {
"matricula": "",
"nome": ""
}
}
]
}
Determinado beneficiário não aparece na funcionalidade desejada
Caso todos os procedimentos de integração e regra de negócios da operadora estejam corretos, se faz necessário verificar algumas etapas:
1 - Verifique o objeto de permissões do login desejado (conforme nossa documentação1.1 - Login )
2 - Verifique se existe a integração do método beneficiariosAcessoFuncionalidade se a mesma está configurado, em caso de positivo verifique se os dados do contrato e chaveUnica batem com os do login informado, como no exemplo abaixo:
Como funciona o Relogin? Quero implementar!
Temos nossa documentação para implementar a rotina de relogin, para saber em mais detalhes e de forma simplificada basta assistir esse nosso vídeo.
Documentação - Relogin: 1.8 - Relogin
Documentação - Login : 1.1 - Login
Mobile Saúde - Mosia Omnichannel