Manual de Produto — Sistema Space Food

1. Visão geral do produto

O Space Food é um ecossistema de gestão para estabelecimentos de alimentação composto por três experiências principais:

• Painel do estabelecimento (sistema principal): onde o lojista e sua equipe gerenciam todo o negócio — cardápio, pedidos, cozinha, financeiro, clientes, canais de venda, promoções, usuários e configurações.
• Cardápio Online (marketplace do consumidor): o cardápio digital próprio de cada estabelecimento, acessível por um link exclusivo, onde o cliente final faz pedidos de delivery e retirada.
• Aplicativo de impressão (Desktop): programa instalado no computador da loja que imprime automaticamente comandas, cupons e notas fiscais nas impressoras físicas.

Principais capacidades

• Gestão de múltiplos estabelecimentos sob uma única conta.
• PDV (ponto de venda) para atendimento de mesa, balcão, delivery e retirada.
• Cardápio digital próprio e integrações com iFood e WhatsApp.
• KDS (sistema de telas de cozinha) com roteamento por estação e disparo coordenado de itens.
• Controle financeiro completo: caixa, contas a pagar/receber, relatórios e notas fiscais.
• Controle de estoque (simples por unidade ou completo por ficha técnica de insumos).
• Promoções: cupons, campanhas de preço e programas de fidelidade (cashback e por itens).
• Controle de acesso por perfis e permissões.

Canais de venda suportados

2. Conta, login e estabelecimentos

2.1 Criação de conta (Cadastro)

Primeiro passo para usar o sistema. Após o cadastro, o usuário é direcionado à área de estabelecimentos para criar seu primeiro negócio.

Campos: Nome completo, E-mail (validado), Telefone (com máscara), Senha (mínimo 6 caracteres) e Confirmar senha. Ao criar a conta, o usuário aceita os Termos de Uso e a Política de Privacidade.

Existe também um fluxo de autocadastro para novos usuários de um estabelecimento existente (nome, e-mail, telefone, senha e confirmação).

2.2 Login

Autentica o usuário com E-mail e Senha. Mensagens de erro são exibidas no campo correspondente ("Usuário não encontrado", "Senha inválida"). A tela oferece os links "Esqueci minha senha" e "Registre-se".

2.3 Recuperação e alteração de senha

• Recuperar senha: o usuário informa o e-mail e recebe uma mensagem para redefinir a senha.
• Alterar senha: a partir do link recebido, define Nova senha (mínimo 6 caracteres) e Confirmação. Se as senhas divergirem, o sistema avisa ("As senhas estão diferentes").

2.4 Meus estabelecimentos (múltiplos negócios)

Um mesmo usuário pode gerenciar vários estabelecimentos em um só lugar. Cada estabelecimento aparece em um cartão com logo, nome fantasia, endereço resumido, selo "Ativo" e o perfil de acesso do usuário naquele negócio.

• Botão Acessar alterna o acesso para o estabelecimento escolhido.
• Botão Novo estabelecimento cria um novo negócio.
• Se o usuário ainda não possui nenhum estabelecimento, é levado diretamente à criação.

2.5 Criar estabelecimento

O cadastro inicia com um plano de teste gratuito de 7 dias (plano "Cozinheiro"), com a chamada "Experimente todas as funcionalidades sem nenhum custo durante 7 dias".

Tipo de pessoa: Pessoa Jurídica (PJ) ou Pessoa Física (PF).

• PJ: CNPJ (validado), Nome fantasia e Razão social.
• PF: CPF (validado) e Nome do estabelecimento.

Endereço: CEP (preenche rua, bairro, cidade e UF automaticamente), Rua, Número, Complemento, Bairro, Cidade e UF. O e-mail e o telefone do estabelecimento são reaproveitados da conta do usuário.

Conclui-se em Testar por 7 dias grátis. A logo e a identidade visual são definidas depois em Configurações → Tema.

3. Painel inicial (Dashboard)

Apresenta uma visão geral do desempenho do estabelecimento, com atualização automática (a cada 30 segundos no modo anual).

Indicadores (cartões):

• Produtos vendidos — total em produtos no período.
• Entregas realizadas — total em entregas no período.
• Ticket médio — valor médio por venda.
• Clientes — total de clientes cadastrados.

Gráfico de vendas: barras com o valor de vendas mês a mês. Filtro de período por Ano (seletor de ano) ou por Data (data início e fim).

Card de Marketplaces: mostra a situação dos canais de venda.

Controle de acesso: os indicadores financeiros e o gráfico dependem da permissão "Dashboard inicial"; sem ela, o usuário vê apenas o card de Marketplaces.

4. Cardápio: produtos, categorias, insumos e estoque

A área de Cardápio é o centro de gestão do que o restaurante vende. A área de Controle de Estoque divide-se em controle simplificado (por unidade) e completo (por insumos/ficha técnica). O acesso é regido por permissões (Gestão de produtos, Gestão de categorias, Listagem de categorias, Controle de estoque simples, Controle de estoque completo).

4.1 Categorias do cardápio

As categorias são as seções que organizam o cardápio (ex.: Entradas, Pizzas, Bebidas) e controlam onde e quando cada grupo aparece.

Campos ao cadastrar/editar:

• Nome (obrigatório).
• Posição (obrigatória): ordem de exibição; o sistema sugere a próxima posição livre e impede duplicidade.
• Marketplaces: canais em que a categoria estará disponível. Cada marketplace tem seu próprio cardápio, permitindo preços diferentes por canal. O iFood é canal exclusivo (ao selecioná-lo, oculta período de exibição e contextos).
• Modelo (definido na criação):
  • Itens principais — comidas, lanches, sobremesas (padrão).
  • Pizza — define tamanho, bordas e sabores.
  • Buffet por Kg — produtos vendidos por peso; disponível apenas no PDV.
• Período de exibição: horários por dia da semana (até 3 faixas por dia) em que a categoria fica visível. Apenas categorias dentro do horário aparecem para o cliente.
• Contextos: ambientes de venda em que a categoria aparece — Simples (Salão/Balcão), Delivery, Retirada, Mesa.

