Impressão e offline

Por que o pedido offline não imprime duas vezes

Cair a internet no meio do serviço já é ruim o bastante; descobrir depois que a cozinha preparou o mesmo prato duas vezes seria pior. Por isso o pedido que você lança sem internet carrega uma identidade própria desde o primeiro segundo, e a nuvem respeita essa identidade quando a conexão volta.

Atualizado em 21 de setembro de 2026 5 min de leitura Para: donos e garçons
Resposta rápida

Fique tranquilo: cada pedido offline nasce com uma chave única, criada pelo agente de impressão no momento em que a comanda sai na impressora. Quando a internet volta, a nuvem compara essa chave com o que já tem. Se ela se repete, o pedido é reconhecido como o mesmo e nada é impresso de novo.

O que é um pedido offline

Pedido offline é o pedido que a sua equipe lança quando a internet do restaurante caiu. Ele não passa pela nuvem: quem atende é o agente de impressão, o programa que roda num computador, num Raspberry ou num celular Android dentro da casa, na mesma rede da impressora térmica. O agente serve uma página local pelo Wi-Fi do restaurante, imprime a comanda na hora e guarda o pedido numa fila no próprio aparelho.

A chave única nasce junto com o pedido, dentro do agente: um código aleatório que não se repete e que fica colado naquele pedido pra sempre. Ele vai junto na fila e vai junto em toda tentativa de envio. Quando a conexão volta, a primeira coisa que o qmen.us faz é procurar se aquele restaurante já tem um pedido com aquela chave. Se já tem, responde duplicado e não cria nada. Se não tem, cria o pedido já marcado como impresso na cozinha, e não gera impressão nenhuma pra ele.

Por que uma comanda só, sempre

  • A comanda de papel é uma só. Quem imprime durante a queda é o agente, ali na cozinha. Na sincronização a nuvem cria o pedido sem nenhum trabalho de impressão junto, então não existe segunda via saindo do nada meia hora depois.
  • Reenviar é seguro. O agente só risca o pedido da fila quando a nuvem confirma. Se a resposta se perde no caminho, ele tenta de novo, a nuvem responde duplicado e o agente aceita isso como confirmação. Pedido repetido na fila não vira pedido repetido na cozinha.
  • Quem garante é o banco de dados. A regra de chave única vale pro restaurante inteiro: mesmo que dois envios cheguem no mesmo instante, só um vira pedido.
  • O pedido chega com a história certa. A hora que entra é a hora em que o garçom lançou, não a hora da sincronização, e o preço é o que estava no cardápio salvo naquele momento: a nuvem não recalcula nada.

Como funciona sem internet, em 7 passos

São sete passos, da faixa de aviso no celular até o pedido aparecendo na Cozinha sem uma segunda comanda no papel.

  1. Reconheça que a internet caiu

    No app do garçom aparece uma faixa no topo: Sem internet — toque para abrir o modo offline. Se a página não abrir mais, o celular mostra a tela Sem internet com o botão Abrir modo offline. Os dois levam pro mesmo lugar: a página local do agente.

  2. Abra a página local do agente

    É um endereço da rede do restaurante, do tipo http://192.168.0.50:8765/, aberto no navegador do celular — não tem app de loja pra instalar. O topo mostra qmen.us — modo offline (sem internet). Se aparecer um aviso de cardápio não salvo, é porque aquele aparelho nunca sincronizou o Cardápio; ele precisa ter estado online pelo menos uma vez.

  3. Escolha o garçom e a mesa

    A página abre com Garçom, Mesa, Nome do pedido (opcional) e PIN, se a casa usa um. Toque em Começar. As listas vêm do Cardápio salvo na última sincronização, com categorias, tamanhos e sabores.

  4. Monte o pedido e toque em Enviar e imprimir

    Toque nos itens, ajuste quantidade e observação em Ver pedido e finalize em Enviar e imprimir. A comanda sai na impressora da praça na hora e a tela confirma com o número local do pedido, no formato OFF-1, OFF-2, OFF-3. Esse número é do agente, pra equipe se achar enquanto está sem internet.

    Dica: Se a impressão falhar, a página avisa e o pedido não entra na fila. É de propósito: melhor repetir o lançamento do que mandar pra nuvem um pedido que ninguém viu no papel.
  5. Deixe a chave única fazer o trabalho

    No instante em que a comanda imprime, o pedido entra na fila local com a chave dele. A fila fica gravada no aparelho, então pode faltar luz, o navegador do celular fechar ou o agente reiniciar: a chave continua lá, do mesmo jeito.

  6. Espere a internet voltar

    O agente tenta se conectar a cada poucos segundos, sozinho. Assim que a conexão volta, ele manda a fila inteira de uma vez e atualiza o Cardápio salvo. Ninguém precisa apertar nada nem lembrar de sincronizar no fim do expediente.

  7. Confira na Cozinha e no painel

    Cada pedido aceito aparece na hora no Monitor da praça, na Mesa do cliente e no painel do dono, com os itens já enviados. O que você não vai ver é papel saindo de novo: esses pedidos entram marcados como já impressos e o qmen.us não manda nada pra impressora.

