Gestão de Terminais

Tempo estimado: 30 minutos por terminal novo

O Que É um Terminal (PDV)

Um terminal é cada ponto físico de operação — cada caixa, cada balcão de pedido, cada kiosk. No PopinaFlow, cada PDV tem:

• Identidade própria (nome, slug)
• Pertence a uma filial
• Configuração de hardware (impressora, pinpad, balança)
• Regras de roteamento (qual categoria vai para qual impressora)

Onde Acessar

/admin/terminals (Filiais → Gestão de Terminais).

Cadastrando

1. Terminais → Novo PDV
2. Preencha:
   • Nome (ex.: "Caixa 1", "Balcão 2", "Kiosk Entrada")
   • Slug (URL-friendly: "caixa-1")
   • Filial — qual unidade
   • Tipo:
     • PDV padrão (caixa)
     • Balcão (alta rotatividade)
     • Kiosk (autoatendimento)
     • Manager (só painéis, não opera)

Configuração de Impressora

Por PDV, defina:

• Impressora de comprovante — IP/USB
• Impressora de cozinha — pode ser a mesma ou separada
• Impressora de label — etiquetas de produto, vales
• Modo de papel — térmico (bobina 80mm comum)

Em Print Routing, defina por categoria:

• "Bebidas" → impressora do bar
• "Pratos quentes" → impressora da cozinha
• "Sobremesas" → impressora da copa
• "Order" → orphan items (sem categoria roteada)

Configuração de Pinpad TEF

Para pagamento direto no PDV:

• Provedor — Stone / Rede / Sitef / etc.
• Terminal ID (fornecido pelo provedor)
• Modo — TCP (rede) ou Serial (USB)
• Timeout — quantos segundos esperar resposta (60s padrão)

Configure credenciais em Sistema → Pagamentos → Gateway primeiro.

Configuração de Balança (Bakery/Açougue)

Se PDV vende produtos pesados (peixe, carne, pão a granel):

• Modelo — Toledo / Filizola / outras
• Conexão — Serial / USB / TCP
• Modo — captura automática (peso vai direto para o item)

Sem balança configurada, operador entra peso manualmente — fonte de erro.

Configuração de Cliente Display (CD)

Display que mostra ao cliente os items à medida que são batidos. Comum em mercados, opcional em restaurante.

• Modelo — Bematech / Tanca / etc.
• Conexão

Permissões por PDV

Funcionário pode ser limitado a usar apenas certos PDVs (em vez de qualquer):

• Em Usuários → :id → PDVs, atribua os terminais permitidos
• Tenta logar em outro PDV → bloqueado

Útil para casas com vários caixas onde você quer rastreabilidade clara de quem operou onde.

Auto-fechamento de Comanda (Kiosk)

Para kiosks de autoatendimento:

• Tempo de inatividade — 90s sem toque → volta para tela inicial (cancela carrinho)
• Cliente pode finalizar — sim/não (se pinpad disponível)
• Imprime senha — sempre (para o cliente acompanhar pedido)

Manutenção

• Status do terminal — verde (online), amarelo (sem heartbeat 5min), vermelho (offline 10min+)
• Diagnóstico — botão "Testar conexão" verifica impressora, pinpad, balança individualmente
• Reiniciar — software-only restart do PDV (sem mexer no hardware)

Erros Comuns

• "Comanda não imprime na cozinha" — Print Routing configurado? Categoria do item está mapeada?
• "Pinpad fica chamando 'aguardando cartão'" — verifique cabo, drive, ou que o terminal está cadastrado no provedor
• "Balança não captura peso" — driver instalado? Cabo bom? COM port correto (Windows) ou /dev/ttyUSB0 (Linux)?