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;
Apache Tomcat na versão 8 ou superior;
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.
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.