Histórico da Página

...

Tabela	Atributo
BEA	(raiz do json)
BE2	procedures

Pré-Análise de Execução de uma Liberação

Outra funcionalidade no verbo GET é a pré-análise de execução de uma Liberação através do queryparam action com o conteúdo validRelease. Para utilizar esta funcionalidade é necessário informar também os queryparams healthProviderCode com o código da Rede de Atendimento e locationCode com o código do Local de Atendimento. A API retorna os dados da guia e a indicação se a liberação pode ser executada no atributo actionReturn e uma mensagem impeditiva (caso necessário) no atributo actionMessage.

VERBO POST

Validação de Reenvio de Guias

Através do verbo POST, a API tem a opção de validar se uma guia está apta a ser realizada o reenvio da mesma pelo sistema Portal Autorizador HAT. Para realizar essa validação, é necessário informar o QueryParam resendBatch. Utilizando essa opção, a API tem três possíveis respostas:

Foi encontrada a guia informada, a API retorna dos dados da guia para o Portal Autorizador realizar a contingência.
A guia informada não foi encontrada, porém já existe uma guia na data de hoje para o Prestador, Rede de Atendimento e Beneficiário, com isso, o reenvio não será permitido.
A guia informada não foi encontrada e não existe uma guia na data de hoje para o Prestador, Rede de Atendimento e Beneficiário, com isso, o reenvio será permitido (será gerado uma nova solicitação TISS Online).

Validação de Liberação

Outra funcionalidade da API POST é realizar a validação da execução de uma Liberação. Para realizar esta validação é necessário informar o queryparam action com o conteúdo execute. A validação realizada é a mesma do Portal do Prestador do Produto Planos de Saúde SIGAPLS.

02. CONFIGURAÇÕES INI

Para iniciar a instalação do processo, devemos configurar seu INI Protheus com a funcionalidade REST para habilitar o acesso as API´s. Documentos auxiliares:

1. Configuração do REST do Protheus

Com o INI Protheus configurado, a nomenclatura das API´s ficará no formato: <url + Porta + chave rest definidos no INI Protheus> + /totvsHealthPlans/v1/authorizations/<guia>. Exemplo:

Image Removed

Logo, a minha URL será: http://localhost:8080/rest/totvsHealthPlans/v1/authorizations/<guia>

03. VERBOS

Seguem os verbos disponíveis na API:

...

04. EXEMPLO DE CHAMADA DA API

Chamada GET - Retorna dados de uma Guia

Exemplo de chamada para a guia 0001.2024.04.00000196:

http://localhost:8080/rest/totvsHealthPlans/v1/executions/000120240400000196

Image Removed

Chamada GET - Realiza uma pré-análise de execução de uma Liberação

Exemplo de chamada da pré-análise:

http://10.171.80.125:3269/rest/totvshealthplans/v1/authorizations/000120230800000064?action=validRelease&healthProviderCode=000004&locationCode=001

Image Removed

...

Chamada POST - Valida se pode realizar o reenvio da guia no HAT

Exemplo de chamada para validação:

http://localhost:8080 /rest/totvshealthplans/v1/authorizations?resendBatch=true

Image Removed

JSON de Solicitação:

Bloco de código

title	JSON Solicitação POST

{
    "tissBatch": "900000008834", 
    "subscriberId": "00010003000003017",
    "healthProviderCode": "000004", 
    "authorizationType": "2"  
}

...

Chamada POST - Valida a execução de uma liberação

Exemplo de chamada para validação da guia 000120230800000064:

http://10.171.80.125:3269/rest/totvshealthplans/v1/authorizations?action=execute

Image Removed

JSON de Solicitação:

Bloco de código

title	JSON Solicitação POST

{
    "idOnHealthInsurer": "000120230800000064",
    "healthProviderCode": "000004",
    "locationCode": "001"
}

...

05. ATRIBUTOS DE RESPOSTA

CHAMADA GET

