Shopify customers can be connected to Acumatica customers through order import settings, tag cross-references, and, for business-to-business (B2B) companies, company synchronization. The appropriate path depends on whether you are importing an order or synchronizing a company and its contacts and locations.
The Biz-Tech Services Shopify Acumatica Connector gives teams several ways to handle customer data, but the settings do different jobs. This guide separates the default customer and tag choices for incoming orders from Shopify Plus B2B company synchronization so you can verify the customer and address on the resulting records.
Before You Map Shopify Customers
The Biz-Tech Services Acumatica Shopify Connector uses the Shopify Stores record to hold connection and import settings. Confirm that the intended Store Code identifies the correct store and that its credentials have been configured and tested. For Shopify Plus B2B synchronization, select Use B2B on the store record.
The customer path also depends on your workflow. Import Customer and customer tag cross-references are described under order import. Import Shopify Companies, Shopify companies, and Export Shopify Companies handle company data. The documentation does not specify a universal matching or duplicate-detection rule across these paths.
Shopify Customer Mapping at a Glance
- Choose the correct Shopify Stores record and verify the connection.
- For incoming orders, decide whether Import Customer is selected or a default customer is used.
- If you use order tags to select a known customer, configure the tag and Acumatica customer code in Cross-Reference.
- Choose the ship-to and billing address override settings for incoming orders.
- For Shopify Plus B2B company data, enable Use B2B and choose the appropriate company import or export process.
- Check the resulting customer, contacts, locations, and order addresses before relying on the configuration.
Choose the Customer for Incoming Shopify Orders
On the store record, the documentation says selecting Import Customer imports Shopify customer information into a new Acumatica customer record. If Import Customer is not selected, Shopify orders are imported with the default customer. Confirm the intended default before importing orders, especially when a single account is used for multiple buyers.
The manual does not explain how an existing customer is matched or whether a new customer is prevented when an order is imported repeatedly. Review existing customer records and test a representative order before processing a large batch. Do not assume that a default customer identifies an individual buyer.
Map a Shopify Tag to an Acumatica Customer
The Biz-Tech Services Shopify Acumatica Integration can use a configured Shopify tag to select an Acumatica customer during order import. In the Import Settings tab, select Use Tags to Import Customer and choose type Code. On Cross-Reference, enter the Shopify tag in Shopify Value and the corresponding Acumatica customer account code, AcctCD, in Acumatica Value.
The manual says an order with a mapped tag should select the customer according to that setup. Check the exact tag and account code with a test order. It does not specify which customer wins if multiple tags match, or how tag mapping interacts with every Import Customer setting. Resolve those cases with Biz-Tech before depending on the behavior.
Import and Export Shopify B2B Companies
For Shopify Plus B2B, the manual describes bidirectional synchronization of customers, contacts, and location information after Use B2B is enabled. Import Shopify Companies retrieves company data from Shopify into Acumatica; its filter uses the Shopify updated date. The manual says a company disappears from that processing screen after successful import.
For a specific company, the Shopify companies screen provides Get Company by ID and Create Customer. The first fetches a company using its Shopify ID; the second imports the selected company as an Acumatica customer. Review its customer details, associated contacts, and locations before creating the customer. The documentation does not state that Create Customer automatically merges a pre-existing Acumatica customer.
Export Shopify Companies sends customers, contacts, and locations from Acumatica to Shopify in a batch. The manual says a successfully synchronized customer disappears from the export screen and returns when changes occur. For the separate Sync Customer action, it describes Acumatica as the source of customer and contact details sent to Shopify. Confirm ownership of each field before synchronizing in both directions.
Check Contacts, Locations, and Order Addresses
The manual describes a B2B customer ID on the Shopify Customers tab for customers linked to a Shopify B2B company. Associated contact IDs are shown on the Contacts tab of the Acumatica Customers screen and on the Contacts screen. A location ID is stored on the Shopify Info tab of the Locations screen. Compare these identifiers with the intended company and location; the manual does not provide a complete field-by-field matching algorithm.
For incoming orders, Override Ship Address Information from Shopify Order and Override Bill Address Information from Shopify Order control whether address information is brought from the order. For outbound orders, the separate Order Export Settings include Export Customer, Update Shipping Address, and Update Billing Address. If Export Customer is unchecked, the manual says the selected default customer is used for exports.
Before enabling automation, compare a representative order with its customer, billing address, and ship-to address in both systems. Review shared company names and contacts manually; neither a company name nor an address is documented as a guaranteed unique match.
Where to Check Your Work
Use the Biz-Tech Services Acumatica Shopify Integration settings and records below to trace a customer from the store setup to the resulting transaction.
- Shopify Stores: confirm Store Code and test the connection credentials.
- Import Settings: review Import Customer and the configured default customer.
- Import Settings: check Use Tags to Import Customer and its selected type.
- Cross-Reference: compare Shopify Value with the tag and Acumatica Value with the customer AcctCD.
- Import Settings: check the ship and bill address override selections.
- Shopify Stores: verify Use B2B when using the documented Shopify Plus B2B flow.
- Shopify companies: inspect company details, contacts, and locations fetched by company ID.
- Customers and Contacts: inspect the linked B2B customer and contact IDs.
- Locations: inspect the location ID on Shopify Info.
- Shopify Orders and the resulting Acumatica document: compare customer and address information with the source order.
Shopify Customer Mapping: Frequently Asked Questions
Why do imported orders use the same Acumatica customer?
Check whether Import Customer is unselected and a default customer is configured. The manual says orders use the default in that case. Also inspect any tag cross-reference setup used for customer selection.
How do I assign an order to an existing customer using a tag?
Select Use Tags to Import Customer, choose type Code, and map the Shopify tag to the Acumatica customer AcctCD in Cross-Reference. Test the resulting selection using an order carrying that tag.
Does B2B company synchronization need a setting?
Yes. The Biz-Tech Services Shopify Acumatica Integrator documentation says to enable Use B2B for bidirectional synchronization with Shopify Plus B2B.
Can I import one specific Shopify company?
The Shopify companies screen offers Get Company by ID to retrieve a specific company and Create Customer to import the selected company as an Acumatica customer.
Does the connector automatically prevent duplicate customers?
The supplied manual does not establish a general duplicate-prevention or merge rule. Review existing records and test your own workflow before importing companies or orders in bulk.
Why is the shipping address different from the one I expected?
Compare the Shopify order address with the Acumatica document and check Override Ship Address Information from Shopify Order. The manual does not document every fallback or conflict case, so verify the result with a representative order.
Where can I find more on Shopify order imports?
The companion article How to Import Shopify Orders into Acumatica covers the broader order-import process. Use this guide when the question is which customer, company, contact, or location is associated with the transaction.
Work With the Biz-Tech Services Shopify Connector
A reliable customer setup starts with an explicit choice of order defaults, tag mappings, company synchronization, and address settings. Validate those choices with real records and review undocumented matching scenarios before enabling batch processes.
For help reviewing your configuration, visit https://biz-techservices.com to discuss the Biz-Tech Services Acumatica Shopify Integrator.
Watch video for more details: https://www.youtube.com/watch?v=1YZGvGQRiCs
