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 — Grupos Fiscais

Grupos Fiscais são perfis tributários que você cria uma vez e reutiliza em todos os itens do cardápio. Em vez de configurar CFOP, NCM e alíquotas manualmente em cada nota, você vincula o item ao grupo correto e o sistema preenche tudo automaticamente.

💡 Dica: Crie um grupo para cada categoria principal (ex: "Bebidas", "Pratos Quentes", "Sobremesas"). Itens de uma mesma categoria geralmente têm a mesma tributação.

Onde encontrar

Acesse Configurações no menu lateral
Clique na aba Fiscal (NF-e)
Role até a seção Grupos Fiscais
Clique em + Novo Grupo para criar

Como criar um grupo

Preencha os campos do formulário:

Campo	O que colocar	Exemplo
Nome	Nome descritivo do grupo	`Bebidas Simples Nacional`
CFOP	Código da operação fiscal	`5102` (venda p/ consumidor final)
NCM Padrão	Código NCM dos produtos deste grupo	`2202.10.00`
ICMS Modalidade	CST do ICMS conforme seu regime	`400 — Não contribuinte`
PIS Modalidade	CST do PIS	`07 — Operação isenta`
COFINS Modalidade	CST do COFINS	`07 — Operação isenta`
IBS / CBS Alíquota	Alíquotas da Reforma Tributária (se aplicável)	`0.00`

Clique em Criar Grupo para salvar.

Reforma Tributária — NT 2025.002 (Lucro Real)

⚠️ Esta seção só aparece se o Regime Tributário estiver configurado como 3 — Lucro Real.

Se sua empresa está no regime de Lucro Real (CRT 3), um painel adicional chamado "Reforma Tributária — NT 2025.002" aparece no formulário. Ele solicita os dados exigidos pela nova legislação:

Campo	O que preencher
CST IBS/CBS	Situação tributária do IBS/CBS (ex: `01 — Tributada integralmente`)
Classificação Tributária	Código `cClassTrib` fornecido pelo contador (ex: `1.01.01`)
IBS UF (%)	Alíquota estadual do IBS
IBS Municipal (%)	Alíquota municipal do IBS
CBS (%)	Alíquota federal da CBS

O sistema exibe automaticamente a alíquota total (IBS UF + IBS Municipal + CBS) enquanto você digita.

Para CSTs 02, 03 e 04 (diferimento ou redução), um botão "Avançado" revela campos adicionais:

% Diferimento (gDif): percentual de diferimento da tributação
% Redução de alíquota (gRed): percentual de redução aplicável

💡 Dica: Consulte seu contador para saber os valores corretos de cClassTrib e as alíquotas IBS/CBS para cada categoria de produto.

Vincular um item do cardápio ao grupo fiscal

Acesse Cardápio no menu lateral
Clique em editar no item desejado
No formulário, selecione o Grupo Fiscal correspondente
Salve — a NF-e emitida para pedidos com esse item usará as configurações do grupo automaticamente

Parte 4 — 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 5 — 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 6 — 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 7 — 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 .xml da 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 registradas

O 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 8 — 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.

Parte 9 — Certificado Digital A1

O certificado digital A1 é necessário para emissão direta via SEFAZ. O PopinaFlow monitora automaticamente a validade do certificado.

Upload do certificado

Acesse Fiscal no menu lateral
Clique na aba Certificado
Clique em Enviar Certificado
Selecione o arquivo .p12 ou .pfx
Digite a senha do certificado
Clique em Enviar

Monitoramento automático

O sistema verifica diariamente se o certificado está próximo de expirar:

30 dias antes: alerta amarelo no painel
7 dias antes: alerta vermelho
Expirado: emissão de notas bloqueada

💡 Dica: Renove o certificado com antecedência para evitar interrupção na emissão de notas.

Parte 10 — Convidar o Contador

Seu contador pode acessar um portal exclusivo com os documentos fiscais do restaurante, sem acesso ao cardápio, pedidos ou configurações.

Como convidar

Acesse Fiscal no menu lateral
Clique no botão Convidar Contador (no topo da página)
Digite o email do contador
(Opcional) Digite o nome
Clique em Enviar Convite

O contador receberá um email com link para acessar o portal em /t/:slug/accountant.

O que o contador pode fazer

Recurso	Acesso
Documentos fiscais	Visualizar e baixar DANFE/XML
Download em lote	Baixar todos os XMLs em ZIP
SPED Fiscal	Gerar EFD ICMS/IPI
SPED Contribuições	Gerar EFD Contribuições
DeRE	Gerar relatório de resultado
Split Payment	Visualizar simulação de impacto

💡 Dica: O contador não consegue emitir, cancelar ou modificar nenhuma nota — apenas consultar e exportar.

Parte 11 — Painel Fiscal (Dashboard)

O Painel Fiscal mostra um resumo consolidado da situação fiscal do restaurante.

Como acessar

No menu lateral, clique em Painel Fiscal (seção Gestão)

