Wiki/Início
Manual do sistema

Wiki - RetaguardaWeb

Referência rápida para consultar, cadastrar, organizar e analisar as informações operacionais do restaurante.

Começar agora Ver dúvidas frequentes
12áreas documentadas 100%navegável e pesquisável 0dependências de servidor
Mapa rápido

O que você encontra aqui

▦

Dashboard

Indicadores de vendas, cancelamentos, ticket médio e gráficos por produto, vendedor e hora.

 ◇

Cadastros

Pessoas, itens de cardápio, dados fiscais, importação CSV e custos de insumos.

 %

Relatórios

Caixa, moedas, garçons, entregadores, documentos fiscais e títulos financeiros.

 ↕

Configuração

Organização visual dos itens no computador e celular por centro de custo.
i

Sobre esta wiki

Este site é independente do RetaguardaWeb. Ele não acessa banco de dados, não altera cadastros e pode ser publicado em qualquer hospedagem de arquivos estáticos.

Fluxo de uso recomendado

  1. 1
    Acesse o sistema

    Abra o endereço fornecido pela administração e entre com um usuário autorizado.

  2. 2
    Escolha o módulo

    Use o menu lateral para navegar entre cadastros, consultas, configurações e relatórios.

  3. 3
    Defina os filtros

    Selecione empresa, período, situação ou demais critérios antes de gerar a consulta.

  4. 4
    Analise ou exporte

    Pesquise na grid, ajuste a paginação e use CSV ou impressão quando disponíveis.

Visão geral

Primeiros passos

Como acessar e usar os padrões comuns de todas as telas.

Acesso ao RetaguardaWeb

  1. 1
    Abra o endereço do sistema

    Normalmente o acesso local usa http://127.0.0.1:8480/. Ambientes com acesso web podem mostrar também uma URL pública no topo.

  2. 2
    Informe usuário e senha

    Somente usuários administrativos, ativos e não bloqueados conseguem entrar.

  3. 3
    Use o menu lateral

    Os módulos ficam agrupados em Cadastro, Consultar, Configurar e Relatórios.

Elementos comuns

ElementoComo usar
Gerar / ConsultarAplica os filtros e consulta os dados no banco.
BuscaFiltra localmente os registros já carregados na grid.
PaginaçãoDefine a quantidade de linhas e navega entre as páginas.
Exportar CSVBaixa os registros visíveis conforme filtros e busca.
ImprimirAbre o diálogo do navegador com layout próprio para impressão.
TemaAlterna entre aparência clara e escura.
!

Atenção aos filtros

Confirme empresa e período antes de executar operações em lote ou interpretar totais. A busca da grid não substitui os filtros enviados ao banco.

Visão geral

Dashboard

Painel consolidado do movimento de vendas em um período.

Filtros disponíveis

Data inicialHora inicialData finalHora finalProdutos: quantidade ou financeiroLimite: 5, 10, 15 ou 20Recarga automáticaIntervalo em minutos

Indicadores

Vendas

Total vendido, quantidade de vendas e pessoas.

Cancelamentos

Valor e quantidade de vendas canceladas.

Ticket médio

Média de venda por pessoa no período.

Repiques

Total de repiques contabilizados no período.

Gráficos

  • Produtos vendidos: alterna entre ranking quantitativo e financeiro.
  • Vendas por vendedor: compara o valor vendido por responsável.
  • Vendas por hora: apresenta o valor líquido ao longo do dia.
✓

Dica

Use “Recarregar” em monitores gerenciais. Escolha um intervalo coerente para não gerar consultas desnecessárias.

Cadastros

Cadastro de Pessoas

Consulta e manutenção de clientes e fornecedores.

Como consultar

  1. 1
    Escolha os tipos

    Marque Cliente, Fornecedor ou ambos.

  2. 2
    Use a busca

    Pesquise em nome, telefones, endereço, documentos e demais campos carregados.

  3. 3
    Exporte se necessário

    O CSV preserva campos sensíveis a zeros à esquerda, como telefone, CEP, CPF, CNPJ, RG e IE.

Informações exibidas

NomeTelefones e celularEndereço e complementoBairro, cidade e CEPNascimentoE-mailRG e CPFCNPJ e IEFantasiaObservações

Edição

A edição atualiza os dados permitidos da pessoa usando transação. Se houver falha, a alteração é cancelada para evitar gravação parcial.

Cadastros

Itens de Cardápio

Consulta e edição de dados comerciais, fiscais, de produção e da reforma tributária.

Consulta e ações

RecursoDescrição
Somente ativosLimita a consulta aos itens ativos na empresa.
EmpresaConsulta uma empresa específica ou todas.
BuscaPesquisa em qualquer coluna carregada.
EditarAbre o item completo ou diretamente o campo selecionado.
Atualização em loteAtualiza campos escolhidos por classe, CST/CSOSN ou critérios da reforma tributária.
Importar CSVAtualiza apenas os campos marcados a partir de um CSV exportado.
Exportar CSVGera arquivo com preço formatado e códigos preservados.

Grupos de dados

Dados

Classe, produto, unidade, preço, EAN, envio à cozinha e impressora.

