1. Conceito

Esta documentação tem o objetivo de informar e orientar os usuários referente à integração do Comanda Mobile. Com isso, esta integração vem com o intuito de igualar as funcionalidades do Comanda Mobile AutoSystem com o Linx Smart Order, fazendo com que passe a ter apenas um único aplicativo. E esse, por sua vez, atenda a integração do Comanda com SmartPOS, Seller, Empório e AutoSystem - seja com o novo PDV integrado ou com o PDV nativo do AutoSystem, podendo atender clientes que utilizam o Comanda e centralizando as melhorias e correções em apenas um único app.

O aplicativo Linx Postos Comanda Mobile permite o registro de pedidos na Comanda através do aplicativo, gerando uma pré-venda diretamente no caixa do AutoSystem para efetuar a baixa. Além do registro de Comandas, é possível fazer o gerenciamento de pedidos, permitindo a consulta de Comandas abertas e pendentes, o lançamento e cancelamento de itens através de tablets e smartphones e a consulta de itens cadastrados.

O aplicativo permite acessar a câmera do dispositivo para efetuar o registro de Comandas, a abertura, o lançamento e o cancelamento de itens através da captura de código de barras dos produtos.

2. Pré-requisitos

Para utilizar o aplicativo Linx Postos Comanda Mobile, é necessário:

• Possuir o módulo Comanda Mobile liberado na chave da Linx;
• Possuir um dispositivo Smartphone com sistema operacional Android na versão igual ou superior a 4.4;
• O dispositivo deve estar conectado na mesma rede em que o serviço da Comanda está sendo executado;
• Versão mínima do AutoSystem para a integração: 3.3.1.168.

3. Configurações iniciais

Para que seja possível utilizar o aplicativo, deve-se fazer a ativação e algumas configurações do Linx Smart Order. Veja as informações:

1. Informe o CNPJ do estabelecimento. Nesse passo, o sistema irá avaliar se o CNPJ está ativo e se possui o módulo Comanda Mobile liberado;
2. Caso o passo anterior dê positivo, o aplicativo irá solicitar que seja informado o IP e a Porta.

Veja as imagens de exemplo:

3.1 Setting e tela de login

O Smart Order recebe, no Settings, algumas configurações para entender que é Comanda Mobile, sendo elas:

• 'enableCustomerAccountManagement': True: entende que o app em questão é Comanda Mobile;
• 'enablePaymentManagement': False: entende que o app é SmartPOS e que tem modo de pagamento ativo e, ainda, se tiver ativo com o primeiro item, habilita a Gestão de Comandas pelo próprio SmartPOS;
• 'showCustomerAccount': True: entende que o SmartPOS pode trabalhar com baixa de comandas (o pagamento delas).

4. SmartPOS - Baixa de comandas

Com as flags enablePaymentManagement e showCustomerAccount, é permitido realizar a baixa de comandas diretamente no SmartPOS - ativando, assim, a guia Comandas junto às guias Abastecimento e Produto.

No AutoSystem, há o checkbox (caixa de seleção) Ativar lançamento de comandas no menu Gerencial > Configurações > Módulos > Tef > Smartpos. Esse checkbox é apresentado somente com o módulo Comanda Eletrônica ativo.

• Ao selecionar uma comanda no SmartPOS, o serviço de integração faz a criação de uma pré-venda para realizar o bloqueio/reserva da Comanda, para evitar que outro equipamento (seja um Smart, Totem ou PDV) realize a baixa da Comanda que já está em andamento;
• Ao remover do carrinho a Comanda, o bloqueio dessa Comanda é retirado da pré-venda, permitindo realizar a leitura da Comanda em outro equipamento;
• No processo de finalização de venda, quando já está sendo gerado os dados para emissão do Comprovante Fiscal, é considerada a Comanda e baixa de todos os seus itens vinculados, atualizando o status dela para Livre.

5. SmartPOS - Gestão de comandas

Quando o equipamento está utilizando o app SmartPOS, é possível gerenciar todas as Comandas. Sendo assim, o Comanda Mobile vira um "módulo" dentro do SmartPOS, sendo apresentado um botão chamado Comanda já na tela principal do app. Através dele, é possível realizar os mesmos procedimentos que o app nativo permite, ou seja, é um espelhamento do aplicativo.

Veja as imagens de exemplo:

