NF-e Issuer for WooCommerce - Base ERP

If you already use the Asaas Plugin for WooCommerce to manage your product sales, you can also automate the issuance of Electronic Product Invoices using the NF-e Issuer for WooCommerce from Base ERP.

This integration connects your WooCommerce store to Base ERP, allowing orders for products sold in the e-commerce store to be used in the NF-e issuance flow, as long as the plugin is installed, configured, and the products are correctly linked between the systems.

When to use

Use this section when your WooCommerce store sells products and needs to automate or facilitate the NF-e issuance process through Base ERP.

Some common scenarios include:

• WooCommerce stores that sell physical products;
• operations that already use the Asaas Plugin for WooCommerce;
• companies that need to issue product NF-e after sales in the e-commerce store;
• legal entity customers that use or want to use Base ERP;
• stores that need to centralize commercial, tax, and financial data;
• operations that want to reduce manual invoice issuance processes.

What is Base ERP?

Base ERP is an Asaas ERP system, cloud-based and with no monthly fee, available exclusively for legal entity customers.

It brings together financial and business management resources in a single system, allowing the company’s operational and administrative routines to be controlled.

With Base ERP, it is possible to:

• control accounts receivable;
• control accounts payable;
• track cash flow;
• manage inventory;
• register incoming invoices;
• prepare commercial proposals;
• create sales orders;
• create purchase orders;
• issue product invoices;
• issue service invoices;
• use a point-of-sale system, POS;
• generate financial reports.

If you want to learn more or ask questions about activating and configuring Base ERP through Asaas, consult the Base ERP FAQ or contact the support team.

How the NF-e Issuer for WooCommerce works

The NF-e Issuer for WooCommerce connects your store to Base ERP through an API key.

After the plugin is installed and configured, the products sold in WooCommerce need to be linked to the corresponding products in Base ERP. This link allows Base ERP to correctly identify the items sold and use the necessary information in the invoice issuance process.

General flow:

Install the NF-e Issuer Plugin for WooCommerce
↓
Generate the API key in Base ERP
↓
Configure the environment and API Key in WooCommerce
↓
Register the products in Base ERP
↓
Link the WooCommerce products to the Base ERP products
↓
Validate the products’ tax information
↓
Start the NF-e issuance flow

Prerequisites

Before using the NF-e Issuer for WooCommerce, check that:

• your Asaas account is a legal entity account;
• Base ERP is activated for the account;
• your store uses WooCommerce;
• you have administrative access to WordPress;
• the NF-e Issuer Plugin for WooCommerce is installed and active;
• you have access to Base ERP;
• the Base ERP API key was generated in the correct environment;
• the products sold in the store are registered in Base ERP;
• the WooCommerce products have been linked to the corresponding products in Base ERP;
• the products’ tax information has been reviewed in Base ERP.

Important settings

Some settings have a direct impact on the integration’s operation.

Connection environments

During configuration, it will be necessary to choose the connection environment:

Base ERP API key

The Base ERP API key is responsible for connecting your WooCommerce store to the NF-e issuer.

It must be generated inside Base ERP, in the environment corresponding to the environment configured in the plugin.

Product registration and linking

For NF-e issuance to work correctly, the products sold in WooCommerce need to be registered in Base ERP.

After registration in Base ERP, it is necessary to copy the Internal Product Identifier and inform this ID in the corresponding product within WooCommerce.

This link is essential so that Base ERP correctly identifies which item was sold in the store.

Relevant behaviors

When using the NF-e Issuer for WooCommerce, consider that:

• the integration depends on the Base ERP API Key;
• each environment has its own API key;
• the Production and Sandbox configuration must be done carefully;
• products need to exist in Base ERP;
• products need to be correctly linked in WooCommerce;
• inventory management continues to be done by WooCommerce in this version;
• inventory changes in one system are not automatically reflected in the other;
• incorrect tax information may prevent or compromise NF-e issuance;
• products without a correct link may not be identified in the issuance process;
• real NF-e issuance should be performed only after validating the settings.

Operational impacts

Incorrect configuration of the NF-e Issuer can directly impact the store’s tax and operational flow.

Some important impacts:

• orders may remain without an invoice issued;
• products sold may not be identified in Base ERP;
• incorrect tax data may generate inconsistencies in the NF-e;
• use of an API Key from the incorrect environment may prevent communication between systems;
• absence of a link between products may interrupt the issuance flow;
• divergences between WooCommerce and Base ERP may make tax and operational checks difficult;
• issuance in Production without prior tests may generate invoices with incorrect data.

Therefore, validate the entire flow in Sandbox before starting real issuance.

Best practices

For a safer configuration, it is recommended to:

• always use the name Base ERP in a standardized way;
• test the integration in Sandbox before using Production;
• generate the API Key in the correct environment;
• store the API key in a secure location;
• not save API keys in source code or public files;
• register the products in Base ERP before starting issuance;
• keep product names the same or easily identifiable in WooCommerce and Base ERP;
• review tax information, taxes, and CFOPs in Base ERP;
• validate the product link before processing real orders;
• keep an internal record of products already linked;
• periodically review the plugin configuration.

Common errors and questions

Structure of this section

This section is organized into specific pages to guide the complete configuration of the NF-e Issuer for WooCommerce.

See also:

• Installation and configuration;
• Plugin installation;
• Plugin configuration;
• Product registration and linking;
• Best practices for NF-e issuance;
• Base ERP FAQ.

Next steps

To start the configuration, follow the recommended order:

Read the overview of this page
↓
Install the NF-e Issuer Plugin for WooCommerce
↓
Generate the API Key in Base ERP
↓
Configure the environment and key in WooCommerce
↓
Register products in Base ERP
↓
Link products between WooCommerce and Base ERP
↓
Validate the flow in Sandbox
↓
Use in Production