CONTEÚDO

  1. Visão Geral
  2. Configurações INI
  3. Verbos
  4. Usabilidade da API
  5. Exemplos de Jsons de Resposta


01. VISÃO GERAL

A API ProcedureGroupAutorization tem como objetivo retornar dados de procedimentos (se o procedimento esta autorizado, negado...), através de bloco de procedimentos, permitindo validar vários eventos em uma chamada única.

Esta API utiliza função padrão do produto para processamento da requisição. Função principal - PLSAUTP.

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:

Configuração do REST Protheus

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

Exemplo:

Logo, a minha URL será: http://localhost:8080/rest/totvshealthplans/v1/procedureAuthorization?procedureId={tableAndProcedure}

03. VERBOS

Seguem os verbos disponíveis na API:

POST/procedureGroupAuthorizationAutorização de Grupo de Procedimentos


04. USABILIDADE DA API


{
    "ansRegistry": "888888",
    "newbornAttendance": false,
    "attendanceProtocol": "88888820251215300007",
    "journey": "2",
    "authorizationStatus": "-1",
    "attendanceNote": "",
    "locationCode": "001",
    "attendanceLocation": "008",
    "missingValidationCode": "01",
    "beneficiary": {
        "birthdate": "1985-04-05",
        "age": 40,
        "weight": "",
        "height": "",
        "gender": "1",
        "healthInsurance": {
            "code": "",
            "description": "PRODUTO EXEMPLO 1"
        },
        "subscriberId": "00010013000001003",
        "oldSubscriberId": "",
        "name": "CARLOS ROBERTO",
        "socialName": "                                                  ",
        "contractType": "2",
        "cardExpiration": "",
        "CNS": "179236727590000",
        "phoneNumber": "",
        "holderCPF": "44184063012",
        "rejectionCauses": []
    },
    "healthProvider": {
        "healthProviderId": "000004",
        "name": "HMU ESSE É O DO HAT",
        "officialRecord": "34585221000190"
    },
    "professional": {
        "idOnHealthInsurer": "000026",
        "cbosCode": "225105",
        "name": "ROBERTO VANDERLEI DE ARRUDA",
        "professionalCouncil": "CRFA",
        "professionalCouncilNumber": "132456",
        "stateAbbreviation": "SP",
        "cbos": {
            "code": "225105",
            "description": "Médico acupunturista",
            "specialtyCode": "001",
            "specialtyDescription": "CLINICA MEDICA"
        }
    },
    "rejectionCauses": [],
    "password": "",
    "attendanceModel": "1",
    "requestDate": "20260106",
    "clinicalCondition": "",
    "attendanceType": "23",
    "specialCoverage": "",
    "procedures": [
        {
            "status": -1,
            "tableCode": "22",
            "procedureCode": "10101012",
            "procedureDescription": "CONSULTA ELETIVA",
            "authorizedQuantity": 0,
            "groupValidation":true,
            "requestedQuantity": 1,
            "procedureType": "NaN",
            "rejectionCauses": []
        },
        {
            "status": -1,
            "tableCode": "22",
            "procedureCode": "40303136",
            "procedureDescription": "SANGUE OCULTO",
            "groupValidation":true,
            "authorizedQuantity": 0,
            "requestedQuantity": 1,
            "procedureType": "NaN",
            "rejectionCauses": []
        }
    ]
}


Exemplo de chamada para utilização de um procedimento:

http://10.171.80.125:3330/rest/totvshealthplans/v1/ProcedureGroupAuthorization

Os eventos que serão validados deverão ser informados com os atributos status: -1 e groupValidation: true.

 {
            "status": -1,
            "tableCode": "22",
            "procedureCode": "10101012",
            "procedureDescription": "CONSULTA EM CONSULTORIO",
            "authorizedQuantity": 0,
            "requestedQuantity": 1,
            "groupValidation": true,
            "procedureType": "NaN",
            "rejectionCauses": []
   }


05. EXEMPLOS DE JSONS DE RESPOSTA

