> 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/oneprint-integration.md).
# OnePrint Integration
Order Desk can submit your print on demand orders to [**OnePrint**](https://oneprint.io/). As orders are fulfilled, shipment details will automatically be pulled back into Order Desk and sent to the original shopping cart, if your store is set up for it.
### Setup
To connect to OnePrint, click **Manage Integrations** in the left sidebar. Under the **Print on Demand** tab, find and enable the OnePrint integration.
Alternatively, search for *OnePrint* from the available integrations search.
Enter your OnePrint **API Key** and **API Secret**, then click **Connect**:
> **NOTE:**
>
> Order Desk isn’t able to help find or reset your OnePrint credentials, as they can only be provided by the OnePrint team.
### Integration Settings
Once connected, you’ll have a few settings where you can set your preferences for this integration.
#### Default Shipping Service
Select the default shipping service you want OnePrint to use for your orders.
If you need to apply specific shipping methods for certain orders, match your method names to OnePrint’s names in the [Shipping Class Match](#shipping-class-match) section below.
#### After Import, Move To
Select the folder you want orders to be moved into after they are successfully sent to OnePrint.
If you want to use a custom folder, create your own from 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 you want orders to be moved into when OnePrint sends shipment details back to Order Desk.
> **TIP: Status Updates**
>
> Asides shipments, OnePrint can occasionally send status updates to Order Desk about your order. The new status will be added to the order history and saved to an order metadata field called **oneprint\_status**.
>
> You can also take automatic actions when these status updates come in. [See the Rules section here](#rules-reference) for more info.
#### If Canceled, Move To
Select the folder you want orders to be moved into if they are canceled at OnePrint.
> **TIP: Canceling Orders**
>
> OnePrint orders can be canceled manually from the order details page:
>
> 
>
> Keep in mind that canceling an order at OnePrint is an order delete operation and can only succeed if an order hasn’t already reached the processing status over there.
>
> You can also cancel orders automatically by using the **Cancel Order at OnePrint** rule action. [More info about rule actions here.](#rules-reference)
#### View OnePrint Products
This option links you to a page where you can view OnePrint’s active product catalog. You can use this page to find product details you’ll need for order submission, including the `print_sku` (this is the same as the OnePrint SKU for the item). Learn more about the [required fields for order submission here](#preparing-your-items).
#### Product Settings
For detailed information about what the product settings within the OnePrint integration do, read the [**Print on Demand Product Settings**](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-integration-product-settings.md) guide.
#### Shipping Class Match
The shipping methods you have set up in your shopping carts may not match the methods OnePrint uses. To make sure your shipping preferences are sent to OnePrint with each order, match your methods to theirs in the Shipping Class Match feature. If your shipping method name doesn’t match their shipping method name exactly, your [default shipping service](#default-shipping-service) will be used instead.
For information about how to set up your shipping preferences, read the [**Shipping Class Match**](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide.
### Sending Orders to OnePrint
Getting your orders ready to send to OnePrint will take some setup time. For a detailed walkthrough of how to use Order Desk with your print on demand orders, read the [**Print on Demand Fulfillment**](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-fulfillment.md) guide.
#### Preparing Your Orders
The following field can be set as checkout data or order metadata on each order.
| Field Name | Description |
| ------------- | ------------------------------------------------- |
| ShippingLabel | URL of the shipping label to send with the order. |
If you’re 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. These fields tell OnePrint what catalog item should be used and which artwork files should be printed on the item.
| Field Name | Description |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| print\_sku | **Required**. This is OnePrint’s product code or SKU for the item. You can find this on the [View OnePrint Products](#view-oneprint-products) page. |
| print\_url\_x | Link to your artwork file so OnePrint can print it. Use `print_url_1` through `print_url_5` for up to five artwork files. |
| print\_location\_x | Location of the artwork on the item. Use `print_location_1` through `print_location_5` to match the corresponding `print_url` field. |
| print\_preview\_x | Link to your mockup or print preview file. Use `print_preview_1` through `print_preview_5` to match the corresponding `print_url` field. |
### Rules Reference
In addition to the [**general set of rule events and actions**](/resources/rules-reference-events-filters-and-actions.md) in Order Desk, OnePrint includes a number of rule events and actions that are specific to the integration. These aren’t found directly on the integration page. Instead, you’ll need to use the **Rule Builder** to access them.
If you’re new to using rules in Order Desk, we recommend starting 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 OnePrint. To find them, type ***OnePrint*** in the **Event** dropdown menu in the Rule Builder:
| Event | Description |
| ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| OnePrint Status Changed | Triggered when OnePrint sends an order status update to Order Desk. |
| Order Canceled at OnePrint | Triggered after an order is successfully canceled at OnePrint. |
| Order Scheduled to OnePrint | Triggered when an order is scheduled to be sent from Order Desk to OnePrint. This triggers immediately after the order is scheduled, so it can be used when you want to take action on the order at that point. |
| After Order Submitted to OnePrint | Triggered after an order has been successfully submitted to OnePrint. |
| Before Order Submitted to OnePrint | Triggered just before an order is sent from Order Desk to OnePrint. This is useful when you want to make last-minute updates before an order is sent. |
| Order Not Submitted to OnePrint Because of Invalid SKU | Triggered when an order submission fails because one or more SKUs aren’t valid in OnePrint. |
| Order Not Submitted to OnePrint Because of General Error | Triggered when a general error prevents the order from being submitted to OnePrint. |
| Order Not Submitted to OnePrint Because No Products Available | Triggered when an order submission fails because no valid products were found for submission. |
#### Rule Actions
OnePrint also supports specific rule actions that you can apply to your orders. These can be found in the **Actions** dropdown by searching for ***OnePrint***:
| Action | Description |
| ------------------------ | ---------------------------------------------------------------------------------------------------------- |
| Submit Order to OnePrint | Sends an order from Order Desk to OnePrint. |
| Cancel Order at OnePrint | Attempts to cancel an order at OnePrint. This can only succeed before the order reaches processing status. |
---
# 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/oneprint-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.