Ações sobre categorias: cadastrar produto, editar, excluir (digitando o nome para confirmar — remove a categoria e seus produtos), duplicar (copia com todos os produtos) e reordenar (arrastar e soltar). A tela de Cardápio permite visualização em Lista ou em Tabela.

4.2 Produtos

Ao iniciar o cadastro escolhe-se o tipo de produto, e o sistema apresenta um assistente em etapas específico:

Produto Preparado: Nome, Habilitar complementos (Sim/Não), Habilitar observação (Sim/Não), Preço, Preço sem desconto (preço "de"), Quantidade de pessoas servidas (N/A, 1 a 4), Detalhes e Imagem.

Produto Industrializado: localizado por código de barras; Nome, Marca, Código de barras, Preço, Preço sem desconto e Imagem.

Produto Pizza: Tamanho, Precificação (Maior preço / Preço dividido / Preço misto), quantidade de Sabores, Fatias, Máximo de adicionais, Massa obrigatória (Sim/Não), Borda obrigatória (Sim/Não) e Imagem. Os componentes (Massas, Bordas, Sabores, Adicionais) são cadastrados em abas próprias, cada um com nome, preço, preço sem desconto e imagem; sabores também têm detalhes e permitem alteração de preço em massa.

Produto por Peso (Buffet por Kg): Nome, Preço por Kg, opção Buffet livre (valor teto) — limita o valor máximo pago — e Imagem. Disponível apenas no PDV.

Combo: Nome, Preço base, Preço sem desconto, Quantidade de pessoas servidas, Detalhes e Imagem. Os produtos do combo são buscados e adicionados com quantidade e preço no combo (pode ser zero); ao adicionar, o sistema pergunta se deseja incluir o preço original e, em pizza/preparado, se deseja herdar os preços dos complementos. Itens podem ser configurados individualmente dentro do combo.

Ações sobre produtos: editar; excluir (digitando o nome); ativar/inativar (disponibilidade); copiar para outra categoria; atualizar preço; atualizar imagens em massa; criar item de complemento em massa. A visualização em tabela filtra por descrição, preço mínimo/máximo, marketplace e categoria.

4.3 Complementos, adicionais e variações

• Grupos de complementos: Nome, Preenchimento obrigatório (Sim/Não), Mínimo e Máximo de itens. Os grupos podem ser reordenados e copiados de outro produto.
• Itens de complemento: Descrição/Nome, Detalhes, Preço, Preço sem desconto, Ativo, Imagem e, opcionalmente, ficha técnica e processos de preparo (KDS). Permite alteração de preço em massa e criação de um item para vários produtos de uma vez.
• Variações de pizza: combinações de massa, borda, sabor e adicionais, conforme o modelo de precificação escolhido.

4.4 Vínculo com a cozinha (KDS)

Em cada produto (e em componentes de pizza e itens de complemento) há a etapa KDS:

• Estação KDS padrão: para onde o item é enviado quando não há processos de preparo.
• Tempo de preparo (min): de 1 a 120 minutos.
• Processos de preparo: etapas em múltiplas estações, para fluxos complexos.

A etapa pode aparecer desabilitada (quando o KDS está desligado) ou no modo Simples (quando o roteamento é por estação, não por produto). Ver capítulo 6.

4.5 Disponibilidade por canal e contexto

A disponibilidade de venda é definida em vários níveis: Marketplaces (canais, por categoria — cada canal com seu próprio preço), Contextos (Salão/Simples, Mesa, Retirada, Delivery), Período de exibição (horários por dia) e Status do produto (Ativo/Inativo).

4.6 Insumos (matérias-primas)

Gerenciados no controle de estoque completo. Cadastro: Nome, Unidade (Quilo/kg, Litro/L ou Item/Unidade — não pode ser alterada depois) e Quantidade inicial. Aceitam valores decimais (até 3 casas). Ações: editar, excluir (digitando "Excluir permanentemente"), reabastecer e consumir.

Ficha técnica (composição): define quais insumos e em que quantidade compõem um produto (ou sabor, borda, massa, item de complemento). É a base para a baixa automática de matérias-primas conforme as vendas.

4.7 Controle de estoque

Dois modos, escolhidos no cadastro do produto:

• Simplificado: controla a quantidade de unidades do próprio produto.
• Completo: controla pela ficha técnica (baixa dos insumos). Pizza é sempre completo; industrializado é sempre simplificado.

Também pode ficar Desabilitado.

Consumir e Reabastecer:

• Consumir reduz a quantidade (uso/venda/retirada).
• Reabastecer aumenta a quantidade (chegada de mercadoria).

Existem quatro variações: Consumir/Reabastecer Insumos (decimais; respeitam a unidade) e Consumir/Reabastecer Produtos (apenas inteiros). Em todas, o usuário vê em tempo real a quantidade atual, a movimentada e a final antes de confirmar.

4.8 Unidades de medida

Insumos usam Quilo (kg), Litro (L) ou Item (Unidade). Produtos do cardápio são sempre contados por unidade. A unidade do insumo é definida no cadastro e não pode ser alterada.

5. Pedidos, Operação e PDV

O módulo de Pedidos concentra a operação do caixa (PDV), o acompanhamento e gestão dos pedidos, o atendimento por chat e as configurações de entrega, pagamento, comandas e fluxo de trabalho. O menu organiza-se em PDV (tela de Operação), Conversas (atendimento por chat) e Operação (listagem e gestão dos pedidos).

5.1 Conceitos fundamentais

Tipos de pedido:

Status do pedido (cada um com cor própria): Aguardando confirmação, Em preparo, Em transporte, Concluído, Cancelado, Em andamento, Pronto para retirada, Em negociação, Aguardando resposta cliente.

Métodos de pagamento padrão: Dinheiro, Pix, Cartão, Débito, Crédito, Voucher, Refeição, Alimentação — além de métodos personalizados.

5.2 Tela de Operação (PDV)

