CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Verbos
  4. Exemplo de Chamada da API
  5. Atributos de Resposta
  6. Exemplos de JSON de Resposta


01. VISÃO GERAL

A API referenceValues tem como objetivo retornar a tabela de valores de referência para apoio de análise de eventos em auditoria quando utilizado a Carol Pós.


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/referenceValues Exemplo:

Logo, a minha URL será: http://localhost:8080/rest/totvsHealthPlans/v1/referenceValues

03. VERBOS

Seguem os verbos disponíveis na API:

Verbo

Path

Query Params

Descrição

GETreferenceValues
  • level
  • healthProviderId
  • healthProviderOfficialRecord
  • healthProviderName
  • hospitalizationGroupId
  • hospitalCategoryId
  • accommodationId
  • hospitalRegimeId
Retorna dados da tabela de referência

04. EXEMPLO DE CHAMADA DA API


VERBO GET

Através do verbo GET podemos retornar os dados da tabela de referência em 2 níveis:


NÍVEL 1

Retorna: Dados da Rede de Atendimento e Grupo de Internação

QueryParams obrigatórios: Não há.

URL Exemplo: http://localhost:8080/rest/totvshealthplans/v1/referenceValues?level=1


No nível 1 ainda podemos realizar alguns filtros opcionais:

AtributoDescrição
healthProviderId Código RDA
healthProviderOfficialRecordCPF/CNPJ RDA
healthProviderNameDescrição RDA
hospitalizationGroupIdCódigo Grupo de Internação
hospitalCategoryIdCódigo Categoria Hospitalar
accommodationIdCódigo Acomodação
hospitalRegimeId Código Regime Hospitalar


NÍVEL 2

Retorna: Categoria do Hospital, Regime Hospitalar e Acomodação.

QueryParams obrigatórios:

AtributoDescrição
healthProviderId Código RDA
hospitalizationGroupIdCódigo Grupo de Internação
hospitalCategoryIdCódigo Categoria Hospitalar
accommodationIdCódigo Acomodação
hospitalRegimeId Código Regime Hospitalar


URL Exemplo: http://localhost:8080/rest/totvshealthplans/v1/referenceValues?level=1&healthProviderId=000004&hospitalCategoryId=1&hospitalizationGroupId=1&accommodationId=1&hospitalRegimeId=1


05. ATRIBUTOS DE RESPOSTA

Chamada GET Level 1:

AtributoCampo Protheus Tipo
healthProviderIdBO0_CODRDACaracter
hospitalizationGroupIdBO0_GRPINTCaracter
officialRecordBAU_CPFCGCCaracter
nameBAU_NOMECaracter
hospitalCategoryIdBO0_CATHOSCaracter
accommodationIdBO0_ACOMODCaracter
hospitalRegimeIdBO0_REGINTCaracter
{
    "hasNext": false,
    "items": [
        {
            "healthInsurer": {
                "healthProviderId": "000004",
                "officialRecord": "34585221000190",
                "name": "HOSPITAL BOM CLIMA"
            },
            "hospitalizationGroup": {
                "id": "1",
                "description": "Clinica"
            },
            "hospitalCategory": {
                "id": "1",
                "description": "AAA - Alto custo"
            },
            "hospitalRegime": {
                "id": "1",
                "description": "Hospitalar"
            },
            "accommodation": {
                "id": "1",
                "description": "Enfermaria"
            }
        },
        {
            "healthInsurer": {
                "healthProviderId": "000004",
                "officialRecord": "34585221000190",
                "name": "HOSPITAL BOM CLIMA"
            },
            "hospitalizationGroup": {
                "id": "1",
                "description": "Clinica"
            },
            "hospitalCategory": {
                "id": "1",
                "description": "AAA - Alto custo"
            },
            "hospitalRegime": {
                "id": "3",
                "description": "Domiciliar"
            },
            "accommodation": {
                "id": "1",
                "description": "Enfermaria"
            }
        },
        {
            "healthInsurer": {
                "healthProviderId": "000004",
                "officialRecord": "34585221000190",
                "name": "HOSPITAL BOM CLIMA"
            },
            "hospitalizationGroup": {
                "id": "1",
                "description": "Clinica"
            },
            "hospitalCategory": {
                "id": "2",
                "description": "AA - Custo Medio"
            },
            "hospitalRegime": {
                "id": "1",
                "description": "Hospitalar"
            },
            "accommodation": {
                "id": "1",
                "description": "Enfermaria"
            }
        },
        {
            "healthInsurer": {
                "healthProviderId": "000004",
                "officialRecord": "34585221000190",
                "name": "HOSPITAL BOM CLIMA"
            },
            "hospitalizationGroup": {
                "id": "2",
                "description": "Cirurgica"
            },
            "hospitalCategory": {
                "id": "2",
                "description": "AA - Custo Medio"
            },
            "hospitalRegime": {
                "id": "2",
                "description": "Hospital-Dia"
            },
            "accommodation": {
                "id": "2",
                "description": "Apartamento"
            }
        },
        {
            "healthInsurer": {
                "healthProviderId": "000004",
                "officialRecord": "34585221000190",
                "name": "HOSPITAL BOM CLIMA"
            },
            "hospitalizationGroup": {
                "id": "3",
                "description": "Obstetrica"
            },
            "hospitalCategory": {
                "id": "3",
                "description": "A - Custo Padrao"
            },
            "hospitalRegime": {
                "id": "3",
                "description": "Domiciliar"
            },
            "accommodation": {
                "id": "3",
                "description": "UTI"
            }
        },
        {
            "healthInsurer": {
                "healthProviderId": "000004",
                "officialRecord": "34585221000190",
                "name": "HOSPITAL BOM CLIMA"
            },
            "hospitalizationGroup": {
                "id": "4",
                "description": "Pediatrica"
            },
            "hospitalCategory": {
                "id": "4",
                "description": "I - Interior"
            },
            "hospitalRegime": {
                "id": "1",
                "description": "Hospitalar"
            },
            "accommodation": {
                "id": "1",
                "description": "Enfermaria"
            }
        },
        {
            "healthInsurer": {
                "healthProviderId": "000004",
                "officialRecord": "34585221000190",
                "name": "HOSPITAL BOM CLIMA"
            },
            "hospitalizationGroup": {
                "id": "5",
                "description": "Psiquiatrica"
            },
            "hospitalCategory": {
                "id": "5",
                "description": "E - Especial"
            },
            "hospitalRegime": {
                "id": "2",
                "description": "Hospital-Dia"
            },
            "accommodation": {
                "id": "2",
                "description": "Apartamento"
            }
        },
        {
            "healthInsurer": {
                "healthProviderId": "000005",
                "officialRecord": "48564082000123",
                "name": "PRODE ODONTOLOGIA"
            },
            "hospitalizationGroup": {
                "id": "1",
                "description": "Clinica"
            },
            "hospitalCategory": {
                "id": "1",
                "description": "AAA - Alto custo"
            },
            "hospitalRegime": {
                "id": "1",
                "description": "Hospitalar"
            },
            "accommodation": {
                "id": "1",
                "description": "Enfermaria"
            }
        }
    ]
}



06. ATRIBUTOS DE RESPOSTA