Como realizar o cadastro de Configurações do Serviço de Integração dentro do módulo PSPDV Mobile no Petroshow?
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.