OnePrint Integration

Order Desk can submit your print on demand orders to OnePrint. 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 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 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 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.

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.

Product Settings

For detailed information about what the product settings within the OnePrint integration do, read the Print on Demand Product Settings 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 will be used instead.

For information about how to set up your shipping preferences, read the Shipping Class Match 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 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 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 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 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 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.