Table of Contents
- Configuration
- Prerequisites
- Example Migration for Dropship to ShipperHQ
- Deleting WebShopApps Attributes
- Attribute Mapping Reference
If you're moving from WebShopApps stand-alone extensions to ShipperHQ on Magento 1, we have a handy tool to help set up your catalog's configuration. The Migration Manager, available on Github, maps your existing WebShopApps product attribute values to your selected ShipperHQ configuration values. This article explains how to use the Migration Manager effectively, and includes a full attribute mapping reference.
How It Works
The Migration Manager, available on GitHub, handles migration from the following WebShopApps extensions:
- Dropship
- Product Matrix
- Shipping Override
- Freight modules
If there are other extensions you'd like to use this tool with, please let us know.
For example, if you used Dropship and are moving to ShipperHQ, the Migration Manager will reassign all products previously assigned to a WebShopApps warehouse to the corresponding ShipperHQ Origin you select.
Requirements
- ShipperHQ Installed in Magento
- You've configured your Origins and Shipping Groups in ShipperHQ
- You have synchronized your Magento site with ShipperHQ
Migrating Your Attributes (Example: Dropship)
1. Go to Catalog › ShipperHQ › Migration Manager
2. The migration dialog lists each warehouse you created in WebShopApps. For each warehouse, select the corresponding ShipperHQ Origin.
3. Click Migrate.
ShipperHQ will assign every product with the matching WebShopApps warehouse value to the ShipperHQ Origin you selected. For example:
-
- Products assigned to "New York Warehouse" → ShipperHQ Origin "New York"
- Products assigned to "California Warehouse" → ShipperHQ Origin "California"
Once the migration completes, you will see a count of how many products were updated.
Deleting WebShopApps Attributes
If you need to delete WebShopApps attributes after migration, do this from the Magento admin for a clean removal. If the delete option is not available for an attribute, ask your developer to update the attribute in the eav_attribute table, setting user_defined to 1. You can then delete it from the admin.
Proceed carefully — ShipperHQ is not responsible for any issues that result from attribute deletion.
Attribute Mapping Reference
Use the table below to map your existing WebShopApps product attributes to their ShipperHQ equivalents. This is useful for manual verification or for extensions not covered by the Migration Manager.
Product Matrix
| WebShopApps Attribute | ShipperHQ Equivalent | ShipperHQ Field |
|---|---|---|
package_id |
Shipping Group | shipperhq_shipping_group |
shipping_qty |
Shipping Qty | shipperhq_shipping_qty |
Product Matrix with Volume Support
| WebShopApps Attribute | ShipperHQ Equivalent | ShipperHQ Field |
|---|---|---|
ship_depth |
Depth | ship_length |
ship_height |
Height | ship_height |
ship_width |
Width | ship_width |
Premium Rates
| WebShopApps Attribute | ShipperHQ Equivalent | ShipperHQ Field |
|---|---|---|
volume_weight |
Volume Weight | shipperhq_volume_weight |
Shipping Override
| WebShopApps Attribute | ShipperHQ Equivalent | ShipperHQ Field |
|---|---|---|
special_shipping_group |
Special Shipping Group | shipperhq_shipping_group |
shipping_price |
PER ITEM Shipping Price | shipperhq_shipping_fee |
Handling Fees Matrix
| WebShopApps Attribute | ShipperHQ Equivalent | ShipperHQ Field |
|---|---|---|
handling_id |
Handling ID | shipperhq_shipping_group |
Freight Extensions
| WebShopApps Attribute | ShipperHQ Equivalent | ShipperHQ Field |
|---|---|---|
must_ship_freight |
Must Ship Freight | must_ship_freight |
freight_class |
Freight Class | freight_class |
nmfc_class |
NMFC Class | shipperhq_nmfc_class |
FedEx Freight
| WebShopApps Attribute | ShipperHQ Equivalent | ShipperHQ Field |
|---|---|---|
fedex_freight_class |
FedEx Freight Class | freight_class |
Dropship / Ship Manager
| WebShopApps Attribute | ShipperHQ Equivalent | ShipperHQ Field |
|---|---|---|
warehouse |
Warehouse | shipperhq_warehouse |
Dimensional Shipping
| WebShopApps Attribute | ShipperHQ Equivalent | ShipperHQ Field |
|---|---|---|
ship_height |
Dimension Height | ship_height |
ship_length |
Dimension Length | ship_length |
ship_width |
Dimension Width | ship_width |
ship_possible_boxes |
Possible Packing Boxes | shipperhq_poss_boxes |
ship_separately |
Ship Separately | ship_separately |
ship_box_tolerance |
Box Tolerance | ship_box_tolerance |