VW_BENEFICIARIOS_MOBILE - Obrigatório

Após a validação em Criar Acesso, Login ou Reiniciar Senha, será necessário buscar os dados de Beneficiário, seja ele do tipo Titular, Dependente, ou Contratante. A tabela abaixo demostra a necessidade de cada atributo que deve retornar na VW_BENEFICIARIOS_MOBILE, com uma breve explicação sobre cada atributo.

Processo aos quais é usado a VW_BENEFICIARIOS_MOBILE.

A implementação desta VW é Obrigatório, para funcionamento das aplicações que usaram está integração.

Tabela de Atributos que devem retornar da VW_BENEFICIARIOS_MOBILE:

Nome Atributo	Tipo Atributo	Obrigatório	Descrição
id_registro	Número	Sim	Cada registro da view, deve ter um número único, para diferenciar cada linha de retorno na view, porém nunca serão usados como filtros.
chave_unica	Texto	Sim	Chave única do titular, ou, dependente, caso o Titular esteja logado, deve apresentar a chave do seus dependentes.
id_operadora	Texto	Sim	Retornar com a identificação da operadora
matricula	Texto	Sim	Matrícula do beneficiário. Informar a matrícula completa, sem espaços ou caracteres especiais
matricula_antiga	Texto	Não	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.
matricula_funcionario	Texto	Não	Indicar o código da matrícula de funcionário na empresa patrocinadora, caso aplicável.
nome_social	Texto	Não	Informe o nome social do beneficiário.
sexo	Texto	Sim	Informar o sexo do usuário. M = Masculino / F = Feminino / N = Não se aplica. Apenas maiúsculos
data_nascimento	Data	Sim	Data de nascimento do beneficiário (yyyy-MM-dd).
cpf	Texto	Sim	CPF do beneficiário
celular	Texto	Não	Informar o numero do telefone celular do beneficiário, sem mascara.
email	Texto	Não	Email do beneficiário.
endereco	Texto	Não	Endereço do beneficiário.
bairro	Texto	Não	Bairro do beneficiário.
cep	Texto	Não	Cep do beneficiário.
cidade	Texto	Sim	Cidade do beneficiário.
estado	Texto	Sim	Estado do beneficiário.
complemento	Texto	Não	Complemento de endereço do beneficiário.
numero_endereco	Texto	Não	Número endereço do beneficiário.
tipo_usuario	Texto	Sim	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 tipo_usuario = T por contrato.
grau_parentesco_id	Texto	Sim	Indicar o ID do grau de parentesco
descricao_grau_parentesco	Texto	Sim	Descrição do Grau de Parentesco
data_contratacao	Data	Sim	Data da contratação do plano de saúde. Obrigatório PIN-SS conforme RN 389. Formato (yyyy-MM-dd).
data_Inicio_cobertura	Data	Sim	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).
convenio_id	Texto	Sim	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.
convenio_descricao	Texto	Sim	Texto descritivo do nome do plano (produto) do beneficiário. Informar o nome comercial junto a ANS.
convenio_abrangencia	Texto	Não	Texto descritivo do nome do plano (produto) do beneficiário. Informar o nome comercial junto a ANS Obrigatório no cartão devido a RN 389
convenio_acomodacao	Texto	Não	Texto descritivo do padrão de acomodação do plano do beneficiário, conforme ANS
convenio_modalidade_cobranca	Texto	Não	Texto descritivo da modalidade de cobrança do contrato do beneficiário, como por exemplo: Pré-pagamento, Pós-pagamento e etc.
convenio_padrao_conforto	Texto	Não	Texto descritivo do padrão de conforto do plano (produto)
convenio_participativo	texto	Não	Campo para informar se o plano (produto) do beneficiário possui coparticipação ou não. Caso tenha retornar “S”, caso não tenha coparticipação retornar “N”.
convenio_segmentacao	Texto	Não	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.
convenio_tipo_pessoa	Texto	Não	Tipo de contrato do plano (produto) do beneficiário Exemplo: Pessoa Física ou Pessoa Jurídica
convenio_tipo_contrato	Texto	Sim	Informação sobre o tipo de contratação do plano privado de assistência à saúde, conforme RN 195. Individual/Familiar, coletivo por adesão ou coletivo empresarial.
convenio_regulamentacao	Texto	Sim	Informação sobre a regulamentação do plano, entendendo-se por: Regulamentado / adaptado / não regulado.
cartao_validade	Texto	Não	Informe textos como "Indefinida" ou "31/12/2020", ou "Vencido"
cartao_via	Texto	Não	Indica o numero da via do cartão vigente do beneficiário
chave_empresa_contratante	Texto	Sim	Código identificador da empresa contratante do plano do beneficiário (nos casos de planos coletivos por adesão ou coletivos empresariais). 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.
nome_empresa_contratante	Texto	Sim	Nome da empresa contratante Obrigatório PIN-SS conforme RN 389.
contrato_empresa_contratante	Texto	Sim	Numero do contrato/apólice. Obrigatório PIN-SS conforme RN 389
cod_familia	Texto	Sim	Este atributo define uma código para uma família dentro de um contrato, quando a operadora usa o número do contrato para definir varias pessoas dentro do mesmo, o atributo deve retornar com a mesma numeração do codigo_contrato.
numero_cns	Texto	Não	Numero do Cartão Nacional de Saúde. Obrigatório no cartão do beneficiário conforme RN 389.
convenio_ans	Texto	Não	Número de registro do plano do beneficiário na ANS.
data_final_cpt	Data	Não	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 padrão (yyyy-MM-dd)
codigo_contrato	Texto	Sim	Código que identifica de qual contrato esse usuário está vinculado.
rede_atendimento	Texto	Não	Informe o código e a descrição da Rede de Atendimento do beneficiário Observação PTU 5.1: campo obrigatório
modelo_cartao	Texto	Não	Indique o layout de cartão que deve ser exibido. O dado aqui deve ser idêntico ao acordado entre sua empresa e a Mobile Saúde, na documentação de layouts de cartões
telefone	Texto	Não	Telefone de contato, não o celular