Manual Comanda Mobile

Transcrição

1 Manual Comanda Mobile Sumário 1 Conceito 2 Requisitos 2.1 Requisitos Comerciais 2.2 Requisito de Software 3 Configurações 3.1 Python Gunicorn 3.3 Django 3.4 PsyCopG2 3.5 Comanda Mobile Arquivo Local.py 3.6 Configurações via Windows Instalação do Xampp (Apache) Edição do arquivo local.py Instalação do mod_wsgi 3.7 Módulo Gerencial Lotes Terminal Impressora Regras de Impressão 4 Funcionalidades 4.1 Login 4.2 Lançamento 4.3 Itens Mais Vendidos 4.4 Conta de Clientes em Aberto 4.5 Conta de Clientes Pendente 4.6 Cancelar Item 4.7 Consultar Item 1 Conceito O módulo Comanda Mobile facilitará o gerenciamento de pedidos, permitindo o lançamento e o cancelamento de itens para uma comanda, através de tablets e smartphones. Além de permitir consultas de itens cadastrados, itens mais vendidos e de comandas já inicializadas.

2 2 Requisitos Antes de utilizar o módulo Comanda Mobile será necessário que alguns requisitos sejam atendidos. 2.1 Requisitos Comerciais Para utilizar o módulo Comanda Mobile será necessário entrar em contato com o Departamento Comercial do Linx Postos AutoSystem, para que seja liberada a implantação do módulo. 2.2 Requisito de Software Para o funcionamento do módulo será necessário a instalação dos softwares: Python 2.7; Gunicorn; Django; Psycopg2. Para funcionamento deste módulo, será necessário que o browser esteja devidamente atualizado e seja um dos seguintes: Google Chrome, Safari ou Firefox. Para utilização em dispositivos móveis, acessar através de dispositivos versão maior ou igual a ios 6 e Android Configurações O módulo Pista Mobile foi homologado no sistema operacional Ubuntu e Windows. Para o funcionamento do módulo Comanda Mobile será necessário possuir a instalação do Linx Postos AutoSystem. Importante A sequência de comandos a seguir para Ubuntu deverá ser idêntica a descrita abaixo, para não comprometer a instalação dos pacotes. Usuários sem permissões de super-usuários devem usar o comando sudosu e inserir a senha de administrador, antes de executar os comandos listados abaixo. 3.1 Python 2.7