Tela central para criar e fechar pedidos. Requer caixa aberto (com caixa fechado, a operação é bloqueada).

Fluxo de criação: escolher o tipo de pedido → vincular cliente (obrigatório em delivery/retirada) → informar dados específicos → adicionar produtos → aplicar cupons/fidelidade → escolher método de pagamento (e troco) → definir opções rápidas (nota, impressão, agendamento) → Concluir (F8) ou Salvar (F9).

• Mesa: seleção por teclado numérico ou pelo grid visual de mesas (estado disponível/ocupada). O número de mesas é definido nas configurações.
• Delivery: exige cliente e endereço; o frete é calculado automaticamente (pode ser sobrescrito); permite agendamento.
• Retirada: exige cliente; sem endereço/frete; permite agendamento.
• Simples: venda rápida; cliente opcional (necessário só para cupom/fidelidade).
• Pedidos não concluídos: lista os pedidos em aberto/salvos para retomada rápida.

5.3 Checkout (fechamento)

• Resumo de valores: total dos produtos, descontos/cupons, frete (delivery), taxa de serviço quando aplicável (ver 11.6).
• Método de pagamento: cards clicáveis; Dinheiro abre o cálculo de troco (valor recebido → troco válido/inválido); permite múltiplos pagamentos (pagamento parcial).
• Ações rápidas: IMPRIMIR (impressão automática ao concluir), NOTA (emissão de nota fiscal), AGENDAR (data/horário), CUPOM (painel de cupons), COMANDAS.
• Botões: Concluir (F8), Salvar (F9) e Dividir pagamento.

Taxa de serviço no checkout: quando há uma taxa de serviço configurada para o contexto do pedido (Simples ou Mesa), o resumo exibe a linha "Taxa de serviço (X%): R$ valor" com um botão Remover/Aplicar. A taxa entra automaticamente, mas o operador pode desligá-la ou religá-la naquele pedido — quando removida, a linha aparece riscada e o valor não é somado ao total. Detalhes da configuração no capítulo 11.

5.4 Divisão de conta e de pedido

Dividir pagamento (um pedido pago por várias pessoas), em três modos:

• Por quantidade de pessoas: divide o total igualmente.
• Por produtos selecionados: cada pessoa paga pelos itens que consumiu (em delivery, um pagador pode assumir a entrega).
• Por valores selecionados: valor manual por pessoa, controlando o "Valor Pendente" até zerar.

Cada pagador escolhe seu método (com troco para dinheiro).

Dividir pedido: separa um pedido em dois pedidos independentes, selecionando quais itens vão para o novo pedido.

5.5 Cupons, descontos e fidelidade no PDV

Tipos de cupom/desconto: Item, Item progressivo, Desconto total da taxa de entrega (frete grátis), Abatido do valor total, Porcentagem, Porcentagem produtos.

Aplicação: desconto rápido (valor/percentual avulso na hora), seleção de cupons cadastrados (múltiplos) e remoção. Cupons podem ter patrocinadores, validade, limite de uso e vínculo a marketplaces. O desconto é recalculado em cascata (entrega → produtos → total).

Fidelidade: quando o cliente participa de um programa, aparecem cartões de Cashback (saldo usável como desconto) e Itens (resgate de produtos como brinde).

5.6 Detalhe do pedido

Reúne: cabeçalho (números, datas, previsões, status, tipo, marketplace, botões Editar e Atualizar status), valores, dados do cliente, endereço (delivery) ou mesa, histórico de status (timeline), pagamentos, cupons e anexos/comandas.

5.7 Edição, impressão e nota fiscal

Edição: alterar tipo do pedido, gerenciar produtos (quantidade, complementos, observações), cliente, endereço e frete (delivery), cupons/fidelidade, pagamentos e status. A taxa de serviço também pode ser aplicada ou removida na edição do pedido, quando o contexto permite.

Atualização de status: transições típicas — Aguardando confirmação → Confirmar → Em preparo; Em preparo (delivery) → Despachar (escolhendo entregador) → Em transporte; Em preparo (retirada) → Pronto para retirada; Em transporte / Pronto → Concluir → Concluído.

Impressão e comandas: tipos de documento — Nota fiscal, Nota não fiscal, Comanda de cozinha, Comanda com número do pedido, Evidência de negociação. Pode ser manual ou automática ao concluir.

Emissão de nota fiscal (NFC-e): ao concluir com emissão ativa, informa-se Tipo de pessoa (Não declarado / CPF / CNPJ), número do documento e nome. A configuração fiscal completa fica em Financeiro → Contabilidade (capítulo 7).

5.8 Configuração de métodos de pagamento

Lista de transferência entre métodos Disponíveis e Escolhidos. Apenas os escolhidos aparecem no checkout. É possível criar métodos personalizados.

5.9 Esteira de pedidos (quadro kanban)

Quadro que organiza os pedidos em colunas por status; arrastar o card muda o status. Cada card mostra número, valor, cliente/mesa, data/hora, tipo, região (delivery) e marketplace. Filtros: período e contextos. Configurações: colunas (status) exibidas e tempo de atualização automática (5s, 15s, 30s, 1min).

5.10 Listagem e gestão de pedidos

Tabela com número, número diário, número externo, data/hora, agendamento, situação de pagamento (Pago/Pendente/Não gerenciado), status, marketplace, total, cliente/mesa, itens, contexto e edição. Abas: Em aberto, Concluídos, Cancelados.

Filtros: número, data início/final, contextos, marketplace e tipo de filtro por data (Emissão ou Agendamento).

Ações em lote (exigem mesmo contexto, marketplace e status): confirmar, concluir, despachar (com entregador), marcar pronto para coleta, cancelar.

Cancelamento: exige motivo (ex.: pedido duplicado, item indisponível, sem entregadores, fora da área, fora do horário) e é irreversível.

MiniKDS: painel compacto que mostra os itens agrupados por estação, com status por item (Aguardando disparo, Aguardando, Em preparo, Pronto, Cancelado) e ações (Iniciar, Concluir, Reverter, "Tudo pronto" por estação).

