NF-e Issuer for WooCommerce - BaseERP

Use the NF-e Issuer for WooCommerce to connect your store's orders to Base ERP and use them in the product NF-e issuance flow.

The integration depends on the connection with Base ERP and on the link between each product sold in WooCommerce and its corresponding record in the ERP.

When to use

Use this integration when:

• your WooCommerce store sells products that require an NF-e;
• your operation uses or plans to use Base ERP;
• WooCommerce orders need to be related to the products' tax records in Base ERP.

Base ERP is a cloud-based business management system available for Asaas legal entity (company) accounts.

For information on activating and using the ERP, see the Base ERP FAQ.

How it works

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Install the plugin"] --> B["Generate the API Key in Base ERP"]
B --> C["Connect WooCommerce"]
C --> D["Register the products in Base ERP"]
D --> E["Link the products by internal ID"]
E --> F["Validate the tax data"]
F --> G["Test the flow in the Sandbox"]
G --> H["Use in Production"]

classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

class A inicio
class B,C,D,E,F,G validacao
class H sucesso

linkStyle default stroke:#94A3B8,stroke-width:2px

Installation and connection are covered in Installation/Configuration. Product registration and linking are detailed in Product Registration/Linking.

Before you start

Confirm that:

• your Asaas account is a legal entity (company) account;
• Base ERP is activated for the account;
• your store uses WooCommerce;
• you have administrative access to WordPress;
• you have access to Base ERP.

Understand where each setting is configured

Sandbox and Production

Each environment uses its own API key.

Configure the Sandbox to test the connection, product registration, and the link between the systems before starting real issuance.

Key generation and environment configuration are detailed in Installation/Configuration.

Registration, linking, and inventory

Each product sold in WooCommerce must have a corresponding record in Base ERP.

After registering the item in the ERP, use the Internal Product Identifier to link it to the correct product in WooCommerce.

WooCommerce remains the source of inventory control. Base ERP keeps the product records and tax information used in the issuance flow.

See Product Registration/Linking to register items, find the Internal Product Identifier, and complete the link.

Before using in Production

Validate in the Sandbox that:

• the plugin is connected to the correct environment;
• the API Key matches the configured environment;
• the products sold are registered in Base ERP;
• each product is linked by the correct Internal Identifier;
• the tax information, taxes, and CFOPs have been reviewed in Base ERP;
• the issuance flow uses the expected product.

After this validation, switch the integration to Production with the key corresponding to that environment.

Next steps

• Install and configure the NF-e Issuer
• Register and link the products
• See the Base ERP FAQ