Configurações Gerais

Tempo estimado: 30 minutos para configurar do zero

Onde Acessar

/admin/settings — hub central de configuração do tenant.

Organizado em abas:

Aba "Geral"

• Nome do estabelecimento (visível para clientes)
• CNPJ + Razão social (para NF-e)
• Endereço completo (também usado em NF-e e geocoding)
• Telefone
• Email principal
• Horário de funcionamento — por dia da semana, com possibilidade de feriados

Aba "White Label" (Branding)

• Logo — upload de PNG/SVG (recomendado 512×512px transparente)
• Cor primária — color picker
• Domínio customizado — se você tem meurestaurante.com.br, aponte CNAME para popinaflow.com e configure aqui
• Favicon — opcional, para abas do navegador

Cor primária aparece em:

• Botões principais
• Header do PDV
• Email transacional
• Página de tracking do cliente

Aba "Módulos"

Habilite/desabilite módulos que você usa:

• Reservas / Mesas
• Delivery
• Marketplace (iFood, etc.)
• Fiscal (NFC-e)
• Loyalty
• Bar / Cashless
• Production (PCP)
• Scheduling (escalas)
• HCM (RH lite)

Módulos desabilitados não aparecem no menu e seus endpoints retornam 403. Reduz fricção visual para casas que não usam tudo.

Aba "Notificações"

• Email principal para alertas administrativos
• WhatsApp integração (Evolution API) — telefone para notificações de pedido
• SMS — Twilio se quiser SMS para clientes
• Notificações push — para app cliente

Configure por evento:

• Novo pedido delivery → push + WhatsApp
• KPI breach → email
• SLA breach → email + WhatsApp

Aba "Pagamentos"

Ver payment-config.md para detalhes. Resumo:

• Cadastrar gateways (Stone, Rede, Stripe, MercadoPago)
• Cascata por canal (qual tenta primeiro)
• Limites de transação

Aba "Fiscal"

• Certificado digital A1 (upload .pfx) — necessário para NF-e
• Token Focus NFe (provedor)
• Regime tributário (Simples / Presumido / Real)
• Configuração CFOP / CST / CSOSN por categoria de produto

Aba "Segurança"

• MFA obrigatório para admins (recomendado)
• PIN supervisor (4-8 dígitos)
• Limite de discount por função (ver roles-and-permissions.md)
• API keys — gerar tokens para integrações externas
• IP allowlist (opcional, restringe acesso à conta admin a IPs específicos)

Aba "LGPD"

• Designar DPO (Data Protection Officer) — pessoa ou área
• Política de privacidade — texto público
• Política de retenção — quanto tempo guardar cada tipo de dado
• Texto de consentimento — apresentado no cadastro de cliente

Aba "Integrações"

• Google Maps API key (para delivery zones)
• Mapbox token (para mapas)
• Stripe (assinatura SaaS)
• Open Banking (em roadmap)

Aba "Cobrança" (Billing)

Veja billing.md. Resumo: plano atual, método de pagamento, faturas.

Quem Pode Editar

• Admin do tenant — todas as abas
• Branch manager — apenas configurações da própria filial (subset)
• Outras funções — nada

Auditoria registra cada mudança crítica (mudança de plano, integração de pagamento, etc.).

Erros Comuns

• "Mudei a cor mas não atualizou" — cache do navegador. F5 força refresh ou limpe cache.
• "NFC-e parou de emitir" — certificado digital expirou. Faça upload do novo .pfx.
• "Cliente não está recebendo email" — verifique caixa de spam, depois SPF/DKIM do seu domínio (peça ao DevOps).