NFE Nota Fiscal de Serviço para WHMCS

NFE Nota Fiscal de Serviço para WHMCS

Developed By NFE.io

Compatible with WHMCS v8.13

Automate the issuance of electronic service invoices directly in your WHMCS through the Invoice Module for WHMCS via NFE.io. With this module, you can automate the routine of generating and sending NFSe to your customers when they pay an invoice for a recurring order or service, issue invoices from individual invoices or every time a payment is received in WHMCS, for example.

Main features

  • Automatic issuance of invoices
  • Manual issuance of invoices
  • Scheduling issuance of invoices
  • Cancellation of invoice when invoice is canceled
  • Configuration of customized service code per product
  • Intuitive panel for viewing issued invoices
  • Quick action buttons for issuance, cancellation and sending
  • Monitoring the issuance status
  • Sending invoice by e-mail
  • Downloading invoice in PDF and XML format

Additional Features

  • Issues invoices sequentially, avoiding overloads on city hall websites.
  • Saves the debug of calls to the NFE.io API in the WHMCS Module log for diagnostic purposes
  • Selects the option to send the municipal registration number for the invoice in the module settings.
  • Selects the option to automatically send the invoice by email in the module settings.
  • Validates the customer's CPF/CNPJ and does not issue the invoice if it is invalid

 

There are no reviews yet!

Be the first to review NFE Nota Fiscal de Serviço para WHMCS.

Version Compatibility


Compatible with WHMCS v8.13

Full Version Compatibility


  • All versions of WHMCS v8.13
  • All versions of WHMCS v8.12
  • Selected versions of WHMCS v8.11
        8.11.0 - 8.11.2
  • Selected versions of WHMCS v8.10
        8.10.0

Support for this product

The best place to start if you need help with a specific product is to contact the developer. All WHMCS Marketplace developers have both a website and support URL listed.

Developed By NFE.io

Changelog

v3.1.0 Released December 30th, 2025

Latest Version


A versão 3.1.0 implementa o suporte à Reforma Tributária Brasileira, com a inclusão de novos campos obrigatórios para a emissão de notas fiscais de serviço.

Novos Recursos

Reforma Tributária Brasileira

A versão implementa os requisitos da Reforma Tributária Brasileira, adicionando novos campos obrigatórios para a emissão de notas fiscais de serviço. Estes campos são necessários para empresas optantes do Lucro Real ou Lucro Presumido e devem ser preenchidos tanto na configuração global quanto no cadastro individual de serviços.

Aplicabilidade:

Estes campos são obrigatórios apenas para empresas com regime tributário de Lucro Real ou Lucro Presumido. Empresas com outros regimes não serão impedidas de configurar estes campos, mas não será necessário preenchê-los. Esta regra poderá sofrer alterações de acordo com as mudanças relacionadas a RTC, sempre verifique os canais de comunicação da NFE.io e/ou órgãos oficiais para informações atualizadas.

Novos Campos Adicionados:

  • NBS (Nomenclatura Brasileira de Serviços): Classificação obrigatória que identifica o tipo de serviço prestado. Consulte a tabela de correlação NBS/LC116 para encontrar o código apropriado para seu serviço.

  • Classificação Tributária (CBS/IBS): Define a alíquota aplicável ao serviço conforme a Contribuição Social (CBS) e Imposto sobre Bens e Serviços (IBS). Consulte a tabela de referência CST para determinar a classificação correta.

  • Indicador de Operação (indOp): Especifica o tipo de operação de fornecimento do serviço. Consulte a tabela de referência do Indicador de Operação para selecionar a operação adequada.

Para detalhes completos sobre a Reforma Tributária e seus requisitos, consulte a documentação oficial da NFe.io.

Configuração Global (Empresa):

Os campos podem ser configurados globalmente na seção de configuração da empresa, estabelecendo valores padrão para todos os serviços daquele emissor.

Configuração por Serviço:

Além da configuração global, cada serviço pode ter seus próprios valores para NBS, Classificação Tributária e Indicador de Operação, permitindo maior flexibilidade e precisão na classificação de diferentes tipos de serviços.

 

Previous Versions


v3.0.0 Released April 28th, 2025

View/hide detailed changelog

A versão 3.0.0 traz melhorias significativas, incluindo suporte a multiempresas, novas funcionalidades e aprimoramentos na usabilidade.

Novos Recursos

Multiempresas

Agora, é possível configurar múltiplos emissores com suporte a multiempresas. Contas da NFe.io com mais de uma empresa cadastrada podem utilizar este recurso para definir diferentes emissores na configuração do módulo. Isso permite associar um cliente do WHMCS a um emissor específico, que será utilizado como emitente para as notas fiscais, independentemente da empresa padrão configurada para emissão.

  • Emissor Padrão: Configurações que utilizarem mais de um emissor cadastrado precisarão definir um como padrão. Este emissor será utilizado para todos os clientes que não possuírem uma associação personalizada.

  • Associar Clientes: A nova tela "Associar Clientes" em Configurações permite a associação de um cliente a um emissor específico, garantindo que todos os produtos ou serviços faturados neste cliente tenham como emitente a empresa associada.

  • Códigos Personalizados: Com o recurso multiempresa, os códigos personalizados agora podem ser associados a um emissor específico. Isso possibilita definir diferentes códigos de serviços personalizados para diferentes produtos e emissores. Ao cadastrar um novo código de serviço, será necessário selecionar a qual dos emissores cadastrados ele se destina.

  • Alíquotas: As alíquotas dos códigos personalizados agora estão associadas a um emissor. Ao cadastrar uma nova alíquota, o emissor vinculado ao código de serviço selecionado será exibido.