Cabeçalho

...

subscriberId

...

Atributo procedures

...

Atributo rejectionCauses

...

CHAMADA POST

...

Campo fixo que indica a ação encontrada: 0001 e 0002.

...

Mensagem indicativa referente ao código acima:

0001 - Guia informada encontrada, apta para realizar a contingencia

0002 - Não foi encontrada guia, e possível realizar o reenvio

...

Número da guia (baseado no alias da guia informada)

BEA_OPEMOV+BEA_ANOAUT+BEA_MESAUT+BEA_NUMAUT

B4Q_OPEMOV+B4Q_ANOAUT+B4Q_MESAUT+B4Q_NUMAUT

...

Image Added

02. CONFIGURAÇÕES INI

Para iniciar a instalação do processo, devemos configurar seu INI Protheus com a funcionalidade REST para habilitar o acesso as API´s. Documentos auxiliares:

1. Configuração do REST do Protheus

Com o INI Protheus configurado, a nomenclatura das API´s ficará no formato: <url + Porta + chave rest definidos no INI Protheus> + /totvsHealthPlans/v1/executions/<guia>. Exemplo:

Image Added

Logo, a minha URL será: http://localhost:8080/rest/totvsHealthPlans/v1/executions/<guia>

03. VERBOS

Seguem os verbos disponíveis na API:

Verbo	Path	Path Param	Query Param	Descrição
GET	executions	idHealthIns (número da guia)		Numero da liberação

04. EXEMPLO DE CHAMADA DA API

Chamada GET - Retorna dados de uma Guia

Exemplo de chamada para a guia 0001.2024.04.00000196:

http://localhost:8080/rest/totvsHealthPlans/v1/executions/000120240400000196

Image Added

05. ATRIBUTOS DE RESPOSTA

CHAMADA GET

Cabeçalho

Atributo	Campo	Tipo
subscriberId	BEA_OPEUSR+BEA_CODEMP+BEA_MATRIC+BEA_TIPREG+BEA_DIGITO	Caracter
primaryICD	BEA_CID	Caracter
attendanceLocation	BEA_LOCAL	Caracter
password	BEA_SENHA	Caracter
accidentIndication	BEA_INDACI	Caracter
attendanceModel	BEA_TIPADM	Caracter
attendanceProtocol	BEA_PROATE	Caracter
attendanceType	BEA_TIPATE	Caracter
authorizationDate	BEA_DATPRO	Data
authorizationStatus	BEA_STATUS	Caracter
authorizationType	BEA_TIPGUI	Caracter
billingType	BEA_TIPFAT	Caracter
clinicalCondition	BEA_INDCLI	Caracter
closingReason	BEA_TIPSAI	Caracter
consultationType	BEA_TIPCON	Caracter
endTreatmentDate	BEA_DPTETA	Data
healthProviderId	BEA_CODRDA	Caracter
idAuthOnHealthProvider	BEA_GUIPRE	Caracter
locationCode	BEA_CODLOC	Caracter
mainAuthorizationCode	BEA_GUIPRI	Caracter
newbornAttendance	BEA_ATERNA	Caracter
passwordExpireDate	BEA_VALSEN	Data
priorAuthorization	BEA_LIBERA	Caracter
priorAuthorizationStatus	BEA_STALIB	Caracter
professionalRequestorId	BEA_CDPFSO	Caracter
professionalExecutorId	BEA_CDPFRE	Caracter
requestDate	BEA_DATSOL	Data
attendanceToken	BEA_TOKEDI	Caracter
missingValidationCode	BEA_AUSVLD	Caracter
specialtyCode	BEA_CODESP	Caracter
professionalRequestorCouncil	BEA_SIGLA	Caracter
professionalRequestorState	BEA_ESTSOL	Caracter
professionalRequestorCouncilNumber	BEA_REGSOL	Caracter
professionalRequestorSpecialtyCode	BEA_ESPSOL	Caracter
professionalExecutorCouncil	BEA_SIGEXE	Caracter
professionalExecutorState	BEA_ESTEXE	Caracter
professionalExecutorCouncilNumber	BEA_REGEXE	Caracter
dischargedType	BE4_TIPALT	Caracter
dischargedDate	BE4_DTALTA	Data
dischargedHour	BE4_HRALTA	Caracter
expectedHospitalizationDate	BE4_PRVINT	Data
hospType	BE4_TIPINT	Caracter

