ShipHero customer and warehouse mapping in Acumatica starts with the ShipHero Store setup: choose the customer handling for imported orders and map ShipHero warehouse values to the corresponding Acumatica warehouses. Then check the customer, addresses, and warehouse on a representative imported order.
The Biz-Tech Services ShipHero Acumatica Connector supports both ShipHero-to-Acumatica and Acumatica-to-ShipHero workflows. This guide focuses on the documented inbound customer and warehouse settings; the two workflow directions do not necessarily expose identical settings.
Before You Map ShipHero Customers and Warehouses
In the Biz-Tech Services Acumatica ShipHero Connector, choose the intended ShipHero Store Code and Integration Option, then enter the connection information on the Connection Settings tab and use Test Credentials. The ShipHero-to-Acumatica option exposes the inbound settings discussed below.
Under Stores to get, select the stores whose orders and shipments should be imported. The store-level Customer field can specify an individual or default customer for a store; when it is blank, the manual says order import takes customer information from the Customer Information setup. Verify that the store and customer choices match your business process.
ShipHero Customer and Warehouse Mapping at a Glance
Select the intended ShipHero Store Code and the ShipHero-to-Acumatica integration direction.
Select the source stores in Stores to get and review each store-level Customer value.
In Customer Information, choose Import Customer or the default Customer and, when applicable, Customer Class.
Review the separate shipping and billing address override options.
Select Use Cross Ref for Warehouse and map the ShipHero and Acumatica warehouse values.
Retrieve a representative order, import it, and compare its customer, addresses, and warehouse with the intended setup.
Choose the Customer for Imported ShipHero Orders
In Customer Information, selecting Import Customer imports customer information from ShipHero into a new customer record in Acumatica. The Customer Class field appears when Import Customer is selected and supplies the default class for newly created customers.
When Import Customer is not selected, the manual says orders use the default customer in the Customer field. Stores to get also has its own Customer field, with a fallback to Customer Information when the store-level field is empty. Check both places when an order uses an unexpected customer, and test the intended combination before processing a batch.
The manual does not describe a complete existing-customer matching algorithm or guarantee prevention of duplicate customers or orders. Review existing records and the source order identifiers before importing; confirm ambiguous cases with your implementation team.
Map ShipHero Warehouses to Acumatica
The Biz-Tech Services ShipHero Acumatica Integration uses the Warehouse Cross-Reference for order import and item synchronization. Select Use Cross Ref for Warehouse in Cross-Reference Options to display the corresponding tab, then map the ShipHero values to their intended Acumatica values.
The manual says an imported order receives the mapped warehouse on the sales order. It also describes the same setup being used to establish an item warehouse during ShipHero item synchronization. Review both results when a warehouse serves multiple order or inventory workflows.
The documentation does not specify a complete fallback or error message for a missing or conflicting warehouse mapping. If the warehouse is unexpected, inspect the selected store and cross-reference, then confirm the correct values before repeating the process.
Review Shipping and Billing Addresses
Customer Information contains separate Override Ship Address Information from Ship Hero Order and Override Bill Address Information from Ship Hero Order options. The manual describes the first as importing the destination address. Its billing description names a different platform, so confirm the billing behavior for your installed version before relying on it.
Compare the source order with the customer and both addresses on the resulting Acumatica document. A shipping address and a customer account answer different questions: review both when an order is assigned to a default customer.
Understand Warehouse Locations and Item Defaults
Warehouse mapping and location mapping are related but separate settings. The Locations tab offers Use Location Mapping, which shows a grid for mapping locations. The manual says locations are loaded for warehouses configured in Warehouse Cross-Reference. Check the warehouse mapping first when a required location is missing from the loaded list.
The Sync Info tab also provides a Warehouse ID default for newly created items when Import Item is selected. When Import Item is not selected, the manual describes using the configured replacement item and Warehouse ID instead of creating a new item. These item defaults should be reviewed alongside the warehouse cross-reference, without assuming the manual defines every precedence case.
Where to Check Your Work
Use these screens and fields to review the Biz-Tech Services Acumatica ShipHero Integration before and after a test import:
ShipHero Store: Ship Hero Store Code and Integration Option.
Connection Settings: connection information and Test Credentials result.
Stores to get: Selected and the store-level Customer field.
Customer Information: Import Customer, Customer Class, and Customer.
Customer Information: shipping and billing address override settings.
Cross-Reference Options: Use Cross Ref for Warehouse.
Warehouse Cross-Reference: the ShipHero and Acumatica warehouse values.
Locations: Use Location Mapping and locations loaded for mapped warehouses.
Import Ship Hero Orders: selected Ship Hero Store Code, Get Orders, and Import.
Ship Hero Order and the resulting sales order: source order, customer addresses, and assigned warehouse.
ShipHero Customer and Warehouse Mapping: Frequently Asked Questions
Why did an imported order use the default customer?
Check Import Customer and the Customer field in Customer Information, as well as the Customer field for the selected source store. The manual says a blank store-level Customer falls back to Customer Information.
How do I show the Warehouse Cross-Reference tab?
Select Use Cross Ref for Warehouse in Cross-Reference Options. The Biz-Tech Services ShipHero Acumatica Integrator then exposes the corresponding tab for mapping values.
Why is the wrong warehouse on an imported order?
Check the selected store and the ShipHero-to-Acumatica warehouse mapping, then compare the result on the sales order. The manual does not give a specific error message or complete fallback rule for an absent mapping.
Does the connector prevent duplicate customers?
The supplied manual does not establish a general duplicate-prevention or merge rule. Review existing records and validate a representative import before relying on automated customer creation.
Why is a warehouse location missing from the loaded list?
The manual says locations load for warehouses configured on Warehouse Cross-Reference. Check that the intended warehouse is mapped and review Use Location Mapping before loading locations.
Where can I check the source order and addresses?
The Ship Hero Order screen displays the store code and order identifiers, with an Addresses tab for customer addresses. Compare those values with the imported sales order.
Work With Biz-Tech Services on ShipHero Mapping
For the broader order process, see “How to Sync Orders Between ShipHero and Acumatica”; for inventory synchronization, see “How to Sync ShipHero Inventory with Acumatica.”
To review your customer, warehouse, and location requirements with Biz-Tech Services, visit https://biz-techservices.com and ask about the Biz-Tech Services Acumatica ShipHero Integrator.
Watch video for more details https://www.youtube.com/watch?v=nmPg3d1oAPI
