Módulo Restaurante

O que é o módulo Restaurante

O módulo Restaurante é uma solução completa para operação em salão, bar e lanchonete. Ele é independente dos módulos PDV, Vendas e Delivery — aqui tratamos apenas da gestão da operação do restaurante em si.

O módulo cobre cinco pilares:

• Mesas e ambientes — grid visual, status em tempo real, chamadas de garçom.
• Cardápio digital — categorias, itens, adicionais, personalizações, combos, promoções.
• Atendimento — apps de garçom e tablet na mesa, autoatendimento.
• Cozinha (KDS) — tela de pedidos em tempo real por setor.
• Fila de espera — com IA vendedora que sugere aperitivos enquanto o cliente aguarda.

Como acessar

No menu lateral, acesse Restaurante → Mesas (ou qualquer um dos subitens: Cardápio, KDS, Fila de Espera, Atendimento, Configurações). Rota: /restaurante.

No menu principal, entre em Restaurante. As páginas disponíveis são:

• /restaurante/mesas — grid de mesas com status.
• /restaurante/cardapio — gestão do cardápio.
• /restaurante/receitas — receitas e custo dos pratos.
• /restaurante/personalizacoes — grupos de escolhas e adicionais.
• /restaurante/promocoes — ofertas do cardápio.
• /restaurante/comandas-fisicas — comandas com QR Code.
• /restaurante/atendimento — dispositivos de garçom e tablet.
• /restaurante/kds — telas de cozinha.
• /restaurante/fila-espera — fila e painel de TV.
• /restaurante/alertas — alertas de custo e disponibilidade.
• /restaurante/relatorios — vendas, CMV, mesas abertas.
• /restaurante/configuracoes — ajustes do módulo.
• /restaurante/sobre — página institucional pública.

Mesas e ambientes

O grid de mesas é o ponto central da operação. Cada mesa tem número, nome, capacidade, área (Salão, Varanda, VIP) e um status atualizado em tempo real via Socket.IO.

Status possíveis

Chamadas e notificações

Os botões Chamar garçom e Pedir conta (habilitados por configuração) disparam notificações em tempo real para todos os garçons conectados. Um sino no topo do ERP registra cada chamada para auditoria posterior.

Dispositivos vinculados à mesa

Cada mesa pode ter um tablet vinculado por um token único. Existe também um token público para o chat de IA no celular do cliente, acessado pelo QR Code da mesa. Quando a mesa muda de Livre para Ocupada, o token de IA é renovado — isso garante que a sessão anterior não possa ser reaberta.

Cardápio

O cardápio do restaurante é uma curadoria sobre o cadastro de produtos. Você escolhe quais produtos aparecem no cardápio, com foto, nome de exibição e descrição própria.

Categorias do cardápio

As categorias do cardápio são independentes das categorias dos produtos. Cada categoria tem nome, ícone, cor, imagem de capa, ordem e pode ser vinculada a um setor de produção (Bar, Cozinha, Confeitaria) — o que determina para qual KDS o item será enviado.

Itens do cardápio

• Tipos — revenda (sem receita), preparo (receita simples) ou prato (receita com personalização).
• Campos — nome de exibição, descrição, imagem, disponível, em destaque, ordem.
• Disponibilidade por horário — defina dias da semana e turnos em que o item aparece.
• Setor de produção — sobrescreve o setor da categoria, se necessário.

Combos

Combos são itens compostos por outros itens, com preço próprio ou calculado pela soma. Montados em /restaurante/cardapio/combo/novo.

Adicionais e personalizações

• Adicionais — extras pagos (bacon, queijo, molho extra) agrupados (Extras, Acompanhamentos, Molhos).
• Grupos de personalização — escolhas sem custo ou obrigatórias (Ponto da carne, Tamanho, Tipo de pão). Cada grupo tem várias opções.

Promoções

O módulo de promoções permite criar descontos por item, categoria ou período, com regras de ativação. Promoções ativas aparecem marcadas no cardápio.

Receitas e CMV

Cada prato pode ter uma receita com ingredientes e quantidades. A partir dela o sistema calcula o custo, a margem e o CMV. O modo de precificação pode ser markup composto (recomendado) ou custo detalhado com despesas fixas e variáveis configuráveis.

Comanda da mesa

A comanda é o documento que agrupa os itens pedidos na mesa. O fluxo pode ser automático — a comanda é criada quando o garçom toca na mesa — ou manual, informando um número.

