> 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/smartturn-integration.md).

# SmartTurn Integration

Many warehouses use software provided by [SmartTurn](http://www.smartturn.com/) to manage their orders. If your fulfillment provider uses this software, Order Desk can connect to them through the SmartTurn integration and send your orders for fulfillment. As they fulfill your orders, the tracking numbers will be sent back into Order Desk and back through to the original shopping cart(s).

### Setup

To connect to SmartTurn, click on the **Manage Integrations** link in the left sidebar and under the **Fulfillment** tab find and enable the SmartTurn integration.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FeWaMLqwqkanUNqemSOBz%2Flegacy-4b428b6eebd63f58c280.png?alt=media)

Once enabled, enter your SmartTurn username and password and click to connect.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FMY9u6ZPUGeXQQESqu9L5%2Flegacy-f51f1422c5149499e3f9.png?alt=media)

### Integration Settings

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fw4ch3QQtnETx8FhQSBbE%2Flegacy-12a0fcb1a6ca4468d6cc.png?alt=media)

After you have connected the integration, you can apply any necessary details or preferences to the settings.

#### Owner Code

Enter your owner code provided by SmartTurn if directed to do so by your provider.

#### Priority Code

If your provider tells you to add a priority code, enter it here. You can override this setting on individual orders by using the **smartturn\_priority** checkout data field. Details [below](#custom-details).

#### Default Carrier Name

Enter a carrier name here as your default method. Any order that does not have a shipping method on it will be sent with this carrier name.

If you need to, you can use the [rule builder](/start-here/getting-started-series/quick-start-how-customizable-is-order-desk-really.md#the-order-desk-rule-builder) to set shipping methods on your orders as they’re imported.

#### After Import, Move To

Select the folder you want orders to be moved into after they are successfully sent to SmartTurn.

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 SmartTurn sends shipment details back to Order Desk.

#### Allow Partial Shipments

Select this to enable partial shipments in SmartTurn. If enabled, your provider will know to ship part of an order if any items in the order are not currently available.

#### Automatically Send Imported Orders To SmartTurn

If selected, every order that is added to Order Desk will automatically be sent to SmartTurn.

Select this setting only if all orders will be sent to SmartTurn. If any orders will not be sent, or if you need a delay between when an order is imported into Order Desk and when it is sent to SmartTurn do *not* select this.

#### Inventory Management Settings

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FTjJR6zbEIjZqdQ1BAOLT%2Flegacy-f55215fd175c6f17dd8a.png?alt=media)

#### Sync SmartTurn Inventory

Enable if you want your inventory stock counts to be pulled in from SmartTurn.

For more information, see the [How to Work with Inventory Counts](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-quantities.md#send-counts-tofrom-order-desk) guide.

#### Sync Interval

If Sync SmartTurn Inventory is enabled, choose how often you want Order Desk to check SmartTurn for inventory updates.

#### Inventory Location Name

If you want to set a specific inventory location name for the products you have at SmartTurn, set that name here. As SmartTurn sends back reports, your custom name will be added as the location.

#### Product Settings

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FL8xfT4EoYtLZ7ts5KptV%2Flegacy-89982bedd321d1052c99.png?alt=media)

For more information on what these product settings in the SmartTurn 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.

#### Custom Details

You can customize certain details about orders that are sent to SmartTurn. To do so, set these checkout data fields on the order:

| Field Name           | Field Description                                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| smartturn\_date\_due | Default is the order date. To change the due date for an order, add this checkout data field with the due date as the value. |
| smartturn\_priority  | If using a [Priority Code](#integration-settings), you can override it on specific orders with this checkout data field.     |

For more information about how to use checkout data in Order Desk, read through the [How to Work with Checkout Data](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide.


---

# 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/smartturn-integration.md?ask=<question>&goal=<endgoal>
```

`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.