Histórico da Página

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.

...

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

Bloco de código

title	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": []
        }
    ]
}

...

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

Image Modified

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

Bloco de código

title	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
}

...

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave