CargoWise Integration
Order Desk can send orders directly to CargoWise for fulfillment then pull shipment details back into your orders here and send them to your shopping carts, if applicable.
IN THIS GUIDE
Integration Setup
Settings
Inventory Syncing
Product Settings
Shipping Class Match
Sending Orders to CargoWise
Integration Setup
To enable the integration, click on the Manage Integrations link in the Integrations menu in the left sidebar. Under the Fulfillment tab, find and enable CargoWise.
Alternatively, search for CargoWise from the available integration search.
Once enabled, select the environment you would like to enable (Production for live orders, Sandbox for testing), enter your API Key and Default Warehouse Code provided to you by Logistics Plus, then click Connect.
Please note that Order Desk isn't able to help find or reset your credentials, as they can only be provided by Logistics Plus.
Settings
After Import, Move To
Select the folder orders should be moved to after they are sent to CargoWise from Order Desk.
After Shipment, Move To
Select the folder orders should be moved to when CargoWise sends tracking details back to Order Desk.
If Canceled, Move To
Select the folder orders should be moved to if they are canceled at CargoWise.
Default Mail Class
Select the default mail class you want CargoWise to use. The shipping method you select will be used for all orders where the method on the order does not match any of CargoWise's shipping method names.
If you need to apply specific methods for certain orders, match your method names to CargoWise's names in the Shipping Class Match section below.
Send Customer Email Address to CargoWise
Select this option if you want the customer's email address to be included with the order details that are sent to CargoWise.
Automatically Send Imported Orders to CargoWise
If you plan to automatically submit every order to CargoWise for fulfillment, you can enable this setting. All orders will be sent as they come in to Order Desk.
If you have any other fulfillment services or will have any orders you don't want to send to CargoWise, keep this disabled. Use rules to submit orders to the appropriate vendor or fulfillment service instead.
Inventory Syncing
Sync Inventory
If you would like CargoWise to send inventory reports to Order Desk, enable this setting. If enabled, your stock counts will be pulled into Order Desk on the interval selected in the next setting.
Sync Update Interval
If Sync Inventory is enabled, select the interval you would like Order Desk to pull in inventory updates from CargoWise.
Inventory Location Name
By default, inventory updates will add CargoWise as the location name on each item updated. If you would like to override this to use a different name, add that here.
Product Settings
For more information on what these product settings in the CargoWise integration are for and how to use them, read the Fulfillment Integration Product Settings guide.
Shipping Class Match
If the shipping methods you set up in your shopping cart(s) don't match the shipping method names CargoWise uses, they won't know what methods you intend for them to use. When this happens, the default mail classes applied above will be used instead for all of your orders.
To tell CargoWise what methods you want them to use, you will need to match your method names to theirs. This can be done in the shipping class match section. For detailed instructions on setting this up, please read through the shipping class match guide.
Sending Orders to CargoWise
Preparing Your Orders
The following fields can be set as checkout data or order metadata to specify what gets sent to CargoWise on each order.
| Field Name | Field Value |
| warehouseCode | Overrides the default warehouse code provided during the setup process. |
| PONumber | Use if you'll need to set your own PO number. |
| requiredShipDate | Use this to set a specific ship date. |
| Carrier | Carrier code override value |
| ServiceLevel | Service level override value |
| WarehouseServiceLevel | Service level override value. This is a 3 character code that must be set up in CargoWise. |
| Notes | Any notes that you want to send along with the order, including Shipping Account details |
| IncoTerm | Use to set the international commercial term value. |
| SalesChannel | Use to set the sales channel. |
| ReferenceKeyx | Use to pass order reference data. Up to 5, must be paired with ReferenceValuex (e.g. ReferenceKey1/ReferenceValue1, ReferenceKey2/ReferenceValue, etc.). |
| ReferenceValuex | Use to pass order reference data. Up to 5, must be paired with ReferenceKeyx (e.g. ReferenceKey1/ReferenceValue1, ReferenceKey2/ReferenceValue, etc.). |
If you are unfamiliar with checkout data, see the How to Work with Checkout Data guide.
Preparing Your Items
The following fields can be set as variations or item metadata for each order item.
| Field Name | Field Description |
| quantityUnit | Set a different quantity unit. (Default is UNT) |
| cargowise_quantity_divisor | Set this field to with a numerical value that will be used as a divisor for the stock counts Order Desk receives from CargoWise. Use a value less than 1 if you want to use this field as a multiplier (e.g. a value of .5 will multiply item counts by 2). |
| storageLocation | Use to set a specific storage location. |