WooCommerce customers are connected to Acumatica customers through customer information brought in with orders and through customer synchronization or a manually entered Woo Customer Info record. Configure the store and customer options first, then verify the customer, contact, store code, and WooCommerce customer ID before relying on the connection for orders.
The Biz-Tech Services WooCommerce Acumatica Connector supports both standard customer synchronization and business-to-business (B2B) contact synchronization. The two directions serve different purposes: order import brings customer information into Acumatica, while customer export sends Acumatica customer or contact information to WooCommerce.
Before You Map WooCommerce Customers in Acumatica
The Biz-Tech Services Acumatica WooCommerce Connector uses a WooCommerce Store configuration and customer records with suitable contact information. In WooCommerce Store Preferences, enter the store credentials and use Test Credentials. A successful test displays “Credentials are valid.” Then review the store settings for the intended Store Code.
On the WooCommerce Store screen, decide whether Use B2B store should be selected for the intended workflow. Review Import Customer, Customer Class, and the ship and bill address override options under Order Settings. These choices affect the information used when importing orders; they do not substitute for checking the customer link.
WooCommerce Customer Mapping Step by Step
- Confirm the Store Code and test the connection in WooCommerce Store Preferences.
- Review Import Customer, Customer Class, and the shipping and billing address options in WooCommerce Store Order Settings.
- Check that the Acumatica customer has a contact with first name, last name, and email for automatic customer synchronization.
- For a manual link, open the customer, add a record on Woo Customer Info, and set Contact ID, Store code, WooCommerce Customer ID, and B2B.
- For synchronization, use Sync WooCommerce Customer from Actions on the Customers screen, or use the Export WooCommerce Customers processing screen.
- Inspect the resulting Woo Customer Info record and compare its customer ID and store with the intended WooCommerce account.
- Test an appropriate order and review its customer and address information before using the configuration more broadly.
How Order Import Uses Customer and Address Settings
The manual says individual customers are not imported directly from WooCommerce into Acumatica; customer information arrives through WooCommerce orders. When Import Customer is selected, the integration imports customer information into a new Acumatica customer record. Customer Class supplies the default class for new customers that do not already exist and are created by the integration.
Override Ship Address Information from WooCommerce Order brings in the address to which the order will be shipped. Override Bill Address Information from WooCommerce Order brings in the billing address. When Import Customer and both address override options are unselected, the manual says the order uses default customer information in Acumatica instead.
Review an imported order against the source order, especially when the billing and shipping addresses differ. The manual does not specify every matching rule used to choose an existing Acumatica customer on order import, so confirm that behavior for your configuration instead of assuming email alone determines the match.
Link Existing Customers and Reduce Duplicate Risk
The Biz-Tech Services WooCommerce Acumatica Integration can connect a customer manually through Woo Customer Info. On the Customers screen, add a record on that tab and enter the Contact ID, Store code, WooCommerce Customer ID, and B2B fields. Verify each value against the intended contact and store before saving.
For standard customer synchronization, the documentation says the program checks WooCommerce using the customer email, WooCommerce Customer ID, and first name plus last name. If it finds the customer, it creates a Woo Customer Info record with the WooCommerce Customer ID. If it does not find the customer, it creates a new customer on the WooCommerce website and sets the ID on that tab.
That makes accurate contact information and an existing ID useful checks before synchronization. Similar names or shared email addresses deserve human review. The documentation does not define all tie-breaking rules or guarantee that duplicates can never occur; review the record selected by the process.
Choose Standard or B2B Contact Synchronization
With Use B2B store selected, the documented B2B process synchronizes customer contacts and creates users in WooCommerce. Before export, the system searches for an existing user by contact ID, then email, and finally a username made from the contact first and last names. The manual requires a password to be set on the contact in Acumatica before export.
The Customers screen includes Woo Customer Info, where one or more contacts can be selected for synchronization. If the tab is empty and B2B Store is enabled, the manual says all contacts are exported as separate users. With B2B Store disabled, it says only the primary contact is exported, or the first available contact if no primary contact exists. Check which contacts should represent the customer before processing.
Check the Customer Used for an Outbound Order
When exporting an Acumatica sales order to WooCommerce, the manual says the connector uses the corresponding customer ID in Woo Customer Info if the customer has already been exported. Otherwise, the order is created with the Guest customer. A completed customer sync and a reviewed ID therefore matter when the order must use the intended WooCommerce account.
Customer mapping and order-field mapping are related but separate checks. Order Mappings defines which order fields synchronize; a change to that configuration does not affect orders already retrieved. The manual says an already retrieved order can be changed manually in its Import Fields tab before import.
Where to Check Your Work
Use these checks when reviewing the Biz-Tech Services Acumatica WooCommerce Integration and its customer records:
- WooCommerce Store Preferences: Store Code and the result of Test Credentials.
- WooCommerce Store: Use B2B store and the Order Settings customer options.
- Order Settings: Import Customer and the default Customer Class for newly created customers.
- Order Settings: the separate ship and bill address override selections.
- Customers, Contacts tab: the intended contact and its first name, last name, and email.
- Customers, Woo Customer Info tab: Contact ID, Store code, WooCommerce Customer ID, and B2B.
- WooCommerce Orders, Addresses tab: the address details retrieved for the order.
- WooCommerce Orders, Import Fields tab: order-field values retrieved under the mapping.
- WooCommerce Orders, Sales Order Number: the Acumatica sales order associated with an imported order.
- Get Order Process Error Messages: errors generated during order retrieval.
WooCommerce Customer Mapping: Frequently Asked Questions
Can I link an existing WooCommerce customer manually?
Yes. On the Acumatica Customers screen, add a Woo Customer Info record and set the Contact ID, Store code, WooCommerce Customer ID, and B2B fields. Confirm that the ID belongs to the intended account before saving.
Why did synchronization create a new WooCommerce customer?
In the documented standard customer sync, a new WooCommerce customer is created when the program does not find a matching customer. Check the existing ID and contact details, and investigate the result before repeating the process. The manual does not provide every matching or tie-breaking condition.
Why does an exported order show a Guest customer?
The manual says an outbound order uses the customer ID in Woo Customer Info when the customer was exported beforehand. Without that corresponding ID, the order is created with the Guest customer. Check the customer export and linked ID for the relevant store.
Why can a customer sync fail?
The Biz-Tech Services WooCommerce Acumatica Integrator requires a corresponding contact for the documented standard sync. The manual says missing first name, last name, or email prevents retrieval of the customer from WooCommerce, and a missing contact produces an error; it does not give the exact error text.
Does a different shipping address require a different customer?
The documented address options let an order bring in shipping and billing address information separately from WooCommerce. The documentation does not establish a rule that a different shipping address requires a new customer. Compare the order and its configured override options.
Can I synchronize customers in a batch?
Yes. Export WooCommerce Customers supports processing customers individually or all at once and can be scheduled. Review contact and mapping data before enabling a recurring schedule.
What happens to existing customer links after a package update?
The manual says customer synchronization uses Woo Customer Info and instructs users to run Update Synchronized Customers after publishing a new package to transfer existing data from WooCommerce Info to Woo Customer Info. Verify the transferred information for the applicable store.
Work With Biz-Tech Services on WooCommerce Customer Mapping
A reliable customer mapping review starts with the store, contact, customer ID, and intended order addresses. For the broader import workflow, see “How to Import WooCommerce Orders into Acumatica”; for product mapping, see “How to Map WooCommerce Products to Acumatica Inventory Items.”
To discuss the Biz-Tech Services Acumatica WooCommerce Integrator and your customer workflows, visit https://biz-techservices.com to contact Biz-Tech Services.
Watch video for details https://www.youtube.com/watch?v=N8bnQS5EKTw
