10.1 – Importar Nota Fiscal Eletrônica (NFe)
Objetivo:
Permitir que a academia cadastre fornecedores, produtos e atualize estoques de forma automática através do upload do arquivo XML da NFe.
🔧 Fluxo Completo da Funcionalidade
1. Acesso à Página de Produtos
O usuário acessa:
Produtos e Serviços → Produtos → Importar NFe
Aqui existe o botão “Importar NFe”, que abre o modal para upload do XML.
📂 2. Seleção do Arquivo XML
O usuário pode:
Ou clicar para escolher o arquivo
Depois de selecionar, o botão Importar NFe é habilitado.
🧠 3. Leitura e Processamento do XML
O sistema lê automaticamente os dados da nota:
3.1 Dados da Nota
🧾 4. Cadastro Automático do Fornecedor
O sistema verifica:
🔍 Se o fornecedor (CNPJ) já existe
Caso exista → vincula automaticamente
Caso não exista → pré-preenche o cadastro com os dados do XML:
O usuário pode:
✔ Cadastrar fornecedor
✔ Ou marcar “Não vincular” (casos muito raros)
📦 5. Leitura dos Produtos da Nota
Para cada produto encontrado no XML:
O sistema extrai:
🧲 6. Verificação de Produtos Existentes
Para cada item da NFe, o sistema verifica:
✔ Se SIM:
Produto é atualizado com as informações da nota (se necessário)
Produto aparece já selecionado na lista para importação
✔ Se NÃO:
O sistema pré-cadastra automaticamente um novo produto com:
Preço (com base no valor unitário)
O usuário pode clicar no item para revisar os campos antes de confirmar.
📥 7. Revisão antes da importação
O usuário vê:
Produtos da NFe
Lista com checkbox de seleção:
🧾 8. Confirmação da Importação
Ao clicar em:
Confirmar Importação (X produtos)
O sistema faz:
✔ Entrada no estoque
Atualiza o estoque de todos os produtos selecionados.
✔ Cadastro do fornecedor (se foi escolhido)
✔ Registro de histórico da Nota Fiscal:
Lista de produtos importados
📊 9. Resultado final
Após a importação:
✔ Produtos aparecem automaticamente na lista
✔ Estoque atualizado
✔ Preço atualizado (se desejar sincronizar com custo)
✔ Histórico da NFe salvo
✔ Produto aparece vinculado ao estoque padrão