Histórico da Página

...

Visão Geral
Configurações INI
Verbos
Query Params - GET
Atributos de Resposta
Exemplos de JSONs de Resposta
Pontos de Entrada

01. VISÃO GERAL

A API UserUsage tem como objetivo retornar a utilização do plano de saúde de um beneficiário. A API recebe parâmetros como a matrícula, período de e até, e retorna os eventos executados pelo beneficiário no período informado.

...

Logo, a minha URL será: http://spon019400235localhost:8080/rest/totvsHealthPlans/v1/userUsage

...

Exemplo de chamada para utilização de um beneficiário em Dezembro de 2017:

http://spon019400235localhost:8080/rest/totvsHealthPlans/v1/userUsage?subscriberId=00010001000003002&initialPeriod=201712&finalPeriod=201712

Image RemovedImage Added

Lista de query params não obrigatórios:

...

Atributo	Campo	Tipo	Descrição
procedureCode	BD6_CODPRO	String	Código do procedimento
procedureName	BD6_DESPRO	String	Descrição do procedimento
executionDate	BD6_DATPRO	String	Data do evento no formato yyyy-mm-dd
subscribername	BD6_NOMUSR	String	Nome do beneficiário
healthProviderCode	BD6_CODRDA	String	Código da rede de atendimento
healthProviderName	BD6_NOMRDA	String	Nome da rede de atendimento
serviceType	BR8_CLASSE	String	Código da classe de procedimento
serviceTypeDescription	BJE_DESCRI	String	Descrição da classe de procedimento
quantity	BD6_QTDPRO	Number	Quantidade do evento
healthProviderDocument	BD6_CPFRDA	String	CPF/CNPJ da rede de atendimento
cid	BD6_CID	String	CID principal do atendimento
toothRegion	BD6_DENREG	String	Região do dente
face	BD6_FADENT	String	Face do dente
paidValue	BD6_VLRPAG	Number	Valor pago
disallowanceValue	BD6_VLRGLO	Number	Valor de glosa
coPaymentValue	BD6_VLRTPF	Number	Valor de co-participação
subscriberId	BD6_OPEUSR+BD6_CODEMP+BD6_MATRIC+BD6_TIPREG+BD6_DIGITO	String	Matrícula do beneficiário

...


origin	Iif(BD6_TIPGUI = '04', 'REEMBOLSO', 'CONVENIO') as BD6_TIPGUI	String	Origem
procedureType	BR8_TPPROC	String	Tipo do Procedimento
gender	BA1_SEXO	String	Sexo; M (Masculino) e F (Femino)
birthDate	BA1_DATNAS	String	Data de Nascimento
inclusionDate	BA1_DATINC	String	Data de Inclusão
blockDate	BA1_DATBLO	String	Data de Bloqueio
userType	BA1_TIPUSU	String	Tipo do Usuário; T (Titular) e D (Dependente)
countyCode	BA1_CODMUN	String	Código do Município (Padrão IBGE)
hospitalizationNumber	(CASE BD6_TIPGUI WHEN '03' THEN BD6_OPEINT + BD6_ANOINT + BD6_MESINT + BD6_NUMINT ELSE '' END) AS GUIAINT	String	Número da Guia de Internação (Caso seja uma Internação)
status	(CASE BA1_DATBLO WHEN '' THEN 'A' ELSE 'I' END) AS STATUS	String	Status; A (Ativo) e I (Inativo)

06. EXEMPLOS DE JSONS DE RESPOSTA

Bloco de código

title	Sucesso 202
linenumbers	true

{
    "items": [
        {
            "healthProviderDocument": "34391654857",
            "paidValue": 90.64,
            "subscriberId": "00010001000003002",
            "face": "",
            "coPaymentValue": 0,
            "procedureCode": "10101012",
            "executionDate": "2017-12-27",
            "subscribername": "RENATA",
            "healthProviderName": "RDA SILVIA SANT'ANNA",
            "serviceTypeDescription": "CONSULTAS",
            "serviceType": "000001",
            "cid": "A00",
            "procedureName": "CONSULTA EM CONSULTORIO",
            "healthProviderCode": "000007",
            "disallowanceValue": 44.87,
            "quantity": 1,
            "toothRegion": "",
			"origin": "CONVENIO"
        }
    ],
    "hasNext": false
}

Bloco de código

title	Erro 400
linenumbers	true

{
    "code": 400,
    "message": "Os parametros abaixo devem ter 6 caracteres: ",
    "detailedMessage": "initialPeriod, finalPeriod",
    "helpUrl": "",
    "details": [
        {
            "code": "",
            "message": "",
            "detailedMessage": "",
            "helpUrl": ""
        }
    ]
}

07. PONTOS DE ENTRADA

Foi desenvolvido o Ponto de Entrada PUTZBEN1, que permite trocar a Query padrão de busca dos registros BD6 por uma customizada:

Ponto de Entrada	PUTZBEN1
Fonte	PLUtzUsDao
Parâmetros	paramixb[1] → cQuery (Caracter) - Query padrão da rotina
Retorno	cQuery (Caracter) → Query padrão manipulada pelo usuário

Bloco de código

title	Exemplo PUTZBEN1
linenumbers	true

#INCLUDE "TOTVS.CH"

User Function PUTZBEN1()

	Local cQuery := paramixb[1]

	//Ajuste de query do cliente

Return cQuery

HTML

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

Árvore de páginas

Versões comparadas

Versão antiga 6

Nova versão Atual

Chave

01. VISÃO GERAL

06. EXEMPLOS DE JSONS DE RESPOSTA

07. PONTOS DE ENTRADA