Detalhes da Nota

Uma nova opção "Detalhes" foi adicionada junto às ações da nota. Agora é possível visualizar mais detalhes da nota, como códigos ou mensagens retornadas da API de emissão.

Melhorias

Visualização de Notas

A tabela de visualização de notas emitidas pelo módulo recebeu uma reorganização das colunas e ações, visando adequar as informações e melhorar o layout das ações disponíveis. Os diferentes botões de ações foram agrupados em um sub-menu para uma melhor exibição.

Códigos Personalizados

Foram introduzidas melhorias na gestão dos códigos personalizados dos produtos, incluindo novas janelas de cadastramento e confirmações na exclusão de registros.

Alíquotas

Melhorias na gestão de alíquotas foram implementadas. Agora, além de novas janelas para cadastramento e exclusão, a tabela exibirá apenas as alíquotas cadastradas, ao contrário da versão anterior que mostrava todos os códigos de serviços personalizados, mesmo sem uma alíquota cadastrada.

Demais Melhorias

  • Alguns métodos que dependiam de código legado foram reescritos para melhor manutenção.
  • Melhorias no código de tratamento do callback para maior legibilidade e performance.
  • Registro do número da RPS retornado na emissão da NF no banco de dados do módulo.
  • Os processos de download do PDF e XML foram atualizados, agora retornando os arquivos pelo SDK da NFe.io.

Notas sobre Atualização e Migração

  • Algumas reestruturações removeram a dependência de arquivos de versões legadas. É recomendado a exclusão do diretório NFEioServiceInvoices existente no WHMCS antes de realizar o upload novamente do diretório.
  • Esta versão implementa novas colunas nas tabelas existentes, além de novas que serão responsáveis pelos dados das empresas emissoras cadastradas e pela associação de clientes.
  • Importante: Sempre realize um backup antes de qualquer atualização.

 

v2.2.0 Released June 13th, 2024

View/hide detailed changelog

2.2.0 - 2024-06-13

New Features

Validations for CPF and CNPJ

A new Validations helper class has been included in the NFEioServiceInvoices module. This class contains methods to validate CPFs and CNPJs based on the validation algorithm, according to verification rules, instead of defining document validity by character size, ensuring the integrity of the processed data.

Now when the document number is not valid, whether it is a CPF or CNPJ, the invoice issuance process will be terminated and a message with the reason will be shown to the user, in addition to a detailed record in the module log when in debug mode.

Webhook validation and handling (hmac)

A new webhook validation method has been added to the validation class and a new webhook handling in the callback file. It is now possible to verify the webhook signature (HMAC) and make sure it is from a trusted source before processing it.

The return of errors and response codes for API calls to the callback has also been improved. This allows the API to make new attempts to send in cases where processing is not possible on the first call, preventing updates to information in the module from being affected by any momentary inability of the module to listen to the returns.

Option to update the note

A new option has been added to the administrator interface that allows the update of the note status manually. With this, it is possible to search for the information directly in the API to reflect this information in WHMCS.

This feature is useful in cases where the note status information has not been synchronized with the module.

Improvements

Handling of note cancellation status via API

Refactored the handling of the note status when cancellation is performed to comply with the current return structure of the cancellation API. Previously, when canceling a note via API, the return object had a "message" attribute that the process of updating canceled notes was based on. Now, the cancellation API is returning the nf in the object and status code 202. Due to this, canceled notes were not being recorded properly.

Improved error handling and flow status recording

The flowStatus value of webhook returns has been recorded, ensuring that in failure or problem scenarios, the information in this attribute is recorded correctly for troubleshooting. This will make it possible to analyze return messages more efficiently and also use their values ​​for processing in the return message routines implemented in these updates.

Identifiers have also been standardized and new log records have been added to allow better debugging, both of the webhook return and of internal module routines.

NOTE: The ApiNoResponse message is an internal message used to identify when a cancellation action did not return the appropriate status because the invoice was already canceled in the API or its issuance was not completed and the user tries to cancel it in the same way.

Confirmation modals

Confirmation modals have been added for the cancellation and reissue of invoices.

Now, when performing one of these actions, the user will be asked if they want to continue with the action.

Corrections

Fixed problem in the timestamp recording of information in the database

A problem was fixed in the definition of the default value type for the created_at and updated_at fields in the module tables. The information was not being recorded properly due to some manual date definitions of legacy routines and also due to the lack of a definition of default values ​​for these timestamp type columns that could generate an incorrect assignment of values ​​in these fields.

Details of the analysis and correction can be found in issue 156

Fixed duplicate re-issuance issue on invoice

A condition that could lead to duplicate issuance of invoices when the administrator tries to generate new invoices from the preview of an invoice has been fixed. #160

 

See also

w2x for Xero

Synchronise your invoices, Contacts, Products and Payments with Xero

Commercial
Services Fee

Transfer the fees to your client

Commercial
QuickBooks Online For WHMCS

Integrate your financial data stored in WHMCS into QuickBooks Online.

Commercial
KashFlow Accounting

Automatically transfer your billing & transaction history to KashFlow

Free
Zero Invoice Management

Avoid sending notifications or creation of 0€ Invoices

Free