HandyCafe Docs
cashier owner

Gerenciamento de Pedidos

Os pedidos no HandyCafe são usados para vender produtos (alimentos, bebidas, acessórios e quaisquer outros itens que sua lan house ou centro de jogos ofereça). O sistema de pedidos rastreia cada venda desde a criação até o pagamento ou cancelamento, com integração total ao relatório de caixa e rastreamento de turno do operador.


Ciclo de Vida do Pedido

Todo pedido segue um ciclo de vida direto:

Novo Pedido  -->  Aberto  -->  Fechado (pagamento recebido)
                    |
                    +---->  Cancelado (anulado)
  • Aberto: O pedido foi criado e pode ter itens adicionados. Está aguardando pagamento ou modificação.
  • Fechado: O pagamento foi recebido e registrado. Um registro de transação é criado no sistema. O pedido não pode ser modificado após o fechamento.
  • Cancelado: O pedido foi anulado. Nenhuma transação é criada. Pedidos cancelados permanecem no histórico para fins de auditoria mas não afetam cálculos de receita.

Visualização em Abas

A página de Pedidos organiza os pedidos em quatro abas:

Aba Exibe Badge
Abertos Pedidos ativos aguardando pagamento ou modificação Contagem de pedidos abertos
Fechados Pedidos concluídos com pagamento recebido Contagem de pedidos fechados
Cancelados Pedidos anulados Contagem de pedidos cancelados
Todos Todos os pedidos independente do status Contagem total de pedidos

Cada aba mostra um badge de contagem para que você possa ver rapidamente quantos pedidos estão em cada estado. A aba Abertos é a visualização padrão já que são os pedidos que precisam de atenção.


Criando um Novo Pedido

  1. Navegue até a página de Pedidos.
  2. Clique no botão Novo Pedido.
  3. Opcionalmente atribua o pedido a um PC específico selecionando um hostname ou endereço MAC. Isso vincula o pedido a uma estação específica, útil para rastrear entregas em assentos específicos.
  4. Opcionalmente adicione uma nota ao pedido (por exemplo, número da mesa, nome do cliente ou instruções especiais como "sem gelo" ou "extra açúcar").
  5. O pedido é criado no estado Aberto e pronto para receber itens.

Adicionando Itens a um Pedido

Uma vez criado o pedido:

  1. Buscar ou navegar produtos: Use a barra de busca para encontrar produtos por nome ou navegue pelo catálogo.
  2. Selecionar um produto: Clique no produto para adicioná-lo ao pedido.
  3. Definir quantidade: Ajuste a quantidade para cada item. O padrão é 1.
  4. Definir preço unitário: O preço unitário é preenchido do catálogo de produtos mas pode ser alterado por pedido se necessário (por exemplo, para um desconto especial ou promoção).

Você pode adicionar vários produtos diferentes a um único pedido. Cada item aparece como uma linha no pedido com sua própria quantidade e preço unitário.


Modificando Itens

Enquanto um pedido ainda está Aberto, você pode modificar seus itens:

  • Alterar quantidade: Aumentar ou diminuir a quantidade de qualquer item no pedido.
  • Alterar preço unitário: Sobrescrever o preço unitário para um item específico. Útil para aplicar descontos avulsos ou corrigir preços.
  • Remover itens: Remover um item completamente do pedido.

Uma vez que um pedido está Fechado ou Cancelado, seus itens não podem ser modificados.


Total do Pedido

O total do pedido é calculado automaticamente a partir de todos os itens:

Total da Linha = Quantidade x Preco Unitario
Total do Pedido = Soma de todos os Totais de Linha

Cada item de linha também rastreia:

  • Nome do produto: O nome do produto vendido.
  • Preço unitário: O preço por unidade no momento da venda.
  • Quantidade: Quantas unidades foram vendidas.
  • Imposto: Valor do imposto aplicável ao item, se configurado.
  • Descontos: Quaisquer descontos aplicados ao item de linha.
  • Total da linha: O valor final daquela linha (quantidade x preço unitário, ajustado por impostos e descontos).

O total do pedido atualiza em tempo real conforme você adiciona, remove ou modifica itens.


Fechando um Pedido

Quando o cliente está pronto para pagar:

  1. Revise os itens e o total do pedido.
  2. Clique no botão Fechar Pedido.
  3. Selecione o método de pagamento (dinheiro, cartão, pagamento digital, etc.). Os métodos de pagamento disponíveis são configurados nas opções do sistema.
  4. Confirme o pagamento.

Quando um pedido é fechado:

  • Um registro de transação é criado no sistema.
  • A transação é vinculada ao turno atual do operador.
  • A receita aparece no Relatório de Caixa.
  • O pedido muda para a aba Fechados e não pode mais ser modificado.

Cancelando um Pedido

Se um pedido precisa ser anulado:

  1. Selecione o pedido aberto.
  2. Clique no botão Cancelar.
  3. Confirme o cancelamento.

Quando um pedido é cancelado:

  • Nenhuma transação é criada.
  • O pedido muda para a aba Cancelados.
  • Permanece no sistema para fins de auditoria (você pode vê-lo na aba Todos e na aba Cancelados).
  • Pedidos cancelados não afetam cálculos de receita ou o Relatório de Caixa.

Exibição de Tempo

Os pedidos exibem marcas de tempo relativas para facilitar ver quão recentes são:

Tempo Exibição
Menos de 1 hora Minutos (por exemplo, "5m atrás")
1 a 24 horas Horas (por exemplo, "2h atrás")
Mais de 24 horas Dias (por exemplo, "1d atrás")

Isso facilita identificar pedidos que ficaram abertos por muito tempo e podem precisar de atenção.


Notificações de Pedidos (Pedidos Originados no Cliente)

Quando um cliente realiza um pedido pelo PC (usando o recurso de pedidos do aplicativo cliente):

  • Uma notificação aparece no aplicativo servidor com um alerta sonoro.
  • A notificação mostra os detalhes do pedido incluindo os itens solicitados e o PC de origem.
  • O operador pode aceitar o pedido e começar a prepará-lo.

Este recurso permite que clientes facao pedidos de alimentos e bebidas sem sair da estação, melhorando a experiência do cliente e reduzindo tempos de espera.


Permissões Necessárias

O gerenciamento de pedidos está disponível para operadores com as permissões apropriadas. A capacidade de criar, visualizar e gerenciar pedidos é controlada pelo sistema de funções de operador.

Proprietários (função Admin) sempre têm acesso total a todos os recursos de gerenciamento de pedidos.


Histórico de Pedidos e Relatórios

Todos os pedidos, sejam fechados ou cancelados, são armazenados no sistema e contribuem para relatórios:

  • Pedidos fechados aparecem no Relatório de Caixa como transações de receita.
  • Itens de pedido são rastreados individualmente, permitindo ver quais produtos vendem mais.
  • Atribuição ao operador: Cada pedido registra qual operador o criou e fechou, habilitando rastreamento de desempenho por operador.
  • O Relatório de Caixa pode filtrar transações por categoria para mostrar receita de pedidos separadamente da receita de sessões.