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

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

01. DISTRIBUIÇÃO

Versão do APP:

A versão full da comanda está disponível na central de downloadshttps://suporte.totvs.com/portal/p/10098/download#000058/405/

Essa versão é de uso exclusivo para clientes que utilizam a comanda eletrônica em Smarphones 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 mesmomesmos.


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

Link das versões do serviço integração comandas e do PDVhttps://suporte.totvs.com/portal/p/10098/download#000058/

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

02. PRÉ REQUISITOS

  • Máquina com Windows 7 8 ou superior, de preferencia 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
  • Máquina com NFC-e ou SAT com G-sat configurado;
  • Máquina servidora da comanda deve ser um caixa caso o cliente realize a finalização da venda pela comanda eletrônica Android;
  • Modulo Pocket 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;Modulo TEF CE na licença, para realizar o recebimento pela comanda eletrônica Android;
  • 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, com ;
    • Possuir pelo menos 1,5 gb de
    memória ram
    • Memória Ram, Recomendamos 2gb ou superior;


  • POS Digital homologado;
  • Compartilhar as pastas: inetpub e wwwroot dos caminhos: C:\inetpub e C:\inetpub\wwwroot respectivamente;
  • Liberar o acesso para o usuário da máquina nas pastas: inetpub e wwwroot dos caminhos: C:\inetpub e C:\inetpub\wwwroot respectivamente;
  • Digitais;

03. CONFIGURAÇÕES

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

Totvs custom tabs box
tabsFrameworks, Serviço de informações da Internet, Cadastro de setor, Configuração de impressoras, Configuração para recebimento
idspasso1,passo2p1,p2,p3,p4,p5
Totvs custom tabs box items
defaultyes
referenciapasso1p1

Habilitar o framework 3.5 e superiores.

Totvs custom tabs box items
defaultno
referenciapasso2p2

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

Totvs custom tabs box items
defaultno
referenciap3

É 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.

Image Added

Totvs custom tabs box items
defaultno
referenciap4

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.

Image Added

Totvs custom tabs box items
defaultno
referenciap5

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.

Image Added

03. INSTALAÇÃO

...


Totvs custom tabs box
tabsPasso 01, Passo 02, Passo 03, Passo 04Serviço integração comandas, Novas APIs, Validação das APIs, Configurações automáticas, Configuração do G-SAT
idspasso1,passo2,passo3,passo4,passo5
Totvs custom tabs box items
defaultyes
referenciapasso1

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. 

Image Modified

Totvs custom tabs box items
defaultno
referenciapasso2

04. DEMAIS INFORMAÇÕES

Card documentos
InformacaoUse esse box para destacar informações relevantes e/ou de destaque.
TituloIMPORTANTE!

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.

Totvs custom tabs box items
defaultno
referenciapasso3

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:

Image Added


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.

Totvs custom tabs box items
defaultno
referenciapasso4

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

Image Added


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.

Image Added

Totvs custom tabs box items
defaultno
referenciapasso5

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.  

Image Added


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


Image Added


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.


Informações
titleIMPORTANTE!


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

...


Templatedocumentos


HTML
<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>