Atributo procedures

Atributo	Campo	Tipo
authLevel	BE2_NIVAUT	Caracter
sequence	BE2_SEQUEN	Caracter
status	BE2_STATUS	Caracter
requestedQuantity	BE2_QTDSOL	Numérico
authorizedQuantity	BE2_QTDPRO	Numérico
balance	BE2_SALDO	Numérico
unitaryWorth	BD6_VLRPAG + BD6_VLRGLO	Numérico
executionDate	BE2_DATPRO	Data
startingTime	BE2_HORPRO	Caracter
endingTime	BE2_HORFIM	Caracter
accessWay	BE2_VIA	Caracter
usedTechnique	BE2_TECUTI	Caracter
authLevelKey	BE2_CHVNIV	Caracter
auditing	BE2_AUDITO	Caracter
priorAuthorization	BE2_LIBERA	Caracter
priorAuthorizationStatus	BE2_STALIB	Caracter
tableCode	BE2_CODPAD	Caracter
procedureCode	BE2_CODPRO	Caracter

Atributo rejectionCauses

Atributo	Campo	Tipo
procedureSequence	BEG_SEQUEN/BEL_SEQUEN	Caracter
code	BEG_CODGLO/BEL_CODGLO	Caracter
rejectionSequence	BEG_SEQCRI/BEL_SEQCRI	Caracter
description	BEG_DESGLO/BEL_DESGLO	Caracter

06. EXEMPLOS DE JSON DE RESPOSTA

Solicitação GET:

Bloco de código

title	Sucesso 202 - Guia encontrada
collapse	true