5.11 Negociação de pedidos

Trata disputas e reclamações (típicas de delivery via marketplace). Tipos: Reembolso, Reembolso parcial, Tempo de preparação, Atraso. Ações do estabelecimento: Aceitar, Recusar (com motivo) ou Contraproposta. Exibe tempo restante até expiração, itens contestados, mensagem do consumidor, evidências anexadas e regras de timeout.

5.12 Atendimento (Conversas)

Central de chat integrada ao PDV: a equipe atende e monta o pedido na mesma tela. Suporta mensagens de texto, áudio, imagem e vídeo; status de mensagem (enviada/recebida/lida); mensagens rápidas (atalho "/"); busca por nome/telefone; alertas de conversa (ex.: limite de IA atingido, solicitação de reserva, atendimento manual). O atendente cria e conclui o pedido pelo painel lateral, sem sair da conversa.

6. Cozinha, KDS e Expedição

O KDS (Kitchen Display System) substitui as comandas de papel por telas digitais. Os itens dos pedidos são roteados automaticamente para as estações de produção corretas, em tempo real, e uma tela de Expedição consolida o pedido e o libera.

Dois módulos: o módulo Cozinha é a versão atual e completa (modo de operação, roteamento, modo de disparo, Fire Time, processos encadeados, expedição por área). O módulo KDS é uma versão reduzida/legada (apenas estações, painel de estação e expedição). Recomenda-se usar Cozinha.

6.1 Estações de produção

Representam as praças de trabalho (Grill, Forno, Frios, Montagem, Bebidas, Expedição). Cada estação tem seu painel; os itens são roteados para a estação onde devem ser preparados.

Cadastro: Nome; Tipo (Preparo, Expedição, Bebidas, Sobremesas, Customizado); Cor (identificação visual); Alertas de tempo (amarelo, padrão 300s; vermelho, padrão 600s); Tema escuro; Expedição por área. Cada estação tem botões Abrir Painel, Nova aba, Editar e Remover.

6.2 Configuração da Cozinha

Modo KDS:

• Completo: roteamento por produto/processo (cada produto/etapa aponta para uma estação, com tempo próprio).
• Simples: roteamento por estação (selecionam-se categorias e produtos de cada estação).
• Desabilitado: pedidos não são enviados ao KDS.

Disparo de pedidos (modo de disparo):

• Automático: o sistema dispara cada item no momento certo, sozinho.
• Manual: o expeditor decide quando disparar (ligado ao Fire Time).

6.3 Roteamento por produto e processos de preparo

No modo Completo, cada produto define Estação e Tempo de preparo (min). Para preparos em etapas (ex.: pizza = Montar → Assar → Finalizar), usam-se Processos de Preparo, com: descrição de exibição, nome interno, estação, tempo, Usar Fire Time, Aguardar subitens e Depende de (encadeamento). O sistema detecta dependências circulares e respeita a ordem.

6.4 Painel de Estação

Tela em tela cheia que mostra apenas os itens daquela estação, agrupados por pedido. Cada item tem ações conforme o status: Iniciar (▶️), Concluir (✓), Desfazer. Botão "Tudo pronto" marca todos os itens do pedido naquela estação. Suporta navegação por teclado (setas e Enter) e atualiza-se em tempo real.

6.5 Expedição por área

Modo ativável na estação que transforma o painel em uma central que enxerga o pedido inteiro (itens de todas as estações), com controles de disparo e liberação, organizando os pedidos por situação (Aguardando disparo, Em andamento, Em disparo, Prontos).

6.6 Fire Time (disparo coordenado)

Faz todos os itens de um pedido ficarem prontos ao mesmo tempo, segurando os itens mais rápidos e liberando-os na hora certa. O sistema calcula o item de maior tempo (anchor) e agenda os demais; respeita dependências de processos encadeados.

• Cada item/processo tem o interruptor Usar Fire Time (ligado = aguarda disparo coordenado; desligado = aparece imediatamente).
• Automático: o sistema dispara sozinho. Manual: os itens ficam "Aguardando disparo" até o expeditor clicar em Disparar.

6.7 Tempos, cronômetro e status

Cada pedido exibe um cronômetro (MM:SS) que muda de cor conforme os alertas da estação (verde → amarelo → vermelho).

Status de item: Aguardando disparo, Aguardando, Em preparo, Pronto, Cancelado, Liberado. Status do pedido no KDS: Aguardando, Em preparo, Pronto. Status de processo: Bloqueado, Disponível, Em preparo, Pronto, Cancelado.

6.8 Painel de Expedição

Consolida o pedido inteiro reunindo itens de todas as estações. Organiza por situação (Aguardando disparo, Em disparo, Em andamento, Prontos). Ações do expeditor: Disparar (item), Disparar todos, Desfazer, Liberar (quando todos os itens estão prontos) e "Tudo pronto" (no modo expedição por área). Suporta navegação por teclado e tempo real.

7. Financeiro

Organizado em quatro áreas: Caixa, Contas, Relatórios e Contabilidade.

7.1 Controle de Caixa

Cada expediente é um intervalo de caixa. O topo indica Caixa aberto ("atendendo pedidos") ou Caixa fechado.

• Abertura: Descrição (sugerida automaticamente) e Valor inicial (fundo de troco; o sistema sugere o valor final do último caixa). Botão Abrir caixa.
• Fechamento: botão Fechar caixa encerra o intervalo, que passa a constar no relatório diário.
• Indicadores: Início do dia, Agora, Aberto às; Contas a receber, Contas a pagar, Número de vendas.
• Painéis de análise do dia: itens mais vendidos, subitens mais vendidos, principais métodos de pagamento e lista de contas do intervalo (com pagamentos, itens e link para o pedido de origem).
• Controle de Marketplaces: liga/desliga os canais de venda (Abrir/Fechar todos). Canais iFood têm status apenas exibido. Recomendação: caixa fechado → fechar marketplaces.