No menu Gerencial > Configurações > Módulos > Tef > Smartpos > Dispositivos do AutoSystem, há a flag Habilitar gestão de comandas, que permite o simples gerenciamento de Comanda dentro do SmartPOS. Essa configuração, por sua vez, só é possível caso o CNPJ possua o módulo de Comanda habilitado.

6. Gerenciamento de Comanda do SmartPOS e Smart Order

Para uma melhor gestão das Comandas, tanto pelo Smart Order quanto pelo gerenciamento de Comanda do SmartPOS, deve ser cadastrado um terminal do tipo Mobile no menu Gerencial > Configurações > Módulos > Comanda eletrônica > Terminais. Com esse cadastro realizado, será possível controlar questões como:

• Configurações para solicitar local, exibir na procura produtos sem código de barras, seleção de Comanda somente pela câmera e pré-fechamento de comanda;
• Permissões de cancelamento, reabertura, transferência e edição de Comanda através das senhas de acesso;
• Operação em lotes de Comandas específicas;
• Regras de lançamento de produtos através dos grupos de produtos.

Nesse cadastro, há uma nova guia chamada Dispositivos.

Nessa guia, é possível cadastrar o equipamento que irá atender as regras de gestão de Comandas. A tela de inclusão/edição de dispositivo deve possui os campos Serial e Porta. Veja a imagem de exemplo:

O serviço de comunicação com o SmartPOS e o Smart Order, quando inicializado, verifica a existência de cadastro de Terminal Mobile para poder capturar as suas configurações de gerenciamento de Comanda. Para a captura de configuração, é utilizado o campo Número de Série.

7. Iniciar atendimento

O Comanda Mobile inicia pela funcionalidade de listagem de produtos, com os campos Número de comanda e Local.

• Nas configurações de Terminal Comanda, na guia Opções, é possível marcar a flag Solicitar o lançamento do local de entrega, que obriga o Comanda Mobile a lançar alguma informação, mantendo o limite máximo de 15 caracteres;
• O sistema também respeita a flag Exibir na tela de procura apenas os produtos sem código de barras, ou seja, produtos que tenham código de barras não aparecem na lista e podem ser lançados na Comanda apenas se forem bipados. Com essa flag desmarcada, todos os itens para lançamentos são apresentados;
• Na tela de listagem de produtos, somente são apresentados os produtos que fazem parte da configuração de Grupos, de produtos do cadastro do Terminal;
• Ao selecionar um produto, o app apresenta a tela de seleção de vendedor, caso o produto estiver configurado para ser informado.

8. Leitura de comandas

Dentro da guia Opções do cadastro de Terminais, é possível marcar a flag Seleção de comandas somente pela câmera. Com essa flag habilitada, o Linx Smart Order trava o campo Número de comanda e permite somente a leitura pela câmera.

9. Produto composto

Atualmente, no Smart Order, não é realizado a venda de produtos compostos - isso tanto para a venda no SmartPOS quanto para o própri Ccomanda. Nesse caso, o app passa a receber os produtos do tipo Composto, e ao serem selecionados, há telas que permitem a seleção dos produtos com base em:

• Composição dos produtos: entende-se que são somente produtos que completam os itens principais, como por exemplo: um sanduiche (que tem como composição o pão, queijo e presunto);
• Complementos: entende-se que podem ser selecionados itens como bebidas, mas também algum complemento como "o dobro de bacon", por exemplo. E esses apresentam o valor adicional do produto sanduíche, que é o principal; e adicionar valor no item final.
• Observação de preparo: entende-se que devem ser listadas todas as observações de preparo vinculadas no cadastro de produto do AutoSystem para o produto composto. Há também um campo de texto livre na Comanda para que possa ser lançada qualquer outra observação que não se tenha cadastro. Essas observações são impressas na cozinha e KDS, assim como os demais itens já mapeados, local, produtos etc.

Veja mais informações sobre produto composto:

• Ao confirmar a inserção do produto composto, os complementos são adicionados separadamente ao carrinho;
• Ao informar que deseja inserir um complemento, a seleção de quantidade fica liberada;
• Todas as observações que descem no produto composto ficam disponíveis para visualização durante o fluxo de inserção do item; as padrões, por sua vez, são marcadas como default (padrão), mas podem ser desmarcadas se o Operador quiser;
• Os itens mapeados como composição opcional não tem seleção de quantidade e obedecem a quantidade inserida dentro do item; e as que não forem marcadas são retiradas da lista antes da inserção no carrinho.

10. Kit variável

Para a venda de kit de produtos variáveis, foi mantida a funcionalidade que já existe no Smart Order. Porém, para o AutoSystem, foi implementada uma rotina no serviço de integração.

