Controle Fiscal
Tempo estimado: 20 minutos
Este guia explica como usar os recursos fiscais do PopinaFlow: configuração inicial, emissão de notas fiscais, pagamentos via PIX e importação de notas de fornecedor.
O que você precisa
- ✅ Acesso de administrador do restaurante
- ✅ CNPJ do estabelecimento
- ✅ Conta na plataforma Focus NFe (para emissão de NF-e)
- ✅ Chave PIX cadastrada no banco (para pagamentos PIX)
Parte 1 — Configurar o PIX
Configure uma vez. Depois disso, o QR Code PIX é gerado automaticamente no terminal de vendas.
Passo 1: Abrir Configurações
- Acesse o painel admin do restaurante
- No menu lateral, clique em Configurações
- Desça até a seção PIX
Passo 2: Preencher os dados PIX
| Campo | O que colocar | Exemplo |
|---|---|---|
| Chave PIX | Sua chave cadastrada no banco (CPF, CNPJ, e-mail, telefone ou chave aleatória) | 12345678000195 |
| Nome do Beneficiário | Nome exibido no app do cliente (máx 25 caracteres) | Restaurante Bom Sabor |
- Clique em Salvar
Como funciona no PDV
Após salvar, quando o atendente selecionar PIX como forma de pagamento no terminal:
- O sistema gera automaticamente um QR code PIX com o valor do pedido
- A tela exibe o QR code e o código "Copia e Cola"
- O cliente escaneia com o app do banco
- O atendente clica Pagamento Confirmado após ver o comprovante
💡 Dica: O QR code já vem com o valor exato do pedido preenchido — o cliente não precisa digitar nada.
Parte 2 — Configurar a Emissão de NF-e
Passo 1: Criar conta no Focus NFe
- Acesse focusnfe.com.br
- Crie uma conta e configure seu CNPJ e certificado digital A1/A3
- Anote o token de API gerado
Atenção: Comece sempre no ambiente de homologação (testes). Você só muda para produção depois de validar o fluxo.
Passo 2: Preencher os dados fiscais
- Acesse Configurações → Fiscal (NF-e)
- Preencha os campos:
| Campo | O que colocar | Exemplo |
|---|---|---|
| CNPJ | CNPJ do estabelecimento (sem pontos/traços) | 12345678000195 |
| Inscrição Estadual | IE do estabelecimento (se houver) | 123456789012 |
| Token Focus NFe | Token da API (copiado do painel Focus) | abc123xyz... |
| Ambiente | homologacao para testes / producao para uso real | homologacao |
| Regime Tributário | 1 = Simples Nacional · 2 = Lucro Presumido · 3 = Lucro Real | 1 |
| Endereço | Logradouro do estabelecimento | Rua das Flores |
| Número | Número do endereço | 100 |
| Bairro | Bairro | Centro |
| Cidade | Município | São Paulo |
| Estado | UF em 2 letras | SP |
| CEP | CEP (sem hífen) | 01310100 |
- Clique em Salvar
Parte 3 — Emitir uma Nota Fiscal
A nota fiscal é emitida após o pedido ser entregue.
Passo a passo
- Acesse Pedidos no menu lateral
- Encontre o pedido com status Entregue
- Clique na linha do pedido para expandir os detalhes
- Você verá dois botões na parte inferior:
| Botão | Quando usar |
|---|---|
| NFC-e | Consumidor final — venda no balcão ou mesa (sem necessidade de CPF) |
| NF-e | Pessoa jurídica ou quando o cliente pede CPF na nota |
- Clique no botão desejado
- O sistema envia a nota à SEFAZ via Focus NFe automaticamente
Verificar o resultado
Acesse NF-e no menu lateral para ver o status da nota:
| Status | O que significa |
|---|---|
| Pendente | Enviada, aguardando retorno da SEFAZ |
| Autorizada | ✅ Aprovada — DANFE e XML disponíveis para download |
| Rejeitada | ❌ Recusada — veja o erro e corrija |
| Cancelada | Nota cancelada pelo operador |
Parte 4 — Baixar DANFE e XML
Quando a nota estiver Autorizada:
- Acesse NF-e no menu lateral
- Encontre a nota na lista
- Clique nos links:
- DANFE → abre o PDF para impressão ou envio ao cliente
- XML → arquivo para escrituração contábil
💡 Dica: Envie o DANFE por e-mail ou WhatsApp para o cliente que pediu nota.
Parte 5 — Cancelar uma Nota Fiscal
Errou na emissão? Você pode cancelar a nota antes do prazo legal (geralmente 24 horas após autorização).
- Acesse NF-e no menu lateral
- Encontre a nota autorizada
- Clique em Cancelar
- Confirme a ação
⚠️ Atenção: Após o prazo legal, o cancelamento pode ser recusado pela SEFAZ. Em caso de erro grave, consulte seu contador.
Parte 6 — Importar Nota de Fornecedor (NFS)
Quando receber mercadoria de um fornecedor com nota fiscal, você pode importar o XML diretamente para atualizar o estoque automaticamente.
Passo a passo
- Acesse Estoque no menu lateral
- Clique em Importar NFS (ícone de upload no canto superior)
- Selecione o arquivo
.xmlda nota fiscal do fornecedor - Aguarde o processamento
Resultado da importação
O sistema exibe um resumo:
✓ Importação concluída
NF-e: 35260312345678000195...
Emitente: FORNECEDOR LTDA
✓ 12 itens processados
• 3 itens novos cadastrados
• 9 itens atualizados
• 12 movimentações de entrada registradasO que acontece automaticamente
- Produtos novos: São cadastrados no estoque com nome, código, unidade e custo do XML
- Produtos já cadastrados: Têm a quantidade atualizada (entrada registrada)
- Movimentação: Cada produto ganha um registro de entrada com a quantidade e custo da nota
💡 Dica: Você consegue o arquivo XML com a nota fiscal do fornecedor — normalmente enviado por e-mail ou disponível no portal do fornecedor.
Parte 7 — Vincular Cardápio ao Estoque
Com o vínculo ativo, o sistema deduz o estoque automaticamente toda vez que um pedido é entregue.
Como configurar
- Acesse Cardápio no menu lateral
- Clique em editar no item desejado (ex: "Filé ao molho")
- No formulário, procure o campo Item de Estoque
- Selecione o ingrediente principal correspondente (ex: "Filé Mignon — kg")
- Salve
Como funciona
Pedido entregue
↓
Sistema verifica itens do pedido com vínculo de estoque
↓
Registra saída automática: 1 porção = quantidade configurada
↓
Estoque atualizado💡 Dica: Configure o vínculo nos itens mais importantes primeiro — carnes, bebidas e produtos com alto valor de estoque.
Checklist: Antes de Começar a Emitir Notas Reais
Antes de trocar o ambiente para produção, verifique:
- [ ] Testou emissão em homologação e a nota foi autorizada
- [ ] CNPJ e IE corretos em Configurações → Fiscal
- [ ] Endereço completo preenchido
- [ ] Certificado digital configurado no painel Focus NFe
- [ ] Regime tributário correto (
1,2ou3) - [ ] Token de produção configurado (diferente do de homologação)
- [ ] Trocou o campo Ambiente para
producao
Problemas Comuns
| Problema | Causa provável | Solução |
|---|---|---|
| Nota rejeitada "CNPJ inválido" | Dígitos errados ou com formatação | Verifique os 14 dígitos em Configurações → Fiscal |
| Nota rejeitada "Token inválido" | Token desatualizado ou de outro ambiente | Copie o token correto do painel Focus NFe |
| Botão NF-e não aparece | Pedido não está no status Entregue | Atualize o status do pedido para Entregue primeiro |
| QR PIX não aparece | pixKey não configurada | Preencha a Chave PIX em Configurações → PIX |
| Importação NFS falhou | XML inválido ou de outra versão | Use o arquivo XML original, sem edições |
| DANFE não abre | Nota ainda pendente | Aguarde a autorização pela SEFAZ (pode levar alguns segundos) |
Próximos Passos
- Gestão de Estoque — Como cadastrar e movimentar produtos manualmente
- Gerenciando Pedidos — Fluxo completo dos pedidos
- FAQ — Controle Fiscal — Dúvidas rápidas sobre NF-e e PIX