{
    "procedures": [
        {
            "status": 1,
            "paymentOnSpot": false,
            "auditing": false,
            "requestedQuantity": 1,
            "procedureType": "0",
            "procedureDescription": "Mamografia convencional bilateral",
            "tableCode": "22",
            "procedureCode": "40808033",
            "authLevel": "BR8",
            "authLevelKey": "0140808033",
            "authLevelDesc": "Nivel: Tabela Padrao",
            "rejectionCauses": [],
            "medicalTeam": [],
            "authorizedQuantity": 1,
            "inSerie": false,
            "obsNegative": "",
            "obsAudito": "",
            "justification": "",
            "balance": 0,
            "usQuantity": 0,
            "vlrCon": 0,
            "franchise": 0,
            "unitaryWorth": 0,
            "lembrete": "",
            "paymentOnHealthProvider": false,
            "mandatoryAttachment": "",
            "mandatoryFacial": false,
            "facialType": "1,2,3",
            "_expandables": [
                "medicalTeam",
                "rejectionCauses"
            ]
        },
        {
            "status": 2,
            "paymentOnSpot": false,
            "auditing": true,
            "requestedQuantity": 1,
            "procedureType": "0",
            "procedureDescription": "SANGUE OCULTO, PESQUISA NAS FEZES",
            "tableCode": "22",
            "procedureCode": "40303136",
            "authLevel": "BR8",
            "authLevelKey": "0140303136",
            "authLevelDesc": "Nivel: Tabela Padrao",
            "rejectionCauses": [
                {
                    "code": "003",
                    "idTiss": "1802",
                    "description": "PROCEDIMENTO INCOMPATIVEL COM O SEXO DO BENEFICIARIO",
                    "alert": "0",
                    "detail": "Sexo do Procedimento&nbspFeminino<br>Sexo Usuario&nbspMasculino<br>Nivel: BR8 - Tabela Padrao&nbsp09 - Atualizacoes / Procedimento / Tabela Padrao<br>",
                    "interchangeCode": "          ",
                    "negativeReason": "TESTE MOTIVO DE NEGATIVA PROTOCOLO DE NEGATIVAS TESTE DA GERACAO DO RELATORIO TESTE MOTIVO DE NEGATIVA PROTOCOLO DE NEGATIVAS TESTE DA GERACAO DO RELATORIO TESTE MOTIVO DE NEGATIVA PROTOCOLO DE NEGATIVAS TESTE DA GERACAO DO RELATORIO"
                },
                {
                    "code": "001",
                    "idTiss": "1803",
                    "description": "IDADE DO BENEFICIARIO INCOMPATIVEL COM O PROCEDIMENTO",
                    "alert": "1",
                    "detail": "Idade Minima&nbsp90<br>Idade Maxima&nbsp999<br>Idade Usuario&nbsp40<br>Nivel: BR8 - Tabela Padrao&nbsp05 - Atualizacoes / Procedimento / Tabela Padrao<br>",
                    "interchangeCode": "          ",
                    "negativeReason": "\"conforme a Classificação da TUSS\" (...)\n\n\"conforme a Classificação da TUSS\" (...)\n\n\"conforme a Classificação da TUSS\" (...)\n\"conforme a Classificação da TUSS\" (...)\n\"conforme a Classificação da TUSS\" (...)\n\"conforme a Classificação da TUSS\" (...)\n"
                }
            ],
            "medicalTeam": [],
            "authorizedQuantity": 0,
            "inSerie": true,
            "obsNegative": "",
            "obsAudito": "",
            "justification": "",
            "balance": 0,
            "usQuantity": 0,
            "vlrCon": 0,
            "franchise": 0,
            "unitaryWorth": 0,
            "lembrete": "",
            "paymentOnHealthProvider": false,
            "mandatoryAttachment": "4",
            "mandatoryFacial": false,
            "facialType": "1,2,3",
            "_expandables": [
                "medicalTeam",
                "rejectionCauses"
            ]
        }
    ],
    "serviceResponse": true
}



{
    "hasError": true,
    "errorMessage": "Verifique o BODY da api [ansRegistry]"
}