Skip to content

Gerenciamento de Filiais e Terminais

O PopinaFlow organiza a operação em dois níveis: a Filial (a loja física) e os Terminais PDV (os caixas onde as vendas acontecem). Uma filial pode ter vários terminais operando ao mesmo tempo.


Entendendo a hierarquia

Restaurante (Tenant)
  └── Filial (loja física)
        ├── Caixa 1 (PDV)  ←  operador Ana
        ├── Caixa 2 (PDV)  ←  operador João
        └── Caixa 3 (PDV)  ←  aguardando abertura
  • A Filial tem seu próprio CNPJ, endereço e configurações fiscais.
  • Cada Terminal PDV tem um operador ativo, um fundo de caixa e registra suas próprias vendas.
  • O Relatório Diário da Filial soma automaticamente todos os terminais.

Acessando a lista de filiais

  1. No menu lateral do Admin, clique em Filiais
  2. Você vê todas as filiais do restaurante com o status de cada uma
  3. Clique em uma filial para ver detalhes ou entrar na visão completa dela

Acesso direto

Você pode salvar nos favoritos a URL de uma filial: /t/seu-restaurante/admin/b/nome-da-filial/overview


Criando uma filial

  1. Na lista de filiais, clique em + Nova Filial
  2. Preencha os campos obrigatórios:
    • Nome — como você quer chamar internamente (ex: "Unidade Centro")
    • CNPJ — se esta filial tem CNPJ próprio (diferente da sede)
    • Endereço — cidade e estado no mínimo
  3. Clique em Salvar

Depois de criar, você pode configurar os terminais desta filial.


Configurando uma filial

Clique na filial → aba Configurações:

Identidade

CampoO que é
NomeNome exibido nos relatórios
CNPJCNPJ para emissão de NF-e nesta unidade
Token Focus NFeToken da API fiscal (se diferente da sede)
Filial ativaLiga/desliga a filial

Endereço e GPS

Preencha o endereço completo. Ative o Cerca GPS para exigir que os operadores estejam dentro de um raio ao abrir o caixa (útil para garantir presença física).

Gerente responsável

Atribua um gerente para esta filial. O gerente receberá permissão de ver relatórios e gerenciar terminais desta unidade sem acesso às outras filiais.


Gerenciando terminais (PDVs)

Acessar os terminais

  1. No menu admin, clique em Terminais
  2. Selecione a filial no seletor à esquerda
  3. Você vê o grid de terminais desta filial

Cada card de terminal mostra:

  • Nome do terminal
  • Status (ativo/inativo com indicador colorido)
  • Operador atual (se houver turno aberto)
  • Receita do turno em andamento

Criar um terminal

  1. No grid de terminais, clique em + Novo Terminal
  2. Preencha:
    • Nome — ex: "Caixa 1", "Balcão Principal"
    • Modo de serviço — como este caixa opera (ver abaixo)
    • Filial — selecione a filial onde este terminal fica
  3. Salve

Modos de serviço

ModoQuando usar
MesaGarçom atende clientes em mesas numeradas
BalcãoAtendente opera o caixa para o cliente
AutoatendimentoQuiosque — cliente faz o pedido sozinho
Balcão ClienteCliente faz pedido e paga no terminal (fluxo rápido)

Abrindo uma sessão de caixa (turno)

O que é um turno?

Um turno registra o período de trabalho de um operador em um terminal. Ao fechar, o sistema calcula automaticamente quanto cada forma de pagamento rendeu.

Via painel admin (gerente abre para o operador):

  1. Acesse Terminais → selecione a filial
  2. No card do terminal desejado, clique em Abrir Caixa
  3. Informe:
    • Operador — quem vai operar o terminal
    • Fundo de caixa — dinheiro colocado na gaveta para dar troco (ex: R$ 100,00)
  4. Clique em Abrir Turno

O terminal aparece com o indicador verde e o nome do operador.

Via terminal PDV (operador abre sozinho):

  1. Operador faz login no PDV e seleciona o terminal
  2. Se não houver turno aberto, aparece a tela "Abrir Turno"
  3. Informa o fundo de caixa e confirma

Cerca GPS ativada?

Se a filial tem GPS configurado, o sistema verifica se o operador está dentro do raio permitido. Se estiver fora, a abertura é bloqueada.


Fechando uma sessão de caixa

  1. No PDV ou painel admin, clique em Fechar Turno
  2. Conte o dinheiro físico na gaveta e informe o valor
  3. O sistema mostra o resumo do turno:
O que apareceO que significa
Receita totalSoma de todas as vendas do turno
DinheiroTotal vendido com pagamento em dinheiro
PIXTotal vendido em PIX
CartãoTotal vendido em cartão (crédito + débito)
Fundo de caixaValor que você colocou na abertura
Diferença de caixaDinheiro contado − dinheiro esperado
  1. Confirme o fechamento

Diferença de caixa

Se a diferença for negativa: tem mais dinheiro na gaveta do que esperado (sobra). Se for positiva: tem menos dinheiro do que esperado (falta). O gerente irá reconciliar este valor.


Reconciliação pelo gerente

Após o fechamento, o gerente pode revisar e reconciliar:

  1. Acesse Turnos → filtre por Status: Fechado
  2. Clique no turno para ver detalhes
  3. Revise a diferença de caixa
  4. Adicione notas de reconciliação (opcional)
  5. Clique em Reconciliar — o turno é marcado como conferido

Relatório diário da filial

O relatório diário consolida todos os terminais da filial em um único painel:

  1. Acesse Filiais → clique na filial
  2. Na visão da filial, clique em Relatório Diário (ou acesse pelo menu de Terminais)
  3. Selecione a data

O relatório mostra:

  • Totais da filial: receita total, dinheiro, PIX, cartão, número de pedidos, turnos
  • Por terminal: mesmos dados separados por PDV

Isso permite identificar qual caixa teve melhor desempenho no dia e se há variações de performance entre operadores.


Visão completa da filial

Para uma análise mais profunda, acesse a visão dedicada da filial:

  1. Na lista de filiais, clique na linha da filial
  2. No painel de detalhes, clique em Entrar na filial →

Dentro da visão de filial você tem:

SeçãoO que tem
Visão GeralMétricas do dia, últimos pedidos
EstoqueNível de estoque desta filial
PedidosTodos os pedidos desta filial
PagamentosMovimentações financeiras
MesasGestão de mesas (se modo Mesa)
BalcãoSpots do balcão (se modo Balcão)
ConfiguraçõesEditar dados, fiscal, pagamento

Permissões por perfil

PerfilO que pode fazer
AdminCriar/editar filiais, criar terminais, abrir/fechar/reconciliar qualquer turno, ver todos os relatórios
Gerente de FilialAbrir/fechar/reconciliar turnos da sua filial, ver relatório diário da sua filial, gerenciar terminais da sua filial
AtendenteOperar o terminal atribuído, abrir e fechar o próprio turno

Perguntas frequentes

Posso ter dois operadores no mesmo terminal? Não. Cada terminal comporta um turno aberto por vez. Se outro operador precisar usar o mesmo terminal, o turno atual precisa ser fechado primeiro.

O que acontece se o operador sair sem fechar o turno? O sistema detecta o turno aberto na próxima abertura do mesmo terminal e fecha automaticamente. O gerente deve reconciliar depois.

Como atribuir um gerente a uma filial? Nas Configurações da filial, campo Gerente responsável. Após atribuir, configure as permissões no Gerenciamento de Usuários → Funções.


Veja Também

Lançado sob a licença MIT.