---
title: "Notas Fiscais"
description: "Gestão das NFS-e emitidas pelo módulo NFE.io no WHMCS — listagem, status, ações de reemissão, cancelamento, envio por e-mail e emissão manual a partir da fatura."
source_url: https://nfe.io/docs/plugins/whmcs/notas-fiscais
last_updated: 2026-07-30
---

Todas as notas emitidas pelo módulo ficam listadas em `Addons -> NFE.io NFSe -> Notas Fiscais (NFSe)`.

![Listagem de notas fiscais emitidas pelo módulo](https://nfe.io/docs/../assets/img/nfeio-whmcs-notas-fiscais.png)

## A listagem

A tabela apresenta as seguintes colunas:

| Coluna | Conteúdo |
| --- | --- |
| **Fatura** | Número da fatura do WHMCS vinculada à nota |
| **NFe.io ID** | Identificador da nota na NFE.io |
| **Status** | Situação atual da nota (veja a tabela abaixo) |
| **Cliente** | Cliente da fatura |
| **Valor** | Valor dos serviços da nota |
| **Emissor** | CNPJ e nome da empresa emissora |
| **Gerado em** | Data de criação do registro da nota |

A listagem é ordenada por data de criação, da mais recente para a mais antiga. Passe o mouse sobre o status para ver a descrição detalhada do fluxo retornado pela API.

## Status das notas

| Status | Significado |
| --- | --- |
| **Aguardando** | Nota na fila de processamento do módulo |
| **Criada** | Registro criado, aguardando processamento na NFE.io |
| **Emitida** | Nota emitida com sucesso pela prefeitura |
| **Cancelada** | Nota cancelada com sucesso |
| **Falha no Cancelamento** | A tentativa de cancelamento não foi concluída |
| **Erro** | Falha na emissão — consulte os detalhes da nota e o Log de Módulo |
| **CEP do cliente inválido** | O CEP cadastrado no cliente impediu a emissão |
| **Não Disponível** | Sem informação de status disponível |

Estados intermediários do fluxo de emissão (exibidos como descrição do status) incluem: fila de emissão, cálculo de impostos, definição do número do RPS, envio à prefeitura, aguardando retorno da prefeitura e download do PDF.

:::tip Nota com status "Erro"

Abra **Detalhes** para ver o código e a mensagem retornados pela API. Causas frequentes: CPF/CNPJ do cliente inválido ou ausente, CEP inválido, código de serviço municipal incorreto para o emissor e campos fiscais obrigatórios não preenchidos.

:::

## Ações disponíveis

Cada linha da tabela oferece o botão **Detalhes** e um menu **Ações**.

### Detalhes

Abre um resumo da nota com o ID na NFE.io, fatura, status e descrição do fluxo, data de criação, cliente, valor, emissor, código de serviço e a mensagem retornada pela API na última atualização.

### Atualizar

Consulta a NFE.io e sincroniza o status da nota no módulo. Útil quando o [webhook de callbacks](./webhook.md) não está entregando as atualizações.

### Visualizar

Abre a nota no painel da NFE.io, em nova aba.

### Reemitir NFSe

Gera novamente a nota a partir dos dados da fatura, preservando os atributos fiscais da nota original.

> Disponível apenas para notas com status **Cancelada** ou **Falha no Cancelamento**.

### Enviar e-mail

Envia a nota fiscal por e-mail ao cliente. A mensagem é disparada pela plataforma da NFE.io para o endereço principal cadastrado no perfil do cliente.

> Indisponível para notas canceladas ou com erro de emissão.

### Cancelar NFSe

Cancela a nota na NFE.io.

:::warning O cancelamento atinge toda a série da fatura

Quando uma fatura gerou mais de uma nota (por conter serviços com classificações fiscais diferentes), o cancelamento cancela **toda a série de notas daquela fatura**.

Se apenas parte da série for cancelada com sucesso, o módulo exibe um aviso listando as notas que falharam. Nesse caso, verifique se a empresa emissora configurada para a fatura ainda é a mesma que emitiu as notas.

:::

## Ações na tela da fatura

O módulo também adiciona controles na tela da fatura no admin do WHMCS:

- **Emitir Nota Fiscal**: emissão manual, exibida quando a fatura ainda não possui notas e não está em rascunho (`Draft`).
- **Reemitir série NFS-e**: exibido quando todas as notas da fatura estão canceladas.
- **Cancelar série NFS-e**: exibido quando existe ao menos uma nota não cancelada.
- Lista das notas da fatura com status e as ações **Visualizar** e **Enviar e-mail**.

## Na área do cliente

Quando o template `viewinvoice.tpl` do WHMCS é ajustado conforme a [Configuração](./configuracao.md), o cliente passa a ver as notas vinculadas à fatura com botões de download de **PDF** e **XML**.

## Diagnóstico

Com o **Modo Depuração** ativo, todas as chamadas à API — payload enviado e resposta recebida — são registradas em `Utilitários → Logs → Log de Módulo`, sob o módulo `nfeio_serviceinvoices`. Esse é o primeiro lugar a consultar em qualquer investigação de falha de emissão.