Autenticação de beneficiários e/ou profissionais de saúde
- Jean Schulz
- Geovane Henrique Pinto da Costa
- Dáviny Messias Rocha (Unlicensed)
Informações
Avisos
- Só são suportadas integrações no padrão REST.
- O campo "Regra de preenchimento" esclarece quais regras / validações serão aplicadas ou quais os conteúdos serão permitidos ou rejeitados. As ações descritas aqui devem ser implementadas por seus WS, evitando que os conteúdos inválidos sejam criticados pelo nosso sistema de integrações.
Critérios de preenchimento
| Abreviação | Nome | Descrição |
|---|---|---|
| M | Mandatório | O preenchimento do atributo é obrigatório. Caso o atributo esteja nulo ou em branco, seu "response" será rejeitado. |
| C | Condicional | O atributo pode tornar-se obrigatório quando um ou mais atributos auxiliares for preenchido / atualizado. |
| OP | Opcional | Seu preenchimento não é obrigatório. Pode-se enviar NULL para objetos, ou arrays vazios para tipos Array |
Método "login"
Este serviço é utilizado para autenticar o usuário por meio de login e senha previamente cadastrada. Este método é único para beneficiário e profissionais de saúde. Como premissa, é fundamental que o Login de usuário seja uma informação que consiga identificar o usuário nos dois perfis, por exemplo, o CPF da pessoa.
Regras de negócio
- De acordo com a estrutura de sua empresa, o método de login pode devolver estruturas de login que permitam o acesso a alguns perfis de usuário:
- Login de beneficiário;
- Login de profissional de saúde;
- Login de beneficiário + profissional de saúde (quando um profissional de saúde também é um beneficiário de plano de saúde);
- Regras gerais e orientações:
- O Endpoint de login deve validar todas as suas regras de negócio, permitindo acesso apenas a usuários autorizados;
- O Endpoint deverá retornar o usuário que fez login, e de acordo com o perfil, poderá enviar ainda mais informações;
- Regra e estrutura sugerida para o retorno do perfil do Beneficiário:
- Retorna os seus dados + dados dos dependentes;
- Retorna os seus dados + os demais dependentes (não retorna os dados do titular);
- Retorna apenas os dados do beneficiário logado;
- Quando o usuário for um titular;
- Quando o usuário for o cônjuge;
- Quando for outro tipo de dependente (filho, filha, etc);
- Dica: retorne apenas dados que possam ser exibidos. Se um beneficiário da família estiver, por exemplo, bloqueado ou impedido de utilizar o plano, não devolva-o no retorno do endpoint.
- Regra sugerida para o perfil do profissional de saúde:
- Caso seu sistema identifique que o usuário logado também é um profissional de saúde, o método deve retornar a estrutura dedicada aos profissionais de saúde;
- Quando o perfil for exclusivamente profissional de saúde, não é necessário retornar a estrutura de beneficiário;
- Quando o perfil for exclusivamente beneficiário, não é necessário retornar a estrutura de profissional de saúde;
- Quando o perfil for beneficiário e profissional de saúde, retornar todas as estruturas descritas no layout;
- Caso o usuário autenticado possua mais de um contrato, esses devem ser descritos no item Contratos e o array de beneficiário e de profissional de saúde deve conter as informações de todos os contratos;
- Ex.: Beneficiário possui um plano de saúde com um filho dependente e um plano odontológico sem dependentes. Os dois contratos precisam estar descritos no array Contratos e o array Familia vai conter 3 objetos (dois do plano de saúde e um do plano odontológico). Essa mesma lógica se aplica à estrutura do profissional de saúde;
Endpoint
Endpoint | Método | Header Content-Type | Descrição |
|---|---|---|---|
exemplo.com/login Atenção O endpoint obrigatoriamente deve terminar com "/login". | POST | application/json | Endpoint de login |
Parâmetros de entrada
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
login | M | String | ID de identificação do usuário do app. Utilize o CPF do usuário. Importante: caso seu beneficiário tenha mais de um plano (ou mais de uma matricula), vc deverá implementar com muita atenção o objeto contratos. Não recomendamos, sob nenhuma hipótese, o uso de matrícula para identificar o beneficiário no método de login. |
senha | M | String | Senha de acesso informada pelo usuário no momento do login. |
Request body
{
"login": "<login>",
"senha": "<senha>"
}
Objetos e atributos de retorno
Atenção
Os atributos devem seguir exatamente os mesmos nomes indicados nesta documentação, caso contrário, serão rejeitados pelo validador de integração.
Exemplo do atributo "usuarioLogado":
usuario-logadousuario_logadousuario- usuarioLogado
IMPORTANTE:
SOBRE TOKENS DE SEGURANÇA OU AUTENTICAÇÃO:
A Mobile Saúde descreve nesta documentação o formato de adoção obrigatória quando sua empresa desejar utilizar TOKENS de segurança.
O formato suportado pela aplicação está descrito no objeto SEGURANÇA, e sua empresa deve necessariamente implementa-lo conforme descrito quando desejar utilizar essa camada adicional de segurança.
Não serão suportadas outras formas de transacionar TOKENs de segurança, como por exemplo tokens de autenticação na URL da requisição, entre outros.
Caso tenha dúvidas, ou deseje maiores esclarecimentos, entre em contato com o gestor de projeto encarregado de sua implantação, para atendimento às questões ANTES DE DESENVOLVER SUA API.
SOBRE OBJETO PERMISSÕES:
Devemos somente informar na estrutura de permissões dentro do objeto contratos as funcionalidades que o usuário não tem acesso ou ocultar caso queira que não apareça, mas para requisito de validação da estrutura do beneficiário, eleger uma ou mais funcionalidades junto com a equipe de desenvolvimento da Mobile Saúde para facilitar os testes de permissionamento.
Lembrando que a tabela de funcionalidades está no final do documento de especificações.
Exemplo de uso:
1 - Funcionalidade negada com mensagem customizada
"permissoes": [ {
"funcionalidade": "1",
"acesso": false,
"mensagemBloqueio": "Você não possui acesso a está funcionalidade, para mais informações entre em contato com 0800",
"ocultar": false
}]
2 - Funcionalidade negada sem mensagem customizada, será exibida uma mensagem padrão
"permissoes": [ {
"funcionalidade": "1",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": false
}]
3 - Funcionalidade oculta no app
"permissoes": [ {
"funcionalidade": "1",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": true
}]
4 - Acesso liberado
"permissoes": null
Descrição dos objetos e atributos de retorno - Sucesso
Está indicado abaixo a estrutura de retorno do seu método login. Esse método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.
Objeto principal
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| status | M | Boolean | Indica que o login foi realizado corretamente | true |
| usuarioLogado | M | Objeto usuarioLogado | Usuário que efetuou login | Objeto precisa ter sua estrutura completamente preenchida. |
| beneficiarios | C | Array de objetos "beneficiario" | Array que contém todos os beneficiários vinculados ao login | Se contrato possuir tipo = "beneficiario", obrigatório ter a menos 1 registro com conteúdo válido. Caso contrário, não enviar o atributo ou preencher com o valor NULL |
| profissionaisSaude | C | Array de objetos "profissionalSaude" | Array que contém todos os profissionais de saúde vinculados ao login. | Se contrato possuir tipo = "profissionalSaude", obrigatório ter a menos 1 registro com conteúdo válido. Caso contrário, não enviar o atributo ou preencher com o valor NULL |
| contratos | M | Array de objetos "contrato" | Indique ao menos um contrato que está vinculado ao login. | Deve-se ter no mínimo 1 ocorrência válida, que tenha relação com um elemento do array "beneficiario" ou "profissionalSaude" |
| mosia | OP | Objeto "mosia" | Identifique os atributos que permitem ao usuário do aplicativo ser corretamente encaminhado para o atendente do MOSIA. | Preencher quando possuir o produto Mosia. Caso não tenha o produto contratado, não enviar o atributo ou preencher com o valor NULL |
| agenteRelacionamento | OP | Array de objetos "agenteRelacionamento" | Indique os dados de atendentes que estarão disponíveis para serem visualizados como "contatos de atentes de atendimento". | Preencher o array com objetos do tipo "agenteRelacionamento". Se não tiver nenhum contato desse tipo, não enviar o atributo ou preencher com o valor NULL |
| seguranca | OP | Objeto "seguranca" | Lista parâmetros que devem ser enviados no header dos demais endpoints de integração do sistema para garantir que o beneficiário está autenticado no sistema. | Preencher com o objeto do tipo "seguranca". Se não for utilizar não informar, ou informar com o valor "NULL" |
Objeto usuariologado
Essa estrutura contém os dados do usuário logado.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| localizadorMensageria | M | String | Este código será utilizado para registrar o usuário na plataforma de mensageria para envio de notificações. Ele precisa ser um CÓDIGO ÚNICO, capaz de identificar o usuário logado independente de seu contrato ou perfil. Um bom exemplo de código localizador é o CPF do usuário. | ASCII (nao permite especiais - sem acentos, por exemplo) |
| login | M | String | A mesma informação digitada pelo usuário | ASCII (nao permite especiais - sem acentos, por exemplo) |
| integracao | M | Objeto | Informações necessárias para realizar a identificação do beneficiário no sistema ERP do cliente. Deve existir um objeto idêntico para cada um dos beneficiários no array "beneficiarios". Dessa forma, será possível identificar no sistema ERP do cliente qual usuário está logado. | A regra de preenchimento deve obedecer a estrutura chave / valor. Objetos complexos (array de objetos) não são suportados. |
Objeto beneficiario
Essa estrutura contém os dados básicos de um beneficiário de plano de saúde.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| matricula | M | String | Matrícula do beneficiário. Informar a matrícula completa, sem espaços ou caracteres especiais | ASCII (nao permite especiais - sem acentos, por exemplo). Será impressa no cartão |
| matriculaAntiga | OP | String | Matrícula do beneficiário no sistema antigo. Em alguns casos o cliente continua utilizando a matrícula do sistema antigo mesmo após trocar de sistema de gestão, para manter funcionando integrações com outros sistemas legados. Por este motivo é importante termos essa informação. | ASCII (nao permite especiais - sem acentos, por exemplo) |
| matriculaFuncionario | OP | String | Indicar o código da matrícula de funcionário na empresa patrocinadora, caso aplicável. | ASCII (nao permite especiais - sem acentos, por exemplo) |
| matriculaTitular | M | String | Informe a matrícula do titular | ASCII (nao permite especiais - sem acentos, por exemplo). Informar a matrícula do titular da família. Se o beneficio em questão for o próprio titular, repita o conteúdo o campo “matricula” |
| nomeTitular | M | String | Informe o nome do titular | ASCII (nao permite especiais - sem acentos, por exemplo). Informe o nome do titular da família. Se o beneficio em questão for o próprio titular, repita o conteúdo o campo “nome” |
| emailTitular | OP | String | Informe o e-mail do titular | Validar com regras de e-mail válido, se preenchido. |
| telefoneTitular | C | String | Informe o telefone do titular | Permitir entrada somente números, tamanho mínimo / máximo 10, caso comprado os serviços de MENSAGERIA e/ou TELEMEDICINA este campo torna-se do tipo "M" - Mandatório DDD + NNNNNNNNNN 8646166114 |
| celularTitular | C | String | Informe o telefone celular do titular | Permitir entrada somente números, tamanho mínimo / máximo 11, caso comprado os serviços de MENSAGERIA e/ou TELEMEDICINA este campo torna-se do tipo "M" - Mandatório DDD + NNNNNNNNNN 27999826284 |
| cpfTitular | M | String | Informe o CPF do titular | Permitir entrada somente números. Informe o número do CPF do titular da família. Se o beneficio em questão for o próprio titular, repita o conteúdo o campo “cpf” |
| nome | M | String | Nome do beneficiário | Não permitir números, nem caracteres especiais. Permitido acentos |
| nomeSocial | OP | String | Informe o nome social do beneficiário | Não permitir números, nem caracteres especiais. Permitido acentos |
| sexo | M | String | Informar o sexo do usuário | M = Masculino / F = Feminino / N = Não se aplica. Apenas maiúsculos |
| dataNascimento | M | String | Data de nascimento do beneficiário | Formato: YYYY-MM-DD |
| cpf | OP | String | CPF do beneficiário | Somente números. Tamanho mínimo / máximo 11 posições. |
| celular | OP | String | Informar o numero do telefone celular do beneficiário | Permitir entrada somente números, tamanho mínimo / máximo 11, caso comprado os serviços de MENSAGERIA e/ou TELEMEDICINA este campo torna-se do tipo "M" - Mandatório DDD + NNNNNNNNNN 27999826284 |
| telefone | C | String | Informe o número de telefone do beneficiário | Permitir entrada somente números, tamanho mínimo / máximo 10, caso comprado os serviços de MENSAGERIA e/ou TELEMEDICINA este campo torna-se do tipo "M" - Mandatório DDD + NNNNNNNNNN 8646166114 |
| C | String | Email precisa ser válido. | ||
| endereco | OP | String | Endereço | Formato: Texto livre. |
| bairro | OP | String | Bairro | Formato: Texto livre. |
| cep | OP | String | CEP | Formato: Texto livre. |
| cidade | M | String | Cidade | Enviar conforme descrição do IBGE |
| estado | M | String | Estado | Enviar conforme sigla do IBGE (SC, ES, SP, RJ, etc). Tamanho mínimo / máximo 2 posições. Somente letras. Apenas maiúsculas |
| complemento | OP | String | Complemento do endereço | Formato: Texto livre. |
| numeroEndereco | OP | String | Número do endereço | Formato: Texto livre. |
| tipoUsuario | M | String | Informe o tipo de usuário | T = Titular / D = Dependente / A = Agregado. Importante. Só pode existir um (1) usuário no Array de beneficiários com a propriedate tipoUsuario = T por contrato |
| grauParentescoId | M | String | Código do grau de parentesco do beneficiário em relação ao titular | Indicar o ID do grau de parentesco |
| grauParentescoDescricao | M | String | Descrição do Grau de Parentesco | Formato: Texto livre. |
| dataContratacao | M | String | Data da contratação do plano de saúde. Obrigatório PIN-SS conforme RN 389. | Formato: YYYY-MM-DD |
| dataInicioCobertura | M | String | Data do início da cobertura contratual do beneficiário no plano privado de assistência à saúde. Obrigatório no cartão devido a RN 389 | Formato: YYYY-MM-DD |
| convenioId | M | String | Código do plano (produto) do usuário. Este código é fundamental para diferenciação da imagem do cartão, direcionamento (segmentação) de campanhas, mensagens e notícias, além de diversas outras funções no aplicativo e web. | Formato: Texto livre. |
| convenioDescricao | M | String | Texto descritivo do nome do plano (produto) do beneficiário. Informar o nome comercial junto a ANS | Formato: Texto livre. |
| convenioAbrangencia | OP | String | Texto descritivo da abrangência do plano (produto) do beneficiário. Informe aqui a abrangência (estadual, municipal, grupo de municípios) ou detalhe as informações conforme seu entendimento legal. Obrigatório no cartão devido a RN 389 | Formato: Texto livre. |
| convenioAbrangenciaVerso | OP | String | Texto descritivo da abrangência contido no verso do cartão do PTU 5.1. Não tem efeito para operadoras fora do sistema Unimed | Formato: Texto livre. |
| convenioAcomodacao | OP | String | Texto descritivo do padrão de acomodação do plano do beneficiário, conforme ANS | Formato: Texto livre. |
| convenioModalidadeCobranca | OP | String | Texto descritivo da modalidade de cobrança do contrato do beneficiário, como por exemplo: Pré-pagamento, Pós-pagamento e etc. | Formato: Texto livre. |
| convenioPadraoConforto | OP | String | Texto descritivo do padrão de conforto do plano (produto) | Formato: Texto livre. |
| convenioParticipativo | OP | Boolean | Campo para informar se o plano (produto) do beneficiário possui coparticipação ou não. | True/False |
| convenioSegmentacao | OP | String | Texto descritivo da segmentação do plano do (produto). Exemplo de segmentação: Ambulatorial + Hospitalar com Obstetrícia. Sugere-se utilizar as segmentações definidas pela ANS, conforme registro de produtos. | Formato: Texto livre. |
| convenioTipoPessoa | OP | String | Tipo de contrato do plano (produto) do beneficiário Exemplo: Pessoa Física ou Pessoa Jurídica | Formato: Texto livre. |
| convenioTipoContrato | M | String | Informação sobre o tipo de contratação do plano privado de assistência à saúde, conforme RN 195. Individual/Familiar, coletivo por adesaão ou coletivo empresarial. | Formato: Texto livre. |
convenioRegulamentacao | M | String | Informação sobre a regulamentação do plano, entendendo-se por: Regulamentado / adaptado / não regulado. | Formato: Texto livre. |
cartaoValidade | OP | String | Informe textos como "Indefinida" ou "31/12/2020", ou "Vencido" | Formato: Texto livre. |
cartaoVia | OP | Numérico | Indica o numero da via do cartão vigente do beneficiário | Somente números inteiros |
| chaveEmpresaContratante | M | String | Código identificador da empresa contratante do plano do beneficiário (nos casos de planos coletivos por adesão ou coletivos empresariais). Importante: nos casos onde o contrato seja de planos individuais/familiares, sugerimos o preenchimento deste atributo com o CPF do contratante. Observação: este código é fundamental para diferenciação da imagem do cartão, direcionamento (segmentação) de campanhas, mensagens e noticias, além de diversas outras funções no aplicativo e web | |
| nomeEmpresaContratante | M | String | Nome da empresa contratante. Importante: nos casos onde o contrato seja de planos individuais/familiares, sugerimos o preenchimento deste atributo com nome completo do contratante. Obrigatório PIN-SS conforme RN 389. | |
| contratoEmpresaContratante | M | String | Numero do contrato/apólice. Obrigatório PIN-SS conforme RN 389. Importante: nos casos onde o contrato seja de planos individuais/familiares, sugerimos o preenchimento deste atributo com a matrícula do contratante. | |
| numeroCns | OP | String | Numero do Cartão Nacional de Saúde. Obrigatório no cartão do beneficiário conforme RN 389. | Formato: Texto livre. |
| equipeAtendimentoCMS | OP | String | Equipe de Atendimento que poderá ser filtrada em Solicitação de Autorização, Solicitação de Reembolso, Solicitação de Atualização cadastral e Solicitação de 2a via de cartão. | Formato: Texto livre. |
| convenioAns | OP | String | Número de registro do plano do beneficiário na ANS. | Formato: Texto livre. |
| dataFinalCpt | OP | String | Data final da CPT do cliente, quando houver, no formato String. Pode-se informar também textos indicativos, de acordo com a necessidade da operadora. Obrigatório no cartão do beneficiário conforme RN 389. | Formato: Texto livre. |
| qrCodeCartaoVirtual | OP | String | Caso sua empresa deseje utilizar QRCode no cartão virtual, inclua neste atributo o conteúdo QRCode no cartão virtual. | Formato: ASCII (Não permite especiais). Envie códigos que sejam interpretáveis por QRCode, além de sua empresa concatenar / separar dados caso necessário. |
| codigoContrato | M | String | Código que identifica de qual contrato esse usuário está vinculado. | ASCII (nao permite especiais). Este código deve ser o mesmo do campo codigoContrato da estrutura “contratos“ |
| redeAtendimento | OP | String | Informe o código e a descrição da Rede de Atendimento do beneficiário Observação PTU 5.1: campo obrigatório | ASCII (nao permite especiais). |
| modeloCartao | C | String | Indique o layout de cartão que deve ser exibido. O dado aqui deve ser idêntico ao acordado entre sua empresa e a Mobile Saúde, na documentação de layouts de cartões | ASCII (nao permite especiais). Torna-se obrigatório quando o cartão virtual foi contratado. |
| carencias | OP | Array de objeto "carencia" | Retorna uma lista de estruturas “carencia” contendo as instruções sobre as carências do usuário. Essa informação só é necessária se houver necessidade de apresentar as carências no cartão virtual. | Caso não exista nenhuma carência, envie o array vazio |
| custom | OP | Array de objetos "custom" | ||
| integracao | M | Objeto | Informações necessárias para realizar a identificação do beneficiário no sistema. A estrutura aqui enviada será enviada no corpo das demais requisições de integração junto com os dados preenchidos pelo beneficiário no sistema. | Atenção! A regra de preenchimento deve obedecer a estrutura chave / valor. Objetos complexos (array de objetos) não são suportados. |
| cooperativas | OP | Objeto | As cooperativas Unimed, que possuem suas particularidade devem utilizar esse objeto para transacionar informações sobre cartão virtual, e outros temas de relevância para seu negócio. | Preenchimento condicional, se a Unimed necessitar. Empresas fora do sistema Unimed não devem considerar o uso deste objeto. |
| seed | OP | String | Usado para exibir / calcular o token na funcionalidade de cartão virtual do beneficiário | Só preencha quando for utilizar o token. Recomenda-se utilizar um identificador único por beneficiário (por exemplo, matrícula). Caso deseje utilizar outro conteúdo, entre em contato com a Mobile Saúde. |
Objeto profissionalsaude
Essa estrutura contém os dados básicos de um profissional de saúde de plano de saúde.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| nome | M | String | Nome do contrato | Não permite números |
| chaveProfissionalSaude | M | String | Chave única de identificação do profissional de saúde no seu sistema de gestão. Este campo será utilizado pelo aplicativo como chave em todas as demais integrações referentes ao perfil de profissional de saúde, como por exemplo: extrato de pagamento, declarações e solicitações. Ele deve ser único por coooperado e não pode se repetir em nenhuma hipótese. | Preencher com a chave que será utilizada para integração com demais serviços. |
| conselhoRegional | OP | String | Número no conselho regional | Somente números |
| siglaConselhoRegional | C | String | Sigla do conselho regional | Se conselhoRegional possuir conteúdo, torna-se obrigatório. Tamanho máximo 8 posições |
| estadoConselhoRegional | C | String | Estado do conselho regional | Se conselhoRegional possuir conteúdo, torna-se obrigatório. Tamanho máximo 2 posições |
| titulo | OP | String | Tratamento com o profissional, exemplo, Dr. Dra. Etc. | |
| sexo | M | String | Sexo do profissional de saúde, | M = Masculino / F = Feminino / N - Não se aplica - Apenas maiúsculas |
| dataNascimento | M | String | Data de nascimento do profissional de saúde | Formato: YYYY-MM-DD |
| cpf | M | String | CPF do profissional de saúde. Apenas números, sem máscara | Somente números. 11 posições. |
| celular | OP | String | Número do celular do profissional de saúde | Tamanho mínimo / máximo 11 posições. Somente números |
| especialidades | M | Array de objeto "especialidade" | Retorna uma lista de estruturas “especialidade“ (definição abaixo), caso o usuário possua mais de um contrato | Ao menos um conteúdo válido. |
| codigoContrato | M | String | Código que identifica de qual contrato esse usuário está vinculado. | Este código deve ser o mesmo do campo codigoContrato da estrutura “contratos“ |
| M | String | Email do profissional de saúde | Email válido. | |
| custom | OP | Array de objeto "custom" |
Objeto contrato
Estrutura que contém todo os contratos que o usuário logado está vinculado.
Atenção
Caso a sua Empresa/Operadora faça uso de multi contrato é aqui que deve ser tratado essa questão.
O que é multi contrato?
Multi contrato é um conceito de existir mais de 1 (um) contrato para o beneficiário na operadora e por isso devem ser separados, como é o caso de:
- O usuário autenticado possua mais de um contrato, esses devem ser descritos no item Contratos e o array de beneficiário e de profissional de saúde deve conter as informações de todos os contratos;
- Ex.: Beneficiário possui um plano de saúde com um filho dependente e um plano odontológico sem dependentes. Os dois contratos precisam estar descritos no array Contratos e o array Familia vai conter 3 objetos (dois do plano de saúde e um do plano odontológico). Essa mesma lógica se aplica à estrutura do profissional de saúde;
- Diferentes cartões virtuais para o mesmo beneficiário;
- Acessos restritos ou liberados para funcionalidades dependendo do tipo de contrato;
Fluxo login COM multi contrato
| Tela de login | selecionar o contrato | logado com o contrato selecionado | clicando novamente é possível mudar de contrato | logado com o novo contrato selecionado |
|---|---|---|---|---|
|
|
|
|  |
Fluxo login SEM multi contrato
| Tela de login | Beneficiário logado no app |
|---|---|
|
|
.PNG?version=1&modificationDate=1641391319586&cacheVersion=1&api=v2&width=140&height=250)
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| nome | M | String | Nome do contrato | Não permite números |
| codigoContrato | M | String | Preencher com a chave relacionada aos atributos de "codigoContrato" dos objetos beneficiario e profissionalSaude. | ASCII (nao permite especiais). |
| tipo | M | String | Preencha com beneficiario ou profissionalSaude | Conteúdo válido: beneficiario ou profissionalSaude |
| permissoes | M | Array de objeto "permissoes" | Sigla do conselho regional | Objetos válidos relacionados às funções do app contratado. |
Objeto permissoes
Essa estrutura contém as instruções sobre quais funcionalidades do aplicativo o usuário logado poderá visualizar ou ter acesso, conforme as regras de negocio da operadora.
Por padrão, todas as funcionalidades (do escopo do projeto) são permitidas e essa estrutura deve tratar a exceção, ou seja, apenas aquilo que o usuário não pode visualizar ou acessar.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| funcionalidade | M | String | Informe o ID da funcionalidade do App. A tabela de Ids de funcionalidade encontra-se no final desta documentação | Funcionalidade deve ter correlação com a tabela no fim desta documentação |
| acesso | M | Boolean | Preencher com a chave relacionada aos atributos de "codigoContrato" dos objetos beneficiario e profissionalSaude | true/false |
| mensagemBloqueio | C | String | Preencha com beneficiario ou profissionalSaude | Só pode ter conteúdo quando acesso = false |
| ocultar | M | Boolean | informe se o ícone da funcionalidade será exibido (false) ou ocultado (true) para este contrato. | true/false |
Objeto carencia
Esta estrutura contém as informações sobre as carências do beneficiário para serem impressas no cartão virtual. As informações enviadas nesta estrutura já devem estar prontas para serem apresentadas para o beneficiário.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| tipoServico | M | String | Texto com o tipo de serviço, exemplo: Consulta, Exames, Internação, Parto... | Formato: Texto livre. |
| carencia | M | String | Informar o texto a ser apresentado. | Formato: Texto livre. |
Objeto mosia
Esta estrutura contém as informações de integração com o módulo de Chat da Mobile Saúde, o Mosia. Essa integração permite identificar o usuário e fazer alocação direta numa fila ou em um atendente específico.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| callerKey | M | String | Chave de identificação do chamador. | Repasse a informação utilizada no atributo login, do objeto usuarioLogado. |
| callerEmail | C | String | Email do chamador | Email válido. Preenchimento obrigatório somente se não tiver conteúdo no callerPhone. |
| callerName | M | String | Nome do chamador | Não permite números |
| callerPhone | C | String | Telefone do chamador | Tamanho mínimo / máximo 11 posições. Somente números Preenchimento obrigatório se callerEmail estiver vazio. |
| allocationAgent | OP | String | Utilize este campo caso queria alocar este usuário em um atendente específico. Um caso de uso: se o seu usuário é um VIP e possui um gerente pessoal para atendimento, você pode enviar o código do gerente neste campo e quando o chamador acionar o chat ele será alocado direto para o gerente e não em uma fila. O código de atende está disponível no cadastro de atendentes do Mosia. Consulte a documentação do módulo para maiores detalhes. | Regra: obrigatório se desejar encaminhar o usuário autenticado para um atendente específico. Deve ser compatível com o código de integração no cadastro do atendente no Mosia. |
| allocationQueue | OP | String | Utilize este campo caso queria alocar este usuário em uma fila especifica. Um caso de uso: se o seu usuário for de um plano referência e possui uma equipe exclusiva para atendimento, utilize este campo para enviar o código da fila de atendimento exclusivo para este usuário. O código da fila está disponível no cadastro de atendentes do Mosia. Consulte a documentação do módulo para maiores detalhes. | Regra: obrigatório se desejar encaminhar o usuário autenticado para uma fila específica. Deve ser compatível com o código de integração no cadastro do filas de atendimento no Mosia |
| customClientDataWidget | OP | Array de objeto "customClientDataWidget" | Repassar objeto customizado (padrão chave : valor) para o widget padrão "Dados do cliente" | Ao passar essas informações, o widget do Mosia passará a exibi-las automaticamente, quando um usuário autenticado pelo app estiver usando a plataforma para conversar por CHAT. |
Objeto agenterelacionamento
Esta estrutura contém as informações de contato do agente de relacionamento da conta do usuário. Essas informações aparecerão em destaque na área de contatos do aplicativo e do portal. Essa estrutura é um array e pode conter mais de um agente.
Observação: Se não for informado nenhum e-mail ou telefone, a informação não será apresentada na área de contatos.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| nome | M | String | Indique o nome do gestor de relacionamento | Não permite números |
| telefone1 | M | String | Indique um segundo telefone do gestor de relacionamento | Tamanho mínimo 10 / máximo 11 posições. Somente números |
| telefone2 | OP | String | Indique um segundo telefone do gestor de relacionamento | Tamanho mínimo 10 / máximo 11 posições. Somente números |
| C | String | Indique o email do gestor de relacionamento | Regras de e-mail | |
| linkFoto | OP | String | Indique uma URL ativa de internet com a imagem para a foto do gestor de relacionamento. | URL válida |
| tituloApresentacao | OP | String | Texto de apresentação para ser divulgado na rotina | Formato: Texto livre. |
Objeto segurança
Este objeto é destinado as propriedades relacionadas a segurança dos dados do beneficiário.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| auth | M | Array de objetos “auth” | Lista parâmetros que devem ser enviados no header dos demais endpoints de integração do sistema para garantir que o beneficiário está autenticado no sistema. | Objeto auth valido |
objeto auth
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
chave | M | String | Nome do parâmetro no header aonde será enviado o valor da propriedade token. | ASCII (nao permite especiais) |
token | M | String | Valor do token que será enviado no header, em caso de tokens no padrão Bearer, JWT, Api-Key etc. enviar o prefixo junto do token. Ex: JWT 123xyz | Formato: Texto livre |
| expiracao | O | Number | Caso o token tenha data de expiração, deve ser retornado nessa propriedade o timestamp da data na qual o token irá expirar. | Timestamp (em milissegundos) |
Objeto especialidade
Estrutura que contém todo os contratos que o usuário logado está vinculado.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| cboEspecialidadeId | M | String | Código CBO, ou código equivalente. | Formato: Texto livre. |
| cboEspecialidadeDescricao | M | String | Descrição para ser apresentada ao usuário da solução. | Formato: Texto livre. |
Objeto custom
Utilize esse objeto para enviar campos que não estão suportados pelo layout padrão de atributos (por exemplo, exibir número da matrícula funcional de empregado, tipo sanguíneo).
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| chave | M | String | Nome da propriedade | Formato: Texto livre. |
| valor | OP | String | Valor da propriedade | Formato: Texto livre. |
Objeto customCLIENTDATAWIDGET
Utilize esse objeto para enviar dados que não estão suportados pelo layout padrão de atributos (por exemplo, exibir número da matrícula funcional de empregado, entre outros). Esses dados serão exibidos no widget padrão chamado "Dados do cliente" no produto Mosia Chat.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| chave | M | String | Nome da propriedade | Formato: Texto livre. Envie, por exemplo, "Nome da mãe" |
| valor | OP | String | Valor da propriedade | Formato: Texto livre. Envie, por exemplo, "Maria da Graça" |
Objeto INTEGRACAO
Utilize esse objeto para repassar atributos para métodos auxiliares, chamados após execução deste método. O conteúdo deste objeto será repassado integralmente para os próximos métodos do app, facilitando a interpretação de outros sistemas e parâmetros exclusivos de sua aplicação.
Atenção!
A regra de preenchimento deve obedecer a estrutura chave / valor. Objetos complexos (array de objetos) não são suportados.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| chave | M | String | Nome da propriedade | Formato: Texto livre. |
| valor | OP | String | Valor da propriedade | Formato: Texto livre. |
Objeto COOPERATIVAS
Caso sua operadora seja uma Unimed, você precisa configurar o objeto cooperativas.
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| seed | M | String | Seed utilizado para gerar o token. | Formato: Texto livre, mas deve ser enviado como BASE32. |
| unimedContratada | M | String | Informe a operadora contratada, quando houver (campo para cartão virtual Unimed PTU - digital) | Formato: Texto livre. |
| convenioAnsContratada | M | String | Informe o número de registro ANS da operadora contratada, quando houver (campo para cartão virtual Unimed PTU - digital) | Formato: Texto livre. |
| layoutCartaoVirtual | M | String | Informe o modelo de cartão a ser exibido, quando tratar-se do cartão PTU (Unimed) | Preenchimento obrigatório quando for Unimed - padrão de cartão virtual PTU. Preenchimento: BENEFICIARIO / COOPERADO / LOWCOST |
| nomeCartao | OP | String | Nome do beneficiário a ser exibido no cartão digital - versão padrão - PTU Unimed (25 posições conforme manual) | Se Unimed, utilize esse campo para exibir um nome reduzido, conhecido como nome cartão no manual do PTU. Caso não seja informado, o nome do beneficiário será exibido no cartão com base no atributo "nome", dentro do objeto beneficiario. |
| nomeSocialCartao | OP | Nome social do beneficiário a ser exibido no cartão digital - versão padrão - PTU Unimed (25 posições conforme manual) | Se Unimed, utilize esse campo para exibir um nome social reduzido, conhecido como nome social cartão no manual do PTU. Caso não seja informado, o nome do beneficiário será exibido no cartão com base no atributo "nomeSocial", dentro do objeto beneficiario. |
A descrição acima é bem resumida. Caso sua empresa seja uma UNIMED, recomendamos a leitura completa do documento relacionado ao objeto Cooperativas. Existem itens que precisam ser combinados entre nossa operadora e a Mobile Saúde. Para maiores detalhes sobre essa ação, clique aqui.
Retorno API - Sucesso
{
"status": true,
"seguranca": {
"auth": [
{
"chave": "Authorization",
"token": "JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzI5ODQ4MzgsIm5iZiI6MTU3Mjk4NDgzOSwiZXhwIjoxNTczMDI4MDM4LCJkYXRhIjp7ImxvZ2luIjoiZGVybGFuZHlAbW9iaWxlc2F1ZGUuY29tLmJyIn19.dzJOQhSG8pJx-l6WDDgMVszFsKB26PsIjF4rB1TnWrk"
},
{
"chave": "Authorization-Custom",
"token": "JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzI5ODQ4MzgsIm5iZiI6MTU3Mjk4NDgzOSwiZXhwIjoxNTczMDI4MDM4LCJkYXRhIjp7ImxvZ2luIjoiZGVybGFuZHlAbW9iaWxlc2F1ZGUuY29tLmJyIn19.dzJOQhSG8pJx-l6WDDgMVszFsKB26PsIjF4rB1TnWrk",
"expiracao": 1574366666921
}
]
},
"usuarioLogado": {
"localizadorMensageria": "derlandy@mobilesaude.com.br",
"login": "derlandy@mobilesaude.com.br",
"integracao": {
"chaveBeneficiario": "2320170425162943",
"ae": "perferendis",
"bd": "repellendus",
"chave_interna": 57293800
}
},
"beneficiarios": [
{
"integracao": {
"chaveBeneficiario": "2320170425162943",
"ae": "voluptatibus",
"bd": "quibusdam",
"chave_interna": 9288701
},
"matricula": "2320170425162943-0",
"matriculaAntiga": null,
"matriculaFuncionario": null,
"matriculaTitular": "2320170425162943-0",
"nomeTitular": "Derlandy Belchior",
"emailTitular": "derlandy@mobilesaude.com.br",
"telefoneTitular": "8646166114",
"celularTitular": "27999826284",
"cpfTitular": "92188083970",
"nome": "Derlandy Belchior",
"sexo": "F",
"dataNascimento": "2017-11-05",
"cpf": "92188083970",
"celular": "27999826284",
"telefone": "8646166114",
"email": "derlandy@mobilesaude.com.br",
"endereco": "Avenida Carolina, 2",
"bairro": "Guilherme do Sul",
"cep": "58895-647",
"cidade": "Natália d'Oeste",
"estado": "PB",
"tipoUsuario": "T",
"grauParentescoId": "01",
"grauParentescoDescricao": "Titular",
"dataContratacao": "2012-01-01",
"dataInicioCobertura": "2012-01-01",
"convenioId": "01",
"convenioDescricao": "Plano Básico",
"convenioAbrangencia": "Estadual",
"convenioAbrangenciaVerso": "Estadual",
"convenioAcomodacao": "Individual",
"convenioModalidadeCobranca": "Pós-pagamento",
"convenioPadraoConforto": "",
"convenioParticipativo": false,
"convenioSegmentacao": "Ambulatorial + Hospitalar com obstetrícia",
"convenioTipoPessoa": "Pessoa Jurídica",
"convenioTipoContrato": "Plano Coletivo Empresarial",
"convenioRegulamentacao": "Plano Regulamentado",
"cartaoValidade": "05/11/2022",
"cartaoVia": 1,
"chaveEmpresaContratante": "03",
"nomeEmpresaContratante": "Mobile Saúde",
"contratoEmpresaContratante": "004",
"numeroCns": "999999999999999",
"convenioAns": "999.999/99-9",
"dataFinalCpt": "Não há",
"qrCodeCartaoVirtual": "123123123222",
"carencias": [
{
"tipoServico": "ES - Atendimentos Ambulatoriais",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Internações e Outros Procedimentos",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Partos a Termo",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Odontologia",
"carencia": "31/12/2012"
}
],
"codigoContrato": "99991",
"redeAtendimento": null,
"modeloCartao": null,
"custom": [
{
"chave": "minha_chave_customizada",
"valor": "Meu valor customizado"
}
],
"cooperativas": {
"seed": "23202222170425162943",
"unimedContratada": "Unimed Contratada ABC DEF",
"convenioAnsContratada": "1122334",
"layoutCartaoVirtual": "BENEFICIARIO",
"nomeCartao": "NOME BENEF. VINTECINCOPO",
"nomeSocialCartao": "NOME SOCIAL VINTECINCOPO"
},
"seed": "23201704251629430"
},
{
"integracao": {
"chaveBeneficiario": "2320170425162943-1",
"ae": "animi",
"bd": "distinctio",
"chave_interna": 37949677
},
"matricula": "2320170425162943-1",
"matriculaAntiga": null,
"matriculaFuncionario": null,
"matriculaTitular": "2320170425162943-0",
"nomeTitular": "Derlandy Belchior",
"emailTitular": "derlandy@mobilesaude.com.br",
"telefoneTitular": "4937909985",
"celularTitular": "27999826284",
"cpfTitular": "92188083970",
"nome": "Conjuge",
"sexo": "F",
"dataNascimento": "1987-11-05",
"cpf": "65612426291",
"celular": "75946497528",
"telefone": "6344767671",
"email": "laura.uchoa@maia.net",
"endereco": "Avenida Carolina, 2",
"bairro": "Guilherme do Sul",
"cep": "58895-647",
"cidade": "Natália d'Oeste",
"estado": "PB",
"complemento": "Casa",
"numero": "123",
"tipoUsuario": "D",
"grauParentescoId": "02",
"grauParentescoDescricao": "Esposa(o)",
"dataContratacao": "2012-01-01",
"dataInicioCobertura": "2012-01-01",
"convenioId": "01",
"convenioDescricao": "Plano Básico",
"convenioAbrangencia": "Estadual",
"convenioAbrangenciaVerso": "Estadual",
"convenioAcomodacao": "Individual",
"convenioModalidadeCobranca": "Pós-pagamento",
"convenioPadraoConforto": "",
"convenioParticipativo": false,
"convenioSegmentacao": "Ambulatorial + Hospitalar com obstetrícia",
"convenioTipoPessoa": "Pessoa Jurídica",
"convenioTipoContrato": "Plano Coletivo Empresarial",
"convenioRegulamentacao": "Plano Regulamentado",
"cartaoValidade": "05/11/2022",
"cartaoVia": 1,
"chaveEmpresaContratante": "03",
"nomeEmpresaContratante": "Mobile Saúde",
"contratoEmpresaContratante": "004",
"numeroCns": "999999999999999",
"convenioAns": "999.999/99-9",
"dataFinalCpt": "Não há",
"qrCodeCartaoVirtual": "123123123223",
"carencias": [
{
"tipoServico": "ES - Atendimentos Ambulatoriais",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Internações e Outros Procedimentos",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Partos a Termo",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Odontologia",
"carencia": "31/12/2012"
}
],
"codigoContrato": "99991",
"redeAtendimento": null,
"modeloCartao": null,
"custom": [
{
"chave": "minha_chave_customizada",
"valor": "Meu valor customizado"
}
],
"cooperativas": {
"seed": "23202222170425162943",
"unimedContratada": "Unimed Contratada ABC DEF",
"convenioAnsContratada": "1122334",
"layoutCartaoVirtual": "BENEFICIARIO",
"nomeCartao": "NOME BENEF. VINTECINCOPO",
"nomeSocialCartao": "NOME SOCIAL VINTECINCOPO"
},
"seed": "23202222170425162943"
},
{
"integracao": {
"chaveBeneficiario": "2320170425162943-2",
"ae": "deserunt",
"bd": "perspiciatis",
"chave_interna": 2414111
},
"matricula": "2320170425162943-2",
"matriculaAntiga": null,
"matriculaFuncionario": null,
"matriculaTitular": "2320170425162943-0",
"nomeTitular": "Derlandy Belchior",
"emailTitular": "derlandy@mobilesaude.com.br",
"telefoneTitular": "6626007527",
"celularTitular": "27999826284",
"cpfTitular": "92188083970",
"nome": "Filho(a)",
"sexo": "F",
"dataNascimento": "2012-11-05",
"cpf": "26693601570",
"celular": "75960567928",
"telefone": "9540683952",
"email": "queiros.valeria@hotmail.com",
"endereco": "Avenida Carolina, 2",
"bairro": "Guilherme do Sul",
"cep": "58895-647",
"cidade": "Natália d'Oeste",
"estado": "PB",
"complemento": "Casa",
"numero": "123",
"tipoUsuario": "D",
"grauParentescoId": "03",
"grauParentescoDescricao": "Filho(a)",
"dataContratacao": "2012-01-01",
"dataInicioCobertura": "2012-01-01",
"convenioId": "01",
"convenioDescricao": "Plano Básico",
"convenioAbrangencia": "Estadual",
"convenioAbrangenciaVerso": "Estadual",
"convenioAcomodacao": "Individual",
"convenioModalidadeCobranca": "Pós-pagamento",
"convenioPadraoConforto": "",
"convenioParticipativo": false,
"convenioSegmentacao": "Ambulatorial + Hospitalar com obstetrícia",
"convenioTipoPessoa": "Pessoa Jurídica",
"convenioTipoContrato": "Plano Coletivo Empresarial",
"convenioRegulamentacao": "Plano Regulamentado",
"cartaoValidade": "05/11/2022",
"cartaoVia": 1,
"chaveEmpresaContratante": "03",
"nomeEmpresaContratante": "Mobile Saúde",
"contratoEmpresaContratante": "004",
"numeroCns": "999999999999999",
"convenioAns": "999.999/99-9",
"dataFinalCpt": "Não há",
"qrCodeCartaoVirtual": "123123123224",
"carencias": [
{
"tipoServico": "ES - Atendimentos Ambulatoriais",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Internações e Outros Procedimentos",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Partos a Termo",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Odontologia",
"carencia": "31/12/2012"
}
],
"codigoContrato": "99991",
"redeAtendimento": null,
"modeloCartao": null,
"custom": [
{
"chave": "minha_chave_customizada",
"valor": "Meu valor customizado"
}
],
"cooperativas": {
"seed": "23202222170425162943",
"unimedContratada": "Unimed Contratada ABC DEF",
"convenioAnsContratada": "1122334",
"layoutCartaoVirtual": "LOWCOST",
"nomeCartao": "NOME BENEF. VINTECINCOPO"
},
"seed": "23202222170425162943"
},
{
"integracao": {
"chaveBeneficiario": "2320170425162943",
"ae": "incidunt",
"bd": "consequatur",
"chave_interna": 323253947
},
"matricula": "2320170425162943-3",
"matriculaAntiga": null,
"matriculaFuncionario": null,
"matriculaTitular": "2320170425162943-3",
"nomeTitular": "Derlandy Belchior",
"emailTitular": "derlandy@mobilesaude.com.br",
"telefoneTitular": "2224489673",
"celularTitular": "27999826284",
"cpfTitular": "92188083970",
"nome": "Derlandy Belchior",
"sexo": "F",
"dataNascimento": "2012-11-05",
"cpf": "92188083970",
"celular": "27999826284",
"telefone": "2224489673",
"email": "derlandy@mobilesaude.com.br",
"endereco": "Avenida Carolina, 2",
"bairro": "Guilherme do Sul",
"cep": "58895-647",
"cidade": "Natália d'Oeste",
"estado": "PB",
"complemento": "Casa",
"numero": "123",
"tipoUsuario": "T",
"grauParentescoId": "01",
"grauParentescoDescricao": "Titular",
"dataContratacao": "2012-01-01",
"dataInicioCobertura": "2012-01-01",
"convenioId": "01",
"convenioDescricao": "Plano Executivo",
"convenioAbrangencia": "Estadual",
"convenioAbrangenciaVerso": "Estadual",
"convenioAcomodacao": "Individual",
"convenioModalidadeCobranca": "Pós-pagamento",
"convenioPadraoConforto": "",
"convenioParticipativo": false,
"convenioSegmentacao": "Ambulatorial + Hospitalar com obstetrícia",
"convenioTipoPessoa": "Pessoa Jurídica",
"convenioTipoContrato": "Plano Coletivo Empresarial",
"convenioRegulamentacao": "Plano Regulamentado",
"cartaoValidade": "05/11/2022",
"cartaoVia": 1,
"chaveEmpresaContratante": "03",
"nomeEmpresaContratante": "Mobile Saúde",
"contratoEmpresaContratante": "004",
"numeroCns": "999999999999999",
"convenioAns": "999.999/99-9",
"dataFinalCpt": "Não há",
"qrCodeCartaoVirtual": "123123123226",
"carencias": [
{
"tipoServico": "ES - Atendimentos Ambulatoriais",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Internações e Outros Procedimentos",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Partos a Termo",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Odontologia",
"carencia": "31/12/2012"
}
],
"codigoContrato": "99992",
"redeAtendimento": null,
"modeloCartao": null,
"custom": [
{
"chave": "minha_chave_customizada",
"valor": "Meu valor customizado"
}
],
"cooperativas": {
"seed": "23202222170425162943",
"unimedContratada": "Unimed Contratada ABC DEF",
"convenioAnsContratada": "1122334",
"layoutCartaoVirtual": "COOPERADO",
"nomeCartao": "NOME BENEF. VINTECINCOPO"
},
"seed": "23202222170425162943"
},
{
"integracao": {
"chaveBeneficiario": "2320170425162943-4",
"ae": "eos",
"bd": "excepturi",
"chave_interna": 8
},
"matricula": "2320170425162943-4",
"matriculaAntiga": null,
"matriculaFuncionario": null,
"matriculaTitular": "2320170425162943-3",
"nomeTitular": "Derlandy Belchior",
"emailTitular": "derlandy@mobilesaude.com.br",
"telefoneTitular": "7524220598",
"celularTitular": "27999826284",
"cpfTitular": "92188083970",
"nome": "Conjuge",
"sexo": "F",
"dataNascimento": "1987-11-05",
"cpf": "65612426291",
"celular": "74937571185",
"telefone": "1343852217",
"email": "melissa.mendonca@ig.com.br",
"endereco": "Avenida Carolina, 2",
"bairro": "Guilherme do Sul",
"cep": "58895-647",
"cidade": "Natália d'Oeste",
"estado": "PB",
"complemento": "Casa",
"numero": "123",
"tipoUsuario": "D",
"grauParentescoId": "02",
"grauParentescoDescricao": "Esposa(o)",
"dataContratacao": "2012-01-01",
"dataInicioCobertura": "2012-01-01",
"convenioId": "01",
"convenioDescricao": "Plano Executivo",
"convenioAbrangencia": "Estadual",
"convenioAbrangenciaVerso": "Estadual",
"convenioAcomodacao": "Individual",
"convenioModalidadeCobranca": "Pós-pagamento",
"convenioPadraoConforto": "",
"convenioParticipativo": false,
"convenioSegmentacao": "Ambulatorial + Hospitalar com obstetrícia",
"convenioTipoPessoa": "Pessoa Jurídica",
"convenioTipoContrato": "Plano Coletivo Empresarial",
"convenioRegulamentacao": "Plano Regulamentado",
"cartaoValidade": "05/11/2022",
"cartaoVia": 1,
"chaveEmpresaContratante": "03",
"nomeEmpresaContratante": "Mobile Saúde",
"contratoEmpresaContratante": "004",
"numeroCns": "999999999999999",
"convenioAns": "999.999/99-9",
"dataFinalCpt": "Não há",
"qrCodeCartaoVirtual": "123123123228",
"carencias": [
{
"tipoServico": "ES - Atendimentos Ambulatoriais",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Internações e Outros Procedimentos",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Partos a Termo",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Odontologia",
"carencia": "31/12/2012"
}
],
"codigoContrato": "99992",
"redeAtendimento": null,
"modeloCartao": null,
"custom": [
{
"chave": "minha_chave_customizada",
"valor": "Meu valor customizado"
}
],
"cooperativas": {
"seed": "23202222170425162943",
"unimedContratada": "Unimed Contratada ABC DEF",
"convenioAnsContratada": "1122334",
"layoutCartaoVirtual": "BENEFICIARIO"
},
"seed": "23202222170425162943"
},
{
"integracao": {
"chaveBeneficiario": "2320170425162943-5",
"ae": "et",
"bd": "harum",
"chave_interna": 65338931
},
"matricula": "2320170425162943-5",
"matriculaAntiga": null,
"matriculaFuncionario": null,
"matriculaTitular": "2320170425162943-3",
"nomeTitular": "Derlandy Belchior",
"emailTitular": "derlandy@mobilesaude.com.br",
"telefoneTitular": "7321384591",
"celularTitular": "27999826284",
"cpfTitular": "92188083970",
"nome": "Filho(a)",
"sexo": "F",
"dataNascimento": "2012-11-05",
"cpf": "26693601570",
"celular": "48990552633",
"telefone": "4625317453",
"email": "alonso.pereira@ig.com.br",
"endereco": "Avenida Carolina, 2",
"bairro": "Guilherme do Sul",
"cep": "58895-647",
"cidade": "Natália d'Oeste",
"estado": "PB",
"complemento": "Casa",
"numero": "123",
"tipoUsuario": "D",
"grauParentescoId": "03",
"grauParentescoDescricao": "Filho(a)",
"dataContratacao": "2012-01-01",
"dataInicioCobertura": "2012-01-01",
"convenioId": "01",
"convenioDescricao": "Plano Executivo",
"convenioAbrangencia": "Estadual",
"convenioAbrangenciaVerso": "Estadual",
"convenioAcomodacao": "Individual",
"convenioModalidadeCobranca": "Pós-pagamento",
"convenioPadraoConforto": "",
"convenioParticipativo": false,
"convenioSegmentacao": "Ambulatorial + Hospitalar com obstetrícia",
"convenioTipoPessoa": "Pessoa Jurídica",
"convenioTipoContrato": "Plano Coletivo Empresarial",
"convenioRegulamentacao": "Plano Regulamentado",
"cartaoValidade": "05/11/2022",
"cartaoVia": 1,
"chaveEmpresaContratante": "03",
"nomeEmpresaContratante": "Mobile Saúde",
"contratoEmpresaContratante": "004",
"numeroCns": "999999999999999",
"convenioAns": "999.999/99-9",
"dataFinalCpt": "Não há",
"qrCodeCartaoVirtual": "123123123229",
"carencias": [
{
"tipoServico": "ES - Atendimentos Ambulatoriais",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Internações e Outros Procedimentos",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Partos a Termo",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Odontologia",
"carencia": "31/12/2012"
}
],
"codigoContrato": "99992",
"redeAtendimento": null,
"modeloCartao": null,
"custom": [
{
"chave": "minha_chave_customizada",
"valor": "Meu valor customizado"
}
],
"cooperativas": {
"seed": "23202222170425162943",
"unimedContratada": "Unimed Contratada ABC DEF",
"convenioAnsContratada": "1122334",
"layoutCartaoVirtual": "BENEFICIARIO"
},
"seed": "23202222170425162943"
},
{
"integracao": {
"chaveBeneficiario": "2320170425162943",
"ae": "perferendis",
"bd": "repellendus",
"chave_interna": 57293800
},
"matricula": "2320170425162943-6",
"matriculaAntiga": null,
"matriculaFuncionario": null,
"matriculaTitular": "2320170425162943-6",
"nomeTitular": "Derlandy Belchior",
"emailTitular": "derlandy@mobilesaude.com.br",
"telefoneTitular": "6741119430",
"celularTitular": "27999826284",
"cpfTitular": "92188083970",
"nome": "Derlandy Belchior",
"sexo": "F",
"dataNascimento": "2007-11-05",
"cpf": "92188083970",
"celular": "27999826284",
"telefone": "6741119430",
"email": "derlandy@mobilesaude.com.br",
"endereco": "Avenida Carolina, 2",
"bairro": "Guilherme do Sul",
"cep": "58895-647",
"cidade": "Natália d'Oeste",
"estado": "PB",
"complemento": "Casa",
"numero": "123",
"tipoUsuario": "T",
"grauParentescoId": "01",
"grauParentescoDescricao": "Titular",
"dataContratacao": "2012-01-01",
"dataInicioCobertura": "2012-01-01",
"convenioId": "01",
"convenioDescricao": "Plano Silver Corporate",
"convenioAbrangencia": "Estadual",
"convenioAbrangenciaVerso": "Estadual",
"convenioAcomodacao": "Individual",
"convenioModalidadeCobranca": "Pós-pagamento",
"convenioPadraoConforto": "",
"convenioParticipativo": false,
"convenioSegmentacao": "Ambulatorial + Hospitalar com obstetrícia",
"convenioTipoPessoa": "Pessoa Jurídica",
"convenioTipoContrato": "Plano Coletivo Empresarial",
"convenioRegulamentacao": "Plano Regulamentado",
"cartaoValidade": "05/11/2022",
"cartaoVia": 1,
"chaveEmpresaContratante": "03",
"nomeEmpresaContratante": "Mobile Saúde",
"contratoEmpresaContratante": "004",
"numeroCns": "999999999999999",
"convenioAns": "999.999/99-9",
"dataFinalCpt": "Não há",
"qrCodeCartaoVirtual": "123123123230",
"carencias": [
{
"tipoServico": "ES - Atendimentos Ambulatoriais",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Internações e Outros Procedimentos",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Partos a Termo",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Odontologia",
"carencia": "31/12/2012"
}
],
"codigoContrato": "99993",
"redeAtendimento": null,
"modeloCartao": null,
"custom": [
{
"chave": "minha_chave_customizada",
"valor": "Meu valor customizado"
}
],
"cooperativas": {
"seed": "23202222170425162943",
"unimedContratada": "Unimed Contratada ABC DEF",
"convenioAnsContratada": "1122334",
"layoutCartaoVirtual": "BENEFICIARIO"
},
"seed": "23202222170425162943"
},
{
"integracao": {
"chaveBeneficiario": "2320170425162943-7",
"ae": "est",
"bd": "ipsum",
"chave_interna": 9971
},
"matricula": "2320170425162943-7",
"matriculaAntiga": null,
"matriculaFuncionario": null,
"matriculaTitular": "2320170425162943-6",
"nomeTitular": "Derlandy Belchior",
"emailTitular": "derlandy@mobilesaude.com.br",
"telefoneTitular": "8544016063",
"celularTitular": "27999826284",
"cpfTitular": "92188083970",
"nome": "Conjuge",
"sexo": "F",
"dataNascimento": "1987-11-05",
"cpf": "65612426291",
"celular": "42986469182",
"telefone": "6321180938",
"email": "gian70@uol.com.br",
"endereco": "Avenida Carolina, 2",
"bairro": "Guilherme do Sul",
"cep": "58895-647",
"cidade": "Natália d'Oeste",
"estado": "PB",
"complemento": "Casa",
"numero": "123",
"tipoUsuario": "D",
"grauParentescoId": "02",
"grauParentescoDescricao": "Esposa(o)",
"dataContratacao": "2012-01-01",
"dataInicioCobertura": "2012-01-01",
"convenioId": "01",
"convenioDescricao": "Plano Silver Corporate",
"convenioAbrangencia": "Estadual",
"convenioAbrangenciaVerso": "Estadual",
"convenioAcomodacao": "Individual",
"convenioModalidadeCobranca": "Pós-pagamento",
"convenioPadraoConforto": "",
"convenioParticipativo": false,
"convenioSegmentacao": "Ambulatorial + Hospitalar com obstetrícia",
"convenioTipoPessoa": "Pessoa Jurídica",
"convenioTipoContrato": "Plano Coletivo Empresarial",
"convenioRegulamentacao": "Plano Regulamentado",
"cartaoValidade": "05/11/2022",
"cartaoVia": 1,
"chaveEmpresaContratante": "03",
"nomeEmpresaContratante": "Mobile Saúde",
"contratoEmpresaContratante": "004",
"numeroCns": "999999999999999",
"convenioAns": "999.999/99-9",
"dataFinalCpt": "Não há",
"qrCodeCartaoVirtual": "123123123233",
"carencias": [
{
"tipoServico": "ES - Atendimentos Ambulatoriais",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Internações e Outros Procedimentos",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Partos a Termo",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Odontologia",
"carencia": "31/12/2012"
}
],
"codigoContrato": "99993",
"redeAtendimento": null,
"modeloCartao": null,
"custom": [
{
"chave": "minha_chave_customizada",
"valor": "Meu valor customizado"
}
],
"cooperativas": {
"seed": "23202222170425162943",
"unimedContratada": "Unimed Contratada ABC DEF",
"convenioAnsContratada": "1122334",
"layoutCartaoVirtual": "BENEFICIARIO"
},
"seed": "23202222170425162943"
},
{
"integracao": {
"chaveBeneficiario": "2320170425162943-8",
"ae": "corrupti",
"bd": "voluptatem",
"chave_interna": 719
},
"matricula": "2320170425162943-8",
"matriculaAntiga": null,
"matriculaFuncionario": null,
"matriculaTitular": "2320170425162943-6",
"nomeTitular": "Derlandy Belchior",
"emailTitular": "derlandy@mobilesaude.com.br",
"telefoneTitular": "9329153121",
"celularTitular": "27999826284",
"cpfTitular": "92188083970",
"nome": "Filho(a)",
"sexo": "F",
"dataNascimento": "2012-11-05",
"cpf": "26693601570",
"celular": "64966730451",
"telefone": "4133804867",
"email": "tzaragoca@ig.com.br",
"endereco": "Avenida Carolina, 2",
"bairro": "Guilherme do Sul",
"cep": "58895-647",
"cidade": "Natália d'Oeste",
"estado": "PB",
"complemento": "Casa",
"numero": "123",
"tipoUsuario": "D",
"grauParentescoId": "03",
"grauParentescoDescricao": "Filho(a)",
"dataContratacao": "2012-01-01",
"dataInicioCobertura": "2012-01-01",
"convenioId": "01",
"convenioDescricao": "Plano Silver Corporate",
"convenioAbrangencia": "Estadual",
"convenioAbrangenciaVerso": "Estadual",
"convenioAcomodacao": "Individual",
"convenioModalidadeCobranca": "Pós-pagamento",
"convenioPadraoConforto": "",
"convenioParticipativo": false,
"convenioSegmentacao": "Ambulatorial + Hospitalar com obstetrícia",
"convenioTipoPessoa": "Pessoa Jurídica",
"convenioTipoContrato": "Plano Coletivo Empresarial",
"convenioRegulamentacao": "Plano Regulamentado",
"cartaoValidade": "05/11/2022",
"cartaoVia": 1,
"chaveEmpresaContratante": "03",
"nomeEmpresaContratante": "Mobile Saúde",
"contratoEmpresaContratante": "004",
"numeroCns": "999999999999999",
"convenioAns": "999.999/99-9",
"dataFinalCpt": "Não há",
"qrCodeCartaoVirtual": "123123123245",
"carencias": [
{
"tipoServico": "ES - Atendimentos Ambulatoriais",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Internações e Outros Procedimentos",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Partos a Termo",
"carencia": "31/12/2012"
},
{
"tipoServico": "ES - Odontologia",
"carencia": "31/12/2012"
}
],
"codigoContrato": "99993",
"redeAtendimento": null,
"modeloCartao": null,
"custom": [
{
"chave": "minha_chave_customizada",
"valor": "Meu valor customizado"
}
],
"cooperativas": {
"seed": "23202222170425162943",
"unimedContratada": "Unimed Contratada ABC DEF",
"convenioAnsContratada": "1122334",
"layoutCartaoVirtual": "BENEFICIARIO"
},
"seed": "23202222170425162943"
}
],
"profissionaisSaude": [
{
"nome": "Derlandy Belchior",
"chaveProfissionalSaude": "63718245",
"conselhoRegional": "63718245",
"siglaConselhoRegional": "CRM",
"estadoConselhoRegional": "ES",
"titulo": "Dr",
"sexo": "M",
"dataNascimento": "1985-01-01",
"cpf": "99999999900",
"celular": "27999826284",
"especialidades": [
{
"cboEspecialidadeId": "2.2.5.1.20",
"cboEspecialidadeDescricao": "Cardiologia"
}
],
"codigoContrato": "13986450",
"email": "derlandy@mobilesaude.com.br"
}
],
"contratos": [
{
"nome": "Plano Básico",
"codigoContrato": "99991",
"permissoes": [
{
"funcionalidade": "0",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "1",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "2",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "3",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "4",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "5",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "6",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "7",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "8",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "9",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "10",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "11",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "12",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "13",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "14",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "15",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "16",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "39",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "17",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "18",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "29",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "89",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "20",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "21",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "38",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "42",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "48",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "46",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "30",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "31",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "33",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "34",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
}
],
"tipo": "beneficiario"
},
{
"nome": "Plano Executivo",
"codigoContrato": "99992",
"permissoes": [
{
"funcionalidade": "0",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "1",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "2",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "3",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "4",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "5",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "6",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "7",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "8",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "9",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "10",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "11",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "12",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "13",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "14",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "15",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "16",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "39",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "17",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "18",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "29",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "89",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "20",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "21",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "38",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "42",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "48",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "46",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "30",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "31",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "33",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "34",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
}
],
"tipo": "beneficiario"
},
{
"nome": "Plano Silver Corporate",
"codigoContrato": "99993",
"permissoes": [
{
"funcionalidade": "0",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "1",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "2",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "3",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "4",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "5",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "6",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "7",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "8",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "9",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "10",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "11",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "12",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "13",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "14",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "15",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "16",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "39",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "17",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "18",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "29",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "89",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "20",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "21",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "38",
"acesso": false,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "42",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "48",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "46",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": true
},
{
"funcionalidade": "30",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "31",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "33",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "34",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
}
],
"tipo": "beneficiario"
},
{
"nome": "Cooperado Cooperativas",
"codigoContrato": "13986450",
"permissoes": [
{
"funcionalidade": "102",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "103",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "105",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "106",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "110",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
},
{
"funcionalidade": "32",
"acesso": true,
"mensagemBloqueio": null,
"ocultar": false
}
],
"tipo": "profissional_saude"
}
],
"mosia": {
"callerKey": "derlandy@mobilesaude.com.br",
"callerEmail": "derlandy@mobilesaude.com.br",
"callerName": "Derlandy Belchior",
"callerPhone": "27999826284",
"allocationAgent": null,
"allocationQueue": null,
"customClientDataWidget":[
{
"chave": "Matricula Funcionario",
"valor": "11223344"
},
{
"chave": "Matricula Beneficiário",
"valor": "99998888777"
},
{
"chave": "Cor preferida",
"valor": "Vermelho"
}]
},
"agenteRelacionamento": [
{
"nome": "Salomé Irene Godói Jr.",
"telefone1": "34940972035",
"telefone2": "47984672759",
"email": "carolina.mascarenhas@salas.com.br",
"linkFoto": "https://randomuser.me/api/portraits/women/17.jpg",
"tituloApresentacao": "Beneficiário"
},
{
"nome": "Dr. Isabel Paulina Lozano Neto",
"telefone1": "15973656244",
"telefone2": "4933875727",
"email": "rafael15@zaragoca.com",
"linkFoto": "https://randomuser.me/api/portraits/women/18.jpg",
"tituloApresentacao": "Cooperado"
}
]
}
Descrição dos objetos e atributos de retorno - Falha
Está indicado abaixo a estrutura de retorno do seu método login. Esse método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.
Objeto principal
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| status | M | Boolean | Indica que o login não foi realizado corretamente. | false |
| motivoCritica | M | String | Motivo pelo qual o acesso foi negado. | Envie nesta propriedade o motivo pelo qual o acesso foi negado. Formato: Texto livre. |
Retorno API - Falha
{
"status": false,
"motivoCritica": ""
}
Método de "trocarSenha"
Este serviço é utilizado para alterar a senha de acesso do usuário. O usuário poderá solicitar a alteração de senha dele, por meio de uma opção nas configurações do aplicativo.
Este método é único para beneficiário e profissional de saúde.
Regras de negocio
- Enviaremos o usuário e a nova senha. O sistema altera a senha e retorna True caso tenha sucesso, ou False e o motivo da negativa caso não tenha sucesso na alteração da senha;
- A confirmação de senha será feita na própria interface de alteração de senha e não é necessária no webservice;
- Será adicionado ao corpo da requisição as informações enviadas no atributo integracao no retorno do login.
- Um ponto de atenção caso sua estrutura seja multi contrato, quando houver a troca de senha, que será realizada após o login do beneficiário na plataforma com o mesmo logado, as credenciais de acesso (login e senha) será para ambos contratos.
- Você pode ou não enviar no cabeçalho da requisição o auth gerado no endpoint de login é opcional e não obrigatório, isso garante que o beneficiário está autenticado no sistema.
Endpoint
Endpoint | Método | Header Content-Type | Descrição |
|---|---|---|---|
exemplo.com/trocarSenha Atenção O endpoint obrigatoriamente deve terminar com "/trocarSenha". | POST | application/json | Endpoint de trocar senha |
Parâmetros de entrada
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| login | M | String | Login do utilizado pelo beneficiário (Ex: CPF) |
senhaAtual | M | String | Senha atual do usuário para que o webservice valide a autenticidade. |
novaSenha | M | String | Nova senha informada pelo usuário. |
| integracao | M | Objeto | Informações necessárias para realizar a identificação do beneficiário no sistema. A estrutura aqui enviada será enviada no corpo das demais requisições de integração junto com os dados preenchidos pelo beneficiário no sistema. |
Request body
{
"integracao": {
"<chave>": "<valor>"
}
"login": "<login>"
"senhaAtual": "<senhaAtual>",
"novaSenha": "<novaSenha>"
}
Objetos e atributos de retorno
Atenção
Os atributos devem seguir exatamente os mesmos nomes indicados nesta documentação, caso contrário, serão rejeitados pelo validador de integração.
Exemplo do atributo "status":
status-confirmacaoStatus- status
Descrição dos objetos e atributos de retorno - Sucesso
Está indicado abaixo a estrutura de retorno do seu método de trocarSenha. Esse método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.
Objeto principal
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| status | M | Boolean | Indica que a troca da senha foi bem sucedida. | true |
Retorno da API - Sucesso
{
"status": true
}
Descrição dos objetos e atributos de retorno - Falha
Está indicado abaixo a estrutura de retorno do seu método trocarSenha. Esse método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.
Objeto principal
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| status | M | Boolean | Indica que a troca de senha foi mal sucedida. | false |
| motivoCritica | M | String | Motivo pelo qual não foi possível trocar a senha. | Formato: Texto livre. |
Retorno API - Falha
{
"status": false,
"motivoCritica": ""
}
Método de "novoUsuario"
Este serviço é utilizado para criar acesso a novos usuários, que por motivos operacionais, ainda não possuem senha de acesso ao aplicativo e portal do beneficiário ou profissional de saúde.
Em termos práticos, este webservice seria consumido por um link chamado “Crie seu acesso“ na tela de login.
Regras de negocio
- Este webservice deverá validar todas as regras de negocio da empresa e só permitir a criação do acesso do usuário caso ele seja um beneficiário ou profissional de saúde ativo e que tenha direito de uso. Este método é único para beneficiário e profissional de saúde.
- O webservice deverá retornar o usuário que fez login.
- Quando o usuário for um titular.
- Retorna os seus dados + dados dos dependentes.
- Quando o usuário for o cônjuge.
- Retorna os seus dados + os demais dependestes e exclui o titular do retorno.
- Quando for outro tipo de dependente.
- Retorna apenas os seus dados e de nenhum outro dependente ou titular.
- O seu sistema deve identificar se o usuário também é um profissional de saúde e se sim, deve retornar a estrutura dedicada ao profissional de saúde.
- Regra sugerida para o perfil do Beneficiário.
- Regra sugerida para o perfil do Profissional de saúde.
- Quando o perfil for Empresa, não é necessário retornar nenhum beneficiário.
- Quando o perfil for exclusivamente profissional de saúde, não é necessário retornar a estrutura de beneficiário.
- Quando o perfil for exclusivamente beneficiário, não é necessário retornar a estrutura de profissional de saúde.
- Quando o perfil for beneficiário e profissional de saúde, retornar todas as estruturas descritas no layout.
- Caso o usuário possua mais de um contrato, esses devem ser descritos no item Contratos e o array de beneficiário e de profissional de saúde deve conter as informações de todos os contratos.
- Ex.: Beneficiário possui um plano de saúde com um filho dependente e um plano odontológico sem dependentes. Os dois contratos precisam estar descritos no array Contratos e o array Familia vai conter 3 objetos (dois do plano de saúde e um do plano odontológico). Essa mesma lógica se aplica à estrutura do profissional de saúde.
- A ideia é que se a criação do usuário seja bem sucedida, o app já faça o login imediatamente.
Endpoint
Endpoint | Método | Header Content-Type | Descrição |
|---|---|---|---|
exemplo.com/novoUsuario Atenção O endpoint obrigatoriamente deve terminar com "/novoUsuario". | POST | application/json | Endpoint para criar acesso de novos usuários |
Parâmetros de entrada
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
login | M | String | Id de identificação do usuário. |
dataNascimento | M | String | Campo data de nascimento. A ideia é que o cruzamento dos campos login + DataNascimento permita ao sistema identificar o usuário com segurança para a criação do usuário de acesso. Formato: yyyy-MM-dd |
| senha | M | String | Nova senha, informada pelo usuário. |
| OP | String | E-mail informado pelo usuário. Armazenar essa informação para ser utilizada para recuperação de senha. |
Request body
{
"login": "<login>",
"dataNascimento": "<dataNascimento>",
"senha": "<senha>”,
“email”: “<email@email.com>"
}
Objetos e atributos de retorno
Atenção
Os atributos devem seguir exatamente os mesmos nomes indicados nesta documentação, caso contrário, serão rejeitados pelo validador de integração.
Exemplo do atributo "usuarioLogado":
usuario-logadousuario_logadousuario- usuarioLogado
Descrição dos objetos e atributos de retorno - Sucesso
Referência: Método "login" > Descrição dos objetos e atributos de retorno - Sucesso
Retorno API - Sucesso
Referência: Método "login" > Retorno API - Sucesso
Descrição dos objetos e atributos de retorno - Falha
Referência: Método "login" > Descrição dos objetos e atributos de retorno - Falha
Retorno API - Falha
Referência: Método "login" > Retorno API - Falha
Método de "reiniciarSenha"
Este serviço é utilizado para criar uma nova senha para o usuário, que não sabem ou perderam a senha anterior.
Em termos práticos, este webservice seria consumido por um link chamado “Recuperar senha“ na tela de login.
Regras de negócio
- Este webservice deverá validar todas as regras de negócio da empresa e só permitir a recuperação do acesso do usuário caso ele seja um beneficiário ou profissional de saúde ativo e que tenha direito de uso. Este método é único para beneficiário e profissional de saúde.
- A ideia é que só altere a senha do usuário caso os dados informados estejam iguais aos cadastrados na sua base.
- Caso o usuário nunca tenha acessado a área restrita, fica a critério da operadora decidir se já cria o acesso com a nova senha ou retorna uma mensagem de erro dizendo que o usuário não está cadastrado e que deve passar pela funcionalidade de "Criar seu acesso" .
- Um ponto de atenção caso sua estrutura seja multi contrato, quando houver a reinicialização da senha, as credenciais de acesso (login e senha) será para ambos contratos.
Endpoint
Endpoint | Método | Header Content-Type | Descrição |
|---|---|---|---|
exemplo.com/reiniciarSenha Atenção O endpoint obrigatoriamente deve terminar com "/reiniciarSenha". | POST | application/json | Endpoint para criar acesso de novos usuários |
Parâmetros de entrada
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
login | M | String | Id de identificação do usuário. |
dataNascimento | M | String | Campo data de nascimento. A ideia é que o cruzamento dos campos login + DataNascimento permita ao sistema identificar o usuário com segurança para a criação do usuário de acesso. Formato: yyyy-MM-dd |
| senha | M | String | Nova senha informada pelo usuário. |
| OP | String | E-mail informado pelo usuário. Pode ser usado para verificar os dados junto com o login + dataNascimento. |
Request body
{
"login": "<login>",
"dataNascimento": "<dataNascimento>",
"senha": "<senha>”,
“email”: “<email@email.com>"
}
Objetos e atributos de retorno
Atenção
Os atributos devem seguir exatamente os mesmos nomes indicados nesta documentação, caso contrário, serão rejeitados pelo validador de integração.
Exemplo do atributo "status":
status-confirmacaoStatus- status
Descrição dos objetos e atributos de retorno - Sucesso
Objeto principal
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| status | M | Boolean | Indica que a senha foi reiniciada com sucesso. | true |
Retorno da API - Sucesso
{
"status": true
}
Descrição dos objetos e atributos de retorno - Falha
Objeto principal
| Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
| status | M | Boolean | Indica que a reinicialização da senha foi mal sucedida. | false |
| motivoCritica | M | String | Motivo pelo qual não foi possível trocar a senha. | Formato: Texto livre. |
Retorno API - Falha
{
"status": false,
"motivoCritica": "Dados inválidos, verifique os dados informados"
}
Tabela de funcionalidades
| Descrição | Código |
|---|---|
Notícia | 0 |
InBox ( caixa de notificações ) | 1 |
| Agendamento On-line | 2 |
| Cartão Virtual | 3 |
| Busca de Rede Credenciada | 4 |
| Busca de Medicamento | 5 |
| Prescrições | 6 |
| Alarmes | 7 |
| Contatos | 8 |
| Extrato de Utilização e Coparticipação | 11 |
| Extrato de Autorizações | 13 |
| Débitos (boletos) | 14 |
| Revistas e Manuais | 18 |
| Declarações (IR, Carta de quitação e Carta de permancia) | 20 |
| Componente Cadastral (PIN-SS) Cadastral | 21 |
| Guia Médico Nacional | 24 |
| Navegador Interno (para abrir links dentro do App) | 29 |
| Fila de Espera | 35 |
| Resultado de Exames | 36 |
| Navegador Externo (para abrir links fora do App, diretamente no navegador) | 37 |
| Solicitação de Segunda Via de Cartão | 38 |
| Solicitação de Atualização Cadastral | 39 |
| Solicitação de Cancelamento de Plano | 42 |
| Botão de Emergencia | 43 |
| Chat | 46 |
| Solicitação de Autorização | 48 |
| Cartão Virtual Modelo Unimed Brasil | 55 |
| Reembolso CMS | 56 |
| Extrato Reembolso | 57 |
| Mosia TeleCare | 58 |
| Detalhes do agendamento | 89 |
| Eventos - exclusivo para o perfil de profissional de saúde | 102 |
| Extrato de Pagamento - exclusivo para o perfil de profissional de saúde | 103 |
| Indicação de Ausência - exclusivo para o perfil de profissional de saúde | 105 |
| Programa de Pontos - exclusivo para o perfil de profissional de saúde | 106 |
| Programa de Cursos - exclusivo para o perfil de profissional de saúde | 110 |
Mobile Saúde - 2019