====== FoodsMobile — Guia de operação ======

//Gestão de pedidos para restaurantes direto na maquininha Stone ou smartphone Android.//

O **FoodsMobile** (Ello Foods) é o aplicativo que roda na maquininha **Stone** ou em smartphones Android e permite lançar e fechar pedidos sem precisar de outro equipamento. Ele atende três formas de operação — **Mesa**, **Ficha** e **Cartão de consumo** — e aceita pagamento em **PIX**, **Crédito/Débito**, **Dinheiro** e **Outros**, podendo ainda emitir **NFC-e** ao final.

> Esta página é o guia de uso diário. Para a configuração inicial (parâmetros no ERP e configurações do dispositivo), veja [[ello_foods_mobile:configuracao|Configuração]]. Para a instalação técnica (usuário e permissões), veja [[ello_foods_mobile:instalacao|Instalação]]. Para o cadastro de pizzas (tamanhos, sabores, massas e bordas), veja [[ello_erp:modulos:foods:pizzas|Cadastro de Pizzas]].

===== Visão geral do fluxo =====

Do login à venda finalizada, em cinco passos:

  - **Login** — usuário e senha do operador.
  - **Modo Mesa** — selecionar uma mesa livre no grid.
  - **Pedido** — lançar produtos, complementos e sabores.
  - **Fechamento** — escolher a forma de pagamento.
  - **Comprovante** — NFC-e e/ou extrato impresso.

