Páginas filhas
  • Manual de configuração e instalação da comanda eletrônica Android

01. DISTRIBUIÇÃO

Versão do APP:

A versão full da comanda está disponível na central de downloads

Essa versão é de uso exclusivo para clientes que utilizam a comanda eletrônica em Smartphones com o sistema Android, versão 5.0 ou superior.

Já as versões dos POS Digitais são disponibilizadas nas lojas próprias dos mesmos.


Versão do serviço integração comandas e PDV:

Link das versões do serviço integração comandas e do PDV

Aconselhamos sempre a utilizar a ultima versão disponível na central de downloads.

02. PRÉ REQUISITOS

  • Máquina com Windows 8 ou superior, de preferência Windows 10 64 bits;
    • Banco de Dados MS SQLServer 2008 ou Superior;
    • Memoria RAM: pelo menos 6gb para o caixa e pelo menos 8gb para o servidor de Banco de dados.
    • Para um melhor desempenho das aplicações e usabilidade das comandas, é recomendado que o servidor de Banco de dados, servidor da Comanda Eletrônica, utilizem SSD.
    • Possuir o Framework 3.5 e os mais novos Instalados,  4.8 ou superior. 
    • Validar da liberação Firewall do Windows para as API's da comanda;
    • Windows Defender deve estar desativado;
    • Liberação da pasta C:\MS colocando como exceção no Antivírus


  • Compartilhar as pastas criadas pelo IIS: inetpub e wwwroot dos caminhos: C:\inetpubC:\inetpub\wwwroot respectivamente;
    • Liberar o acesso para o usuário da máquina nas pastas do IIS: inetpub e wwwroot dos caminhos: C:\inetpub e C:\inetpub\wwwroot respectivamente;
    • Compartilhar a Pasta MS (C:\MS) e a Pasta SPOOL (C:\MS\Spool);
  • Possuir Setor Cadastrado;
  • Configurar Impressora de Produção caso seja utilizado.


  • Módulo Pocket habilitado na licença com a quantidade de dispositivos que o cliente irá utilizar (modulo utilizado para realizar o login na comanda eletrônica e realizar lançamentos de pedidos);
    • Não será possível conectar mais dispositivos simultâneos, além da quantidade disponível na licença;


  • Máquina com NFC-e ou SAT;
  • Para a emissão de cupom fiscal pela comanda eletrônica é necessário que o servidor da comanda tenha função de caixa (realize abertura e fechamento de caixa).
    • É necessário possuir licença de pagamento móvel (TEF CE) e emissão fiscal
    • A emissão do cupom é realizado nos modelos fiscais (SAT e NFC-e);
      • No SAT é necessário configurar o G-SAT;
        • No documento abaixo, explica como configurar;
  • *** Não possui suporte para ECF.
  •  
    • Roteador deve seguir as especificações do documento de infra estrutura do PDV, sendo suficiente para atender a quantidade Total de equipamentos Wi-Fi que forem conectados no estabelecimento, estando estabelecidos pelo fabricante do roteador.
      • O roteador das comandas não deve ser o mesmo roteador que possa fornecer a conexão de internet para os clientes do estabelecimento.


  • Smartphone ou Tablet com no mínimo Android 5.0, Recomendamos Android 9.0 ou superior;
    • Possuir pelo menos 1,5 gb de Memória Ram, Recomendamos 2gb ou superior;


03. CONFIGURAÇÕES

Máquina servidora das comandas - Ativar ou desativar recursos do Windows:

Habilitar o framework 3.5 e superiores.

Habilitar os recursos do IIS, deixando as duas primeiras pastas com o "V" de confirmação.

É necessário cadastrar pelo menos um setor para utilização na comanda eletrônica.
Para acessar o cadastro de setores, é necessário acessar o configurações.exe, Operações, Comanda sem fio, Operações novamente, setor.

OBS: a comanda também funciona com setor de venda.

Para configurar impressoras de produção para a comanda é necessário acessar o configurações.exe, operações, comanda sem fio. Caso o cliente utilize setor de venda, o mesmo deve acessar a configuração de impressoras do PDV, selecionar o setor de venda e realizar a configuração.

Para realizar o recebimento pelo POS Digitais, após ter o módulo TEF CE na licença é necessário habilitar a flag Recebimento Comanda na aba TEF/POS no configurações gerais. Caso o cliente utilize a comanda eletrônica Android em um Smartphone e queira realizar o recebimento utilizando um Chip&pin é necessário ter o SITEF local instalado e configurado na máquina.

03. INSTALAÇÃO


Foram incluídas mais três novas APIs no exe serviço integrações comandas a partir da versão 2.28.03, agora ao realizar a instalação do mesmo, além das APIs ComandaEletronica.API e do ServicoIntegracaoComandas as APIs TOTVS Food Service Mobile, Pagamento e Finaliza Venda são instaladas também. 

Quais são as finalidades das novas APIs?

TOTVS Food Service Mobile: Necessário para o funcionamento da comanda.
TOTVS Food Service Pagamento: Responsável pelo processamento dos pagamentos.
TOTVS Food Service Finaliza Venda: Responsável pela emissão e cancelamento do cupom, nos modelos fiscais NFC-e e SAT.

Após a instalação do Serviço integração comandas por precaução é recomendado verificar se as APIs estão em execução.

Para verificar as APIs ComandaEletronica.API e ServicoIntegracaoComandas execute os dois link abaixo no navegador:

