Product registration/linking

In this first version of the Base ERP NF-e Issuer Plugin for WooCommerce, there is no automatic product and inventory synchronization between WooCommerce and Base ERP.

This means that inventory management will continue to be done exclusively by WooCommerce, without direct interference from Base ERP.

When to use

Use this page when you need to prepare your WooCommerce store products for NF-e issuance through Base ERP.

Some common scenarios include:

• registering in Base ERP the products sold in WooCommerce;
• linking WooCommerce products to the corresponding products in Base ERP;
• locating the Internal Product Identifier in Base ERP;
• informing the Base ERP product ID within the product registration in WooCommerce;
• reviewing tax information necessary for NF-e issuance;
• avoiding product identification failures in the issuance process;
• validating the flow before using the plugin in Production.

How product linking works

For Base ERP to correctly identify which product was sold in WooCommerce, it is necessary to create a link between the two systems.

This link is made through the Internal Product Identifier, automatically generated in Base ERP after the item is registered.

General flow:

Register product in Base ERP
↓
Locate the Internal Product Identifier
↓
Access the corresponding product in WooCommerce
↓
Inform the Base ERP ID in the indicated field
↓
Save the product in WooCommerce
↓
Validate whether the link was created correctly

Source of truth for inventory

In this version of the plugin, inventory is not automatically synchronized between WooCommerce and Base ERP.

Therefore, consider the following operational rule:

What will come in future versions?

We are working so that, in future updates, the plugin offers automatic inventory synchronization between WooCommerce and Base ERP.

This way, all product movements can be updated in real time on both platforms.

While automatic synchronization is not available, keep operational inventory and shipping controls in WooCommerce.

Important product attributes

During product registration and linking, some fields deserve special attention.

Registering your products in Base ERP

For invoice issuance to work correctly, it is necessary to replicate your WooCommerce products inside Base ERP.

Follow the step-by-step instructions below:

1. Access Base ERP.

   Go to the Commercial > Products and Services module.

2. Add a new product or service.

   Click the Add Product/Service button.

3. Fill in the required information.

   Required fields are identified by the paper icon next to the field name.

4. Save the registration.

   After filling in all necessary fields, click Save to complete the registration.

Linking your products between Base ERP and WooCommerce

With the product already registered in Base ERP, the next step is to create the link between the ERP item and the corresponding product in WooCommerce.

This link is essential so that Base ERP correctly identifies which product is being sold in your e-commerce store.

Follow the step-by-step instructions below:

1. Locate the product internal ID in Base ERP.

   After saving the registration, the system automatically generates an internal identification number.

   This code is displayed in the Internal Product Identifier field.

   Copy this number.

2. Access the WooCommerce panel.

   In the WordPress administrative panel, go to:

   Products > All Products

   If the item does not exist yet, access Add Product.

3. Edit the corresponding product.

   Locate the product sold in the store and open its editing screen.

4. Paste the Base ERP ID.

   Inside the Product Data tab, select the Base ERP section.

   In the indicated field, paste the Internal Product Identifier that you copied from Base ERP.

5. Save the changes.

   Click Update or Publish, if it is a new product.

Done! Your product is linked between WooCommerce and Base ERP.

Process summary

Practical example

Imagine that your WooCommerce store sells the product Basic Blue T-Shirt.

For this product to be used in the NF-e issuance flow through Base ERP:

Product sold in WooCommerce: Basic Blue T-Shirt
↓
Product registered in Base ERP: Basic Blue T-Shirt
↓
Base ERP generates the Internal Product Identifier
↓
Internal ID is copied from Base ERP
↓
ID is pasted into the corresponding product in WooCommerce
↓
Product becomes linked for the NF-e issuance flow

This association prevents the order from being processed without correct identification of the corresponding tax product.

Important behaviors

When using product registration and linking, consider that:

• the plugin does not automatically synchronize products between WooCommerce and Base ERP;
• the plugin does not automatically synchronize inventory between the systems;
• WooCommerce continues to control the store’s availability and inventory;
• Base ERP maintains the tax registration necessary for NF-e issuance;
• each product sold in WooCommerce needs to be linked to the corresponding product in Base ERP;
• products without a link may not be identified in the issuance process;
• changes made to the product in one system do not automatically update the other;
• the name and SKU help with checking, but the link depends on the Base ERP product internal ID;
• incorrect tax data may impact invoice issuance;
• products with variations must be checked carefully to avoid incorrect linking.

Operational impacts

The absence of automatic synchronization requires some operational precautions.

Some important impacts:

• inventory must be controlled in WooCommerce;
• inventory changes in Base ERP should not be considered automatic store updates;
• order shipping must follow the operational flow defined in WooCommerce;
• internal reports need to consider that product registrations exist in two systems;
• divergences between name, SKU, or tax registration may make reconciliations difficult;
• unlinked products may delay or prevent the NF-e issuance flow;
• tax changes made in Base ERP must be reviewed before issuance;
• operations, tax, and e-commerce teams must be aligned on which system controls each piece of information.

Best practices and notes

For a safer operation, it is recommended to:

• keep product names the same or easily identifiable in WooCommerce and Base ERP;
• use SKU to facilitate internal checks, when applicable;
• maintain a spreadsheet or internal control with WooCommerce product, SKU, and Internal Product Identifier in Base ERP;
• review tax information before starting issuance in Production;
• validate taxes and CFOPs in Base ERP;
• avoid registering the same product more than once in Base ERP;
• check products with variations before creating the link;
• test the flow in Sandbox before using it in Production;
• keep inventory control in WooCommerce;
• periodically review linked products.

Common errors and questions

Validation checklist

Before starting NF-e issuance in Production, validate:

• whether all products sold in WooCommerce were registered in Base ERP;
• whether the Internal Product Identifier was copied correctly;
• whether the ID was informed in the corresponding product in WooCommerce;
• whether names and SKUs facilitate identification between the systems;
• whether tax data was reviewed in Base ERP;
• whether CFOPs and taxes were checked;
• whether products with variation were linked correctly;
• whether inventory continues to be controlled by WooCommerce;
• whether the responsible team understands that there is no automatic synchronization in this version;
• whether the flow was tested in Sandbox before being used in Production.

Next step

After registering and linking the products, validate whether the NF-e issuance flow is working as expected.

Register product in Base ERP
↓
Review tax data
↓
Copy Internal Product Identifier
↓
Inform ID in the corresponding WooCommerce product
↓
Save changes
↓
Test NF-e issuance flow