Como realizar a Instalação e Configuração do COMANDA WEB e IMPRESSORA de COMANDA no módulo PSPDV no Petroshow?

OBJETIVO

 

Auxiliar o usuário na instalação e configuração da Comanda Web e também da impressora de comanda (Utilizada geralmente no PDV Comanda). 

 

REQUISITOS

 

Para configurar o Comanda WEB corretamente é necessário atender aos seguintes requisitos:

 

  • Java JRE na versão 8 ou superior; (T:\Temp\Aline Eli\jre1.8.0_361)

  • Apache Tomcat na versão 8 ou superior; (T:\Temp\Aline Eli\Apache tomcat versão

  • Usuário do Windows como administrador e ter mapeado o usuário e senha da máquina (caso o usuário não tenha senha é necessário criar);

  • Porta que o Tomcat irá usar precisa estar liberada;

 

O Apache Tomcat deverá ser configurado exclusivamente para o Comanda WEB, ou seja, se for necessário configurar outras aplicações Web, as mesmas deverão ser configuradas em outro Tomcat e com outra porta.

 

Além disso, a instalação deve ser feita na máquina onde vai ser instalado o PDV comanda ou será o servidor do comanda web, lembrando que deve estar comunicando com o banco firebird. 

 

INSTALANDO O TOM CAT

 

O processo de instalação do Tomcat não possui nenhuma particularidade específica, no entanto, é recomendado, conforme imagem abaixo, configurar o nome do serviço como ComandaWEB, dessa forma deixa claro que o Tomcat em questão é configurado para o Comanda WEB. 

 

Observação: Configurar no campo HTTP/1.1 Connector Port uma porta que ainda não esteja em uso por outra aplicação. 

 

image-20240927-202808.png

 

COPIANDO OS ARQUIVOS DO COMANDA WEB

 

Primeiramente, acesse a pasta raiz de instalação do Tomcat, localize a pasta webapps.

 

Conforme mostrado abaixo, crie a pasta Comanda. Em seguida, acesse a versão liberada do Comanda WEB (link abaixo) e observe que a mesma possui dois diretórios:

 

  • Comanda

  • Comanda - servidor

 

Acesse a pasta Comanda e copie seu conteúdo para a pasta Comanda do Tomcat a qual criamos anteriormente.  

 

Link para download:

 

https://drive.google.com/drive/folders/1S486b-1xmeI2fPBIrfiELMzhQ6e5bFEd

 

 

Em seguida, na pasta server (instalação Petroshow), crie a pasta ComandaServer, e na mesma insira os arquivos que se refere a pasta Comanda - Servidor:

 



CONFIGURANDO O COMANDA WEB

 

Abra o prompt de comando (como administrador), na pasta criada no tópico acima e execute o programa api-comanda.exe:

 

 

Ao instalar o serviço, será necessário ir nas propriedades do serviço ComandaWEB para  informar as credenciais de logon para a utilização da impressora, o mesmo deve ser de um usuário do Windows administrador da máquina:

 



Se faz necessário ajustar as informações do arquivo “Application-properties”, para respeitar a porta configurada acima, usuário e senha padrão é o caminho do banco de dados firebird.

 

 

No campo server.port deve ser informado uma porta para o serviço da Comanda, ou seja, uma diferente da que é usada no TomCat.

Após realizar as configurações, é preciso iniciar os serviços do Tomcat comanda Web, pela rotina de serviços do Windows, e também é necessário abrir o gerenciador de tarefas acessar a aba Serviços localizar o serviço “Comanda server” e deixar em execução.

Também é necessário ajustar a conexão de URL serviço comanda pelo PSConfigurador, informado a porta configurado no arquivo properties do serviço do Comanda Web.

 

O serviço pode ser testado usando o seguinte link: http://localhost:PORTA/api-comanda/servidor substituindo a porta pela que foi informada no application.properties, sendo um resultado exibido assim:

 

Posteriormente, é só acessar o navegador e informar o IP e porta definidos e na sequência o caminho comanda, exemplo:

 

127.0.0.1:7071/Comanda 

A tela abaixo precisa ser configurada para o acesso, informar o IP e a porta do servidor de serviço da Comanda.

 

 

Tela inicial do Comanda Web:

 

 

Criação de Nova comanda:

 

 

Adicionado Itens na Comanda:

 

 

Lembrando que, o usuário que irá acessar o comanda web deve ter seu cadastro no Viasoft3C XE e no módulo PSGerencial, >> Gerente > PetroshowPDV >> Conf. de Usuário, e além disso o mesmo deve estar sincronizado no banco do PSPDV.

 

 

IMPORMAÇÕES IMPORTANTES PARA IMPRESSÃO

 

Se faz necessário a configuração do nome da impressora do comanda no módulo Gerencial do PetroShow.


A impressora pode ser definida por item, grupo de item e por estabelecimento (dentro de seus respectivos cadastros).

 

Segue imagem de onde configurar a impressora comanda no item, na rotina, PSGerencial >> Estoque >> Item ou pelo acesso rápido no ícone :

 

 

Segue imagem de onde configurar a impressora comanda no grupo de item, na rotina, PSGerencial >> Estoque >> Item >> Grupos:

 

 

Segue imagem de onde configurar a impressora comanda nas configurações do estabelecimento, na rotina, PS - Gerencial >> Cadastros Específicos >> Estabelecimento >> Configuração ou pelo acesso rápido (Ctrl + O) :

 

 

Ressalto que no campo Caminho/Nome da Impressora deve ser idêntico ao nome da impressora que será utilizada para impressão da comanda. 

 

Esse cadastro você pode fazer através do caminho: Cadastro específicos >> Impressora - comanda

 

 

VERSÃO DO SISTEMA DOCUMENTADO

 

Versão 2108.1001.