--- title: "Automatize a emissão de notas fiscais de serviço NFS-e com WHMCS e NFE.io" description: "Módulo oficial NFE.io para WHMCS — emissão automática de NFS-e, multiempresas, campos da Reforma Tributária (NBS, CBS/IBS, PIS/COFINS) e gestão das notas no admin." source_url: https://nfe.io/docs/integracoes/plugins/whmcs last_updated: 2026-09-15 --- # 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. ![Notas fiscais emitidas pelo módulo NFE.io no WHMCS](https://nfe.io/docs/./assets/img/nfeio-whmcs-notas-fiscais.png) :::info Escopo do módulo 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 `curl` e `json` - Conta ativa na [NFE.io](https://nfe.io) com **chave de acesso (API Key)** - Tarefas cron do WHMCS em execução conforme a [documentação oficial](https://docs.whmcs.com/Crons#System_Cron) - [Automação do WHMCS](https://docs.whmcs.com/Automation_Settings) 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](./docs/instalacao.md) | Download, upload dos arquivos, campos personalizados e ativação | | [Configuração](./docs/configuracao.md) | Emissores, configurações globais de emissão e link da nota na fatura | | [Código de Serviço](./docs/codigos-servicos.md) | Códigos de serviço personalizados por produto | | [Retenções](./docs/retencoes.md) | Alíquotas de ISS, PIS/COFINS e tipo de tributação por código de serviço | | [Reforma Tributária](./docs/reforma-tributaria.md) | Campos RTC e a ordem de precedência aplicada na emissão | | [Associar Emissor](./docs/associar-emissor.md) | Associação de clientes a um emissor específico | | [Notas Fiscais](./docs/notas-fiscais.md) | Listagem, status e ações disponíveis em cada nota | | [Webhook e Callbacks](./docs/webhook.md) | Como o módulo recebe as atualizações de status e como diagnosticar | | [Atualização](./docs/atualizacao.md) | 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](https://github.com/nfe/whmcs-addon/blob/main/CHANGELOG.md). As versões são publicadas em [Releases no GitHub](https://github.com/nfe/whmcs-addon/releases). 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](./docs/atualizacao.md)) | :::warning Ao atualizar o módulo 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](https://github.com/nfe/whmcs-addon/issues) - Dúvidas sobre a API ou sua conta: [suporte@nfe.io](mailto:suporte@nfe.io)