O que você verá

Status do certificado A1 — verde (válido), amarelo (expirando), vermelho (expirado)
Notas autorizadas — total do mês
Notas rejeitadas — atenção se houver muitas
Notas pendentes — aguardando retorno da SEFAZ
Emissão por tipo — NF-e, NFC-e, NFS-e

Parte 12 — CNPJ Alfanumérico (Julho 2026)

A partir de julho de 2026, a Receita Federal passará a emitir CNPJs com letras (A-Z) nas 12 primeiras posições.

O que muda no PopinaFlow

O campo de CNPJ nas configurações agora aceita letras e números
O formato é: AA.BBB.CCC/DDDD-99 (onde A-D podem ser letras ou números)
A validação (Módulo 11) funciona automaticamente para ambos os formatos
As notas fiscais geradas já suportam o novo formato

💡 Dica: Se sua empresa ainda tem CNPJ numérico, nada muda. O sistema é compatível com os dois formatos.

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, 2 ou 3)
[ ] Token de produção configurado (diferente do de homologação)
[ ] Trocou o campo Ambiente para producao
[ ] Grupos fiscais criados para as categorias principais do cardápio
[ ] Itens do cardápio vinculados ao grupo fiscal correspondente
[ ] Certificado digital A1 válido (enviado na aba Certificado)
[ ] Contador convidado (opcional, mas recomendado)

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)
Nota rejeitada "NCM inválido" ou "CST inválido"	NCM/CST incorreto no grupo fiscal	Verifique o grupo fiscal vinculado ao item e corrija o NCM ou CST
Certificado expirando	Faltam menos de 30 dias para vencer	Renove o certificado digital A1
Emissão automática não funciona	`autoEmitOnPayment` não está ativo	Ative nas configurações do tenant
NCM não encontrado	Item não tem NCM configurado	Use a busca NCM no grupo fiscal

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

Controle Fiscal ​

O que você precisa ​

Parte 1 — Configurar o PIX ​

Passo 1: Abrir Configurações ​

Passo 2: Preencher os dados PIX ​

Como funciona no PDV ​

Parte 2 — Configurar a Emissão de NF-e ​

Passo 1: Criar conta no Focus NFe ​

Passo 2: Preencher os dados fiscais ​

Parte 3 — Grupos Fiscais ​

Onde encontrar ​

Como criar um grupo ​

Reforma Tributária — NT 2025.002 (Lucro Real) ​

Vincular um item do cardápio ao grupo fiscal ​

Parte 4 — Emitir uma Nota Fiscal ​

Passo a passo ​

Verificar o resultado ​

Parte 5 — Baixar DANFE e XML ​

Parte 6 — Cancelar uma Nota Fiscal ​

Parte 7 — Importar Nota de Fornecedor (NFS) ​

Passo a passo ​

Resultado da importação ​

O que acontece automaticamente ​

Parte 8 — Vincular Cardápio ao Estoque ​

Como configurar ​

Como funciona ​

Parte 9 — Certificado Digital A1 ​

Upload do certificado ​

Monitoramento automático ​

Parte 10 — Convidar o Contador ​

Como convidar ​

O que o contador pode fazer ​

Parte 11 — Painel Fiscal (Dashboard) ​

Como acessar ​

O que você verá ​

Parte 12 — CNPJ Alfanumérico (Julho 2026) ​

O que muda no PopinaFlow ​

Checklist: Antes de Começar a Emitir Notas Reais ​

Problemas Comuns ​

Próximos Passos ​

Controle Fiscal

O que você precisa

Parte 1 — Configurar o PIX

Passo 1: Abrir Configurações

Passo 2: Preencher os dados PIX

Como funciona no PDV

Parte 2 — Configurar a Emissão de NF-e

Passo 1: Criar conta no Focus NFe

Passo 2: Preencher os dados fiscais

Parte 3 — Grupos Fiscais

Onde encontrar

Como criar um grupo

Reforma Tributária — NT 2025.002 (Lucro Real)

Vincular um item do cardápio ao grupo fiscal

Parte 4 — Emitir uma Nota Fiscal

Passo a passo

Verificar o resultado

Parte 5 — Baixar DANFE e XML

Parte 6 — Cancelar uma Nota Fiscal

Parte 7 — Importar Nota de Fornecedor (NFS)

Passo a passo

Resultado da importação

O que acontece automaticamente

Parte 8 — Vincular Cardápio ao Estoque

Como configurar

Como funciona

Parte 9 — Certificado Digital A1

Upload do certificado

Monitoramento automático

Parte 10 — Convidar o Contador

Como convidar

O que o contador pode fazer

Parte 11 — Painel Fiscal (Dashboard)

Como acessar

O que você verá

Parte 12 — CNPJ Alfanumérico (Julho 2026)

O que muda no PopinaFlow

Checklist: Antes de Começar a Emitir Notas Reais

Problemas Comuns

Próximos Passos