> 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/sales-channels/podos-import-integration.md).

# podOS Import Integration

Order Desk can import your print on demand orders from [**podOS**](https://printondemandsoftware.com/), process them, and send them for fulfillment based on the settings you choose. As orders are fulfilled, tracking details will be sent back to podOS and the orders will be marked as complete.

### Setup

In Order Desk, click **Manage Integrations** under the Integrations menu in the left sidebar. Under the **Shopping Carts** tab, find and enable the podOS import integration:

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

Alternatively, search for *podOS* from the available integration search, then click **Enable** for the import integration.

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

On the next screen, enter your **Project Name** and **API Token**, then click **Connect**:

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

> Please note that Order Desk can’t help find or reset your credentials, as these can only be provided by the podOS team.

### Integration Settings

Once connected, you’ll have a few settings where you can set your preferences for this integration.

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

#### Check for New Orders

Select how often you want Order Desk to download orders from podOS.

> When Order Desk imports orders from podOS, the following key details will be saved on each order item as item metadata:
>
> * **print\_url\_x:** The publicly accessible link to the artwork that should be printed on each item. For multi-print items, the value of `x` will increase for each print job, for example, `print_url_1` and `print_url_2`.
> * **print\_location\_x:** The position where the print file should be placed on the item. The value of `x` corresponds to each `print_url_x` field.

#### Folder for New Orders

Select the folder where newly imported orders from podOS should be placed.

For more information about folders, see the [**Working with Folders**](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide.

#### Order Status Filter

Select the status of the orders to be imported from podOS. You can select multiple statuses, if needed.

#### Sync Tracking Numbers

If the **Sync Tracking Numbers** setting is enabled, Order Desk will automatically send shipment information back to podOS and update the orders there.

#### Order Prefix

If you would like to add an order prefix to your podOS orders as they import into Order Desk, add that value here.

#### Country Filter

Select countries from the dropdown menu, or choose **Select All**.

Choose **Standard** for Order Desk to only import orders from the selected countries. Choose **Inverted** to import all orders *except* from the selected countries.

#### First Import Date

Set the date from which you would like orders to begin importing from podOS.

### Manual Imports

#### Manually Import Orders

You can manually import orders from podOS at any time. You can import orders by **Date** if you need to bring in multiple orders, or by a specific **Order ID** if you only need to import one order.

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

> **Tip: Importing Orders by Date**
>
> If podOS has a large number of orders in the selected date range, you may need to click the **Import** button a few times to bring them all in.


---

# 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/sales-channels/podos-import-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.