ICMS

CST/CSOSN, NCM, CEST, alíquota, redução, substituição e FECP.

PIS / COFINS

Códigos de situação tributária e alíquotas.

SPED e produção

Categoria do produto, tempo de produção e tempo máximo.

Reforma tributária

CST IBS/CBS, classificação tributária, alíquota IBS na UF e alíquota CBS.

Importação CSV segura

  • Exporte primeiro a planilha do próprio sistema.
  • Não altere a coluna Código; ela identifica o registro.
  • Marque somente os campos que deseja atualizar.
  • Valores numéricos aceitam separador decimal por vírgula.
  • Confira o log de validação antes de considerar a rotina concluída.
!

Operação sensível

Importação e atualização em lote exigem autorização. Faça uma cópia do CSV original e valide uma amostra antes de alterar muitos itens.

Cadastros

Insumos

Consulta de unidades, conversões e custos por empresa.

Como usar

  1. 1
    Selecione a empresa

    Os valores de compra e custo podem variar por empresa.

  2. 2
    Clique em Consultar

    A grid carrega os insumos vinculados à empresa escolhida.

  3. 3
    Pesquise ou exporte

    A busca percorre todas as colunas e o CSV utiliza formatação monetária brasileira.

Colunas

CódigoClasseDescriçãoUnidade usualUnidade de compraConversãoValor de compraCusto médioNCMCEST
Consultas

Itens Vendidos e Ainda não Recebidos

Localize itens por comanda, mesa, cartão de consumo e cliente.

Modos de consulta

Pendentes

Mostra itens vendidos que ainda não foram recebidos.

Por período

Mostra itens vendidos no intervalo, recebidos ou não.

Filtros e ordenação

Data e hora inicialData e hora finalItemPessoaOrdenar por itemOrdenar por pessoaOrdenar por valor

Resumo

O topo apresenta total de registros, quantidade vendida e valor acumulado. A grid detalha item, mesa, cartão de consumo, quantidade, valor, pessoa e comanda.

Configuração

Posição dos Itens

Organização visual do cardápio no computador e no celular.

Aba Computador

  • Selecione o centro de custo e clique em Carregar.
  • Arraste classes e itens no quadro para reorganizar as posições.
  • Use Posicionamento Automático para recriar a ordem pelo script do sistema.
  • Clique em Salvar posições para gravar o arranjo.
  • Itens removidos aparecem em uma área separada.

Aba Celular

  • Carregue a organização pelo centro de custo.
  • Reordene subclasses e itens para a experiência móvel.
  • Use Clonar do Computador para copiar a base de posicionamento.
  • Salve as posições depois de concluir os ajustes.
!

Alterações não salvas

Ao trocar de centro de custo ou recarregar a tela, confirme se as alterações atuais já foram salvas.

Relatórios

Reforços e Sangrias

Movimentações de entrada, saída e estorno do caixa.

Filtros

Data inicialData finalTodosSangriasReforçosEstornosDescrição

Resultados

Os cartões resumem total de entradas, total de saídas e quantidade de movimentações. A tabela apresenta data, hora, tipo, entrada, saída, histórico e usuário.

Saídas disponíveis

  • Exportar CSV: gera as movimentações filtradas.
  • Imprimir: prepara o relatório sem controles de tela.
Relatórios

Moedas Utilizadas

Análise de recebimentos nas visões Diário, PDV e Delivery.

Abas

AbaFiltros principaisUso
DiárioPeríodo, moeda e “Sem separação por moeda”Consolida os recebimentos diários.
PDVPeríodo e terminal PDVCompara valores por ponto de venda.
DeliveryPeríodo, horários, tipo e e-commerceSepara lançamentos manuais e integrações.

Grid e resumo

A busca localiza origem, data, moeda, PDV ou e-commerce. Os cartões mostram número de registros, total e tipo de visão ativa. A exportação CSV acompanha os dados exibidos.

Relatórios

Vendas por Garçom

Totais, comissões, comandas atendidas e detalhamento de produtos vendidos.

Aba Totais e Comissão

RecursoDescrição
PeríodoData e hora inicial e final.
GarçomUm profissional ou Todos.
TurnoFiltra o movimento pelo turno selecionado.
QTD COMANDASAdiciona a coluna com a quantidade distinta de comandas atendidas.
PorcentagensCalcula 1%, 3%, 5%, 7%, 10% ou percentuais manuais separados por ponto e vírgula.

Os cartões mostram total vendido, quantidade de garçons e soma das porcentagens calculadas.

Aba Vendas por Garçom

  • Filtre por período, garçom e classe.
  • Ao selecionar Todos, os produtos são separados por garçom na grid.
  • Marque CLASSE para agrupar produtos e obter quantidade e total vendido de cada classe.
  • Use a busca por produto, classe ou garçom.

Impressão e CSV

A impressão remove os filtros, inclui todos os registros da consulta, quebra o conteúdo em várias páginas e repete os cabeçalhos. O CSV acrescenta Garçom e Classe conforme o modo escolhido.

i

Quantidade de comandas

A contagem considera cada código de comanda uma única vez por garçom no período, mesmo que a comanda possua vários itens.

