CONTEÚDO

  1. Visão Geral
  2. Configurações INI
  3. Verbos
  4. Uso da API - POST
  5. Atributos de Resposta
  6. Tabelas utilizadas


01. VISÃO GERAL

A API notification tem como objetivo retornar notícias cadastradas para beneficiários e também incluir o histórico de visualização. Os verbos disponibilizados são o GET e o POST.

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:

03. VERBOS

Seguem os verbos disponíveis na API:

Verbo

URL

Descrição

GEThttps://<url>:porta>/rest/totvsHealthPlans/v1/notificationRetorna as notícias para o beneficiário informado e quais foram já foram visualizadas ou não visualizadas.
POSThttps://<url>:porta>/rest/totvsHealthPlans/v1/notificationRegistra o histórico de visualizações da notícia.


04. USO DA API 

GET

Dados do queryparam de envio:

Atributo

Tipo

Regra

Descrição

codeUserCaracterObrigatórioBSW_CODUSR


POST

Dados do body de envio:


Atributo

Tipo

Regra

Descrição

codeNotificationCaracterObrigatório

BPL_CODIGO

codeUser

CaracterObrigatório

BSW_CODUSR


05. ATRIBUTOS DE RESPOSTA


API GET - JSON de resposta: 

Atributo

Campo Protheus

code

BPL_CODIGO

title

BPL_TITULO

message

BPL_NOTICI

visualized

Se tiver registro para BPL_CODIGO + BSW_CODUSR na tabela BJH será enviado true, caso contrário, false.



API POST - JSON de resposta:

Atributo pai

Atributo

Campo Protheus

loginDetails

code

BSW_CODUSR


username

BSW_LOGUSR


email

BSW_EMAIL


name

BSW_NOMUSR

beneficiaries

subscriberId

B49_BENEFI


name

BA1_NOMUSR


subscriberType

BA1_TIPUSU

menus

code

AI8_CODMNU


name

AI8_TEXTO


main

AI8_CODPAI


module

AI8_ROTINA




06. TABELAS UTILIZADAS


BSW - Login

BPL - Cadastro de Noticias          

BJH - Notificações Lidas