API ProcedureGroupAuthorization - Autorização de Procedimentos em Bloco

CONTEÚDO

Visão Geral
Configurações INI
Verbos
Usabilidade da API
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

/procedureGroupAuthorization

Autorização de Grupo de Procedimentos

04. USABILIDADE DA API

Exemplo de Body

{
    "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

Sucesso 200

{
    "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
}

Erro 200

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

Árvore de páginas