Notas Fiscais Eletrônicas (NF-e)
O módulo de Notas Fiscais Eletrônicas (NF-e) permite cadastrar, consultar, editar e acompanhar o status das notas emitidas no sistema. A tela reúne a listagem das NF-es, filtros, ações por linha, emissão de relatórios, download de XML e um formulário completo com seções fiscais e comerciais.
Visão Geral
A tela de NF-e apresenta uma lista de todas as notas fiscais eletrônicas cadastradas, com funcionalidades para:
- ✅ Adicionar nova NF-e
- ✅ Editar NF-es existentes
- ✅ Visualizar detalhes completos da NF-e
- ✅ Pesquisar NF-es por número, destinatário e outros critérios
- ✅ Filtrar por status, data de saída e empresa
- ✅ Transmitir NF-es selecionadas
- ✅ Gerar relatório em PDF
- ✅ Baixar XML individual ou em lote
- ✅ Imprimir o DANFE
- ✅ Excluir NF-es em rascunho ou com erro, conforme regras de negócio
Acessando o Módulo
Para acessar NF-es:
- Faça login no sistema
- No menu lateral, clique em Fiscal
- Clique em Notas Fiscais Eletrônicas
- A listagem de NF-es será exibida
Lista de NF-es
Na tabela principal, cada linha representa uma NF-e cadastrada.
A lista principal exibe, para cada NF-e:
| Campo | Descrição |
|---|---|
| NÚMERO | Número da NF-e |
| STATUS | Situação da NF-e na SEFAZ (Rascunho, Autorizada, Erro, Cancelada etc.) |
| DATA SAÍDA | Data de saída da mercadoria/serviço |
| EMP | Empresa emissora (código ou sigla) |
| DESTINATÁRIO | Nome do cliente ou fornecedor destinatário |
| VALOR TOTAL | Valor total da NF-e (R$) |
| AÇÕES | Visualizar, editar e menu de configurações |
Status da NF-e
Os status mais comuns são:
| Status | Descrição |
|---|---|
| RASCUNHO | NF-e em elaboração, ainda não enviada/validada |
| AUTORIZADA | NF-e aprovada pela SEFAZ |
| ERRO | Problema na validação/envio da NF-e |
| CANCELADA | NF-e cancelada após autorização |
Na lista, cada status é exibido com uma cor de destaque para facilitar a identificação visual.
Pesquisa, Filtros e Ações em Lote
No topo da listagem, a tela oferece:
- Campo Pesquisar... para busca rápida
- Botão Adicionar Filtro para filtros avançados
Filtros disponíveis:
| Filtro | Descrição |
|---|---|
| Empresa | Restringe a listagem a uma empresa emissora |
| Data de Saída | Filtra por intervalo de datas |
| Status | Filtra por situação da NF-e |
Quando uma ou mais notas são selecionadas, a barra de ações inferior permite executar operações em lote.
Ações em lote
- Transmitir: disponível para NF-es que ainda não estejam AUTORIZADA ou CANCELADA
- Excluir: disponível apenas para NF-es que não estejam AUTORIZADA ou CANCELADA
Estado vazio
Quando não há NF-es cadastradas, a tela exibe:
- Ícone de documento
- Mensagem "Nenhuma NFe encontrada"
- Texto complementar "Comece adicionando sua primeira NFe"
- Botão "Adicionar NFe" para criar a primeira nota
Ações da Lista
Na coluna Ações, as opções típicas incluem:
- Visualizar – abre a NF-e em modo de visualização
- Editar – permite alterar dados da NF-e (conforme status e permissões)
- Imprimir DANFE – disponível para NF-es AUTORIZADA
- Download XML – disponível para NF-es AUTORIZADA com XML autorizado disponível
- Excluir – permitido em NF-es que não estejam AUTORIZADA ou CANCELADA
O menu de configurações por linha desabilita automaticamente ações incompatíveis com o status atual da nota.
Menu do Cabeçalho
No canto superior direito da tela, o menu de três pontos (⋯) oferece:
- Relatórios – gera o PDF da listagem conforme os filtros ativos
- Download XML – abre o modal para baixar XMLs autorizados em lote por período
- Ajuda – abre a documentação do módulo
O relatório em PDF respeita os filtros atualmente aplicados na tela.
Criando ou Editando uma NF-e
Para criar uma nova NF-e:
- Clique no botão "Adicionar NFe" no canto superior direito da listagem
- O formulário será aberto em uma tela com seções (via menu lateral)
- Preencha as informações em cada seção
- Clique em Salvar ou Salvar e Novo
As principais seções do formulário são:
- Informações Básicas
- Destinatário
- Empresa
- Transporte
- Produtos
- Referenciadas
- Vencimentos
- Eventos
Ao fechar o formulário sem salvar, o sistema exibe a confirmação "Deseja sair sem salvar as alterações?".
Seção Informações Básicas
Configura os dados gerais da NF-e.
Campos principais
| Campo | Obrigatório | Descrição |
|---|---|---|
| Número NFe | — | Número da NF-e. Pode ser gerado automaticamente pelo sistema; exibido na tela (ex.: Número NFe: 1) |
| Status | — | Status atual (RASCUNHO, AUTORIZADA, ERRO, CANCELADA etc.) |
| Data de Saída | ✅ | Data e hora da saída da mercadoria/serviço |
| Tipo | ❌ | Entrada ou Saída |
| Consumidor Final | ❌ | Indica se o destinatário é consumidor final (Sim/Não) |
| Natureza da Operação | ✅ | Ex.: Venda, Devolução, Remessa, Compra, Transferência |
| Modelo | ❌ | Modelo da NF-e (ex.: 55) |
| Série | ❌ | Série da nota (ex.: 1) |
| Finalidade de Emissão | ❌ | 1-Normal, 2-Complementar, 3-Ajuste, 4-Devolução |
| Tipo de Frete | ❌ | 0-Emitente, 1-Destinatário, 2-Terceiros, 3-Próprio Remetente, 4-Próprio Destinatário, 9-Sem Frete |
| Forma de Emissão | ❌ | 1-Normal, opções de contingência (FS-IA, SCAN, DPEC, FS-DA, SVC-AN, SVC-RS, Offline NFC-e) |
| Dados Complementares | ❌ | Campo de texto para informações adicionais a serem impressas no DANFE e enviadas à SEFAZ |
No topo da seção, o sistema também exibe os rótulos Número NFe e Status do documento atual.
Seção Destinatário
Define o destinatário da NF-e.
Seleção do destinatário
| Campo | Obrigatório | Descrição |
|---|---|---|
| Cliente | ✅ | Seleção do parceiro de negócios que receberá a nota |
O campo utiliza o seletor Selecionar Parceiro de Negócios, que permite:
- Pesquisar por nome, CPF ou CNPJ
- Navegar pela lista de parceiros disponíveis
- Cadastrar um novo parceiro pelo botão + no próprio modal
O destinatário é obrigatório para salvar a NF-e.
Seção Empresa
Mostra os dados da empresa emissora, como:
- Razão social
- Nome fantasia
- CNPJ
- Endereço completo
Em geral, esses dados vêm da empresa selecionada no contexto do sistema.
Seção Transporte
Permite configurar as informações de transporte, como:
- Transportadora (fornecedor transportador)
- Tipo de frete
- Dados de volumes, peso, espécie e placa/UF do veículo, conforme layout da tela
Seção Produtos
Lista os itens/produtos da NF-e.
Funcionalidades típicas:
- Adicionar produtos através de um seletor ou modal de produto
- Definir quantidade, valor unitário e total
- Configurar tributação (através de modais específicos de tributação)
Os itens seguem o layout fiscal da NF-e, incluindo dados tributários e de classificação quando configurados.
Seções Notas Referenciadas, Vencimentos e Eventos
- Referenciadas – relaciona outras notas (ex.: devoluções e complementares) como referência na NF-e atual.
- Vencimentos – permite cadastrar parcelas de vencimento (datas e valores) quando a NF-e estiver associada a uma condição de pagamento.
- Eventos – lista eventos vinculados à NF-e (ex.: envio, autorização, carta de correção, cancelamento), conforme implementado no módulo.
Download de XML em Lote
Pelo menu do cabeçalho, a opção Download XML abre um modal para baixar XMLs autorizados em arquivo ZIP.
Campos do modal:
| Campo | Descrição |
|---|---|
| Ano | Ano de referência para busca dos XMLs |
| Mês | Mês de referência |
| Empresa | Permite filtrar por uma empresa específica ou usar todas |
O sistema baixa apenas XMLs de NF-e autorizadas dentro do período selecionado.
Boas Práticas
Antes de emitir NF-es, mantenha Clientes, Fornecedores, Produtos e Configurações fiscais devidamente cadastrados para reduzir erros de validação na SEFAZ.
Revise Informações Básicas, Destinatário, Produtos e Totais antes de transmitir a NF-e, especialmente em operações de devolução, remessa ou transferência.
Acompanhe o status (Rascunho, Autorizada, Erro, Cancelada) diretamente na lista de NF-es. Utilize o DANFE e o XML apenas para notas AUTORIZADA.
Próximos Passos
Após dominar o módulo de NF-e:
- Utilize Recebimentos de Compras para importar XMLs de fornecedores
- Configure Tributações e CFOP no menu Fiscal para simplificar o preenchimento das notas
- Explore relatórios fiscais e de faturamento baseados nas NF-es emitidas