> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/fulfillment-services/cargowise-integration.md). # CargoWise Integration Order Desk can send orders directly to [CargoWise](https://www.cargowise.com/) for fulfillment then pull shipment details back into your orders here and send them to your shopping carts, if applicable. ### 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. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F3aVOEe1jHNx3tooE0mRr%2Flegacy-4a1268bb9e55dbebfa97.png?alt=media) Alternatively, search for CargoWise from the available integration search. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FaAswdNG4rYZghmo6626W%2Flegacy-99f540e2e8b0943a9bcc.png?alt=media) 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. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FF3xMS9DREHeM32Eq5HmQ%2Flegacy-064ad82b1a997bb67c74.png?alt=media) Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by Logistics Plus. ### Integration Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fl7KkecWTP4gaBpoRoWc1%2Flegacy-8c0aa757b9c97fef5d4f.png?alt=media) #### 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](#shipping-class-match) 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](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) to submit orders to the appropriate vendor or fulfillment service instead. #### Inventory Syncing ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FlJLXh5jsBmBipH3YvwBI%2Flegacy-fb3aafce9373caee0482.png?alt=media) #### 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 ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fs74uvGQj34aMf1RS22Jt%2Flegacy-77aa4c22ede288dc178c.png?alt=media) 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](/integration-setup-guides/fulfillment-services/fulfillment-integration-product-settings.md) guide. #### Shipping Class Match ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FnluRkQxeQmjafGqcVMnz%2Flegacy-6a0c0b144a4ec31d3d4f.jpg?alt=media) 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](#integration-settings) 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](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) 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](#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](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) 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. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.orderdesk.com/integration-setup-guides/fulfillment-services/cargowise-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.