{
    "items": [
        {
            "ansRegistry": "888888",

06. EXEMPLOS DE JSON DE RESPOSTA

Solicitação GET:

Bloco de código

title	Sucesso 202 - Guia encontrada
collapse	true

{
    "endTreatmentDate": null,
    "locationCode": "001",
    "professionalRequestorSpecialtyCode": "063",
    "professionalRequestorCouncil": "CRM",
    "professionalExecutorCouncil": "",
    "procedures": [
        {
            "status": "0",
            "sequence": "001",
            "endingTime": "1800",
            "auditing": "1",
            "requestedQuantity": 1,
            "startingTime": "1800",
            "tableCode": "22",
            "authorizedQuantity": 1,
            "accessWay": "",
            "priorAuthorization": "0",
            "priorAuthorizationStatus": "",
            "rejectionCauses": [
                {
                    "code": "",
                    "procedureSequence": "001",
                    "rejectionSequence": "002",
                    "description": "NÍVEL: BRV - PLANOS E GRUPOS DE COBERTURA ( 02 - ATUALIZACOES / PRODUTO SAUDE / PRODUTO SAUDE --> FOLDER COBERTURA/CAREN"
                },
          "idOnHealthInsurer": "000120240400000197",
      {
        "idOnHealthProvider": "000120240400000197",
            "codejourney": "0252",
            "subscriberId": "00010101000007012",
            "procedureSequenceprimaryICD": "001",
                    "rejectionSequence"attendanceLocation": "001008",
            "password": "96753982225399803499",
        "description": "PARA ESTE PROCEDIMENTO NECESSITA AUDITORIA.""accidentIndication": "9",
            "attendanceModel": "1",
   }
            ]"attendanceProtocol": "88888820240402300053",
            "executionDateattendanceType": "2022-09-1502",
            "procedureCodeauthorizationDate": "101010122024-04-02",
            "unitaryWorthauthorizationStatus": 0"1",
            "authLevelKeyauthorizationType": "000100010010222",
            "balanceguideType": 0"02",
            "usedTechniquebillingType": "",
            "authLevelclinicalCondition": "",
        }
    ],
    "healthProviderId"closingReason": "000004",
            "consultationType": "1",
    "requestDate": null,
    "dischargedDate": null,
    "hospTypeendTreatmentDate": "",
       "priorAuthorizationStatus": "",
    "newbornAttendancehealthProviderId": "0000004",
       "professionalExecutorState": "",
    "attendanceLocationidAuthOnHealthProvider": "008",
    "specialtyCode": "002",
        "authorizationTypelocationCode": "01001",
       "passwordExpireDate": "2022-10-15",
    "professionalRequestorIdmainAuthorizationCode": "A01834000120240400000196",
       "missingValidationCode": "01",
    "attendanceModelnewbornAttendance": "1"false,
      "attendanceToken": "",
      "professionalRequestorCouncilNumberpasswordExpireDate": "6543212298-01-15",
       "professionalExecutorCouncilNumber": "",
    "subscriberIdpriorAuthorization": "00010101000007012"false,
       "billingType": "",
    "dischargedTypepriorAuthorizationStatus": "",
       "professionalExecutorId": "",
    "accidentIndicationprofessionalRequestorId": "9000026",
       "priorAuthorization": "0",
    "idAuthOnHealthProviderprofessionalExecutorId": "",
    "password        "requestDate": "2024-04-02",
            "attendanceTypeattendanceToken": "05",
     "attendanceProtocol       "missingValidationCode": "88888820220915300033",
       "dischargedHour": null,
    "authorizationStatusspecialtyCode": "6015",
      "primaryICD": "",
      "professionalRequestorStatespecialCoverage": "SP",
    "authorizationDate": "2022-09-15",
        "mainAuthorizationCodeattendanceScheme": "02",
       "expectedHospitalizationDate": null,
    "closingReasonoccupationalHealth": "",
            "clinicalConditionattendanceNote": ""
}

Bloco de código

title	Falha 400 - Guia não encontrada
collapse	true

{ ",
    "code        "professionalRequestorCouncil": 400"CRFA",
    "message": "Guia informada nao encontrada",
    "detailedMessageprofessionalRequestorState": "Entre em contato com o Suporte",
SP",
            "helpUrlprofessionalRequestorCouncilNumber": "132456",
    "details": [
        {"professionalRequestorSpecialtyCode": "005",
            "codeprofessionalExecutorCouncil": "",
            "messageprofessionalExecutorState": "",
            "detailedMessageprofessionalExecutorCouncilNumber": "",
            "helpUrldischargedType": "",
        }
    ]
}

Solicitação POST:

Bloco de código

title	Sucesso 200 - Guia encontrada
collapse	true

{
    "code"dischargedDate": "0001",
            "messagedischargedHour": ""Guia,
  informada encontrada, apta para realizar a contingencia",
    "idOnHealthInsurerexpectedHospitalizationDate": "000120230500000019",
    "authorization": {
        "subscriberIdexpectedAdmissionDate": "00010003000003017",
            "primaryICDhospitalizationDate": "",
            "attendanceLocationhospitalizationHour": "008",
            "passwordhospType": "1084179216633992",
            "accidentIndicationhasClinicalAttachment": ""false,
            "attendanceModelhasTreatmentExtension": "2"false,
            "attendanceProtocolhasInitialSituation": "88888820220816300034"false,
        "attendanceType": "05",
    ,
            "authorizationDateprofessional": "2023-05-15",{
        "authorizationStatus": "1",
        "authorizationTypeidOnHealthInsurer": "02000026",
        "billingType": "",
        "clinicalConditionphoneNumber": "9999999",
        "closingReason": "",
        "consultationTypeprofessionalCouncil": "1CRFA",
        "endTreatmentDate": null,
        "healthProviderIdprofessionalIdentifier": "000004",
                "idAuthOnHealthProviderprofessionalCouncilNumber": "132456",
        "locationCode": "001",
        "mainAuthorizationCodename": "100000000ROBERTO",
        "newbornAttendance": "0",
        "passwordExpireDateemail": "2297-02-26",
        "priorAuthorization": "0",
        "priorAuthorizationStatusstateAbbreviation": "SP",
        "professionalRequestorId": "000142",
        "professionalExecutorIdcbos": "",{
        "requestDate": null,
            "attendanceTokencode": "221105",
          "missingValidationCode": "",
          "specialtyCodespecialtyDescription": "055Biologo",
           "professionalRequestorCouncil": "CRM",
        "professionalRequestorStatespecialtyCode": "RS005",
         "professionalRequestorCouncilNumber": "334455",
           "professionalRequestorSpecialtyCodedescription": "223Biologo",
         "professionalExecutorCouncil": "",
      }
  "professionalExecutorState": "",
        "professionalExecutorCouncilNumber": "" },
            "dischargedTypeprocedures": "",[
        "dischargedDate": null,
       {
 "dischargedHour": "",
          "expectedHospitalizationDate": null,
        "hospTypeauthLevel": "BR8",
        "procedures": [
            {
"sequence": "001",
                    "authLevelstatus": "BRV"1,
                    "sequencerequestedQuantity": "001"1,
                    "statusauthorizedQuantity": "1",
                    "requestedQuantityauthorized": 1"S",
                    "authorizedQuantitybalance": 10,
                    "balanceunitaryWorth": 030,
                    "unitaryWorthexecutionDate": 76.4"2024-04-02",
                    "executionDatestartingTime": "2023-05-151740",
                    "startingTimeendingTime": "10081740",
                    "endingTimeaccessWay": "1008",
1",
                    "accessWayusedTechnique": "",
                    "usedTechniqueauthLevelKey": "0110101013",
                    "authLevelKeyauditing": "000100010010070",
                    "auditingtoothRegion": "0",
                    "teethRegionsurfaces": "",
                    "surfacepriorAuthorization": "0",
                    "priorAuthorizationpriorAuthorizationStatus": "02",
                    "priorAuthorizationStatusobsAudito": "",
                    "tableCodemedicalTeam": "22",[
                 "procedureCode": "10101012",
       []
           "rejectionCauses": []
        ],
    }
        ]
    }
}

Bloco de código

title	Sucesso 200 - Reenvio permitido
collapse	true

{
    "codetableCode": "000200",
       "message": "Nao foi encontrada guia, e possivel realizar o reenvio"
}

Bloco de código

title	Falha 400 - Reenvio não permitido
collapse	true

{
    "codeprocedureCode": 400"10101013",
    "message": "Nao e possivel realizar o reenvio",
    "detailedMessage": "Ja foi encontrada uma guia no seu sistema de gestao para o beneficiario e prestador na data de hoje. Guia(s) encontrada(s): 000120230500000019, 000120230500000021",
"procedureDescription": "GLICOSE",
                    "helpUrlprocedureType": "5",
    "details": [
                 {
"rejectionCauses": []
             "code": "",
  }
          "message": "",
 ]        
   "detailedMessage": "",
    }
    ],
    "helpUrlhasNext": ""false
}

Bloco de código

title	Falha 400 - Guia não encontrada
collapse	true

{
        }
"items": [],
    "hasNext": ]false
}

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

02. CONFIGURAÇÕES INI

03. VERBOS

04. EXEMPLO DE CHAMADA DA API

05. ATRIBUTOS DE RESPOSTA

02. CONFIGURAÇÕES INI

03. VERBOS

04. EXEMPLO DE CHAMADA DA API

05. ATRIBUTOS DE RESPOSTA

06. EXEMPLOS DE JSON DE RESPOSTA

06. EXEMPLOS DE JSON DE RESPOSTA