English translation

A WHMCS addon that integrates with the official Brazilian National NFS-e API, providing automatic electronic service invoice issuance when invoices are paid, payment gateway-based automation control, NBS and service code configuration, PDF DANFS-e generation, organized XML storage by environment and series, status tracking, processing queue management, and automatic XML/PDF delivery via email.

Overview

• Compatible with WHMCS 8.13.x.
• Requires PHP 8.1+.
• Powered by the nfse-nacional/nfse-php SDK.
• Uses vendor-scoped dependencies to minimize conflicts with other WHMCS modules.
• Automatically issues NFS-e invoices when a WHMCS invoice is paid, with independent automation settings for each payment gateway.
• Supports configuration of Service Code, NBS classification, tax rate, and default tax parameters.
• Supports issuing NFS-e invoices for both Brazilian and international customers.
• Generates DANFS-e PDFs and automatically emails both XML and PDF documents to customers.
• Includes a processing queue, WHMCS-integrated cron job, and automatic/manual status tracking.
• Organizes generated XML files by environment, series, year, and month.

Features

Tax Automation

• Automatically issues NFS-e invoices after invoice payment.
• Independent automation settings for each payment gateway.
• Processing queue for invoice issuance, reprocessing, and status checks.
• WHMCS-integrated cron with duplicate execution protection.

Invoice Management

• Manual issuance, reissuance, and cancellation of NFS-e invoices from the admin area.
• Manual and automatic invoice status tracking.
• Supports issuing invoices for domestic and international customers.
• Individual XML and PDF downloads.
• Email delivery of XML and PDF documents.

Dashboard & Monitoring

• Operational dashboard with real-time metrics.
• Statistics for issued, cancelled, rejected, pending, failed invoices, and total issued amount.
• Quick access to recent issuances, latest errors, and recent cancellations.
• Shortcuts for common operational tasks and monthly closing.

Reports & Exports

• Issued NFS-e reports.
• Failure and rejection reports.
• Cancellation reports.
• Technical log reports with detailed request/response inspection.
• CSV export of issued invoices.
• ZIP download containing all XML files generated during a selected period.

Client Area

• Customer portal listing all issued NFS-e invoices.
• Customer download of XML and PDF files.
• Customer-initiated resend of XML/PDF via email.
• Configurable informational notice displayed in the client area.

Configuration

• Environment, digital certificate, and service provider configuration.
• DPS series, sequential numbering, and processing parameters.
• Service Code and NBS catalog management.
• Mapping by product, product group, and payment gateway.
• DANFS-e settings and PDF header customization.
• Default customer information and IBGE municipality synchronization.
• Municipality resolution using a local IBGE-based catalog with ViaCEP fallback.
• Configurable retention policies for logs and processing queue data.

Portuguese Translation

Addon para WHMCS com emissão de NFS-e Nacional integrada à API oficial, emissão automática quando a fatura é paga, controle de automação por gateway de pagamento, configuração de NBS e código de serviço, geração de DANFS-e em PDF, armazenamento de XML organizado por ambiente e série, consulta de status, fila de processamento e envio de XML/PDF por e-mail ao cliente.

Visão Geral

• Compatível com WHMCS 8.13.x.
• Requer PHP 8.1+.
• Usa a SDK nfse-nacional/nfse-php.
• Usa vendor-scoped para reduzir risco de conflito com dependências de outros módulos do WHMCS.
• Permite emissão automática ao pagamento da fatura, com controle separado por gateway.
• Permite configurar código de serviço, NBS, alíquota e parâmetros tributários padrão.
• Suporta emissão de NFS-e para clientes no Brasil e no exterior.
• Gera DANFS-e em PDF e envia XML/PDF por e-mail ao cliente.
• Possui fila de processamento, cron integrado ao WHMCS e consulta automática/manual de status.
• Organiza XMLs emitidos por ambiente, série, ano e mês.

Panorama Funcional

Automação Fiscal

• Emissão automática de NFS-e quando a fatura é paga.
• Controle de automação separado por gateway de pagamento.
• Fila de processamento para emissões, reprocessamentos e consultas de status.
• Cron integrado ao WHMCS com proteção contra execução duplicada.

Operação de Notas

• Emissão manual, reemissão e cancelamento de NFS-e pelo admin.
• Consulta manual e automática de status da nota.
• Emissão de NFS-e para tomadores nacionais e estrangeiros.
• Download individual de XML e PDF.
• Envio de XML e PDF por e-mail.

Dashboard e Monitoramento

• Dashboard operacional com métricas do período.
• Indicadores de emitidas, canceladas, rejeitadas, pendentes, erros e valor emitido.
• Listas rápidas de últimas emissões, últimos erros e últimos cancelamentos.
• Atalhos para ações operacionais e fechamento mensal.

Relatórios e Exportações

• Relatórios de NFS-e emitidas.
• Relatórios de falhas e rejeições.
• Relatórios de cancelamentos.
• Relatórios técnicos de logs com visualização detalhada de request/response.
• Exportação CSV de emitidas.
• Download em ZIP dos XMLs emitidos no período.

Área do Cliente

• Listagem das NFS-e emitidas vinculadas ao cliente.
• Download de XML e PDF pelo cliente.
• Reenvio de XML/PDF por e-mail pelo cliente.
• Aviso configurável na área do cliente.

Configuração e Cadastros

• Configuração de ambiente, certificado digital e dados do prestador.
• Configuração de série DPS, sequenciais e parâmetros de processamento.
• Catálogo de código de serviço e NBS.
• Mapeamento por produto, grupo e gateway.
• Configuração do DANFS-e e personalização de cabeçalho do PDF.
• Dados padrão do tomador e sincronização de municípios IBGE.
• Resolução de municípios com catálogo local alimentado por fonte IBGE e fallback via ViaCEP.
• Política de retenção de logs e fila.