> 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/shippingeasy-integration.md). # ShippingEasy Integration Order Desk can send orders directly to [**ShippingEasy**](https://shippingeasy.com/), then pull shipment details back into your orders and send them to your shopping carts, if applicable. ### Setup To connect to ShippingEasy, click on the **Manage Integrations** option in the left sidebar and, under the **Fulfillment** tab, find and enable the ShippingEasy integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FSuoDPUNXTG6RL9DHP7BW%2Flegacy-28a9d92677621a485544.png?alt=media) Alternatively, search for **ShippingEasy** from the available integrations. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FFGjHi5GlWIJu3vSqvlOj%2Flegacy-2443296d960b19fae9a0.png?alt=media) Once enabled, enter your ShippingEasy **API Key** and **Secret**, then click **Connect**. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FCrmg0cdPAdpBo587cis6%2Flegacy-7995b51988aaed47349c.png?alt=media) Order Desk isn’t able to help find or reset your ShippingEasy credentials. If you need some help getting the credentials handy, you can reach out to the ShippingEasy team. ### Integration Settings After you have connected the integration, you can apply any necessary details or preferences to the settings. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F3gzMe4E7Fi4zUCHEPILe%2Flegacy-affa5acabd830fa35a45.png?alt=media) #### Store If you have multiple stores in ShippingEasy, select the default one where you want Order Desk to send your orders. #### After Import, Move To Select the folder you want orders to be moved into after they are successfully sent to ShippingEasy. You can use one of the default folders already in your store or create your own. Read the [**Working with Folders**](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide for more information. #### After Shipment, Move To Select the folder you want orders to be moved into as ShippingEasy sends shipment details back to Order Desk. #### If Canceled, Move To Select the folder you want orders to be moved into if they are canceled in ShippingEasy. #### Shipment Callback URL Copy this URL and add it to your ShippingEasy API settings as the **Store URL**. You can reach out to their team for help if needed. #### Shipment Callback Path Copy this URL and add it to your ShippingEasy API settings as the **Shipment Callback Path**. You can reach out to their team for help if needed. > Setting up both the Shipment Callback URL and Shipment Callback Path makes sure ShippingEasy can send tracking details back to Order Desk when orders are shipped. #### Automatically Send Imported Orders to ShippingEasy If enabled, every order added to Order Desk will automatically be sent to ShippingEasy. Only enable this if all orders should be sent. If not, or if you need a delay, leave this disabled and use rules instead. ### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FNh5phf46dMNpcT2PWUbO%2Flegacy-59a7140831150a86c84a.png?alt=media) For more information on what these product settings within the ShippingEasy integration are for, refer to the [**Print on Demand Product Settings**](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-integration-product-settings.md) guide. #### Order Level Details The following fields can be added as checkout data or order metadata to be passed to ShippingEasy. 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. | Field Name | Field Description | | ------------- | ------------------------------------------------------------------- | | order\_status | Use this field to pass your preferred order status to ShippingEasy. | #### Item Level Details The following can be set as item metadata or variations on your order items. If you are unfamiliar with how to add item metadata or variations, see the [**How to Work with Inventory Details**](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-details.md#store-extra-item-details-in-order-desk) guide. | Field Name | Field Description | | -------------------- | ---------------------------------------------------------------------------- | | bin\_picking\_number | Use this to send the bin picking number of your order items to ShippingEasy. | #### Rules Reference In addition to the [**general rules available**](/resources/rules-reference-events-filters-and-actions.md) for all orders, ShippingEasy includes a set of events and actions that are specific to this integration. These aren’t found directly on the integration page. Instead, use the **Rule Builder** and search for ***shippingeasy*** to find them. If you’re new to using rules in Order Desk, we recommend starting with our [**How to Work With Rules**](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) guide. #### Rule Events The following events are specific to ShippingEasy. To find them, type ***shippingeasy*** in the **Event** dropdown menu in the Rule Builder: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fb8AZoxtYtfsjyxy1cfiU%2Flegacy-52a6a4f5ba0665cb3266.png?alt=media) | Event | Description | | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Order Canceled at ShippingEasy | Triggered when an order is canceled in ShippingEasy. | | Order Scheduled to ShippingEasy | Triggered when an order is scheduled to be sent from Order Desk to ShippingEasy. This runs immediately after scheduling, so it can be used to take action right away. | | After Order Submitted to ShippingEasy | Triggered after an order has been successfully submitted to ShippingEasy. | | Before Order Submitted to ShippingEasy | Triggered just before an order is sent from Order Desk to ShippingEasy. Useful for last-minute updates before submission. | | Order Not Submitted to ShippingEasy Because of Invalid SKU | Triggered when submission fails because one or more SKUs are not valid in ShippingEasy. | | Order Not Submitted to ShippingEasy Because of General Error | Triggered when a general error prevents the order from being submitted to ShippingEasy. | | Order Not Submitted to ShippingEasy Because No Products Available | Triggered when submission fails because no valid products were found for the order. | #### Rule Actions ShippingEasy also supports specific rule actions that you can apply to your orders. To find them, search for **s** ***hippingeasy*** in the **Actions** dropdown: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Faubdcsfcbha98erNyb2a%2Flegacy-470044addbe412397c28.png?alt=media) | Action | Description | | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Submit Order to ShippingEasy | Sends an order from Order Desk to ShippingEasy. | | Cancel Order at ShippingEasy | Attempts to cancel an order that has already been submitted to ShippingEasy. Whether this succeeds depends on the order’s status in ShippingEasy at that time. | --- # 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/shippingeasy-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.