FAQ - Integrações
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
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
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": ""
}
}
]
}Com estas correlações o app exibirá ambos os contratos
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
Determinado beneficiário não aparece na funcionalidade desejada
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
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:
Com correções a funcionalidade funcionará conforme o desejado
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 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
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
Beneficiários não conseguem acessar o cartão virtual no app.
Todos os procedimentos abaixo devem ser seguidos com cautela. Caso não possua o conhecimento técnico necessário, recomendamos que entre em contato com sua equipe de TI da Operadora ou nos acione via chamado solicitando uma agenda especial para verificação em conjunto com um técnico da Mobile Saúde.
Possíveis Soluções
1. Verificação com Login e Senha do Beneficiário
Caso a Operadora tenha o login e senha do beneficiário em questão, realize as seguintes etapas:
Acessar o Validador de Integração de Login:
Navegue até Configurador de funcionalidades → Opções de login → Login → Integrações → Login/editar.
Verificar Dados do Beneficiário:
No validador, verifique se os dados do beneficiário estão corretos.
Se forem encontrados erros, corrija-os, pois alguns erros podem impedir o login do beneficiário no app.
2. Análise Sem Login e Senha
Se não for possível obter o login e a senha do beneficiário, a recomendação é realizar uma análise mais detalhada na central de logs:
Acessar a Central de Logs:
Navegue até Segurança → Central de Logs.
Aplicar Filtros:
Aplique os filtros de Operação e Login para buscar por entradas relacionadas ao login do beneficiário.
Verificar o JSON Retornado:
Ao consultar os logs, verifique o conteúdo do JSON retornado. Isso pode ajudar a identificar erros específicos ou problemas de integração que estão impedindo o acesso ao cartão virtual.
Todos os procedimentos abaixo devem ser seguidos com cautela. Caso não possua o conhecimento técnico necessário, recomendamos que entre em contato com sua equipe de TI da Operadora ou nos acione via chamado solicitando uma agenda especial para verificação em conjunto com um técnico da Mobile Saúde.
Related content
Mobile Saúde - Mosia Omnichannel