> No **Modo Ficha**, em vez de mesas, o operador seleciona os itens, confere e fatura; cada item adicionado é impresso em uma ficha separada. Veja a seção [[#modo_ficha|Modo Ficha]].

===== Passo 1 — Login =====

Tela de entrada com as credenciais cadastradas nas [[ello_foods_mobile:configuracao|Configurações]].

{{:foods:mobile:fmstone_login.png?360|Tela de login}}

  * O app valida usuário e senha no servidor configurado.
  * Após entrar, o operador vai direto para o modo escolhido (Mesa, Ficha ou Cartão).
  * O botão **Entrar** só responde quando os dois campos estão preenchidos.

===== Passo 2 — Modo Mesa (grid de mesas) =====

Lista todas as mesas do salão; as cores mostram o status em tempo real.

{{:foods:mobile:fmstone_grid_mesas.png?360|Grid de mesas}}

^ Cor ^ Significado ^
| Cinza | Mesa livre — pode abrir um novo pedido |
| Laranja | Mesa ocupada — toque para ver os itens lançados |
| Cinza escuro | Mesa desativada no cadastro ou aguardando conferência |
| Azul escuro | Pagamento parcial — ainda há saldo em aberto |

  * O campo **"Ir para mesa nº"** salta direto para a mesa sem rolar o grid.
  * Para atualizar o status, puxe a lista para baixo (o app busca os dados no servidor).

===== Passo 3 — Pedido (comanda) =====

Tela do pedido vinculado à mesa. Lista os itens, calcula serviço e couvert.

{{:foods:mobile:fmstone_comanda.png?360|Comanda da mesa}}

  * O cabeçalho mostra o número da comanda e a quantidade de ocupantes.
  * Cada linha exibe quantidade, descrição e valor total do item.
  * O painel inferior consolida produtos, serviço (10%), couvert, valor pago e desconto.
  * **Adicionar Item** abre o catálogo (grupos, produtos, sabores e complementos).
  * **Faturar** leva à escolha da forma de pagamento.

==== Lista de produtos ====

{{:foods:mobile:fmstone_lista_produtos.png?360|Lista de produtos}}

  * Selecione o produto percorrendo a lista.
  * No campo **"Pesquisar produto"** dá para digitar a descrição ou o código do produto para filtrar a lista.

==== Edição do item ====

{{:foods:mobile:fmstone_edicao_item.png?360|Edição do item}}

  * Aumente ou diminua a quantidade.
  * Inclua sabores e complementos.
  * **Adicionar e enviar** — inclui o item no pedido e já envia a comanda para a cozinha.
  * **Adicionar ao pedido** — inclui apenas em uma lista, para conferir e enviar depois.
  * **Voltar** — retorna para a lista de produtos.

Ao montar o pedido para conferência, a tela mostra todos os itens com a quantidade ajustável antes do envio:

{{:foods:mobile:fmstone_itens_pedido.png?360|Itens do pedido para conferência}}

Ao enviar, o app pergunta se deseja conferir os itens antes (na conferência é possível excluir um item):

{{:foods:mobile:fmstone_conferir_itens.png?360|Confirmação antes de enviar}}

==== Lançamento de pizza ====

Para produtos do tipo pizza, o app monta o item escolhendo massa, borda e sabores conforme o limite de sabores do tamanho.

{{:foods:mobile:fmstone_pizza.png?360|Lançamento de pizza}}

> O que aparece aqui (tamanhos, sabores, massas e bordas) vem do [[ello_erp:modulos:foods:pizzas|Cadastro de Pizzas]] no ERP.

===== Passo 4 — Faturamento =====

Tela final do fluxo. Exibe o valor total e os botões de cada forma de pagamento.

{{:foods:mobile:fmstone_faturamento.png?360|Tela de faturamento}}

  * **Crédito / Débito** — abre o aplicativo da Stone para o pagamento.
  * **PIX** — gera um QR Code pela Stone para o cliente escanear.
  * **Dinheiro** — registra o recebimento manual, com cálculo de troco.
  * **Outros** — vouchers, ticket alimentação e formas semelhantes.
  * **Pagamentos parciais** somam-se ao total já pago; o saldo restante aparece no topo.

==== Pagamento via PIX ====

{{:foods:mobile:fmstone_pix.png?360|Pagamento via PIX}}

  * O app aciona a Stone com o valor da comanda e a Stone gera o QR Code.
  * O cliente escaneia com o app do banco e confirma o pagamento.
  * A Stone devolve o resultado ao app, que marca o pagamento como aprovado.
  * Se a internet cair, o pagamento fica salvo no aparelho e é reenviado automaticamente quando a conexão voltar.
  * Após a aprovação, segue para a impressão do comprovante e/ou NFC-e.

==== Pagamento em Cartão (Crédito/Débito) ====

{{:foods:mobile:fmstone_cartao.png?360|Pagamento em cartão}}

  * Fluxo padrão da Stone para crédito e débito.
  * A Stone assume o pagamento; o app fica aguardando o retorno.
  * **Pagamento parcial** — se o operador informar um valor menor que o total, a mesa volta para o grid em status "parcial" (azul escuro), com o saldo em aberto.
  * Após o retorno, o app imprime o comprovante.
  * Cancelamentos são feitos pelo fluxo de cancelamento da Stone.

==== Impressão do comprovante ====

{{:foods:mobile:fmstone_comprovante.png?360|Comprovante}}

  * A via do estabelecimento é impressa automaticamente; a via do cliente é impressa ao tocar no botão.

==== Impressão do extrato ====

{{:foods:mobile:fmstone_extrato.png?360|Extrato}}

==== Impressão da NFC-e ====

{{:foods:mobile:fmstone_nfce.png?360|NFC-e}}

  * Sai automaticamente quando a emissão automática de NFC-e está ligada nos [[ello_foods_mobile:configuracao|parâmetros do ERP]].

===== Modo Ficha =====

Fluxo alternativo: em vez de selecionar uma mesa, o operador seleciona os produtos da ficha física que será entregue ao cliente. Útil em lanchonetes, padarias, eventos e operações de balcão sem lugar fixo.

==== Abrir / lançar itens ====

{{:foods:mobile:fmstone_ficha_abrir.png?360|Abertura da ficha}}

  * Ao confirmar, abre a mesma tela de Pedido, permitindo o faturamento.

==== Pedido (carrinho) ====

{{:foods:mobile:fmstone_ficha_pedido.png?360|Pedido no modo Ficha}}

  * Usa o mesmo motor da comanda de mesa, adicionando os itens a um carrinho.
  * O topo mostra o carrinho com a quantidade de itens adicionados.
  * Os grupos do cardápio aparecem para tocar e listar os produtos.
  * Cada toque no item soma +1 na quantidade.
  * Ao voltar, aparece a tela de grupos com o carrinho no topo para conferência.
  * O botão **Enviar** pergunta se deseja conferir; na conferência é possível excluir itens. Em seguida, segue o mesmo fluxo de pagamento (PIX/Cartão/Dinheiro).

==== Fechamento ====

{{:foods:mobile:fmstone_ficha_fechamento.png?360|Fechamento da ficha}}

  * Encerramento da ficha após a confirmação do pagamento pela Stone.
  * Resumo financeiro: subtotal, serviço e total efetivamente pago.
  * No modo Ficha a **NFC-e fica bloqueada** (regra do estabelecimento).
  * O pagamento é gravado no aparelho mesmo sem internet e reenviado ao servidor quando a rede voltar.

===== Notas de instalação e atualização =====

  * O serviço de integração do Foods foi refeito. Para funcionar corretamente, **remova a versão já instalada antes de instalar a nova**.
  * O arquivo de configuração permanece o mesmo da versão anterior.

===== Informações da versão =====

  * **Versão:** 26.5.22
  * **Compatibilidade:** Android 7.1 ou superior.