> 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/print-on-demand/pictorem-integration.md).

# Pictorem Integration

Order Desk can send your print-on-demand orders directly to [Pictorem](https://www.pictorem.com). As Pictorem fulfills your orders, shipment details will automatically be pulled back into Order Desk and sent to the original shopping cart when your store is set up to do so.

### Setup

To connect to Pictorem, click **Manage Integrations** in the left sidebar. Under the **Print on Demand** tab, find and enable the Pictorem integration.

![Pictorem integration under the Print on Demand tab](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FMX6xQ74nue68tZF8f2FX%2Flegacy-ed879d3bf745a9d289ea.png?alt=media)

You can also search for Pictorem using the available integration search.

![Searching for the Pictorem integration](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fb4DW2ruoBWxXjHujYqxH%2Flegacy-7820dea646ed8e9d9279.png?alt=media)

Enter your Pictorem **API Key**, then click **Connect**.

![Pictorem API key connection field](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F06u9XKd3xjPF7UHjIxCQ%2Flegacy-15261ac02f451dd0c9a1.png?alt=media)

> **Note:** Order Desk can’t find or reset your Pictorem credentials. You’ll need to get them directly from the Pictorem team.

### Integration Settings

Once you’re connected, you can adjust the following settings for the integration.

![Pictorem integration settings in Order Desk](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F8HuidnI3XgHc90ToXLNu%2Flegacy-33b7e7e977288061cdd2.png?alt=media)

#### After Import, Move To

Select the folder where orders should be moved after they’re successfully sent to Pictorem.

To use a custom folder, create one from your Store Settings. See 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 where orders should be moved when Pictorem sends shipment details back to Order Desk.

#### If Canceled, Move To

Select the folder where orders should be moved if they’re canceled in Pictorem.

#### Product Code Builder

Click this button to open Pictorem’s [Product Code Builder](https://www.pictorem.com/artflow/0.1/codebuilder). From there, you can select your preferred product options, and Pictorem will generate a code you can copy and use as the [print\_sku](#preparing-your-items) in Order Desk.

![Pictorem Product Code Builder button in Order Desk](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FF9RvLOXPVAaU4fzewiOU%2Flegacy-877263d0078960aadb7b.png?alt=media)

#### Product Settings

For details about what the Pictorem product settings do and how to use them, see the [**Print on Demand Product Settings**](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-integration-product-settings.md) guide.

![Product settings in the Pictorem integration](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FVekWKKyy9O85ZnHGFgZY%2Flegacy-a4ece576d102de8c032c.png?alt=media)

### Sending Orders to Pictorem

Preparing orders for Pictorem takes some initial setup. For a detailed walkthrough of using Order Desk with print-on-demand orders, see the [**Print on Demand Fulfillment**](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-fulfillment.md) guide.

#### Preparing Your Orders

You can set the following field as checkout data or order metadata on each order.

| Field Name | Description                                                |
| ---------- | ---------------------------------------------------------- |
| note       | Add any notes or comments you want to send with the order. |

If checkout data is new to you, see the [**How to Work with Checkout Data**](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide.

#### Preparing Your Items

You can set the following fields as variations or item metadata on each order item. These fields tell Pictorem which catalog item to use and which artwork file to print.

| Field Name     | Description                                                  |
| -------------- | ------------------------------------------------------------ |
| print\_sku     | **Required.** The Pictorem product code or SKU for the item. |
| print\_url     | A link to the artwork file Pictorem should print.            |
| collection\_id | The unique ID for the collection associated with the item.   |
| note           | Any notes you want to send with the item.                    |
| border\_color  | The custom border color you want to send to Pictorem.        |

### Rules Reference

Along with the [**general rule events and actions**](/resources/rules-reference-events-filters-and-actions.md) available in Order Desk, Pictorem has several integration-specific events and actions. You won’t find these on the integration settings page. Instead, you can access them through the **Rule Builder**.

If you’re new to rules in Order Desk, start with the [**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 Pictorem. To find them, search for **Pictorem** in the **Event** dropdown in the Rule Builder.

![Pictorem events in the Rule Builder](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FuWm4ImkOglJLKbPceDU2%2Flegacy-1d00b063b12bfd5e21a1.png?alt=media)

| Event                                                            | Description                                                                                                                                     |
| ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Order Canceled at Pictorem                                       | Runs after an order is successfully canceled at Pictorem.                                                                                       |
| Order Scheduled to Pictorem                                      | Runs as soon as an order is scheduled to be sent from Order Desk to Pictorem. Use this when you need to take action on the order at that point. |
| After Order Submitted to Pictorem                                | Runs after an order is successfully submitted to Pictorem.                                                                                      |
| Before Order Submitted to Pictorem                               | Runs just before an order is sent from Order Desk to Pictorem. Use this when you need to make last-minute updates before submission.            |
| Order Not Submitted to Pictorem Because of Invalid SKU           | Runs when an order can’t be submitted because one or more SKUs aren’t valid in Pictorem.                                                        |
| Order Not Submitted to Pictorem Because of General Error         | Runs when a general error prevents an order from being submitted to Pictorem.                                                                   |
| Order Not Submitted to Pictorem Because of No Products Available | Runs when an order can’t be submitted because no valid products were found.                                                                     |

#### Rule Actions

Pictorem also has an integration-specific rule action. To find it, search for **Pictorem** in the **Actions** dropdown.

![Pictorem actions in the Rule Builder](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F8G2beV8zoX497mqo9OzC%2Flegacy-8f709e125abae647dc7e.png?alt=media)

| Action                   | Description                                 |
| ------------------------ | ------------------------------------------- |
| Submit Order to Pictorem | Sends an order from Order Desk to Pictorem. |


---

# 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/print-on-demand/pictorem-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.