Relatórios

Entregadores

Faturamento e adicionais de entrega por responsável.

Filtros

Data e hora inicialData e hora finalEntregadorTipo de lançamentoModo resumidoBusca

Detalhado e resumido

No modo detalhado, a grid apresenta comanda, total faturado, moeda, quantidade e total de adicionais, tipo de lançamento e entregador. No modo resumido, concentra os totais por entregador.

Indicadores

Total faturado

Soma do faturamento no filtro.

Total adicionais

Valor acumulado dos adicionais.

QTD adicionais

Quantidade contabilizada.

Relatórios

Notas — NFC-e

Consulta de documentos fiscais eletrônicos e seus estados.

Filtros

Data por autorizaçãoData por inclusãoData inicial e finalSérieSituaçãoBusca por NFC-e, chave ou status

Informações

A tabela apresenta número da NFC-e, série, chave, total, autorização, emissão, inclusão e status. Os cartões resumem quantidade, valor total e período consultado.

✓

Exportação

A chave é exportada como texto para evitar notação científica e perda de dígitos em programas de planilha.

Relatórios

Títulos

Contas a pagar e a receber, vencimentos, quitações e saldos.

Filtros

EmpresaSem dataEmissãoVencimentoQuitaçãoCliente / fornecedorPlano de contasReceber / pagarPendenteQuitadoCanceladoBusca

Plano de contas

O seletor apresenta a hierarquia das contas. Use a pesquisa interna para localizar uma conta ou escolha “Todos” para remover o filtro.

Resumo financeiro

Total previsto

Soma dos valores previstos.

Total pago

Soma dos valores efetivamente pagos.

Saldo

Diferença entre previsto e pago.

Grid

Exibe plano de contas, tipo de documento, pessoa, descrição, banco, datas, valores, parcela, situação e natureza do título. O resultado pode ser exportado em CSV.

Administração

Acesso e segurança

Regras de autenticação e proteção das operações.

Autenticação

  • O login é validado no cadastro de usuários do sistema.
  • O acesso é permitido apenas a usuários administrativos.
  • Usuários bloqueados não conseguem entrar.
  • A sessão utiliza cookie protegido e as APIs exigem autenticação.
  • Ao expirar a sessão, o sistema retorna à tela de login.

Boas práticas

  • Não compartilhe usuário e senha.
  • Use acesso web somente pela URL oficial fornecida pela administração.
  • Encerre a sessão ao usar computador compartilhado.
  • Não publique arquivos INI, banco Firebird, licença ou executáveis em áreas públicas.
  • Mantenha rotinas de backup fora da pasta da aplicação.
!

Esta wiki é pública por natureza

O pacote não contém senhas nem dados do banco. Ao personalizar a documentação, não inclua credenciais, tokens, chaves ou endereços internos sensíveis.

Administração

Configuração do RetaguardaWeb

Visão operacional dos arquivos e serviços necessários.

Componentes

ComponenteFinalidade
RetaguardaWeb.exeAplicação Windows e servidor HTTP local.
RetaguardaWeb.iniPorta web, cliente Firebird, charset e ativação do Cloudflare.
tronrestaurante.iniServidor, arquivo do banco e credenciais Firebird.
RetaguardaWeb.licLicença da aplicação.
cloudflared.exeTúnel opcional para acesso web externo.

Acesso local e web

  • No modo local, o servidor atende apenas no computador onde o aplicativo está executando.
  • A porta padrão é 8480, mas pode ser alterada no INI.
  • Quando o Cloudflare está ativo, o sistema obtém online a porta, o token e a URL pública.
  • Se a internet cair, o acesso local continua e o túnel tenta se reconectar.
  • Ao encerrar o RetaguardaWeb, o processo de túnel iniciado por ele também é encerrado.
i

Compilação

O executável deve ser compilado para Win64 quando utiliza a biblioteca Firebird de 64 bits.

Ajuda

Perguntas frequentes

Respostas rápidas para situações comuns.

Por que o botão Exportar CSV está desabilitado?

Ele é habilitado depois que a consulta retorna pelo menos um registro. Clique em Consultar ou Gerar e confira os filtros.

A busca consulta novamente o banco?

Não. A busca filtra os registros já carregados. Para mudar empresa, período ou situação, altere os filtros e gere novamente.

O CSV contém apenas a página atual?

Não. A exportação usa todos os registros visíveis após filtros e busca, mesmo que a grid esteja paginada.

A impressão de Vendas por Garçom inclui todos os dados?

Sim. O sistema monta todas as linhas consultadas, remove filtros, permite múltiplas páginas e repete os cabeçalhos.

Como visualizar a quantidade de comandas por garçom?

Na aba Totais e Comissão, marque QTD COMANDAS. A coluna considera comandas distintas atendidas por cada garçom.

Como agrupar produtos por classe?

Na aba Vendas por Garçom, marque CLASSE. A grid cria grupos e mostra o resumo de quantidade e total vendido de cada classe.

Posso desfazer uma atualização em lote?

Não há desfazer automático na interface. Por isso, valide os filtros e mantenha backup antes de operações amplas.

Wiki - RetaguardaWebManual