Lançamento de itens

Para cada item o garçom informa quantidade, observação livre ("sem cebola", "bem passado") e as personalizações escolhidas. Os itens são enviados para a cozinha imediatamente.

Transferência entre mesas

É possível mover um item de uma comanda para outra (por exemplo, quando alguém muda de mesa). Também é possível mesclar duas comandas completas em uma só.

Divisão de conta

O módulo suporta três modos de divisão:

• Dividir item por valor — um prato de R$ 100 pode virar R$ 60 numa comanda e R$ 40 em outra.
• Dividir comanda igual — rateia proporcionalmente os itens entre N pessoas, criando comandas secundárias.
• Mesclar comandas — une duas comandas em uma só.

KDS — Kitchen Display System

O KDS é a tela de cozinha em tempo real. Cada setor de produção (Cozinha, Bar, Confeitaria) pode ter seu próprio monitor.

Cadastro e ativação

Um dispositivo KDS é cadastrado em /restaurante/kds. Para ativar, gere um código de ativação válido por 10 minutos e digite-o na tela do KDS. O dispositivo recebe um token de longa duração e passa a receber os pedidos.

Operação

• Itens aparecem na tela assim que são lançados, agrupados por comanda ou setor.
• Cores indicam o status: aguardando, preparando, pronto.
• O tempo decorrido de cada item é exibido, com alerta visual configurável (padrão 15 minutos).
• O operador da cozinha toca para marcar como preparando e depois pronto.
• Quando um item fica pronto, o garçom vê no app um aviso para entrega.

Sincronização com iFood

Quando a configuração Sincronização cozinha do iFood está como automática, o sistema marca o pedido iFood como pronto para retirada assim que o último item fica pronto no KDS.

Atendimento — apps de garçom e tablet na mesa

O módulo suporta dois tipos de dispositivo:

• Garçom — app usado pelo garçom para atender várias mesas.
• Mesa (cliente) — tablet fixo na mesa para autoatendimento.
• TV de fila de espera — monitor público com a fila.

Em ambos os casos o fluxo é o mesmo da ativação do KDS: código temporário + token de longa duração.

Fluxo típico do garçom

1. Abre o app, vê o grid de mesas.
2. Toca em uma mesa — a comanda abre automaticamente (se a configuração estiver ativa).
3. Seleciona itens do cardápio, adiciona observações e personalizações.
4. Envia o pedido, que vai direto para o KDS.
5. Quando um item fica pronto, o app sinaliza e o garçom registra a entrega.
6. Cliente pede a conta — status muda, o caixa é acionado.

Autoatendimento no tablet

No modo mesa, o cliente navega pelo cardápio, monta o próprio pedido e envia direto para a cozinha. Configurações permitem mostrar valores, símbolo de moeda, totalizador do carrinho e mensagem de fechamento personalizada. Um PIN opcional permite a troca de mesa.

Conferência de mesa e emissão fiscal (PAF-NFCe Requisito XII)

No Bunto, o fechamento fiscal do restaurante é feito por Conferência de Mesa, em conformidade com o Ato DIAT 038/2020, Anexo III, Requisito XII.

Como funciona

1. O garçom ou o caixa gera a conferência — um snapshot imutável dos itens e valores da(s) comanda(s) da mesa.
2. Cada conferência recebe um número sequencial próprio, que nunca se repete.
3. O documento é apresentado ao cliente com o aviso oficial "AGUARDE A EMISSÃO DO DOCUMENTO FISCAL".
4. Após aprovação, o sistema cria um pedido de venda com o tipo fiscal conta e emite a NFC-e.
5. A conferência fica vinculada à chave da NFC-e e não pode ser excluída — é um registro permanente, exigido pelo período prescricional.

O tipo fiscal padrão do restaurante é Conta (Requisito XII), mas o módulo também suporta Pré-venda (Req III) e DAV (Req IV) quando necessário.

Fila de espera

A fila de espera gerencia clientes que aguardam mesa. Cada entrada tem nome, telefone, e-mail, quantidade de pessoas, observações e preferência de área (interna, externa, qualquer).

Fluxo

1. O cliente entra na fila e recebe um código único para acompanhar a posição pelo celular (/fila-espera/[código]/publica).
2. O sistema calcula o tempo estimado com base na posição e no tempo médio de mesa.
3. Quando há mesa compatível (quantidade e área), o gerente chama o próximo, manualmente ou em modo automático.
4. Ao chegar, o cliente é sentado e a comanda é aberta automaticamente.
5. Quem não se apresenta dentro do tempo limite é marcado como no-show.