Perguntas frequentes

E se o agente enviar o mesmo pedido duas vezes?+

A nuvem responde duplicado e devolve o número do pedido que já existe, sem criar nada e sem imprimir. O agente entende isso como confirmação e tira o pedido da fila.

O pedido feito sem internet imprime de novo quando sincroniza?+

Não. A comanda já saiu na cozinha pelo agente, então o pedido é criado na nuvem sem nenhum trabalho de impressão junto. Só um envio novo, feito pelo garçom depois que a internet voltou, gera papel novo.

Um pedido ficou parado na fila. O que houve?+

A nuvem recusa quando não reconhece a Mesa ou o garçom do pedido, por exemplo se a mesa foi desativada ou o garçom removido enquanto a casa estava sem internet. O pedido não some: ele continua na fila e volta a ser tentado. Recrie a mesa ou o garçom com o mesmo código e ele entra.

A mesa já tinha comanda aberta. Os itens se misturam?+

Não. O pedido entra como um pedido separado naquela Mesa, do lado do que já estava aberto. Nada é sobrescrito e nenhum item é descartado.

O preço mudou enquanto a gente estava sem internet. Qual vale?+

Vale o preço que estava no Cardápio salvo no aparelho na hora do lançamento, igual ao que saiu na comanda. A nuvem não recalcula o valor do que veio pela fila.

Preciso conferir alguma coisa quando a internet volta?+

Não precisa fazer nada pra sincronizar. Vale só uma olhada no painel pra ver os pedidos daquele período aparecendo nas mesas certas.

Glossário

Modo offline
Bloco de configuração do agente que faz ele servir uma página local de pedidos e guardar uma fila enquanto o restaurante está sem internet.
Agente de impressão
O programinha que roda no aparelho da cozinha, busca as comandas no qmen.us, imprime na térmica e confirma.
Página local do agente
Endereço na rede do restaurante, do tipo http://192.168.0.50:8765/, que abre no navegador do celular e faz as vezes do app do garçom enquanto não há internet.
Chave única do pedido
Código aleatório que o agente cria pra cada pedido feito sem internet. É por ele que a nuvem reconhece um pedido que já entrou e não imprime de novo.
Fila do agente
Lista de pedidos guardada no próprio aparelho do restaurante, que só é riscada quando a nuvem confirma o recebimento.

Recursos relacionados

Ainda precisa de ajuda?

Se o passo a passo não resolveu, manda a dúvida com o nome do restaurante. A gente responde em até um dia útil.

Ponha a sua casa no qmen.us e não dependa da internet pra servir

Crie a conta com o Google, monte o cardápio e coloque o primeiro pedido pra rodar hoje mesmo.

Começar agora