Exibir origem

01. DADOS GERAIS

Linha de Produto:	TOTVS Moda
Segmento:	Moda
Módulo:	Virtual.PDV
Função:	Pré-Venda Mobile - Criar API para consulta de transação
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :	DVAARM-1310

02. SITUAÇÃO/REQUISITO

Com a criação do endpoint search-pre-sale na ApiTransaction, API responsável pela criação e consulta de pré-vendas na retaguarda, foi necessário a criação de um endpoint na API interna do Virtual PDV. Dessa forma, a aplicação de pré-venda mobile estaria apto a consultar as pré-vendas locais ou da retaguarda.

03. SOLUÇÃO

O endpoint api/PreVendaMobile/Listar foi criado no webservice interno do Virtual PDV para o consumo do endpoint da retaguarda. Necessário a configuração do parâmetro TP_FINALIZACAO_PRE_VENDA para apontar o local da consulta de pré-vendas, se será na base local ou da retaguarda.

Para que fosse possível a consulta no endpoint da retaguarda, foi necessário a implementação de rotinas para o consumo do token v2. Sem esse token, não é possível autenticar nas APIs v2 da retaguarda. Os seguintes parâmetros foram configurados para obter as informações necessárias para criação do token:

URL_TOKEN_V2: Contém o endereço do endpoint da requisição do token v2;
TOKEN_V2_CLIENT_ID: Contém o parâmetro client_id para usar na requisição;
TOKEN_V2_CLIENT_SECRET: Contém o parâmetro client_secret para usar na requisição.

O parâmetro URL_TOKEN_V2 poderá ser editado na aba Transmissão da tela Configuração de Parâmetros.

O parâmetro TP_FINALIZACAO_PRE_VENDA poderá ser editado na nova aba Pré-venda da tela de Configuração de Parâmetros.

O Virtual PDV fará a requisição do token v2 sempre que o sistema for reaberto.

TOTVS Moda > DT DVAARM-1310 Criar API para consulta de pré-venda > image2020-4-13_16-50-34.png

Imagem 1: Componente ADMFM007, com informações sobre o parâmetro URL_TOKEN_V2

Imagem 2: Componente ADMFM007, com informações do parâmetro TOKEN_V2_CLIENT_ID

Imagem 3: Componente ADMFM007, com informações do parâmetro TOKEN_V2_CLIENT_SECRET

Imagem 4: Componente LOGFM015. Os campos Usuário e Senha correspondem às informações do client_id e client_secret, respectivamente

Imagem 5: Ainda no componente LOGFM015, ao clicar no botão "Liberação..." ele se extenderá, apresentando as permissões dessa credencial

Imagem 6: Tela Configuração de Parâmetros no Virtual PDV. Em destaque, a localização da configuração do endereço do token v2

TOTVS Moda > DT DVAARM-1310 Criar API para consulta de pré-venda > image2020-4-13_16-46-15.png

Imagem 1: Componente ADMFM007, com informações do parâmetro TP_FINALIZACAO_PRE_VENDA

TOTVS Moda > DT DVAARM-1310 Criar API para consulta de pré-venda > image2020-4-13_17-18-31.png

Imagem 2: Tela Configuração de Parâmetros no Virtual PDV. Em destaque, a localização da configuração do tipo de finalização de pré-venda

04. DEMAIS INFORMAÇÕES

Link para a documentação de referência da ApiTransaction: Link

<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;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>