Autenticação de beneficiários e/ou profissionais de saúde

Informações

Avisos
  1. Só são suportadas integrações no padrão REST.
  2. 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çãoNomeDescrição
MMandatórioO preenchimento do atributo é obrigatório. Caso o atributo esteja nulo ou em branco, seu "response" será rejeitado.
CCondicionalO atributo pode tornar-se obrigatório quando um ou mais atributos auxiliares for preenchido / atualizado.
OPOpcional

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âmetroObrigatórioTipoDescriçã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.
Observação sobre criptografia: caso seja necessário criptografar a senha, sugerimos fornecer um acesso via HTTPS ao invés de usar algoritmos próprios.

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-logado
  • usuario_logado
  • usuario
  • usuarioLogado (concordo)

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
AtributoCritérioTipoDescriçãoRegra de preenchimento
statusM

Boolean

Indica que o login foi realizado corretamentetrue
usuarioLogado

M

Objeto usuarioLogado

Usuário que efetuou login

Objeto precisa ter sua estrutura completamente preenchida.

beneficiariosC

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

profissionaisSaudeC

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

contratosM

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"

mosiaOP

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

agenteRelacionamentoOP

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

segurancaOPObjeto "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.

AtributoCritérioTipoDescriçãoRegra de preenchimento
localizadorMensageriaM

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)
integracaoMObjetoInformaçõ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.

AtributoCritérioTipoDescriçãoRegra 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
matriculaAntigaOP

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)
matriculaTitularM

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”
nomeTitularM

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”
emailTitularOP

String

Informe o e-mail do titular

Validar com regras de e-mail válido, se preenchido.  
telefoneTitularC

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

celularTitularC

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

cpfTitularMStringInforme 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”
nomeM

String

Nome do beneficiárioNão permitir números, nem caracteres especiais. Permitido acentos
nomeSocialOPStringInforme o nome social do beneficiárioNão permitir números, nem caracteres especiais. Permitido acentos
sexoM

String

Informar o sexo do usuário

M = Masculino / F = Feminino / N = Não se aplica. Apenas maiúsculos
dataNascimentoM

String

Data de nascimento do beneficiário

Formato: YYYY-MM-DD
cpfOP

String

CPF do beneficiário

Somente números. Tamanho mínimo / máximo 11 posições.
celularOP

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

emailC

String

EmailEmail precisa ser válido.  
enderecoOP

String

Endereço

Formato: Texto livre.
bairroOP

String

BairroFormato: Texto livre.
cepOP

String

CEPFormato: Texto livre.
cidadeM

String

CidadeEnviar conforme descrição do IBGE
estadoM

String

EstadoEnviar conforme sigla do IBGE (SC, ES, SP, RJ, etc). Tamanho mínimo / máximo 2 posições. Somente letras. Apenas maiúsculas
complementoOPStringComplemento do endereçoFormato: Texto livre.
numeroEnderecoOPStringNúmero do endereçoFormato: Texto livre.
tipoUsuarioM

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

grauParentescoIdM

String

Código do grau de parentesco do beneficiário em relação ao titular

Indicar o ID do grau de parentesco
grauParentescoDescricaoM

String

Descrição do Grau de Parentesco

Formato: Texto livre.
dataContratacaoM

String

Data da contratação do plano de saúde. Obrigatório PIN-SS conforme RN 389.

Formato: YYYY-MM-DD
dataInicioCoberturaM

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
convenioIdM

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.
convenioDescricaoM

String

Texto descritivo do nome do plano (produto) do beneficiário. Informar o nome comercial junto a ANSFormato: 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.
convenioAbrangenciaVersoOP

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 UnimedFormato: Texto livre.
convenioAcomodacaoOP

String

Texto descritivo do padrão de acomodação do plano do beneficiário, conforme ANS

Formato: Texto livre.
convenioModalidadeCobrancaOP

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.
convenioPadraoConfortoOP

String

Texto descritivo do padrão de conforto do plano (produto)Formato: Texto livre.
convenioParticipativoOP

Boolean

Campo para informar se o plano (produto) do beneficiário possui coparticipação ou não.

True/False

