Automatize a emissão de notas fiscais de serviço NFS-e com WHMCS e NFE.io
A NFE.io é um sistema de emissão de notas fiscais que automatiza a comunicação com as prefeituras. Com a NFE.io você se livra de diversas tarefas chatas, melhorando o desempenho do seu negócio. E melhor, você economiza tempo e dinheiro.
WHMCS
Automatize a emissão de notas fiscais de serviço NFS-e com WHMCS e NFE.io!
A NFE.io é um sistema de emissão de notas fiscais que automatiza a comunicação com as prefeituras. Com a NFE.io você se livra de diversas tarefas chatas, melhorando o desempenho do seu negócio. E melhor, você economiza tempo e dinheiro.
Automatize a emissão de nota fiscal eletrônica de serviço diretamente em seu WHMCS através do Módulo Nota Fiscal para WHMCS via NFE.io. Com este módulo, é possível automatizar a rotina de geração e envio de NFS-e para seus clientes quando eles realizam o pagamento de uma fatura referente a um pedido ou serviço recorrente, emitir notas a partir de faturas avulsas ou toda vez que um pagamento é recebido no WHMCS por exemplo.

Este módulo emite NFS-e (Nota Fiscal de Serviço Eletrônica). Não é possível emitir nota fiscal de produto (NF-e) por ele.
Principais recursos
Emissão
- Emissão automática quando a fatura é gerada ou quando é paga
- Emissão manual (avulsa) e reemissão de notas a partir do admin
- Agendamento: emitir X dias após o pagamento da fatura
- Condição de emissão personalizada por cliente, sobrepondo a configuração global
- Emissão sequencial (fila), evitando sobrecarga nos sites das prefeituras
- Dedução automática de descontos/abatimentos da fatura no valor da nota
- Agrupamento de itens da fatura por atributos fiscais — itens com tributação divergente geram notas separadas
Conformidade fiscal
- Reforma Tributária (RTC): NBS, Classificação Tributária (CBS/IBS) e Indicador de Operação
- PIS/COFINS e Tipo de Tributação do ISSQN (
taxationType), globais por emissor ou por código de serviço - Retenção de ISS global por emissor ou por código de serviço
- Validação de CPF/CNPJ do cliente antes da emissão, com identificação automática do tipo de pessoa
Multiempresas
- Cadastro de múltiplos emissores (CNPJs) em uma única instalação do WHMCS
- Definição de um emissor padrão e associação de clientes a emissores específicos
- Códigos de serviço e alíquotas próprios por emissor
Gestão e operação
- Painel de visualização das notas emitidas, com status, emissor e valor
- Ações rápidas por nota: atualizar status, reemitir, enviar por e-mail e cancelar
- Modal de detalhes da nota com códigos e mensagens retornados pela API
- Cancelamento automático da nota quando a fatura é cancelada (configurável)
- Envio da nota por e-mail ao cliente pela plataforma da NFE.io
- Download de PDF e XML, no admin e na área do cliente
- Diagnóstico do webhook de callbacks na página "Sobre", com verificação sob demanda
- Registro das chamadas à API no Log de Módulo do WHMCS para diagnóstico
Requisitos
- WHMCS 8.0 ou superior
- PHP 7.4 ou superior, com as extensões
curlejson - Conta ativa na NFE.io com chave de acesso (API Key)
- Tarefas cron do WHMCS em execução conforme a documentação oficial
- Automação do WHMCS configurada
- Portal de pagamento ativo e criação de faturas funcional — as notas são emitidas na criação ou após o pagamento das faturas
Documentação
O módulo é instalado como qualquer módulo adicional do WHMCS. Siga os guias abaixo na ordem para começar a emitir notas fiscais automaticamente.
| Guia | Conteúdo |
|---|---|
| Instalação | Download, upload dos arquivos, campos personalizados e ativação |
| Configuração | Emissores, configurações globais de emissão e link da nota na fatura |
| Código de Serviço | Códigos de serviço personalizados por produto |
| Retenções | Alíquotas de ISS, PIS/COFINS e tipo de tributação por código de serviço |
| Reforma Tributária | Campos RTC e a ordem de precedência aplicada na emissão |
| Associar Emissor | Associação de clientes a um emissor específico |
| Notas Fiscais | Listagem, status e ações disponíveis em cada nota |
| Webhook e Callbacks | Como o módulo recebe as atualizações de status e como diagnosticar |
| Atualização | Atualização entre versões e migração da v1.4 para a v2.x |
Versões
A versão instalada é exibida no menu Sobre do módulo.
O histórico completo de mudanças, com detalhes técnicos de cada versão, está no CHANGELOG do módulo. As versões são publicadas em Releases no GitHub.
Principais marcos das versões recentes:
| Versão | Destaques |
|---|---|
| 3.3.x | PIS/COFINS e Tipo de Tributação (taxationType) na emissão; preservação dos atributos fiscais na reemissão |
| 3.2.x | Webhooks migrados para a API v2 da NFE.io; agrupamento de itens por tupla fiscal completa |
| 3.1.x | Campos da Reforma Tributária (NBS, Classificação Tributária, Indicador de Operação); diagnóstico do webhook |
| 3.0.x | Suporte a multiempresas, associação de clientes a emissores e detalhes da nota |
| 2.x | Reestruturação do módulo (veja o guia de Atualização) |
Após substituir os arquivos pelos da versão mais recente, acesse Opções → Módulos Addon → NFE.io NFSe no painel administrativo do WHMCS e clique em Salvar Alterações. Isso garante que novos parâmetros sejam gravados corretamente no banco de dados e que as migrações de schema sejam executadas.
Suporte
- Bugs e sugestões: issues no GitHub
- Dúvidas sobre a API ou sua conta: suporte@nfe.io