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 NF-es emitidas e recebidas pelo sistema. Você pode visualizar o histórico de notas, conferir status na SEFAZ, imprimir o DANFE e gerenciar informações fiscais como natureza da operação, destinatário, transportador, produtos, vencimentos e eventos.
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 (enquanto em rascunho ou com restrições definidas)
- ✅ Visualizar detalhes completos da NF-e
- ✅ Pesquisar NF-es por número, destinatário e outros critérios
- ✅ Filtrar por status, datas e empresa
- ✅ 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
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 e hora 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, configurações, impressão e exclusão conforme permissõ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 (verde para autorizada, amarelo para rascunho, vermelho para erro, cinza para 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 Autorizadas
- Excluir – permitido em NF-es em Rascunho ou com Erro, conforme regra de negócio
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
- Salve o rascunho e, conforme o fluxo da aplicação, siga para validação e envio à SEFAZ
As principais seções do formulário são:
- Informações Básicas
- Destinatário
- Empresa
- Transporte
- Produtos
- Notas Referenciadas
- Vencimentos
- Eventos
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 |
Seção Destinatário
Define o destinatário da NF-e (cliente ou fornecedor).
Campos principais
| Campo | Obrigatório | Descrição |
|---|---|---|
| Tipo de Destinatário | ✅ | Cliente ou Fornecedor |
| Cliente / Fornecedor | ✅ | Seleção do registro cadastrado, usando o respectivo seletor (modal) |
O sistema utiliza seletores como ClienteModalSelector e FornecedorSelector, permitindo pesquisar e escolher o destinatário. Ao trocar o tipo de destinatário, o sistema limpa o ID atual para evitar inconsistências.
Seção Empresa
Mostra/seleciona os dados da empresa emissora, como:
- Razão social
- Nome fantasia
- CNPJ
- Endereço completo
Em geral, esses dados vêm da empresa logada e não precisam ser alterados em cada nota.
Seção Transporte
Permite configurar as informações de transporte, como:
- Transportadora (fornecedor transportador)
- Tipo de frete (já definido em Informações Básicas)
- 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 (NCM, CFOP, CST/CSOSN, etc.), configurado em componentes especializados do módulo nfe.
Seções Notas Referenciadas, Vencimentos e Eventos
- Notas Referenciadas – relaciona outras notas (ex.: devoluções, 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.
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 apenas para notas Autorizadas.
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