convenioSegmentacaoOP

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.
convenioTipoPessoaOP

String

Tipo de contrato do plano (produto) do beneficiário Exemplo: Pessoa Física ou Pessoa JurídicaFormato: Texto livre.
convenioTipoContratoM

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
chaveEmpresaContratanteM

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


nomeEmpresaContratanteM

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.


contratoEmpresaContratanteM

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.


numeroCnsOP

String

Numero do Cartão Nacional de Saúde. Obrigatório no cartão do beneficiário conforme RN 389.

Formato: Texto livre.
equipeAtendimentoCMSOPStringEquipe 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.
convenioAnsOP

String

Número de registro do plano do beneficiário na ANS. Formato: Texto livre.
dataFinalCptOP

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.
qrCodeCartaoVirtualOPStringCaso 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. 
codigoContratoM

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“
redeAtendimentoOP

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). 

modeloCartaoC

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õesASCII (nao permite especiais). Torna-se obrigatório quando o cartão virtual foi contratado.
carenciasOP

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
customOPArray de objetos "custom"

integracaoMObjetoInformaçõ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.
cooperativasOPObjetoAs 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. 
seedOPStringUsado para exibir / calcular o token na funcionalidade de cartão virtual do beneficiárioSó 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.

AtributoCritérioTipoDescriçãoRegra de preenchimento
nomeM

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.
conselhoRegionalOP

String

Número no conselho regional

Somente números
siglaConselhoRegionalC

String

Sigla do conselho regionalSe conselhoRegional possuir conteúdo, torna-se obrigatório. Tamanho máximo 8 posições
estadoConselhoRegionalC

String

Estado do conselho regional

Se conselhoRegional possuir conteúdo, torna-se obrigatório. Tamanho máximo 2 posições
tituloOP

String

Tratamento com o profissional, exemplo, Dr. Dra. Etc.


sexoM

String

Sexo do profissional de saúde,

M = Masculino / F = Feminino / N - Não se aplica - Apenas maiúsculas
dataNascimentoM

String

Data de nascimento do profissional de saúde

Formato: YYYY-MM-DD
cpfM

String

CPF do profissional de saúde. Apenas números, sem máscara

Somente números. 11 posições. 


celularOP

String

Número do celular do profissional de saúde

Tamanho mínimo / máximo 11 posições. Somente números
especialidadesM

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.
codigoContratoM

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“
emailM

String

Email do profissional de saúde

Email válido.
customOPArray 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 loginselecionar o contratologado com o contrato selecionadoclicando novamente é possível mudar de contratologado com o novo contrato selecionado

Fluxo login SEM multi contrato

Tela de loginBeneficiário logado no app

AtributoCritérioTipoDescriçãoRegra de preenchimento
nomeM

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). 
tipoM

String

Preencha com beneficiario ou profissionalSaude

Conteúdo válido: beneficiario ou profissionalSaude
permissoesM

Array de objeto "permissoes"

Sigla do conselho regionalObjetos 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.

AtributoCritérioTipoDescriçãoRegra de preenchimento
funcionalidadeM

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
mensagemBloqueioC

String

Preencha com beneficiario ou profissionalSaude

Só pode ter conteúdo quando acesso = false
ocultarM

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.

AtributoCritérioTipoDescriçãoRegra de preenchimento
tipoServicoM

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.
Exemplo: Vencida, ou 31/12/2015, ou 12 meses, ou da forma como for necessário.

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.

AtributoCritérioTipoDescriçãoRegra de preenchimento
callerKeyM

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. 

callerNameM

String

Nome do chamador

Não permite números 
callerPhoneC

String

Telefone do chamador

Tamanho mínimo / máximo 11 posições. Somente números

Preenchimento obrigatório se callerEmail estiver vazio.

allocationAgentOP

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.
allocationQueueOP

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
customClientDataWidgetOPArray 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.

AtributoCritérioTipoDescriçãoRegra de preenchimento
nomeM

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
telefone2OP

String

Indique um segundo telefone do gestor de relacionamento

Tamanho mínimo 10 / máximo 11 posições. Somente números
emailC

String