Conferência de Caixa: documento pronto para impressão com resumo do intervalo, resumo financeiro (entradas: abertura, produtos, serviços/entrega, recebidos; saídas: contas a pagar; resultado), resumo por método de pagamento, detalhamento de recebidos, produtos vendidos, taxas de entrega e contas manuais. Serve para conferir a gaveta física contra o sistema.

Sangria e suprimento/reforço: não há telas com esses nomes. Esses movimentos são feitos via contas manuais (A Pagar = saída; A Receber = entrada), que aparecem na Conferência de Caixa como Saídas e Entradas.

7.2 Lançamento de Contas (a pagar e a receber)

Registra contas geradas pelos pedidos (automáticas) e contas manuais (despesas e recebimentos avulsos).

• Lista: Descrição, Valor, Tipo (A Receber/A Pagar), Vencimento, Status (Pago/Pendente).
• Filtros: Descrição, Tipo, Status, Data início/fim.
• Nova/Editar conta: Descrição, Valor total, Tipo, Data de vencimento, vínculo opcional a um intervalo de caixa, e interruptor Pago (com método de pagamento). Parcelamento (na criação): 2 a 36 parcelas, com divisão automática do valor e vencimentos mensais, ajustáveis individualmente.
• Ações em lote: editar (1 conta), excluir, adicionar/remover pagamento (apenas contas manuais de mesmo tipo e status).

7.3 Relatórios

• Caixa Diário: histórico de todos os intervalos (descrição, abertura, fechamento, valor inicial/final, contas), com acesso à conferência de cada intervalo.
• Contas Mensais: visão anual a pagar × a receber, com gráfico de barras e resumo mensal. Filtros: ano, tipo e status.
• Itens Mais Vendidos: Top 5 em gráfico e tabela completa. Filtros: data início/fim e tipo (Produto, Entrega, Item, Subitem).

7.4 Contabilidade — Notas Fiscais

• Consulta/gestão (NFC-e): lista as notas emitidas pelos pedidos (número, série, data, protocolo, status, mensagem da Sefaz, CNPJ, link do pedido). Ações em lote: baixar PDFs, baixar XMLs e cancelar.
• Configuração de Emissão: dados da empresa (razão social, nome fantasia, CNPJ, inscrições), endereço, série e próximo número, Regime Tributário (Simples Nacional / Simples Nacional com excesso de sublimite / Regime Normal), CSC e ID CSC, certificado digital (.pfx) com senha, e opções de discriminar impostos e enviar nota por e-mail. Modalidade de frete: Emitente, Destinatário, Terceiros, Sem frete.
• Configuração de Recebimento: e-mails que recebem, no dia 01 de cada mês, um ZIP com todos os XMLs das notas — facilitando a rotina do contador.

7.5 Fluxo de conciliação (resumo)

Abrir o caixa (fundo de troco) → abrir marketplaces → durante o expediente, vendas viram contas automaticamente e despesas/recebimentos avulsos viram contas manuais → acompanhar indicadores → na hora de fechar, usar a Conferência de Caixa → fechar marketplaces e caixa → consultar relatórios → envio mensal automático dos XMLs ao contador.

8. Canais de venda (Marketplaces): Cardápio Online, iFood e WhatsApp

"Marketplace" é cada canal de venda pelo qual o restaurante recebe pedidos. É possível cadastrar vários canais, cada um com aparência, funcionamento e integração próprios.

8.1 Listar e cadastrar marketplaces

A listagem mostra logo, nome, tipo, descrição e status (Aberto/Fechado). Cadastro/edição:

• Dados de controle: Nome (interno), Descrição, Tipo (não editável depois).
• Dados públicos: Nome público, Telefone, Slug (compõe o link https://pedir.spacefood.com.br/{slug} — letras minúsculas, números e hífens; único; não editável depois).
• Valor mínimo de carrinho.

8.2 Personalização do Cardápio Digital

Com pré-visualização ao vivo: Logo (até 5 MB, ideal 300×300), Capa/banner (até 10 MB, ideal 1920×600), Cor primária (destaques, abas, botão de carrinho) e Cor secundária (preços).

8.3 Detalhes do Cardápio Online

Cada bloco é salvo independentemente:

• Status: interruptor Aberto/Fechado + mensagem opcional ao cliente.
• Link público e QR Code: com download do QR e cópia do link.
• Dados e Personalização (atalhos para os formulários).
• Endereço do estabelecimento (com busca por CEP).
• Horários de funcionamento: até 3 faixas por dia — apenas informativos (não abrem/fecham a loja automaticamente).
• Métodos de pagamento: copiar do PDV ou customizado. Para Pix, há Cobrar via QR Code (PIX online) — o cliente paga e o pedido é confirmado automaticamente; exige a chave Pix de destino.
• Tipo de cobrança de entrega: por região (descrição + preço) ou por distância (faixas km + valor, com formulário de endereço Padrão ou Google Autocomplete).
• Tipo de autenticação do cardápio: Simples (nome + telefone) ou Verificada (verificação de e-mail/telefone).
• Agendamento de pedido: Sem agendamento, Apenas data, Apenas hora, ou Data e hora (com opção de obrigatório).
• Pixel da Meta (acompanhar conversões de anúncios) e LogRocket (gravação de sessões para análise de experiência).

8.4 Integração iFood

Conecta a loja do iFood ao Space Food. Vinculação em 2 etapas: informar o identificador da loja (Merchant ID) → selecionar o catálogo. O painel mostra status da integração, dados da loja, horários de funcionamento no iFood (calendário semanal) e interrupções (pausas temporárias com início, fim e descrição). Permite excluir a integração (com confirmação por digitação).

8.5 Integração WhatsApp

Transforma o WhatsApp da loja em canal automatizado. Conexão do número: por QR Code (renovado a cada 60s) ou por código de pareamento (telefone). Após conectar, mostra "Número conectado com sucesso".

Comportamentos de atendimento (5 tipos):

• Resposta automática simples: mensagem única de boas-vindas com link do cardápio.
• Resposta automática híbrida: cliente escolhe pedir sozinho ou falar com atendente.
• Resposta automática com IA: atendimento por inteligência artificial (a primeira mensagem é gerada pela IA e não é editável).
• Atualizações de pedido: mensagens automáticas a cada mudança de status.
• Atualizações KDS: mensagens automáticas por estação da cozinha.

Regras: apenas um comportamento de resposta automática, uma configuração de atualizações de pedido e uma de KDS. As mensagens usam variáveis dinâmicas (ex.: {nomeCliente}, {linkCardapio}, {numeroPedido}, {nomeEstacao}). Há também mensagens rápidas (atalhos "/").

9. Promoções: cupons, campanhas e fidelidade

9.1 Cupons

Códigos de desconto aplicados pelo cliente. Tipos: Desconto total da taxa de entrega, Abatido do valor total (R$), Porcentagem (%), Porcentagem produtos (% só nos produtos).

Campos: Código (único), Nome, Descrição, Tipo, Marketplaces de validade, Valor, Limite de uso por usuário (em branco = ilimitado), Data de validade (em branco = sem validade) e Ativo. A listagem mostra usos, clientes únicos e status (Ativo/Inativo/Expirado).

9.2 Campanhas

Alteram diretamente o preço de itens do cardápio por um período (diferente do cupom, que desconta no checkout). Campos: Nome, Descrição, Início e Término (data/hora — permite agendar), e itens da campanha com preço promocional (maior que zero e menor que o preço atual). Status: Rascunho, Agendada, Ativa, Pausada, Finalizada, Cancelada, Falha. Ações: Editar, Abrir, Pausar, Retomar, Finalizar, Cancelar, Ver Logs.

9.3 Programas de Fidelidade

Dois tipos:

• Cashback: o cliente recebe de volta uma porcentagem do valor de cada pedido como saldo em R$, usável como desconto. Configura porcentagem de retorno (0,01 a 100%), dias para vencimento (opcional) e limite máximo de acúmulo (opcional).
• Itens: o cliente acumula pedidos; a cada N pedidos ganha direito a item(ns). Configura quantidade de pedidos necessários e produtos resgatáveis.

Gestão: ativar/inativar (programas não são excluídos). Há uma tela de acompanhamento de clientes por programa, com exportação (XLS) e saldo/pedidos de cada cliente. O resgate acontece no pedido (PDV), convertendo o benefício em desconto; cada benefício pode ser resgatado uma vez por pedido.

Resumo das diferenças: o cupom é um código de desconto no checkout; a campanha altera temporariamente o preço de itens; o programa de fidelidade recompensa a recorrência (cashback ou acúmulo de pedidos).

10. Clientes, entregadores, usuários, perfis e permissões

10.1 Clientes

Concentra a base de consumidores, seus endereços e histórico de pedidos. Abas: Clientes (listagem) e Fidelidade.

• Listagem: Nome, Telefone, Observação, Cadastrado às; filtros por nome/observação/telefone; ações em lote (editar dados, editar endereço, excluir) e exportar clientes (.xlsx).
• Cadastro/edição: Nome, Observação, Telefone, CPF.
• Endereços (vários por cliente): Observação (nome do endereço), CEP (preenche automaticamente), UF, Cidade, Bairro, Rua, Número, Complemento e Região (quando a cobrança é por região). Adapta-se à forma de cobrança de entrega.
• Histórico de pedidos: painel com número, valor, itens, status, marketplace, data/hora e atalho para abrir o pedido.

10.2 Entregadores

Base de entregadores vinculáveis às entregas. Cadastro: Nome (obrigatório), E-mail, Telefone (obrigatório), CPF e CNPJ (permite pessoa jurídica). Listagem com filtros (nome/telefone/e-mail), edição e exclusão.

10.3 Usuários do sistema

Gerencia quem acessa o painel. Cada usuário recebe um perfil de acesso. Um usuário é único na plataforma e pode ter acesso a vários estabelecimentos, com perfil e status (ativo/inativo) independentes por estabelecimento.

• Listagem: Nome, E-mail, Telefone, CPF, Perfil, Ativo, Criado às; filtros por perfil/e-mail/nome; ações em lote (inativar, reativar, alterar perfil).
• Cadastro: Nome, E-mail (login), Telefone, CPF e Perfil. A senha é definida pelo próprio usuário (autocadastro ou recuperação).
• Meu Perfil: disponível a qualquer usuário — Alterar dados (nome e telefone; e-mail somente leitura) e Alterar senha (mínimo 6 caracteres).

10.4 Perfis de acesso

Um perfil é um conjunto de permissões que define o que o usuário pode acessar. Possui Nome, Descrição e Módulos liberados. Atribuído no cadastro do usuário ou posteriormente (ação "Alterar perfil").

O controle de acesso atua em dois níveis:

• Módulos: controlam a exibição dos itens de menu/grandes áreas.
• Funcionalidades: controlam telas/ações específicas (sem a funcionalidade, o usuário é redirecionado para "não autorizado").

10.5 Lista de permissões

Módulos (controlam menu/áreas): Gestão de usuários, Gestão de clientes, Entregadores, Financeiro, Cardápio, Configurações, Atendimento, Controle de estoque simples, Controle de estoque completo, Marketplaces - Cozinheiro, Marketplaces - Aprendiz. (Pedidos, Dashboard e Estabelecimentos aparecem para todos os usuários autenticados.)

Funcionalidades (controlam telas/ações): Dashboard inicial, Gestão de clientes, Cadastro de usuários, Listagem de usuários, Cadastro de entregador, Listagem de entregadores, Gestão de produtos, Gestão de categorias, Listagem de categorias, Gestão de marketplace, Listagem de marketplaces, Gestão de caixa, Relatório de caixa diário, Fluxo de trabalho, Controle de estoque simples, Controle de estoque completo, Notas fiscais.

Módulos e funcionalidades podem ser ampliados conforme o plano contratado, mantendo a mesma divisão entre módulos (menus/áreas) e funcionalidades (telas/ações).

11. Configurações gerais

O menu Configurações reúne: Métodos de pagamento (capítulo 5), Número de mesas, Fluxo de operação, Entrega, Tempo de entrega, Taxa de serviço, Tema e Contabilidade (capítulo 7).

11.1 Tema (identidade visual)

Personaliza logo e cores, em abas Tema Claro e Tema Escuro. Por aba: Logo (JPEG/PNG, até 5 MB), Cor primária (botões e destaques) e Cor secundária (elementos de suporte). Botões Salvar (recarrega para aplicar) e Limpar.

11.2 Número de mesas

Controle deslizante de 0 a 100 mesas, que determina quantas mesas aparecem na Operação. Aviso: ao alterar, todos os pedidos em aberto são concluídos.

11.3 Fluxo de operação

Define, em um diagrama, como cada tipo de pedido (Simples, Delivery, Mesa, Retirada) é processado e quais documentos são gerados. Cada tipo existe apenas uma vez.

Modo do fluxo:

• PDV: pedidos concluídos automaticamente na criação (operação rápida).
• Completo: pedidos entram na mesma esteira dos marketplaces, passando por todas as etapas.

Comandas por fluxo: Nota não fiscal (até 5), Nota fiscal (até 1, pode ser obrigatória), Comanda de cozinha (até 5). Cada comanda configura: Cópias, Destinatários (Todos ou por Perfil), Produtos (Todos ou por Categoria) e Marketplaces (PDV, iFood, Rappi, WhatsApp, Simples, QR Code, Cardápio Online). Requer a permissão "Fluxo de trabalho".

11.4 Entrega (cobrança e endereço)

Tipo de cobrança:

• Por região: regiões personalizadas (descrição + preço fixo).
• Por distância: faixas de distância (início/fim em km + valor). Neste modo, escolhe-se o formulário de endereço: Padrão ou Google Autocomplete.

As regiões e faixas têm cadastro, edição e exclusão (com confirmação por digitação).

11.5 Tempo de entrega / preparo (opcional)

Configura a previsão de tempo exibida ao cliente.

• Tempo fixo: mínimo/máximo para entrega e retirada.
• Preparo + tempo de rota: o tempo de rota é somado ao preparo com um percentual de tolerância. Disponível apenas quando PDV e cardápio digital usam cobrança por distância.

11.6 Taxa de serviço

Permite cobrar automaticamente um percentual de taxa de serviço (a clássica "taxa dos 10%" do garçom) nos pedidos atendidos na loja. A configuração fica em Configurações → Taxa de serviço.

O que se configura:

• Percentual: valor da taxa, de 0% a 100% (aceita casas decimais, ex.: 10 ou 12,5).
• Aplicar nos contextos: em quais tipos de pedido a taxa será sugerida. Estão disponíveis apenas Simples (Salão/Balcão) e Mesa — os contextos típicos de consumo no local. Delivery e Retirada não recebem taxa de serviço.

Regras de validação: é preciso informar um percentual entre 0 e 100 e selecionar ao menos um contexto; caso contrário o sistema avisa e não salva.

Como a taxa funciona no PDV (checkout):

• Quando o pedido é de um contexto configurado, o resumo do checkout exibe a linha "Taxa de serviço (X%): R$ valor", já somada ao total.
• A base de cálculo é o valor dos produtos + frete; o valor da taxa é esse total multiplicado pelo percentual.
• A taxa é sugerida automaticamente, mas o operador tem total controle: um botão Remover desliga a taxa naquele pedido (a linha fica riscada e o valor sai do total) e Aplicar a religa. Essa escolha vale apenas para o pedido em questão.
• A taxa também pode ser aplicada ou removida na edição de um pedido já existente, desde que o contexto permita.

Remover a configuração: o botão Remover configuração (com diálogo de confirmação) apaga a taxa de serviço do estabelecimento. A partir daí, os pedidos futuros não recebem mais a taxa sugerida automaticamente.

A taxa de serviço aparece como item próprio no resumo de valores do pedido e na Conferência de Caixa, separada de produtos e frete.

12. Cardápio Online — experiência do cliente final

Ambiente onde o cliente faz o pedido pela internet, funcionando no computador e no celular, sem instalar aplicativo.

12.1 Acesso ao cardápio

Cada estabelecimento tem um link próprio (pedir.spacefood.com.br/nome-do-estabelecimento), divulgável em redes sociais, WhatsApp ou QR Code. Ao abrir, o cliente vê logo, capa e nome público.

12.2 Página inicial

Mostra o status da loja (Loja aberta/fechada, com mensagem personalizada), o pedido mínimo, um campo de busca (ignora acentos e maiúsculas) e o painel "Loja" (endereço, telefone, horários de funcionamento e formas de pagamento aceitas).

12.3 Navegação e produtos

Cardápio organizado em categorias (barra de abas fixa). Produtos em cartões com imagem, nome, descrição curta e preço (preço fixo; "Valor único"/"A partir de" para pizzas e montáveis; preço original riscado em promoção).

12.4 Montagem do pedido

• Produto simples/industrializado: observação opcional, quantidade e "Adicionar".
• Produto preparado com complementos: grupos obrigatórios/opcionais com mínimo e máximo; validação automática (botão desabilitado enquanto há grupos obrigatórios pendentes); rolagem automática para o próximo grupo; observações.
• Pizza: bordas, massas, sabores (meio a meio ou mais frações), adicionais, observações; preço conforme a regra do restaurante.
• Combo: passo a passo guiado ("item 1 de 3") com personalização de cada item.

12.5 Carrinho e finalização

• Carrinho: itens com quantidade, valor e complementos; ajuste de quantidade; validação do valor mínimo.
• Tipo de pedido: Delivery ou Retirada.
• Endereço e frete (delivery): vários endereços; cadastro por CEP, busca de endereço ou região; frete por região (fixo) ou distância; previsão de tempo.
• Pagamento: Pix (na entrega ou pelo app, com QR Code e confirmação automática), Cartão (na entrega) e Dinheiro (com troco).
• Finalização: conclui o pedido; opção de enviar pedido no WhatsApp (mensagem pré-formatada).

12.6 Acompanhamento, login e perfil

• Status do pedido: passo a passo visual (Aguardando confirmação, Em preparo/Em andamento, Em transporte, Pronto para retirada, Concluído, Cancelado, Em negociação, Aguardando resposta do cliente), com previsão, itens, endereço, valores, pagamento e telefone da loja.
• Login/cadastro: Google, Facebook, telefone (código de 6 dígitos por SMS), e-mail (código) ou cadastro rápido (nome + telefone).
• Perfil: editar nome (telefone/e-mail só visíveis), gerenciar endereços, excluir conta e sair.
• Histórico de pedidos ("Meus pedidos"): todos os pedidos com número, data, itens, cupons, total e status.

12.7 Cupons e fidelidade (visão do cliente)

• Cupom: digitar o código, ver como etiqueta e remover; desconto na entrega, percentual ou valor fixo.
• Cashback: saldo em reais acumulado, com data de validade e limite; resgatável como desconto.
• Programa por itens: itens grátis após N pedidos, com barra de progresso e botão "Resgatar itens".

12.8 Termos, privacidade e cookies

Aviso de cookies na primeira visita ("Estou ciente") e página de Termos de Uso e Política de Privacidade (operada pela OnTime Delivery LTDA sob a plataforma Space Food Marketplace), descrevendo dados coletados, uso de cookies e o papel da plataforma como intermediadora (preparo e entrega são responsabilidade da loja).

13. Aplicativo de impressão (Desktop)

13.1 Para que serve

Programa instalado no computador da loja (Windows) que imprime automaticamente os documentos de cada pedido — comandas para a cozinha, cupons/comprovantes e notas fiscais. Funciona como ponte entre o sistema de pedidos e as impressoras físicas: assim que um documento é gerado, o app o envia para a impressora certa, sem ação manual. O sistema Space Food abre dentro do próprio app (com barra de título própria e botões de minimizar, maximizar e fechar), e a impressão acontece em segundo plano. Um único computador com o app instalado pode gerenciar e distribuir a impressão para várias impressoras da loja ao mesmo tempo.

13.2 Conexão com o estabelecimento

O lojista faz login na conta Space Food e o app se vincula automaticamente ao estabelecimento, passando a receber os documentos a imprimir. Ele respeita a configuração de operação (quais comandas imprimir e para qual perfil de usuário). Monitoramento de internet: se a conexão cair, o app avisa e não imprime até reconectar, evitando documentos perdidos; sinaliza "Anexo não impresso — Falha de conexão".

13.3 Impressão automática

O documento chega ao app automaticamente, é impresso (em preto e branco, com escala adequada por tipo) e segue para o próximo. O app identifica o tipo de cada documento e o envia para a(s) impressora(s) configurada(s) para aquele tipo (ver 13.4). Quando um tipo está mapeado para mais de uma impressora, o documento sai em todas elas (uma de cada vez, com um pequeno intervalo entre as impressões). Em erro, avisa "Anexo não impresso — Erro inesperado" e mantém registro interno (logs) para suporte.

13.4 Gestão de múltiplas impressoras (Configurações de Impressão)

O app possui uma tela própria de Configurações de Impressão para o lojista organizar, em um só computador, para onde cada documento é impresso. Ela é aberta pelo menu Impressora → Configurações de Impressão (atalho Ctrl+P) na barra superior, ou pelo ícone na bandeja do Windows.

Na tela, o lojista pode:

• Ver as impressoras detectadas no computador (com a contagem total) e atualizar a lista pelo botão "Recarregar impressoras" — útil quando uma impressora é ligada ou instalada com o app já aberto.
• Associar cada tipo de documento a uma ou mais impressoras. Cada tipo (ex.: Nota Fiscal, Nota Não Fiscal, Comanda - Cozinha) aparece em uma seção própria, com uma lista de impressoras e caixas de seleção. É possível marcar várias impressoras para o mesmo tipo (o documento sai em todas) e direcionar tipos diferentes para impressoras diferentes — por exemplo, a nota fiscal no balcão/caixa e a comanda na cozinha.
• Identificar impressoras indisponíveis: se uma impressora que estava configurada não for mais encontrada (desligada/removida), ela continua listada com a marca "não encontrada", sem travar o restante.
• Usar impressora padrão como fallback: opção que, quando ligada, garante que documentos de um tipo sem nenhuma impressora marcada ainda sejam impressos na impressora padrão do Windows — nunca deixando de imprimir.
• Exibir notificações de impressão: opção que mostra um aviso ("Imprimindo [documento] na impressora [nome]") a cada documento enviado, útil para acompanhar a operação.
• Salvar as configurações, que ficam guardadas no computador e permanecem mesmo após fechar e reabrir o app.

Tipos de documento dinâmicos: os tipos exibidos na tela acompanham o que a loja realmente usa na sua operação — eles surgem conforme os documentos passam a ser gerados. Enquanto o app ainda não recebeu nenhum documento, a tela exibe os tipos padrão (Nota Fiscal, Nota Não Fiscal, Comanda - Cozinha) ou o aviso "Nenhum tipo de documento ativo. Aguardando conexão".

13.5 Bandeja do Windows (segundo plano)

O app fica acessível por um ícone na bandeja do Windows (próximo ao relógio), com o menu Abrir, Configurações de Impressão e Sair. Ao fechar a janela principal, o app não é encerrado — continua rodando em segundo plano (minimizado na bandeja), de modo que a impressão automática segue funcionando mesmo com a janela fechada. Um duplo clique no ícone reabre a janela principal.

13.6 O que o lojista precisa saber

App voltado ao Windows; basta login para vincular; depende de internet ativa; manter as impressoras instaladas e ligadas; deixar o app aberto ou minimizado na bandeja durante o expediente; e definir, em Configurações de Impressão, qual impressora (ou impressoras) recebe cada tipo de documento — podendo gerenciar toda a impressão da loja a partir de um único computador.