Painel de TV e painel público

O painel de TV exibe quem está sendo chamado e os próximos da fila. A página pública permite que o cliente acompanhe a posição no celular, receba notificações por e-mail e SMS, e até desista da fila.

Consumo durante a espera

Se a configuração Consumo habilitado está ativa, o cliente pode pedir aperitivos e bebidas enquanto espera — os itens ficam numa comanda temporária.

IA vendedora

Após um tempo mínimo na fila (configurável), a IA vendedora entra em ação. Ela sugere itens de categorias pré-definidas (aperitivos, bebidas, entradas) no chat com o cliente. Quando o cliente aceita, o item vai direto para o carrinho.

Chat de IA na mesa

Cada mesa tem um token público que, lido por QR Code no celular do cliente, abre um chat de IA personalizado. O cliente pode perguntar sobre o cardápio, receber recomendações, ver detalhes de pratos e — se a configuração permitir — montar o próprio pedido pelo chat. A sessão dura apenas enquanto a mesa está ocupada; ao liberar a mesa o histórico é apagado, atendendo à LGPD.

O assistente do garçom também usa IA para sugerir combinações, upsell e alternativas, diretamente no app.

Comanda física com QR Code

Para operações que ainda usam comanda de papel, o módulo oferece comandas físicas com QR Code únicos. Cada comanda tem um número, um UUID e um QR Code que, ao ser lido pelo garçom, abre a comanda correta no app — eliminando erros de digitação.

O design das comandas (cores, logo, tamanho) é configurável, e a impressão pode ser feita em lote.

Integração com iFood

A integração com iFood, quando ativa, permite:

• Sincronizar o cardápio do Bunto para o iFood.
• Receber pedidos automaticamente com som de alerta.
• Confirmar pedidos manualmente ou após tempo máximo.
• Emitir NFC-e (automática, manual ou em lote).
• Importar financeiro (taxas, comissões, repasses) em categorias específicas.
• Sincronizar horários de funcionamento.
• Atualizar status da cozinha automaticamente (readyToPickup).

Toda configuração do iFood está centralizada em Configurações do Restaurante, incluindo intermediador fiscal, categorias financeiras, caixa, forma de recebimento, cliente padrão e impressora.

Configurações do módulo

A tela Configurações do Restaurante reúne todos os ajustes do módulo. Os principais grupos:

Atendimento

• Modo cliente e modo garçom habilitados.
• Botões de chamar garçom e pedir conta.
• Tipo fiscal padrão (conta, pré-venda, DAV).
• Tempo de inatividade.
• Comanda automática ao tocar a mesa.
• Exibir valores e quantidades no grid.

Carrinho do cliente

• Mostrar ou ocultar a página de minha conta.
• Mostrar valores e símbolo de moeda.
• Totalizador no topo.
• Mensagem de fechamento customizável.
• Bloquear novos pedidos após pedir a conta.
• PIN de troca de mesa.

Cozinha

• Modo — nenhum, KDS ou impressão de ticket.
• Tempo de alerta para pedidos parados.
• Impressora de cozinha e de conferência.

Tema

• Tema do atendimento — claro, escuro ou automático.
• Idiomas do tablet.

Grade inicial do cardápio

• Filtro — destaques, mais vendidos ou categoria específica.
• Quantidade de itens.
• Imagens de fundo nas categorias.

Precificação e CMV

• Modo — markup composto ou custo detalhado.
• Meta de CMV.
• Percentuais de despesas fixas e variáveis.
• Margem de lucro desejada.
• Momento de abatimento do estoque — preparo, entrega ou fechamento.
• Recálculo automático quando ingrediente muda.
• Pratos estimados por mês (rateio).
• Dias de alerta de validade.

Inteligência Artificial

• Sugestões para o garçom.
• Chat de mesa (tablet e celular).
• Assistente do garçom.
• Alertas automáticos de custo.
• Provedor, modelo e prompt personalizado.
• Cidade para contexto climático.
• Cards interativos e pedido via chat.

Sobre o restaurante

• Nome, descrição, horários.
• Redes sociais, telefone, endereço.
• Galeria de imagens e imagem destaque.

Cardápio digital público

• Slug do restaurante para URL pública (/cardapio-publico/meu-restaurante).

