Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

Índice
minLevel1
maxLevel7

...

Critérios de preenchimento

Abreviação

Nome

Descrição

M

Mandatório

O preenchimento do atributo é obrigatório. Caso o atributo esteja nulo ou em branco, seu "response" será rejeitado.

C

Condicional

O atributo pode tornar-se obrigatório quando um ou mais atributos auxiliares for preenchido / atualizado.

OP

Opcional

Seu preenchimento não é obrigatório. Pode-se enviar NULL para objetos, ou arrays vazios para tipos Array

Objetos e atributos de retorno

Nota

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 "contatos":

  • contatos-beneficiario

  • contatos_beneficiario

  • contato

  • contatos (concordo)

Método - Primeiro Acesso

Dica

Endpoint

Endpoint

Método

Header Content-Type

Descrição

/primeiroAcesso

Nota

Atenção

O endpoint obrigatoriamente deve terminar com "/primeiroAcesso".

POST

application/json

Endpoint de primeiro acesso

Parâmetros de entrada

Informações

Formulário dinâmico criado pelo Formbuilder. A aplicação fica responsável por encaminhar o formulário informado para o método de primeiro acesso. Os parâmetros de entrada devem ser devidamente informados no formulário de autenticação utilizado configurador de integração.

...

Bloco de código
languagejson
{
  "seguranca": {
    "auth": [
      {
        "chave": "Authorization",
        "token": "JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzI5ODQ4MzgsIm5iZiI6MTU3Mjk4NDgzOSwiZXhwIjoxNTczMDI4MDM4LCJkYXRhIjp7ImxvZ2luIjoiZGVybGFuZHlAbW9iaWxlc2F1ZGUuY29tLmJyIn19.dzJOQhSG8pJx-l6WDDgMVszFsKB26PsIjF4rB1TnWrk"
      },
      {
        "chave": "Authorization-Custom",
        "token": "JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzI5ODQ4MzgsIm5iZiI6MTU3Mjk4NDgzOSwiZXhwIjoxNTczMDI4MDM4LCJkYXRhIjp7ImxvZ2luIjoiZGVybGFuZHlAbW9iaWxlc2F1ZGUuY29tLmJyIn19.dzJOQhSG8pJx-l6WDDgMVszFsKB26PsIjF4rB1TnWrk",
        "expiracao": 1574366666921
      }
    ]
  },
  "usuarioLogado": {
    "permissoes": [
      {
        "funcionalidade": "0",
        "acesso": true,
        "mensagemBloqueio": null,
        "ocultar": false,
        "listaUsuario": false
      }
    ],
    "login": "123",
    "chaveUnica": "101012",
    "contato": {
      "email": "geraldo@mobilesaude.com.br",
      "telefoneCelular": "27999826284",
      "telefoneFixo": "2733778899"
    },
    "esquemaCor": "esquema-premium",
    "integracao": {
      "xpto": "voluptatibus",
      "xyz": "quibusdam",
      "abcdef": 9288701
    }
  },
  "beneficiarios": [
    {
      "chaveUnica": "101012",
      "integracao": {
        "xpto": "voluptatibus",
        "xyz": "quibusdam",
        "abcdef": 9288701
      },
      "dadosPessoais": {
        "nome": "Geraldo Felix Junior",
        "dataNascimento": "2017-11-05",
        "cpf": "92188083970",
        "nomeMae": "Geraldina Mother Felix",
        "sexo": {
          "codigo": "F",
          "descricao": "Feminino"
        },
        "contato": {
        "email": "geraldo@mobilesaude.com.br",
        "telefoneCelular": "27999826284",
        "telefoneFixo": "2733778899"
        },
        "estadoCivil": {
          "codigo": "C",
          "descricao": "Casado"
        }
      },
      "dadosDoContrato": {
        "numeroContrato": "99991"
      },
      "dadosDoPlano": {
        "beneficiario": true,
        "idPlano": "01",
        "descricao": "Plano Básico",
        "registroAns": "999.999/99-9",
        "segmentacao": "Ambulatorial + Hospitalar com obstetrícia",
        "acomodacao": "Individual",
        "tipoContratacao": "Plano Coletivo Empresarial",
        "regulamentacao": "Plano Regulamentado",
        "abrangencia": "Estadual",
        "modalidadeCobranca": "Pós-pagamento",
        "padraoConforto": "",
        "participativo": false,
        "dataInicioVigenciaPlano": "2012-01-01",
        "dataFinalCpt": "Não há",
        "dataInclusao": "1990-08-05",
        "matricula": "2320170425162943-0",
        "matriculaAntiga": null,
        "matriculaFuncionario": null,
        "tipoUsuario": {
          "codigo": "D",
          "descricao": "Dependente"
        },
        "grauParentesco": {
          "codigo": "01",
          "descricao": "Conjuge"
        },
        "idRedeAtendimento": "123",
        "carencias": [
          {
            "tipoServico": "ES - Atendimentos Ambulatoriais",
            "carencia": "2012-12-31"
          },
          {
            "tipoServico": "ES - Internações e Outros Procedimentos",
            "carencia": "2012-12-31"
          },
          {
            "tipoServico": "ES - Partos a Termo",
            "carencia": "2012-12-31"
          },
          {
            "tipoServico": "ES - Odontologia",
            "carencia": "2012-12-31"
          }
        ]
      },
      "cartao": {
        "modeloCartao": "plano_basico",
        "numeroCartao": "00010002000001000",
        "validade": "2021-02-15",
        "via": 1,
        "numeroCns": "999999999999999",
        "apresentaCartaoVirtual": true
      },
      "bloqueio": {
        "bloqueado": true,
        "dataBloqueio": "2012-01-01",
        "motivo": "desligamento da empresa contratante"
      },
      "custom": [
        {
          "chave": "minha_chave_customizada",
          "valor": "Meu valor customizado"
        }
      ]
    }
  ],
  "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": "00100200300400500609",
      "email": "derlandy@mobilesaude.com.br"
    }
  ],
  "contratos": [
    {
      "descricaoContrato": "Plano Básico",
      "numeroContrato": "00100200300400500609",
      "empresaContratante": {
        "codigo": "03",
        "descricao": "Mobile Saúde"
      },
      "tipoPessoa": {
        "codigo": "J",
        "descricao": "Pessoa Jurídica"
      },
      "tipoRelacionamento": {
        "codigo": "3",
        "descricao": "Responsavel financeio"
      },
      "tipoContratante": {
        "codigo": "3",
        "descricao": "Empresa"
      },
      "dataInicioVigenciaContrato": "2012-01-01",
      "dadosTitular": {
        "matricula": "2320170425162943-0",
        "nome": "Derlandy Belchior",
        "email": "derlandy@mobilesaude.com.br",
        "telefone": "8646166114",
        "celular": "27999826284",
        "cpf": "92188083970"
      }
    },
    {
      "descricaoContrato": "Plano Gold Familia",
      "numeroContrato": "00100200300400500608",
      "empresaContratante": {
        "codigo": "03",
        "descricao": "Mobile Saúde"
      },
      "tipoPessoa": {
        "codigo": "J",
        "descricao": "Pessoa Jurídica"
      },
      "tipoRelacionamento": {
        "codigo": "3",
        "descricao": "Responsavel financeio"
      },
      "tipoContratante": {
        "codigo": "3",
        "descricao": "Empresa"
      },
      "dataInicioVigenciaContrato": "2012-01-01",
      "dadosTitular": {
        "matricula": "2320170425162943-0",
        "nome": "Derlandy Belchior",
        "email": "derlandy@mobilesaude.com.br",
        "telefone": "8646166114",
        "celular": "27999826284",
        "cpf": "92188083970"
      }
    },
    {
      "descricaoContrato": "Plano Sênior",
      "numeroContrato": "00100200300400500607",
      "tipoPessoa": {
          "codigo": "F",
          "descricao": "Pessoa Física"
      },
        "empresaContratante": {
        "codigo": "03",
        "descricao": "Mobile Saúde"
      },
        "tipoRelacionamento": {
            "codigo": "3",
            "descricao": "Responsavel financeio"
      },
      "tipoContratante": {
        "codigo": "2",
        "descricao": "Empresa"
      },
      "dataInicioVigenciaContrato": "2012-01-01",
      
      "dadosTitular": {
        "matricula": "2320170425162943-0",
        "nome": "Derlandy Belchior",
        "email": "derlandy@mobilesaude.com.br",
        "telefone": "8646166114",
        "celular": "27999826284",
        "cpf": "92188083970"
      }
    }
  ],
  "segmentacao": [
    {
      "chaveSegmentacao": "Plano",
      "idSegmento": "0101",
      "descricaoSegmento": "Plano básico"
    },
    {
      "chaveSegmentacao": "Tipo de usuário",
      "idSegmento": "T",
      "descricaoSegmento": "Titular"
    }
  ],
  "mosia": {
    "alocacao": {
      "codigoAgente": null,
      "codigoFila": null
    },
    "dadosCustomizados": {
      "nascimento": "20/20/2020",
      "vencimento": "20/20/2020",
      "emissao": "20/20/2020"
    }
  },
  "agenteRelacionamento": {
    "nome": "Salomé Irene Godói Jr.",
    "telefone": "34940972035",
    "whatsapp": "47984672759",
    "email": "carolina.mascarenhas@salas.com.br",
    "linkFoto": "https://randomuser.me/api/portraits/women/17.jpg",
    "tituloApresentacao": "Beneficiário"
  }
}

...

Aviso
  • Este método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.

  • Atente-se as mensagens de retorno para cada HTTPS Status Code;

Objetos e atributos de retorno

Atributo

Critério

Tipo

Descrição

Regra de preenchimento

mensagem

M

String

mensagem para ser exibida para o cliente

 texto livre

Exemplo retorno API - falha

Bloco de código
languagejson
{
   "status": true,
   "mensagem": "Beneficiário não encontrado",
}