3 Este capítulo abrange a parte de instalação do módulo Comanda Mobile. Como requisito deverá ser instalado o Python2.7. Verificar a versão do python (executar o comando python version). Caso não for possível realizar o comando, baixar o python no link Python. Extrair o arquivo python tgz (executar o comando tar xzvf Python tgz). Acessar a pasta Python (executar o comando cd Python ). Executar os seguintes comandos na ordem:./configure make make install 3.2 Gunicorn Este capítulo abrange a parte de instalação do módulo Comanda Mobile. Como requisito deverá ser instalado o Gunicorn. Caso o easy_install não esteja instalado, será necessário realizar o download do arquivo (executar o comando wget Após realizar o download, instalar o gunicorn (executar o comando sh setuptools-0.6c10- py2.6.egg). Com o easy_install instalado, realizar a instalação do gunicorn (executar o comando easy_install gunicorn). 3.3 Django Este capítulo abrange a parte de instalação da Comanda Mobile. Como requisito deverá ser instalado o Django. Caso o easy_install não esteja instalado, será necessário realizar o download através do link DJANGO. Com o easy_install instalado, realizar a instalação do django (executar o comando easy_install django==1.6). 3.4 PsyCopG2 Este capítulo abrange a parte de instalação da Comanda Mobile. Como requisito deverá ser instalado o PsyCopG2. Caso o easy_install não esteja instalado, será necessário realizar o download através do link PSYCOPG2. Com o easy_install instalado, realizar a instalação do psycopg2 (executar o comando easy_install psycopg2) 3.5 Comanda Mobile Para a instalação da Comanda Mobile deve-se realizar algumas configurações. Ao solicitar o módulo Comanda Mobile, será disponibilizado um arquivo zip que deverá ser descompactado no diretório usr/local/autosystem3/comanda/. Recortar o arquivo as_comanda_mobile do diretório usr/local/autosystem3/comanda/mobile e colar para o diretório /usr/local/autosystem3/bin/. Será necessário criar link simbólico entre os executáveis (executar o comando ln s /usr/local/autosystem3/bin/as_comanda_mobile/usr/local/bin/as_comanda_mobile).

4 3.5.1 Arquivo Local.py Acessar o diretório usr/local/autosystem3/comanda/mobile e editar o arquivo local.py onde: BASE_URL: informar o IP do servidor e a porta onde está sendo executado o serviço da Comanda Mobile. Exemplo: ' Configurando banco de dados: 'ENGINE': exibirá os softwares instalados; 'NAME': informar o nome do banco de dados; 'USER': informar o nome do usuário do banco de dados; 'PASSWORD': informar a senha do banco de dados; 'HOST': informar o endereço do banco de dados; 'PORT': informar a porta do banco de dados. A seguir imagem de exemplo de configuração:

5 Importante Ao configurar o arquivo, os campos devem permanecer formatados como no exemplo, campos entre apóstrofo, seguido de vírgula. 3.6 Configurações via Windows A rotina de Comanda Mobile agora está disponível também em Windows. Para podermos utilizar ela, é necessário possuir o Python 2.7, Django 1.6 e Psycopg2 já instalados, e realizar as seguintes configurações: Instalação do Xampp (Apache) Realizar o download do apache, selecionando a opção para o sistema operacional Windows. Com o download feito, basta realizar a instalação padrão do XAMPP para que o Apache e demais serviços sejam instalados corretamente em sua máquina. Ao acessar o XAMPP será apresentada a seguinte tela:

6 Clicar no botão Config e na tela seguinte clicar no botão Service and Port Settings.

7 Será apresentada a seguinte tela, onde devem ser informadas as portas a serem configuradas, nos campos e (sugestão de portas: 8081 e 4433), e clicar em, como mostra a imagem Main Port SSL Port Save abaixo:

8 Na sequência, clicar em Config e selecionar a opção Apache (httpd.conf).

9 No arquivo que será aberto, deve ser informada a porta configurada no campo, vista no passo anterior. Para facilitar, pode ser feita uma busca (Ctrl+f por exemplo) pela palavra, e depois por Main Port Listen L ocalhost, como mostra as imagens abaixo:

10 Após inserir as informações, acessar Arquivo > Salvar. Clicar novamente em Config e selecionar a opção Apache (httpd-ssl.conf).

11 Neste arquivo deverá ser informada a porta configurada no campo SSL Port. A busca pode ser feita pela palavra Listen, como mostra a imagem abaixo:

12 Depois de informada a porta, acessar Arquivo > Salvar. Feito isso, clicar em Start, para inicializar o Apache.

13

14 3.6.2 Edição do arquivo local.py O arquivo local.py, localizado na pasta referente à Comanda Mobile, deverá ser editado. A estrutura das pastas deve ser conforme apresentada na imagem abaixo: No arquivo devem ser editadas as seguintes informações: Name: Nome do banco de dados; User: Usuário do banco de dados; Password: Senha do banco de dados; Host: informar Localhost para acesso local, ou o número do IP para acesso a outra máquina; Port: Porta do banco de dados. Também deve ser informada a mesma porta que consta no campo Main Port, já visto anteriormente, como mostra a imagem abaixo:

15 Para finalizar, clicar em Salvar Instalação do mod_wsgi É necessário que seja instalado um módulo do Apache chamado mod_wsgi. Importante Se o python for 32 bits, o mod_wsgi também precisa ser 32 bits; já se o python for 64 bits, o mod_wsgi precisa ser 64 bits. O arquivo mod_wsgi.so deve ser copiado para dentro da pasta de instalação do Apache, acessando apache > modules, como mostram as imagens abaixo:

16

17 Ainda dentro da pasta de instalação do Apache, o arquivo, localizado em, deverá ser editado, e adicionada a linha, conforme httpd.conf apache > conf LoadModule wsgi_module modules/mod_wsgi.so imagem abaixo:

18 Depois de adicionada a linha, o arquivo deverá ser salvo. O último passo a ser realizado será a cópia da pasta Mobile, e dos arquivos index.wsgi e.htaccess, localizados na pasta referente à Comanda Mobile; para a pasta de instalação do Apache, no caminho xam pp > htdocs, conforme imagem abaixo:

19 Para confirmar se a Comanda Mobile já está acessível, basta clicar em Admin, e se tudo estiver correto, a tela para acesso à comanda será apresentada.

20 3.7 Módulo Gerencial Para funcionamento do módulo Comanda Mobile necessário realizar algumas configurações no módulo Gerencial, que serão vistas a seguir Lotes Para configurar os lotes de comanda será necessário acessar no módulo Gerencial Configurações > Módulos > Comanda Eletrônica > Lotes. A imagem a seguir será exibida:

21 Esta tela possui os botões: Novo: permitirá adicionar um lote de comandas; Editar: permitirá editar as configurações de um lote de comandas já existente; Excluir: permitirá excluir um lote de comanda; Listar: gerará um relatório com os códigos dos lotes de comandas e os códigos criptografados; Fechar: permitirá fechar esta tela. Ao clicar no botão Novo ou Editar, será exibida a tela conforme imagem abaixo:

22 Esta tela possui os campos: Código: campo preenchido automaticamente; Nome: informar o nome do lote de comandas; Empresa: informar a empresa (este campo é exibido apenas quando a base for multiempresa); Prefixo: informar o prefixo que será utilizado antes da numeração; Tamanho: informar o número de dígitos utilizados na numeração; Nr. Inicial: informar o número da primeira comanda do lote; Nr. Final: informar o último número da comanda do lote; Nr. extraviados: informar o número das comandas extraviadas. Caso houver mais de uma, separar os números por ponto e vírgula. Na aba Terminais, selecionar os terminais que utilizarão o lote de comandas.

23 A aba Configurações possui as opções: Forma Pgto: informar a forma de pagamento padrão para o lote; Finalizar automaticamente a venda quando passar a comanda no caixa: com esta opção marcada, quando a comanda for informada no caixa a venda será iniciada e finalizada automaticamente. Para correto funcionamento, preencher o campo Forma Pgto com a forma de pagamento padrão do lote;

24 Exibir tela de consulta dos produtos da comanda antes de iniciar a venda: com esta opção habilitada, ao ler a comanda no caixa, o sistema irá apresentar uma tela contendo todos os itens lançados na pré-venda, permitindo que o operador confira a venda que será realizada; Exibir tela de mescla de comandas antes de iniciar a venda: com esta opção habilitada, quando a comanda for lida no caixa, será permitido realizar mescla de produtos entre comandas antes de baixar; Não imprimir dados do cliente no cabeçalho do cupom: com esta opção habilitada, quando o cliente for identificado no início da venda, os dados do mesmo não serão informados no cabeçalho do cupom fiscal emitido; Preencher com zeros a esquerda automaticamente: com esta opção habilitada, o sistema preencherá automaticamente o número da comanda com zeros a esquerda até completar o tamanho do algoritmo. Se houverem prefixos configurados, os zeros serão colocados entre o prefixo e o número da comanda. A opção Utilizar criptografia permitirá selecionar as opções: Sim: permitirá utilizar criptografia das comandas; Não: não permitirá utilizar criptografia das comandas; Regra da empresa: utilizará a criptografia conforme selecionado na regra da empresa. A aba Produtos possui a opção: Restringir Grupos e Subgrupos de produtos que podem ser lançados neste lote: permitirá restringir grupos e subgrupos de produtos a serem movimentados através do lote de comandas. Ao habilitar esta opção, selecionar quais grupos/subgrupos de produtos serão restringidos. Após realizar as configurações, clicar no botão Confirmar para registrar as alterações. Ao selecionar um ou mais lotes e clicar no botão Listar será exibida a tela conforme imagem abaixo:

25 Ao selecionar as opções, clicar no botão Gerar relatório, será exibido um relatório conforme imagem abaixo:

26 3.7.2 Terminal Para configurar um terminal será necessário acessar no módulo Gerencial Configurações > Módulos > Comanda Eletrônica > Terminais. A imagem a seguir será exibida:

27 Clicar no botão Novo para cadastrar um novo terminal. A tela a seguir será exibida:

28 Importante No campo Modelo selecionar a opção MOBILE e no campo Endereço IP deixar em branco. Nome: informar o nome do terminal; Empresa: informar a empresa (este campo é exibido apenas quando a base for multiempresa); Departamento: informar o departamento; Modelo: informar o modelo de dispositivo utilizado pelo terminal. Será possível selecionar os modelos: Wilbor Term 16: microterminal 16 teclas, com saída serial e mini din, teclado numérico; Shellby 915 RF: terminal de radiofrequência SHELLBY 915MHz com leitor de código de barras; Wilbor Term 44: microterminal 44 teclas, com saída serial, paralela e mini din, teclado alfanumérico; Terminal PC: componentes do computador que servirão como terminal, ao qual o monitor será utilizado como display, sem a necessidade de conectar um dispositivo de terceiros; IDTECH: terminais de 16 ou 44 teclas Ethernet, TCP-IP ou Wi-Fi. Endereço IP: informar o endereço de IP do terminal. A aba Grupos de Produto permitirá adicionar grupos de produto específicos para movimentação neste terminal. Esta aba possui os botões:

29 Adicionar: permitirá adicionar um grupo de produto à relação; Excluir: permitirá excluir um grupo de produto da relação. Caso nenhum grupo de produto for informado, o sistema considerará todos os grupos de produtos cadastrados. Na aba Senha de Acesso cadastrar os funcionários que terão acesso ao módulo. A seguir imagem da aba: Esta tela possui os botões: Adicionar: permitirá adicionar usuários de acesso; Editar: permitirá editar o usuário de acesso selecionado; Excluir: permitirá excluir o usuário de acesso selecionado. Clicar no botão Adicionar para cadastrar um usuário, a tela a seguir será exibida:

30 Esta tela possui os campos: Funcionário: informar o funcionário que possuirá acesso ao módulo; Senha: informar a senha de acesso do funcionário para o módulo. A guia Funções Administrativas possui as opções: Permite cancelar itens da comanda: permitirá cancelar os itens da comanda; Permite reabrir comanda pré-fechada: permitirá reabrir comandas pré- fechadas Após informar os campos, clicar no botão Confirmar F5 para registra as informações. Na aba Lotes de Comanda será necessário vincular o lote cadastrado conforme capítulo A seguir imagem da aba:

31 A aba Opções permitirá realizar configurações gerais do módulo. A seguir imagem da aba: A guia Balança não deverá ser preenchida quando o terminal for destinado ao uso do módulo Comanda Mobile. A guia Geral possui as opções: Solicitar o lançamento do local de entrega: solicitará o lançamento do local de entrega do pedido, para lançamento do produto na pré-venda. Permite imprimir pré-fechamento: libera impressão de pré-fechamento de uma ou mais comandas; Enviar preço unitário do produto para a balança: permitirá enviar o preço unitário do produto à balança, para realizar pesagem; Exibir na tela de procura apenas os produtos sem código de barras: bloqueará o uso de itens que tem código de barras em seu cadastro.

32 3.7.3 Impressora Para configurar uma impressora será necessário acessar no módulo Gerencial Configurações > Módulos > Comanda Eletrônica > Impressoras. A imagem a seguir será exibida: Esta tela possui os botões: Novo: permitirá adicionar uma impressora; Editar: permitirá editar as configurações de uma impressora existente; Excluir: permitirá excluir uma impressora da relação; Fechar: permitirá fechar esta tela. Ao clicar no botão Novo, será exibida uma tela conforme imagem abaixo:

33 Esta tela possui os campos: Empresa: informar a empresa (este campo é exibido apenas quando a base for multiempresa); Nome: informar o nome que identificará a impressora no sistema; Porta: informar a porta de comunicação em que a impressora está conectada ou o nome da impressora na rede. A opção Impressora padrão habilitará esta impressora como padrão no sistema. A guia Configurações possui as opções: Colunas: informar o número de colunas em que será feita a impressão; Separação: informar o número de linhas em que será feita a impressão Após realizar as configurações, clicar no botão Confirmar para registrar as alterações. Importante Apenas impressoras não fiscais devem ser cadastradas Regras de Impressão As regras de impressão serão necessárias para impressão de ordem de produção e pré-fechamento. Poderão ser configuradas diferentes impressoras para diferentes grupos ou subgrupos de produtos. Para imprimir o pré-fechamento será necessário que a primeira impressora a ser cadastrada não tenha restrição a nenhum grupo de produto, subgrupo ou produto, desta forma, todos os pedidos serão impressos. Deve-se associar uma impressora a um grupo de produto, subgrupo ou produto quando for utilizada uma impressora distinta para determinada finalidade. Por exemplo, nos casos das cozinhas de restaurantes, onde existir uma impressora destinada a impressão dos lanches dos pedidos, e outra para as bebidas dos pedidos. Para configurar uma impressora será necessário acessar no módulo Gerencial Configurações > Módulos > Comanda Eletrônica > Regras de Impressão. A imagem a seguir será exibida

34 Esta janela possui os botões: Novo: permitirá adicionar uma regra de impressão; Editar: permitirá editar as configurações de uma regra de impressão existente; Excluir: permitirá excluir regras de impressão; Filtrar: permitirá filtrar as regras de impressão; Imprimir: gerará um relatório com as regras de impressão; Fechar: permitirá fechar a tela. Ao clicar no botão Novo ou Editar, será exibida a tela conforme imagem abaixo:

35 Esta tela possui os filtros: Empresa: informar a empresa (este campo é exibido apenas quando a base for multiempresa); Lote: informar o lote de comandas que utilizará a regra de impressão; Terminal: informar o terminal que utilizará a regra; Grupo Produto: informar o grupo de produtos; Subgrupo Produto: informar o subgrupo de produtos; Produto: informar o produto; Impressora: informar a impressora. Após realizar as configurações, clicar no botão Confirmar para registrar as alterações. 4 Funcionalidades O módulo Comanda Mobile permitirá o gerenciamento de pedidos, permitindo o lançamento e o cancelamento de itens para uma comanda, entre outras funcionalidades. Após realizar as configurações, acessar o módulo Comanda Mobile, para isso inicializar o serviço (executar os comandos no terminal as_comanda_mobile start e python manage.pyc runserver :port a) e acessar através do navegador o IP e a porta do servidor em que este serviço está sendo executado.

36 4.1 Login Para acessar o módulo Comanda Mobile será necessário possuir um login e uma senha cadastrados, conforme visto no tópico A seguir imagem da tela de login: Esta tela possui os campos: Login: informar o código do funcionário; Senha: informa a senha cadastrada. Após a validação do login e da senha, o usuário terá acesso aos menus do módulo. Conforme imagem a seguir:

37 Na parte inferior do menu será exibido o funcionário que está logado, e os botões: Inicio: permitirá retornar a tela inicial de menus; Sair: permitirá deslogar o usuário. 4.2 Lançamento O menu Lançamento permitirá o lançamento de itens para uma determinada comanda. Conforme imagem a seguir:

38

39 Esta tela possui os campos: Comanda: informar o número da comanda; Itens: informar o código ou código de barras do produto. O campo Itens possui os botões: Adicionar: permitirá adicionar itens a comanda; Excluir: permitirá excluir itens da comanda; Detalhar: permitirá informar observações de preparo e adicionar complementos. Ao clicar no botão Detalhar, será exibida a tela a seguir:

40 Após selecionar os complementos e/ou observações de preparo, clicar no botão OK para registrar no lançamento. 4.3 Itens Mais Vendidos O menu Itens Mais Vendidos exibirá os produtos mais consumidos em um intervalo de tempo. Para maior precisão dos dados retornados, será necessário que a função SQL seja executada todos os dias (agendar a função produto_mais_vendido_f). A seguir imagem do menu:

41 A partir da lista de itens mais vendidos será possível realizar o lançamento dos itens selecionados. Para isso, devem ser marcados os produtos e clicar no botão Lançar itens. 4.4 Conta de Clientes em Aberto No menu Conta de Clientes em Aberto serão listadas as comandas que estão abertas, ou seja, aquelas que o pré-fechamento ainda não foi realizado. A lista de contas em aberto é limitada a 15 comandas, onde ao clicar no botão Exibir mais comandas serão exibidas mais 15 comandas. A seguir imagem do menu:

42 Ao selecionar uma comanda, a tela a seguir será exibida:

43 Esta tela possui os campos: Responsável: exibirá o funcionário responsável pela comanda; Status: exibirá o status da comanda; Data: exibirá a data em que a comanda foi aberta; Tempo Perm: exibirá o tempo em que a comanda está aberta. Esta tela exibirá os itens lançados para esta comanda, possui os campos: Descrição: exibirá o nome do produto; Qtde. Unit.: exibira a quantidade e o preço unitário do produto; Valor: exibirá o valor do produto; Total: exibirá o total da comanda. Lançar mais itens: permitirá lançar mais itens para a comanda:

44 Ao lançar mais itens, será apresentado tela de lançamento rápido para que sejam lançados novos itens na conta selecionada. Kit de Produto Variável Se for realizado venda com kit variável, ao inserir o código do kit que possua variação em seu cadastro, será inserido automaticamente os itens que são fixos do kit e na sequência será apresentado uma tela para escolha dos itens variáveis que foram configurados, conforme imagem:

45 Com os itens adicionados, basta registrar a comanda para que seja encaminhada ao caixa onde será realizado o fechamento desta comanda. 4.5 Conta de Clientes Pendente Ao selecionar o menu Conta de Clientes Pendente serão exibidas todas as comandas onde o pré-fechamento foi realizado. A seguir imagem da tela:

46 Ao selecionar uma comanda, a tela a seguir será exibida:

47 Esta tela possui os botões: Responsável: exibirá o funcionário responsável pela comanda; Status: exibirá o status da comanda; Data: exibirá a data em que a comanda foi aberta; Tempo Perm: exibirá o tempo em que a comanda está aberta. Lançar mais itens: permitirá lançar mais itens na comanda. Caso ocorra o lançamento de itens em uma comanda pendente, a comanda será reaberta, alterando seu status de pendente para aberta; Ao lançar mais itens, será apresentado tela de lançamento rápido para que sejam lançados novos itens na conta selecionada, assim como vimos no capítulo anterior Cancelar Item No menu Cancelar Item será permitido realizar o cancelamento de itens das comandas que estão em aberto. A seguir imagem do menu:

48 Esta tela possui os campos: Comanda: informar o número da comanda; Usuário: informar o código do funcionário; Senha: informar a senha. Após informar os campos, clicar no botão Listar itens. A tela a seguir será exibida:

49 Esta tela possui o botão: Excluir: permitirá excluir o item da comanda. Serão exibidos os produtos lançados na comanda. Para cancelar o produto da comanda, clicar no botão Excluir. O sistema questionará se deseja cancelar o item da comanda, conforme imagem a seguir:

50 Clicar no botão OK para realizar o cancelamento do item. Caso seja o último item da comanda, não será possível realizar exclusão e será orientado a realizar a exclusão do último item diretamente no caixa ponto de venda. 4.7 Consultar Item

51 No menu Consultar Item será possível realizar a consulta de produtos, esta consulta poderá ser realizada através do código do produto ou do nome do produto. A seguir será exibida a tela do menu: Nesta tela será possível selecionar um ou mais produtos para que sejam lançados em uma comanda aberta através do botão Lançar Itens.

52 Ao lançar um item, será apresentado tela de lançamento de comanda, conforme visto nos capítulos anteriores.