Indique o email do gestor de relacionamentoRegras de e-mail
linkFotoOP

String

Indique uma URL ativa de internet com a imagem para a foto do gestor de relacionamento.URL válida
tituloApresentacaoOP

String

Texto de apresentação para ser divulgado na rotinaFormato: Texto livre.
Objeto segurança

Este objeto é destinado as propriedades relacionadas a segurança dos dados do beneficiário.

AtributoCritérioTipo 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 
AtributoCrité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
expiracaoONumberCaso 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.

AtributoCritérioTipoDescriçãoRegra de preenchimento
cboEspecialidadeIdM

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).

AtributoCritérioTipoDescriçãoRegra de preenchimento
chaveM

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.

AtributoCritérioTipoDescriçãoRegra de preenchimento
chaveM

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.


AtributoCritérioTipoDescriçãoRegra de preenchimento
chaveM

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. 

AtributoCritérioTipoDescriçãoRegra de preenchimento
seedM

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.
convenioAnsContratadaMStringInforme o número de registro ANS da operadora contratada, quando houver (campo para cartão virtual Unimed PTU - digital)Formato: Texto livre.
layoutCartaoVirtualMStringInforme 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
nomeCartaoOPStringNome 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. 
nomeSocialCartaoOP
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

Retorno
{
    "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
AtributoCritérioTipoDescriçãoRegra de preenchimento
statusM

Boolean

Indica que o login não foi realizado corretamente.false
motivoCriticaMString
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âmetroObrigatórioTipoDescrição
loginMStringLogin 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.

integracaoMObjetoInformaçõ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-confirmacao
  • Status
  • status (concordo)

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
AtributoCritérioTipoDescriçãoRegra de preenchimento
statusM

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
AtributoCritérioTipoDescriçãoRegra de preenchimento
statusM

Boolean

Indica que a troca de senha foi mal sucedida.

false
motivoCriticaMString

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âmetroObrigatórioTipoDescriçã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

senhaMStringNova senha, informada pelo usuário.
emailOPStringE-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-logado
  • usuario_logado
  • usuario
  • usuarioLogado (concordo)

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âmetroObrigatórioTipoDescriçã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

senhaMStringNova senha informada pelo usuário.
emailOPStringE-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-confirmacao
  • Status
  • status (concordo)

Descrição dos objetos e atributos de retorno - Sucesso

Objeto principal
AtributoCritérioTipoDescriçãoRegra de preenchimento
statusM

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
AtributoCritérioTipoDescriçãoRegra de preenchimento
statusM

Boolean

Indica que a reinicialização da senha foi mal sucedida.

false
motivoCriticaMString

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çãoCódigo

Notícia

0

InBox ( caixa de notificações )

1

Agendamento On-line2
Cartão Virtual3
Busca de Rede Credenciada4
Busca de Medicamento5
Prescrições6
Alarmes7
Contatos8
Extrato de Reembolso 10
Extrato de Utilização e Coparticipação11
Extrato de Autorizações 13
Débitos (boletos)14
Revistas e Manuais18
Declarações (IR, Carta de quitação e Carta de permancia)20
Componente Cadastral (PIN-SS) Cadastral21
Guia Médico Nacional24
Navegador Interno (para abrir links dentro do App)29
Fila de Espera35
Resultado de Exames36
Navegador Externo (para abrir links fora do App, diretamente no navegador)37
Solicitação de Segunda Via de Cartão38
Solicitação de Atualização Cadastral 39
Solicitação de Cancelamento de Plano42
Botão de Emergencia43
Chat46
Solicitação de Autorização48
Cartão Virtual Modelo Unimed Brasil55
Reembolso CMS56
Extrato Reembolso57
Mosia TeleCare58
Detalhes do agendamento89
Eventos - exclusivo para o perfil de profissional de saúde102
Extrato de Pagamento - exclusivo para o perfil de profissional de saúde103
Indicação de Ausência - exclusivo para o perfil de profissional de saúde105
Programa de Pontos - exclusivo para o perfil de profissional de saúde106
Programa de Cursos - exclusivo para o perfil de profissional de saúde110


Mobile Saúde - 2019