CONTEÚDO

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


01. VISÃO GERAL

A API ProcedureAutorization tem como objetivo retornar dados do procedimento ( Se o procedimento esta autorizado, negado...) , conforme solicitação informando o código da tabela e o código do procedimento. 

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/ProcedureAuthorization.

Exemplo:

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

03. VERBOS

Seguem os verbos disponíveis na API:

Verbo

Path

Descrição

POST/ProcedureAuthorizationAutorização de Procedimento

04. PATH PARAMS - POST

Lista de query params obrigatórios:

Campo

Descrição

procedureId Tabela e Código do Procedimento

Body

{
    "ansRegistry": "349682",
    "newbornAttendance": false,
    "attendanceProtocol": "34968220220608300007",
    "journey": "2",
    "authorizationStatus": "-1",
    "locationCode": "001",
    "attendanceLocation": "005",
    "beneficiary": {
        "birthdate": "1972-12-01",
        "age": 49,
        "weight": "0.00",
        "height": "0.00",
        "gender": "1",
        "healthInsurance": {
            "code": "",
            "description": "PRODUTO EXEMPLO 1"
        },
        "subscriberId": "00010002000001016",
        "oldSubscriberId": "",
        "isInterchange": false,
        "name": "USUARIO - 00010002000001016",
        "cardExpiration": "",
        "CNS": "707801650079316",
        "phoneNumber": "",
        "holderCPF": "77777777777",
        "rejectionCauses": []
    },
    "healthProvider": {
        "healthProviderId": "000002",
        "name": "MEDICO FISICA",
        "officialRecord": "00000000000"
    },
    "professional": {
        "idOnHealthInsurer": "000001",
        "cbosCode": "225125",
        "name": "PROFISSIONAL - 000001",
        "professionalCouncil": "CRM",
        "professionalCouncilNumber": "000001",
        "stateAbbreviation": "SP",
        "email": "",
        "phoneNumber": "",
        "cbos": {
            "code": "225125",
            "description": "Medico clinico",
            "specialtyCode": "001",
            "specialtyDescription": "CLINICA MEDICA"
        }
    },
    "rejectionCauses": [],
    "mainAuthorizationCode": "",
    "password": "",
    "attendanceModel": "1",
    "requestDate": "20220608",
    "clinicalCondition": "",
    "attendanceType": "01",
    "primaryICD": "Z00",
    "procedures": [
        {
            "auditing": false,
            "status": 1,
            "tableCode": "22",
            "procedureCode": "10101020",
            "procedureDescription": "EM DOMICÍLIO",
            "authorizedQuantity": 1,
            "requestedQuantity": 1,
            "authLevel": "BR8",
            "authLevelKey": "0110101020",
            "balance": 0,
            "justification": "",
            "procedureType": "0",
            "rejectionCauses": []
        },
        {
            "status": -1,
            "tableCode": "22",
            "procedureCode": "10101012",
            "procedureDescription": "PLS DSAUPC MONITORAMENTO PROCEDIMENTO INVALIDO",
            "authorizedQuantity": 0,
            "requestedQuantity": 1,
            "procedureType": "0",
            "rejectionCauses": []
        }
    ]
}


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

http://localhost:8080/rest/totvsHealthPlans/v1/ProcedureAuthorization?procedureId=2210101012


05. EXEMPLOS DE JSONS DE RESPOSTA

Sucesso 200



{
    "procedure": {
        "status": 1,
        "auditing": false,
        "requestedQuantity": 1,
        "procedureType": "0",
        "procedureDescription": "CONSULTA 10101012",
        "tableCode": "22",
        "procedureCode": "10101012",
        "authLevel": "BR8",
        "authLevelKey": "0110101012",
        "authLevelDesc": "Nivel: Tabela Padrao",
        "rejectionCauses": [],
        "medicalTeam": [],
        "authorizedQuantity": 1,
        "inSerie": false,
        "obsNegative": "",
        "obsAudito": "",
        "justification": "",
        "balance": 0,
        "usQuantity": 0,
        "vlrCon": 0,
        "franchise": 0,
        "unitaryWorth": 0,
        "lembrete": "1",
        "_expandables": [
            "medicalTeam",
            "rejectionCauses"
        ]
    },
    "serviceResponse": true
}


Erro 200

1
2
3
4

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