Notas Fiscais
Todas as notas emitidas pelo módulo ficam listadas em Addons -> NFE.io NFSe -> Notas Fiscais (NFSe).
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.
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 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.
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, 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.