NFER Emissor Fiscal
| 开发者 | nferfiscal |
|---|---|
| 更新时间 | 2026年11月14日 01:09 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
NFER Emissor Fiscal seamlessly connects your WooCommerce store to the NFER fiscal intelligence cloud platform (nfer.me). Engineered under rigorous software standards and fully compatible with WooCommerce HPOS (High-Performance Order Storage), the plugin eliminates complex manual REST API setups and unifies billing for physical products, digital goods, courses, services, and subscription clubs.
NF-e – Product Invoices (Model 55)
- 100% Automated SEFAZ Flow: Transmission, protocol query, DANFE (PDF) and authorized XML handled end to end by the NFER Cloud Engine.
- Complete Tax Engine: ICMS, ICMS-ST (MVA), IPI, PIS/COFINS and CFOP routing, with automatic Reforma Tributária (IBS/CBS — LC 214/2025) support.
- E-book Immunity: Digital books (NCM 4901) issued with constitutional ICMS immunity (Art. 150 CF), even when set as Virtual in WooCommerce.
- Contingency Ready: Automatic SVC-AN / SVC-RS handling whenever SEFAZ goes offline.
- Full National Coverage: Since November 1st, 2026, all 5,570+ Brazilian municipalities are enabled for the National NFS-e standard for Simples Nacional (ME and EPP) and MEI companies.
- Broad Regime Support: Lucro Presumido and Lucro Real companies issue through unified DPS emission and integrated municipal webservices.
- Standardized Fields: National Tax Code (
cTribNac), itemized service descriptions, and municipal tax withholdings.
- Status-triggered Cancellation: When an order is changed to
CancelledorRefundedin WooCommerce, the plugin automatically requests invoice cancellation via NFER. - 24-Hour SEFAZ Smart Window:
- If the NF-e was authorized within the last 24 hours, an automated cancellation event (Evento 110111) is transmitted directly to SEFAZ.
- If the legal 24-hour deadline has expired, NFER automatically issues a Return / Reversal NF-e (CFOP 1202) referencing the original invoice key, avoiding tax penalties and reversing ICMS/PIS/COFINS.
- Manual Cancellation on Order Screen: Admin button in order metabox with mandatory audited justification (15+ characters).
- B2C Operations (Final Consumer): Consumer sales with automated Final Consumer flag (
indFinal = 1). - B2B Operations (Interstate CNPJ to CNPJ): Corporate sales for resale or industrial manufacturing (
indFinal = 0), handling DIFAL exemptions and applying Tax Substitution rules (ICMS-ST / MVA) and State Registration (IE) status. - Interstate DIFAL Sharing (EC 87/2015): Automatic calculation of interstate tax differentials without maintaining manual tax tables.
- Broad Tax Regime Compatibility: Supports companies under Simples Nacional (CSOSN), Lucro Presumido, and Lucro Real (CST).
- Digital E-books Intelligence (NCM 4901): Automatic recognition of digital books with NF-e (Model 55) emission under constitutional ICMS tax immunity (Art. 150 CF), even when set as Virtual in WooCommerce.
- Hybrid Fiscal Split: Dual simultaneous billing for a single order (e.g. 60% NF-e Merchandise/E-book + 40% NFS-e Service/Course), enabling legal tax optimization for digital creators.
- Fiscal Data Product Tab: NCM (8 digits), CEST (7 digits), Merchandise Fiscal Origin (0 to 8), Standardized Unit of Measurement (UN, PC, KG, etc.), and SPED Item Type. Supports simple and variable products with parent fallback.
- Complete Brazilian Checkout Fields: Injects CPF, CNPJ, Company Name (Razão Social), State Registration (Inscrição Estadual with Isento toggle), Address Number, and Neighborhood with dynamic input masks.
- B2B Purchase Purpose Dropdown: Lets corporate buyers select whether the purchase is for End Consumption, Resale, or Industrialization.
- Compatibility with Brazilian Market Plugins: Works out-of-the-box independently or seamlessly alongside Brazilian Market on WooCommerce (Claudio Sanches) without duplicating fields.
- One-Click or 100% Automated Emission: Configure automatic emission upon payment confirmation or issue manually via order actions or quick modal.
- Instant Access to DANFE, NFS-e PDF & XML: Direct buttons to download DANFE PDF and authorized XML from the WooCommerce order list and order screens in the admin.
- Automated Customer Email: Configurable toggle to instruct the NFER Cloud Engine to automatically dispatch DANFE PDF and XML attachments to the buyer upon SEFAZ authorization.
- Register with a 7-day free trial at nfer.me
- Set up your company and A1 digital certificate, then navigate to Settings > API
- Copy your company's API Key and paste it into the plugin settings in WordPress.
- Official Website: nfer.me
- Document Delivery: Automated email delivery of DANFE PDFs and authorized XML files to buyers is processed and dispatched by the NFER Cloud Engine upon invoice authorization with SEFAZ / municipal tax authorities.
- Terms of Service: nfer.me/termos
- Privacy Policy: nfer.me/privacidade
安装:
- Upload the plugin files to the
/wp-content/plugins/nfer-emissor-fiscaldirectory, or install through the WordPress plugins screen. - Activate the plugin through the 'Plugins' screen in WordPress.
- Navigate to WooCommerce > Settings > NFER Emissor NF-e.
- Enter your NFER API Key and choose your environment (Production or Staging/Homologação).
- Click Save changes and then use the Test Connection button.
- Configure fiscal data (NCM, CEST, Origin) in your WooCommerce products.
屏幕截图:
常见问题:
Do I need to create REST API keys in WooCommerce?
No. NFER uses a push model: you only need to enter your NFER API Key in the WordPress settings.
How does interstate shipping tax (DIFAL) work?
On interstate transactions to non-taxpayer end consumers, NFER automatically calculates and highlights DIFAL according to Constitutional Amendment 87/2015.
What if I sell to a business buyer for resale (B2B)?
The buyer selects "Resale / Commercialization" at checkout. The plugin transmits indFinal = 0 to NFER, applying DIFAL exemption and calculating ICMS-ST / MVA based on destination state and product NCM.
Does it work with product variations?
Yes. Each variation can define its own fiscal parameters (NCM, CEST, Origin) or automatically inherit from the parent product if left blank.
Do I need another plugin for CPF/CNPJ checkout fields?
Not required. The plugin includes built-in fields for CPF, CNPJ, State Registration, and Brazilian address fields. If Brazilian Market on WooCommerce is already installed, NFER automatically maps existing fields to prevent duplicates.
How much does NFER cost?
The plugin is free and open source. To issue invoices, it connects to the NFER Cloud Platform, which requires an active account: new users start with a 7-day free trial, and plans scale according to the monthly emission volume of each store. You can check plans and current prices at nfer.me/precos.
更新日志:
1.6.4
- Directory Metadata: Description restructured — NF-e (Model 55) section now comes first, followed by the updated NFS-e National coverage reflecting Resolução CGSN nº 191/2026 (100% of municipalities for Simples Nacional and MEI since November 1st, 2026).
- Directory Metadata: New FAQ entry about NFER plans, free trial and pricing.
- Directory Metadata: Description links, API key steps and the Third-Party Cloud Service Notice list properly formatted; previous changelog entries translated to English.
- Directory Metadata: Screenshots section updated with 8 real plugin screenshots (Fiscal Notes, Settings, Products, Fiscal Data, Manual Tax Exceptions, NFS-e Services and Orders).
- Directory Metadata: Contributors field adjusted to include only valid WordPress.org usernames.
- Directory Metadata: Feature description adjusted to accurately reflect the published plugin — DANFE (PDF) and authorized XML download buttons are available in the WooCommerce order list and order screens in the admin, and automated DANFE/XML email delivery to buyers is processed by the NFER Cloud Engine (declared external service).
- Fiscal Document Models: The "Fiscal Document Type" selector is now only displayed on products when the store is in NF-e / NFS-e Automatic mode. In exclusive modes (NF-e Only or NFS-e Only), the interface hides the dropdown, simplifying product setup.
- Settings: NFER panel button restyled with a dark background and high-contrast white typography.
- Fiscal Rules: Fiscal rules management link repositioned inline with a clean style and default text color.
- Connection Instructions: Expandable trigger formatted in elegant dark typography.
- Origem do Produto / Tipo de Operação: Substituição do seletor cru do SPED por botões modernos no padrão da NFER com seleção rápida de Revenda (00), Fabricação (04) e Outras... expansível.
- Ocultação de badges de contagem de opções em labels (elimina textos soltos como '39 opções').
- Layout da Aba Dados Fiscais: Reorganização com Classificação Tributária (cClassTrib) posicionada diretamente abaixo de NCM e CEST.
- Remoção de bordas e divisores redundantes, mantendo harmonia com o padrão visual nativo do WooCommerce.
- Margem inferior padronizada de 10px no seletor de Tipo de Documento Fiscal.
- Remoção da linha informativa estática de CEST identificado.
- Nova arquitetura de Classes Fiscais V2 (Regras Fiscais com cenários dinâmicos da NFER).
- Suporte à seleção de Classe Fiscal personalizada nos produtos e variações via API.
- Reforma Tributária (IBS & CBS — LC 214/2025): derivação automática de CST a partir de cClassTrib com badge dinâmico inteligente no painel.
- Atualização de terminologia de "Perfil Fiscal" para "Regras Fiscais / Classe Fiscal".
- Botão Dinâmico no Cabeçalho: O botão "Obter Chave de API" muda dinamicamente para "⚡ Acessar Painel NFER" apontando direto para o dashboard quando a loja estiver conectada.
- Instruções Expansíveis sob Demanda: Inclusão do gatilho interativo "Ver instruções de conexão..." para expandir ou recolher o tutorial e o banner de teste a qualquer momento.
- Ocultação Inteligente de Onboarding: O banner de teste grátis e o guia em 3 passos agora desaparecem automaticamente assim que a Chave de API for validada com sucesso na SEFAZ.
- Design Clean do Tutorial: Remoção de fundos e bordas pesadas do guia de configuração para uma integração visual nativa com o painel WooCommerce.
- Nova linha explicativa sobre emissão em segundo plano e suporte à Reforma Tributária (LC 214/2025).
- Redesign Clean da Tela de Configurações: Cabeçalho simplificado com apresentação direta e objetiva, remoção de badges com emojis redundantes e banner legado.
- Guia de Configuração em 3 Passos: Instruções claras de obtenção da Chave de API, validação em tempo real e preenchimento de dados fiscais nos produtos.
- Informações de Checkout B2B e Compatibilidade: Orientações diretas sobre operação B2B (DIFAL/ICMS-ST) e integração transparente com ou sem o plugin Brazilian Market on WooCommerce.
- Aviso de Plano Ativo e Teste Grátis de 7 dias com links diretos para o painel NFER.
- Seletor Compacto de Modelos Fiscais: Unificação das opções de NF-e, NFS-e, Split Híbrido e Detecção Automática em grupo único sem espaçamento excessivo.
- Suporte Visual a Split Híbrido: Exibição dinâmica dos campos percentuais de NFS-e e NF-e com sincronização automática totalizando 100%.
- Limpeza de Configurações: Remoção do campo redundante de Código de Tributação Padrão NFS-e.
- Prazo de Garantia (Código de Defesa do Consumidor): Nova configuração de prazo com opções de Imediato (padrão), 7 dias (CDC), 15 dias e 30 dias com agendamento nativo e cancelamento automático antes de queimar numeração fiscal.
- Modernização do Modal de Conexão no Painel NFER: Interface limpa e minimalista sem duplicações e sem botões redundantes.
- Order Fiscal Modal UX Polish: Removed pending payment warning box from empty state to keep modal clean and straightforward.
- Button Styling: Removed box-shadow from "Emitir Nota Fiscal Agora" button for a modern flat appearance.
- Contextual Options Menu: Relocated "Abrir no Painel NFER ↗" into a 3-dots actions menu positioned directly to the right of "Notas emitidas neste pedido".
- Dynamic Order Status Badge: Status pill badge is now styled in high-visibility orange when order payment is pending / unpaid, and clean neutral gray when paid.
- Manual Tax Exceptions Harmonization (Exceções Tributárias Manuais): Added full support for ICMS Base Reduction percentage (
reducaoBc/_nfer_reducao_bc_icms) in manual ICMS overrides. - Aligned tax override blocks into 3 organized sections matching NFER cloud emissor: 1. ICMS & CFOP, 2. PIS & COFINS, and 3. IPI.
- Removed duplicated Origin field from ICMS overrides to keep UI clean and consistent.
- Added clean neutral background styling (
#f3f3f8) and helpful contextual guide for manual tax exceptions. - Tax Reform (LC 214/2025) Auto-Inference & SEFAZ Compliance: Automatically calculates and transmits required state tax reduction group (
<gRed>and<cBenef>) when CST is 200 (Alíquota Zero ou Reduzida), preventing SEFAZ rejection "Não informado o grupo de redução de alíquota Estadual [nItem: 1]". - Automatic legal statutory reduction percentage assignment (60% for food, grains, and agricultural commodities under
cClassTrib: 200034). - Optional IPI Code of Enquadramento (
enquadramentoIpi) without hardcoded '999', seamlessly falling back to fiscal profile rules. - Product Catalog Synchronization & API Enrichment: Full product matching by SKU / item code with automatic synchronization of item type (SPED 0200) and fiscal profiles.
- Reforma Tributária (IBS/CBS): Support for Tax Reduction percent field (
_nfer_reducao_ibscbs) with intelligent legal fallback (60% reduction for CST 200 / cClassTrib 200xxx foods and commodities under LC 214/2025). - Seamless Tax Reform dispatch: IBS/CBS fields are always forwarded in order emission payloads even when general manual tax exceptions are unchecked.
- Full integration with NFER catalog auto-detection: matches products by code/SKU and inherits complete fiscal parameters, profiles, and industrialization rules.
- Tax Reform 2026 Municipal IBS Rate: Added manual municipal IBS rate override (
aliquotaIbsMunicipal/_nfer_aliq_ibs_mun) to complete the tripartite tax reform configuration (IBS Estadual, IBS Municipal, CBS) across products and variations.
- Tax Reform 2026 Manual Overrides: Added manual exception rate fields for IBS (
aliquotaIbsEstadual) and CBS (aliquotaCbs) in product and variation fiscal tabs. - NFS-e Service Description: Refined service description input field to a compact single-line field aligned with service code.
- Smart Dynamic Visibility: Automatic toggling between NF-e and NFS-e fields based on product type (virtual and downloadable attributes).
- AI-Powered NCM Suggestion: Added an instant "IA" button inside the NCM input field in the product fiscal tab, allowing store owners to automatically discover and fill the optimal 8-digit NCM code based on the product title via NFER Fiscal Intelligence API.
- Interactive CONFAZ CEST Lookup & Dropdown: Live CEST selector that automatically suggests official Convênio ICMS 142/18 CEST codes matching the product's NCM, complete with option counts and official legal descriptions.
- Automated Email Dispatch Parameter: Direct transmission of
enviarEmailflag in emission payloads according to plugin settings and customer profile. - Clean UI & Fiscal UX: Cleaned cluttered placeholders from tax exception fields and harmonized styles strictly adhering to WordPress.org guidelines.
- Fiscal Profile & Item Type Transmission: Transmits item type (
tipoItem- SPED Bloco 0200) from WooCommerce product fiscal settings to NFER API, enabling automatic activation of fiscal profiles (such as own manufacture / industrialization with CFOP 5101/6101). - Contingency Status Handling: Added support for
nfe.contingenciastatus across webhooks and order lists with warning indicators. - UI & Brand Polish: Updated manual emission buttons to vibrant NFER brand green (
#00C853) and refined modal link styling. - Fast Modal Loading: Fiscal details modal now renders immediately from local order metadata without redundant network overhead.
- Product Fiscal Jump Button Fix: Enhanced the "Preencher Dados Fiscais" shortcut button on product edit screens with native fallback and dedicated admin asset loading, ensuring instant automatic switching to the "Dados Fiscais" tab with smooth scroll, auto-focus, and visual highlight on the NCM input field.
- Automated Direct Webhook (Zero Config): Automatic transmission of webhookUrl, orderId, and origem in all NF-e and NFS-e payloads, ensuring instant real-time order synchronization without requiring manual webhook registration on the NFER dashboard.
- Isolated Multi-Store Routing: Dispatches SEFAZ authorization events directly to the issuing store, preventing cross-store webhook collisions and 404 errors.
- Settings UI: Updated webhook description clarifying that synchronization is fully automated via API payload.
- SEFAZ Freight & Shipping Synchronization: Comprehensive support for order freight (valorFrete) and additional fees (valorOutras) with automatic modFrete assignment (0 for freight by recipient/remetente, 9 for no freight) and payment total balancing, resolving SEFAZ rejection error 610 ("A soma dos pagamentos deve ser igual ao valor total da nota").
- Settings Auto-Save on Test Connection: Testing the API connection automatically validates and persists all configuration fields from the NFER tab (API key, environment, document model, split percentages, trigger statuses, order status transitions, NFS-e tax code, and email dispatch) directly into WordPress options.
- Empty API Key Validation: Immediate visual warning and border highlight when testing or saving without an API key.
- WordPress.org Plugin Review Compliance: Full compatibility with WordPress 7.1, complete translators comments for all internationalized strings with placeholders, clean textdomain consistency, and removal of hidden repository files.
- Full support for invoice cancellation and rebilling: display of cancelled invoices with "Cancelled at SEFAZ" badge, cancelled number (#), access key, and XML download.
- Prominent "Issue New Invoice" button for cancelled orders, enabling rebilling with a new sequential number.
- Detailed fiscal history of cancelled invoices archived in order meta for accounting audit.
- Unlocked re-emission in order metabox and contextual options menu (⋮) after cancellation.
- Visual backend logs for real-time tracking of webhook deliveries.
- New "Fiscal Data" column in WooCommerce product list: green badge with formatted NCM for configured products and warning badge with direct link for missing NCMs.
- Fiscal modal height optimization: comfortably fits multiple invoices without triggering parent scrollbar.
- Smart re-emission preserving the same sequential invoice number (#) and fiscal series when re-transmitting rejected invoices.
- Detailed rejected invoice card with error reason, access key, and retry options.
- Full isolation for status badge click: rendered as an interactive button with native DOM event interception preventing unwanted navigation to order edit page.
- Strict separation of recipient data for CPF (Individual) vs CNPJ (Corporate).
- Smart handling of SEFAZ State Registration indicator (indicadorIe 1, 2, or 9).
- Explicit and canonical "environment" parameter ("homologacao" or "producao") in emission payloads.
- Updated sidebar order metabox title to "NFER: Fiscal Technology".
- Clean flat solid status badges for the "NF-e Status" column in WooCommerce order list.
- Prefix standardization: NF-e Issued, NFS-e Issued, Split Issued, and Return Issued.
- Dynamic icons: document icon for finalized statuses and animated loading spinner for "Processing" status.
- Quick options button with 3-dot icon (⋮) for direct modal opening.
- Clean modal layout for fiscal documents matching NFER specifications.
- Transparent auto-synchronization with SEFAZ upon opening modal or clicking "View".
- Scrollable invoice list for hybrid orders (NF-e, NFS-e, Return).
- 3-dot quick actions menu: Sync with SEFAZ, Issue Return, and Cancel at SEFAZ.
- Fix for SEFAZ payment method 99 (Other) requirement.
- Webhook support for HTTP development and staging environments.
- Mass batch emission in WooCommerce orders list via Bulk Actions.
- Single-order manual emission in order actions dropdown.
- Support for Hybrid Fiscal Split (1 Merchandise NF-e + 1 Service NFS-e per order).
- Quick modal for fiscal details and DANFE / XML downloads in order list.
- State Registration (Inscrição Estadual) checkout field for B2B orders.
- Transparent integration with "Brazilian Market on WooCommerce" plugin.
- Automatic PF / PJ detection at checkout.
- Pre-emission fiscal validations with descriptive error messages.
- Integration for NFS-e (Municipal Services) in over 2,875 Brazilian cities.
- Support for National Tax Code (cTribNac).
- Automatic mapping of WooCommerce payment methods to SEFAZ codes.
- Compact fiscal status column in WooCommerce order list.
- Quick "View" action button for instant fiscal document access.
- Detailed SEFAZ rejection error display.
- Direct SEFAZ cancellation with mandatory 15-character justification.
- Order notes logging with access key and direct document links.
- Full compatibility with WooCommerce HPOS (Custom Order Tables).
- Variable product support with NCM, CEST, and Origin inheritance.
- Checkout purchase purpose selector (End Consumption vs Resale).
- Live connection test in settings tab.
- Official release of NFER plugin for WooCommerce.
- Native HPOS support.
- Fiscal Data tab in products and variations.
- Masked checkout fields and B2B/B2C selector.
- Automated or manual 1-click invoice emission.