http://localhost/ComandaEletronica.Api/
http://localhost/ServicoIntegracaoComanda/Servico.svc

Para verificar se as três novas APIs, estão em execução é necessário:

1- Validar se as 3 APIs estão em execução no serviços do Windows:


2- Validar a URL do Swagger de cada uma das APIs:

TOTVS Food Service Pagamento API: http://192.168.0.130:3101/swagger
TOTVS Food Service Mobile API: http://192.168.0.130:2601/swagger
TOTVS Food Service Finaliza Venda API:  http://192.168.0.130:5001/swagger

Como preencher a URL com os dados corretos:

Exemplos:

TOTVS Food Service Pagamento API: http://IP_da_máquina_que_possui_as_APIs_instaladas:31+Número_do_PC_da_Licença/swagger
TOTVS Food Service Mobile API: http://IP_da_máquina_que_possui_as_APIs_instaladas:26+Número_do_PC_da_Licença/swagger
TOTVS Food Service Finaliza Venda API:  http://IP_da_máquina_que_possui_as_APIs_instaladas:50+Número_do_PC_da_Licença/swagger

EM NEGRITO: Não deve ser alterado.
EM VEMELHO: Deve ser alterado para os dados da máquina do cliente.

Após a instalação do Serviço integração comandas, o mesmo cria uma porta de quatro dígitos no Firewall do Windows para cada nova API, sendo por padrão os dois número referente a identificação da API e os dois últimos sendo o PC da licença do cliente.

Exemplo:

PORTA: 26+NÚMERO PC (EX: 2601) ENDERECO_API_MOBILE
PORTA: 50+NÚMERO PC (EX: 5001) ENDERECO_FINALIZA_VENDA
PORTA: 32+NÚMERO PC (EX: 3101) ENDERECO_API_PAGAMENTO


Além da criação automática no Firewall do Windows, as novas APIs são inseridas na aba integrações do configurações.exe, com o IP que a máquina está, caso o IP da máquina altere o IP no configurações das APIs irão ser alterados automaticamente.

Nesta tela, é necessário configurar o G-SAT, com o Nome da maquina que esta configurado como Caixa e Servidor da(s) Comanda(s).

Se esta configuração não for realizada, Ocorre erros no momento de emitir o cupom.  


Mensagem de erro quando o G-SAT não está configurado: The hostname cloud not be parsed.



04. DIREITOS DE ACESSO

Lista com todos os direitos de acessos utilizados pela comanda eletrônica Android.

Direitos de acessoFuncionalidadeDescrição
LANÇAMENTOLoginPermite realizar o login na comanda eletrônica Android.
TRANSFERÊNCIATransferência de itensPermite acessar a tela de transferência de itens entre mesas.
APLICAR DESCONTO PADRÃODesconto na contaPermite acessar a tela de descontos no fechamento da conta.
FECHAMENTOFechamento da contaPermite realizar o fechamento da conta.
FECHAR CONTA SEM SERVIÇOFechamento/Pagamento sem serviçoPermite retirar o serviço no fechamento da conta e na tela de pagamento
FUNÇÕES ADMINISTRATIVASPagamento do pedidoPermite acessar a tela de pagamento após o fechamento a conta
CANCELAR CUPOM FISCALCancelar o cupom fiscalPermite cancelar o cupom fiscal realizado na comanda
REIMPRIMIR CUPOM FISCALReimprime o cupom fiscalPermite reimprimir o cupom fiscal realizado na comanda
DELETAR PRODUTOCancelamento de itens anteriores e atendimento pendentePermite deletar os itens anteriores no lançamento e o atendimento pendente
CANCELAR CUPOM FISCALFiscalPermite cancelar o cupom fiscal
REIMPRIMIR CUPOM FISCALFiscalPermite reimprimir o cupom fiscal
CADASTRO DE CLIENTESCadastro de portariaPermite alterar os dados do cadastro dos clientes pelo cadastro de portaria.
LIBERAR CONSUMAÇÃOCadastro de portariaPermite desmarcar a opção de cobrar consumação na tela de cadastro de portaria.
ESTOQUE ON-LINE VENDER ITEM COMPOSTO SEM ESTOQUECadastro de portariaPermite vender o produto composto sem estoque como ingresso quando a configuração baixa de estoque online está habilitada.
ACESSAR CONFIGURACOES AVANCADASConfiguraçõesPermite o acessar a tela de configurações do atendimento.
ALTERAR CONFIGURACAO SOLICITAR ATENDENTEConfiguraçõesPermite habilitar ou desabilitar a configuração de solicitar o atendente durante o atendimento.
ALTERAR CONFIGURACAO SOLICITAR SENHA ATENDENTEConfiguraçõesPermite habilitar ou desabilitar a configuração de solicitar a senha do atendente durante o atendimento.
GRAVAR TAG NCFNFCPermite gravar a tag NFC


05. CONCLUSÃO

Após realizar todos os passos informados anteriormente a comanda eletrônica Android estará pronta para o uso.


IMPORTANTE!


1.Toda vez que uma configuração for realizada no configurações.exe, será necessário reiniciar o IIS, realizar o LogOut e LogIn na comanda eletrônica Android novamente.

2.Após a implementação da emissão ou cancelamento do cupom com a API de finalizar vendas, fica obrigatório o uso de G-sat para o modelo fiscal SAT.

06. ASSUNTOS RELACIONADOS