Ao selecionar um produto kit variável, são apresentados os seguintes fluxos:

11. Lançamento de produtos na Comanda

• O serviço registra os produtos na Comanda, independentemente do seu tipo. Ao concluir a montagem de um produto composto, são considerados os complementos, sendo registrado como adicional nas Comandas por serem cobrados. Também é registrado todo o lançamento de observação de preparo que está vinculado ao produto, mantendo isso na impressão da cozinha (caso configurado);
• Permanece, também, o registro de composição dos produtos na Comanda;
• Ao concluir a seleção de produto na montagem do kit, o serviço registra o produto na Comanda e seus respectivos produtos selecionados em todas as etapas.

11.1 Botão "Atendimentos"

• Ao clicar nesse botão, é carregada a lista de Comandas que estão em atendimento no momento. Nessa listagem, cada Comanda possui o status de Aberta ou Pré-fechamento. Ao acessar a guia Atendimentos, é apresentada a lista de Comandas com esses status;
• Ao selecionar uma Comanda da guia, é exibido o detalhamento da Comanda com o local e todos os itens adicionados, com vendedor e observação, preço unitário, total etc.;
• Para o sistema de Retaguarda AutoSystem, através de uma configuração, a guia de pedidos que fica dentro do menu de Atendimentos, deixando visível apenas a guia Comandas. Veja a imagem de exemplo:

12. Cancelamento de Comanda em aberto

Ao visualizar o detalhamento de uma Comanda, é possível fazer o seu cancelamento. Para isso, há uma validação de usuário que é feita ao acessar o menu. Caso o Operador tenha permissão, ele pode cancelar a Comanda, onde é apresentada uma mensagem informando que a Comanda foi cancelada. Caso o Operador não tenha permissão, é aberta uma tela para inserir o usuário com permissão para essa rotina.

13. Edição de Comanda

Ao visualizar o detalhamento de uma Comanda, é possível editá-la, podendo alterar a quantidade de produtos ou, até mesmo, fazer a exclusão de um ou mais itens.

14. Exclusão de produtos da Comanda

Para o AutoSystem, é utilizada a permissão Permite cancelar itens da comanda, onde trata o fluxo sempre na rotina de cancelamento e não faz a exclusão do produto, conforme realizado no Seller.

15. Pré-fechamento

Ao visualizar o detalhamento de uma Comanda, é possível fazer o pré-fechamento dela no próprio app. Para isso, no Smart Order há o botão Pré-fechamento, que envia as informações pelo serviço de comunicação do AutoSystem. Também é possível fazer a reabertura da Comanda com o pré-fechamento já feito.

16. Liberação emergencial

O serviço do AutoSystem entende que uma Comanda pode ser liberada a saída de uma pessoa de forma emergencial através do botão Liberação, encontrado na tela inicial do Smart Order.

Ao acessar essa tela, são listadas todas as Comandas abertas ou com consumo e, ao selecionar a Comanda, o app solicita ao serviço a liberação na catraca da Comanda. O consumo vinculado à Comanda continua ativo junto com o status da comanda e se mantém inalterado, permitindo que, em caso de alguma urgência ou emergência, o cliente possa sair e o consumo fique pendente de pagamento no PDV posteriormente.

17. Inclusão de gorjeta/taxa de serviço

No Smart Order e no gerenciamento de Comanda do SmartPOS, ao ser realizado o pré-fechamento de uma Comanda, é verificada a existência de configuração de gorjeta. Estando habilitado e existindo o cadastro de um produto gorjeta, é lançado automaticamente esse produto na Comanda.

18. Transferência de Comanda

É possível realizar a transferência de produtos entre as Comandas. Pode-se transferir todos os produtos, bem como apenas alguns. Para isso, há a permissão Permite realizar transferência.

Se, em caso de uma Comanda já ter o pré-fechamento realizado e tiver algum registro de gorjeta, isso também é considerado no cálculo e nas transferências.

Nesta função de transferência:

• É permitida a múltipla seleção de itens para transferência entre Comandas;
• Ao confirmar que deseja fazer a transferência, é apresentado em uma lista os itens que serão transferidos.

19. Lotes de Comanda vinculados ao Terminal

Ao vincular um cadastro de lotes de Comandas no AutoSystem, na tentativa de lançar uma Comanda ou realizar a leitura dela pela câmera, essa Comanda irá estar dentro deste lote vinculado.