ÍNDICE

  1. Visão Geral
  2. Configurando o ambiente de administração
  3. Customização de Verificação de Elegibilidade
  4. Customização de Validação do procedimento
  5. Customização da Gravação da autorização

01. VISÃO GERAL

Esta documentação visa explanar sobre as API's desenvolvidas para verificar regras específicas (customizadas) da operadora de saúde em determinados pontos da autorização construída no HAT. Isto é, a Operadora de Saúde deverá desenvolver uma API em seu software de gestão que validará regras específicas na verificação de elegibilidade do beneficiário, na validação dos procedimentos e na gravação do atendimento. A padronização de como o HAT enviará as informações para esta API e o que esperará de retorno será documentada neste espaço.

02. Configurando o ambiente de administração

Para configurar os endpoints da customização, é necessário acessar o painel de administração do HAT.

          Em seguida, acessar, no menu Configurações, Configurações de Integração.

         

          Serão três EndPoints, e podem ter suas informações editadas.

       

  1.        Informe a URL Base no campo endpoint
  2.        Informe o path do endpoint conforme exemplo abaixo
  3.        O tipo deve ser POST
  4.        Informe um tempo de timeout em segundos. Este tempo será usado para informar ao HAT qual o tempo crítico que a customização leva para responder.
  5.        Se possuir healthcheck do endpoint, informe a URL.

        

03. Customização de Verificação de Elegibilidade

Abaixo é o corpo da requisição que o HAT enviará para o seu endpoint customizado

Nome

Tipo

Descrição

beneficiary

Object

Dados do beneficiário

beneficiary.phoneNumber

String

Telefone do beneficiário

beneficiary.newbornAttendance

String

S para atendimento RN e N para atendimento normal

beneficiary.holderCPF

String

CPF do beneficiário ou responsável

beneficiary.whenToCharge

String

1 para Coparticipação com pagamento no ato e 0 Sem coparticipação

beneficiary.birthdate

String

Data de nascimento

Beneficiary.owner

Object

Dados do titular

beneficiary.isOwner

Boolean

Se o beneficiário é titular

beneficiary.CNS

String

Código do Cartão Nacional de saúde

beneficiary.subscriberId

String

Matrícula

beneficiary.name

String

Nome

beneficiary.companyName

String

Nome da empresa do plano

beneficiary.oldSubscriberId

String

Matricula antiga (matant)

beneficiary.healthInsurance

Object

Dados do plano

beneficiary.healthInsurance.code

String

Código do plano

beneficiary.healthInsurance.roomType

String

Tipo de acomodação

beneficiary.healthInsurance.description

String

Descrição do plano

beneficiary.cardExpiration

String

Data de expiração da carteirinha

rejectionCauses

Array of Object

Críticas já validadas pelo HAT

rejectionCauses[n].code

String

Código da Crítica

rejectionCauses[n].alert

String

Se é alerta “1” ou não “0”

rejectionCauses[n].description

String

Descrição da crítica


Abaixo a resposta que o seu endpoint deve retornar:

Nome

Tipo

Descrição

elegibilityResponse

String

S (autorizado) ou N (não autorizado) – Será substituído na decisão do HAT. Exemplo: o HAT não autorizou mas a customização sim, prevalece a customização.

rejectionCauses

Array of Object

Críticas no mesmo padrão do envio. Pode-se manter as críticas validadas pelo HAT, substituir as críticas ou apenas adicionar novas.

04. Customização da Validação do procedimento

Em construção

05. Customização da Gravação da autorização

O HAT vai enviar para o seu endpoint de customização, um corpo diferente para cada tipo de atendimento pois as informações variam de acordo com a guia. Por exemplo: Data de internação: Informado somente na guia de internação.