Árvore de páginas

CONTEÚDO

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


01. VISÃO GERAL

       A API authorizationBatch tem como objetivo alterar o número do código do lote do Portal Autorizador (BEA_LOTHAT) na tabela BEA da guia ou lote informado. O verbo disponibilizado é o PUT.

02. CONFIGURAÇÕES INI

       0Para 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

PUThttps://<url>:porta>/rest/totvsHealthPlans/v1/authorizationBatchAltera o número do código do lote do Portal Autorizador (BEA_LOTHAT)

04. USO DA API


PUT - ALTERA O NÚMERO DO CÓDIGO DO LOTE DO PORTAL AUTORIZADOR (BEA_LOTHAT)

Queryparams:

Atributo

Tipo

Regra

Descrição

batchCodeCaracterObrigatório

Caso o queryParam idOnHealthInsurer não seja informado, o batchCode se torna obrigatório 

idOnHealthInsurerCaracterObrigatório

Caso o queryParam batchCode não seja informado, o idOnHealthInsurer se torna obrigatório

action

CaracterObrigatório

Se action = DELETE, o campo BEA_LOTHAT do lote (batchCode) ou da guia (idOnHealthInsurer) será limpo

Se action = CREATE, o campo BEA_LOTHAT do lote da guia (idOnHealthInsurer) será preenchido com o valor (batchCode)

04. EXEMPLO DE CHAMADA DA API


Chamada PUT - Alterando BEA_LOTHAT com a action DELETE informando idOnHealthInsurer 

Cenário: quando quiser deletar BEA_LOTHAT de guias específicas. 

Exemplo de requisição para a guia 000120240200000103:

http://localhost:8080/rest/totvsHealthPlans/v1/authorizationBatch?action=DELETE&idOnHealthInsurer='000120240200000103'


QueryParamsDescriçãoTipo
actionDELETECaracter
 idOnHealthInsurer Número da GuiaCaracter



Chamada PUT - Alterando BEA_LOTHAT com a action DELETE informando batchCode

Cenário: quando quiser deletar BEA_LOTHAT de todas as guias de um lote de uma vez.

Exemplo de requisição para o lote 00003282:

http://10.171.80.125:3269/rest/totvshealthplans/v1/authorizationBatch?action=DELETE&batchCode=00003282


QueryParamsDescriçãoTipo
actionDELETECaracter
batchCodeCódigo do lote do Portal AutorizadorCaracter


Chamada PUT - Alterando BEA_LOTHAT com a action CREATE informando idOnHealthInsurer e batchCode

Exemplo de requisição para alterar o BEA_LOTHAT das guias com o valor do lote informado:

http://localhost:8080/rest/totvshealthplans/v1/authorizationBatch?action=CREATE&idOnHealthInsurer='000120240200000103', '000120240200000105'&batchCode=00003282


AtributoDescriçãoTipo
actionCREATECaracter
idOnHealthInsurer Números das GuiasCaracter
batchCodeCódigo do lote do Portal AutorizadorCaracter


05. ATRIBUTOS DE RESPOSTA


CHAMADA PUT - Em caso de erro

AtributoValorTipo
code

400

Caracter
message

Mensagem genérica de erro

Caracter
detailMessage

Mensagem explicativa do erro

Caracter

06. EXEMPLOS DE JSON DE RESPOSTA


Erro
{
    "code": 400,
    "message": "Erro na requisição!",
    "detailedMessage": "Campo obrigatório não informado: 'action'"
}


07. CRIAÇÃO DO CAMPO BEA_LOTHAT

X3_ARQUIVO

X3_ORDEM

X3_CAMPO

X3_TIPO

X3_TAMANHO

X3_DECIMAL

X3_TITULO

X3_TITSPA

X3_TITENG

X3_DESCRIC

X3_DESCSPA

X3_DESCENG

X3_PICTURE

X3_USADO

X3_NIVEL

X3_RESERV

X3_PROPRI

X3_BROWSE

X3_VISUAL

X3_CONTEXT

X3_OBRIGAT

X3_CBOX

X3_VALID

BEAEZBEA_LOTHATCaractere80LOTE HATLOTE HATLOTE HATCODIGO LOTE HATCODIGO LOTE HATCODIGO LOTE HAT@!Sim1
Sim
VisualizarRealNão



  • Sem rótulos