Como realizar o cadastro de Configurações do Serviço de Integração dentro do módulo PSPDV Mobile no Petroshow?

Owned by Debora Soares Damasceno
Last updated: Dec 20, 2021
3 min read

OBJETIVO

 

Com o software Petroshow é possível que vendas sejam feitas pelo aplicativo PDV Mobile, onde toda a transação ocorre sem que o usuário precise sair do veículo e ir até o caixa para acertar a venda, por exemplo.

 

INSTALAÇÃO DOS SISTEMAS DESKTOP

 

O primeiro passo a ser feito é a instalação dos sistemas desktop. Para isso, devemos executar o instalador/atualizador do PSPDV, aquele que já estamos acostumados, em uma pasta exclusiva para o PDV Mobile.

 

É muito importante que o banco de dados e o diretório de instalação desses sistemas seja diferente da instalação do PSPDV, pois cada sistema precisa ter seus próprios arquivos para evitar problemas com duplicidade de dados.

 

Ao executar o instalador do PSPDV, será criado uma pasta chamada (DiretórioRaiz)\Viasoft\Server\ServiceIntegrador. É nessa pasta que ficará o serviço de integrações, chamado ViasoftServiceIntegracao.exe

 

O instalador fará a instalação desse aplicativo como serviço do Windows. Ao acessar a lista de serviços, ele será exibido como Petroshow - Integrador.

 

 

O instalador também vai criar um executável chamado PSPDV_Mobile.exe, dentro do diretório (Diretório Raiz)\Viasoft\Client\PAF. Esse é o Gerenciador do PDV Mobile, responsável pela atualização do banco de dados, sincronização, abertura de caixa, dentre outras funcionalidades. Veremos mais sobre ele em outro tutorial.

 

Depois da instalação, é necessário fazer as configurações para o correto funcionamento do serviço.

 

CONFIGURAÇÃO DO SERVIÇO DE INTEGRAÇÕES

 

Devemos parametrizar o serviço de integração em duas etapas. Primeiro as configurações em arquivo ini e depois no PSConfigurador.

 

CONFIGURAÇÕES EM ARQUIVO INI

 

As primeiras configurações que devem ser feitas são a porta para conexão REST e as propriedades para gravação de log.

 

Para isso, dentro da pasta ServiceIntegrador existe um arquivo chamado

ViasoftServiceIntegracao.conf, como na imagem abaixo:

 

  

Porta: Essa é a porta para conexão TCP. Será utilizada para que o gerenciador do PDV Mobile se conecte ao serviço.

 

PortaREST: É através dessa porta que o PDV Mobile fará a comunicação com o serviço de integração. Além de configurar essa porta, é muito importante verificar se ela permite acesso externo, para que o aplicativo mobile possa fazer a conexão.

 

DebugFileLevel: Indica o nível de detalhes do log, onde 0 é nenhum log e 9 é o mais detalhado possível.

 

DebugFile: Armazena em que diretório será salvo o arquivo de log. Adicione ao nome o literal "_DATA", para que seja salvo um arquivo de log por dia.

 

DebugClear: Serve para dizer se o arquivo de log deve ser zerado a cada inicialização do serviço. Se marcado com 1 o log será zerado cada vez que o serviço iniciar. Se marcado com 0, o log será mantido.

 

É recomendável que as configurações de log sejam feitas semelhantes à imagem.

 

CONFIGURAÇÕES NO PSCONFIGURADOR

 

Depois de feitas as configurações no arquivo ini, é necessário indicar ao serviço quais são os bancos de dados que serão utilizados.

 

Para isso, acesse o aplicativo PSConfigurador da pasta ServiceIntegrador.

 

É importante que seja desse diretório pois esse aplicativo configura um arquivo que existe no mesmo local onde ele está.

 

 

Nesta fase, para o serviço, o mais importante é configurar o Estabelecimento, Número do PDV e os bancos de dados utilizados. As demais configurações não são necessárias agora.

 

Lembre-se de que o BD PSPosto NÃO pode ser o mesmo banco já utilizado por um outro PDV. Deve ser um banco de dados específico para uso do PDV Mobile.

 

TESTE DE CONEXÃO COM O SERVIÇO

 

Depois de feitas todas as configurações, podemos testar se o serviço de integrações está funcionando corretamente. Para isso, podemos abrir um navegador qualquer e executar o seguinte link: http://(IP_SERVIDOR:PORTA_REST)/viasoftserver/rest/TPDVRestMobileAPI/ ConsultarStatusServico

 

Deverão ser substituídos os parâmetros:

 

IP_SERVIDOR: Endereço IP do computador que roda o serviço de integrações. PORTA_REST: Porta configurada na propriedade PortaREST do arquivo ViasoftServiceIntegracao.conf.

 

Com a substituição, devemos ter um link semelhante a esse:

 

http://127.0.0.1:9093/viasoftserver/rest/TPDVRestMobileAPI/ConsultarStatusServico

 

Executando no navegador, devemos ter um resultado assim:

 

 

Caso seja retornado "emExecucao": false, verifique os passos anteriores. Caso tudo esteja OK, verifique se o IP/Porta informados tem acesso liberado para serviço. Se mesmo assim o problema persistir, contate o suporte.

 

É extremamente necessário que seja retornado "emExecucao": true para que sejam executados os próximos passos.

 

RESULTADOS ESPERADOS

 

A realização dos processos da rotina de Configurações do Serviços Gerais, conforme as aplicabilidades selecionadas.

 

VERSÃO DO SISTEMA DOCUMENTADO

 

Versão 2108.1001.