Comanda física

• Design customizado — cores, logo, tamanho, texto de boas-vindas.

Fila de espera

• Tempo médio de mesa, timeout de chamado, chamada automática.
• Consumo habilitado.
• Máximo de pessoas.
• Canais e mensagens de notificação (e-mail, SMS).

IA vendedora na fila

• Tempo mínimo antes de sugerir.
• Categorias candidatas.
• Prompt personalizado.

iFood

• Sincronização de cardápio e horários.
• Auto-confirmar pedido e tempo máximo.
• Alerta sonoro.
• Tipo fiscal, intermediador, caixa, forma de recebimento.
• Categorias de receita, comissão e taxa.
• Cliente padrão e impressora.
• Modo de impressão e emissão de NFC-e.
• Sincronização da cozinha.

Integrações com outros módulos

Produtos

O cardápio é uma curadoria sobre os produtos do ERP. Preço, nome base e ficha técnica vêm do cadastro de produtos via serviço compartilhado.

Estoque

O consumo dos ingredientes é abatido automaticamente no estoque, no momento configurado (preparar, entregar ou fechar). Adicionais e personalizações também são computados. Itens cancelados geram estorno automático.

Vendas e PDV

O pedido da mesa vira um pedido de venda com tipo fiscal conta e contexto de mesa. O PDV e o módulo fiscal emitem a NFC-e a partir desse pedido.

Finanças

Pagamentos processados no caixa geram recebimentos e movimentações. Na integração com iFood, taxas, comissões e repasses caem automaticamente nas categorias configuradas.

Fiscal

A emissão de NFC-e usa a conferência de mesa como origem. Os arquivos PAF-NFCe (Req XII) são gerados com base nos registros do módulo.

Chat IA

O módulo consome provedor e modelo configurados no Chat IA, respeitando chaves e limites definidos centralmente.

Marketplaces (iFood)

Pedidos do iFood chegam ao restaurante e seguem o mesmo fluxo de KDS e emissão fiscal, com categorias financeiras próprias.

Delivery

Quando um item de pedido de delivery fica pronto no KDS, a entrega é automaticamente marcada como coletada no módulo Delivery.

Relatórios

Em Relatórios você encontra:

• Vendas por período.
• Produtos mais vendidos.
• CMV por período e por item.
• Horários de pico.
• Mesas abertas — relatório obrigatório do PAF-NFCe Req XII.
• Conciliação do iFood.
• Avaliações do restaurante (feedback do tablet).

Permissões

O módulo tem permissões específicas, separadas entre as disponíveis para vendedores (garçons) e as administrativas:

• Listar mesas — garçom.
• Visualizar mesa — garçom.
• Editar mesa — alterar status — garçom.
• Criar mesa — gerente.
• Excluir mesa — gerente.
• Gerenciar cardápio — gerente ou chef.
• Gerenciar configuração — administrador apenas.

Perguntas frequentes

Posso usar o módulo Restaurante sem iFood?

Sim. A integração com iFood é opcional. Todas as funcionalidades de salão, cardápio, KDS e conferência funcionam sem ela.

Como funciona a divisão igualitária da conta?

Você informa quantas pessoas dividem a conta. O sistema cria comandas secundárias e rateia proporcionalmente cada item. O resultado respeita centavos e garante que a soma das partes bate com o total original.

O estoque é abatido quando?

Depende da configuração Momento de abatimento: no preparo, na entrega ou no fechamento da mesa. Se um item for cancelado, o estoque é automaticamente devolvido.

Como libero uma mesa?

Após o pagamento, a mesa volta para o status Livre. Esse movimento invalida o token público de IA daquela mesa, garantindo que a próxima sessão de chat comece limpa.

Posso imprimir comandas com QR Code?

Sim. No menu Comandas Físicas você gera e imprime comandas com design customizado. O QR Code vincula automaticamente a comanda à mesa quando o garçom faz a leitura.

A conferência de mesa pode ser apagada?

Não. A conferência é um registro fiscal permanente (PAF-NFCe Req XII) e permanece no sistema pelo período prescricional. Quando há necessidade de correção, você ajusta a conferência, gerando uma nova com o vínculo à original.

Como a IA vendedora funciona na fila?

Após o cliente passar um tempo mínimo na fila, a IA inicia um chat com sugestões personalizadas das categorias configuradas. Se o cliente aceita, os itens vão para uma comanda temporária de consumo durante a espera.