Skip to content
Documentação IntegraDoor

Elegibilidade

Caso de Uso:

Verificar elegibilidade de um paciente utilizando a credencial da operadora X

Este caso de uso demonstra como consultar a elegibilidade de um paciente junto à operadora X, utilizando os recursos da API do IntegraDoor.

Importante: Antes de realizar a verificação de elegibilidade, é necessário selecionar a credencial. Esse identificador será utilizado na requisição de elegibilidade.

  1. Listar as credenciais disponíveis da operadora X Utilize o endpoint:

    Exemplo de requisição:

    Terminal window
    curl -X 'GET' \
      'https://api.integradoor.com.br/api/v2/credenciais?Busca=X' \
      -H 'accept: text/plain'

    Exemplo de resposta (credencial encontrada):

    {
      "sucesso": true,
      "data": {
        "items": [
          {
            "id": "e8d3f894-7f1e-41d0-a9f6-123456789abc",
            "nome": "X ASSISTÊNCIA MÉDICA INTERNACIONAL S/A",
            "codigoPrestador": "112233445566",
            "credencialElegibilityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
          }
        ]
      }
    }

  2. Montar os dados do paciente Com a credencialId obtida no passo anterior, monte o corpo da requisição com o número da carteira do paciente.

    Exemplo de payload:

    {
      "credencialId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "carteira": "12345678900"
    }

  3. Enviar solicitação de elegibilidade Envie uma requisição POST para o endpoint /api/v2/autorizar/elegibilidade com os dados preparados.

    Exemplo de requisição:

    Terminal window
    curl -X 'POST' \
      'https://api.integradoor.com.br/api/v2/autorizar/elegibilidade' \
      -H 'Content-Type: application/json' \
      -d '{
            "credencialId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "carteira": "12345678900"
          }'

  4. Interpretar a resposta da operadora O retorno indicará a situação da elegibilidade do paciente, podendo ser ATIVO, CANCELADO, ou conter pendências.

    Exemplo de resposta com paciente ativo:

    {
      "sucesso": true,
      "data": {
        "situacao": "ATIVO",
        "nome": " PACIENTE X",
        "plano": "AMIL +100",
        "requerBiometria": true
      }
    }

Outros exemplos de requisição:

{
  "credencialId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "carteira": "12345678900"
}

Resposta (paciente ativo)

{
  "sucesso": true,
  "erros": [],
  "data": {
    "carteiraInvalida": false,
    "situacao": "ATIVO",
    "nome": " PACIENTE X",
    "dataNascimento": "2025-05-29T06:03:19.829Z",
    "requerBiometria": true, <!-- Indica se a credencial utilizada necessita de biometria. -->
    "carteira": "12345678900",
    "sexo": "M",
    "telefoneDDI": "",
    "telefone": "",
    "plano": "AMIL +100",
    "email": "",
    "dadosBiometricos": {
      "mustRegister": false <!-- Indica se o paciente tem ou não bio cadastrada. -->
    }
  }
}

Resposta (paciente inativo ou cancelado):

{
  "sucesso": true,
  "erros": [],
  "data": {
    "carteiraInvalida": false,
    "situacao": "CANCELADO",
    "nome": " PACIENTE X",
    "dataNascimento": "2025-05-29T06:03:19.829Z",
    "requerBiometria": false,
    "carteira": "12345678900",
    "sexo": "M",
    "telefoneDDI": "",
    "telefone": "",
    "plano": "AMIL +100",
    "email": "",
    "dadosBiometricos": {
      "mustRegister": false
    }
  }
}