Turbine Integration

In This Guide

Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them on to Turbine for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk and back to your shopping cart if your store is set up for it.

Setup

To connect to Turbine, click on the Manage Integrations link under the Integrations menu in the left sidebar, and under the Print on Demand tab find and enable Turbine.

Once enabled, set up the provided webhook URL in your Turbine account, then enter your API details and connect.

Integration Settings

Once connected, you’ll have some shipment and integration settings to adjust per your preferences.

After Import, Move To

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

You can use one of the default folders already in your store or create your own. Read the Working with Folders guide for more information.

After Shipment, Move To

Select the folder you want orders to be moved into after Turbine sends shipment details back to Order Desk.

If Canceled, Move To

Select the folder you want orders to be moved to if they are canceled at Turbine.

Default Shipping Carrier

Choose the shipping carrier you want Turbine to use for your orders.

Default Shipping Method

Choose the shipping method you want Turbine to use for your orders.

Notification URL

Give this notification URL to your Turbine contact and ask them to send shipment notifications to it. This is how they will connect back to Order Desk to send tracking details as they ship your orders.

This URL does not change between staging and production environments.

Setup Redirects

If you have Turbine connected to more than one Order Desk store for the same account, instead of adding the notification URL for each connection to Turbine, add any additional notification URLs from other connections to your primary account. Add one URL per line.

When Turbine ships your items, these redirects will help the shipments find their way back into the Order Desk store the orders came from.

Send Customer Email Address to Turbine

Select this setting if you want customer email addresses to be included with the order details that are sent to Turbine.

Garments Will Be Provided

Select this setting if you will be providing the garments for Turbine to use for printing.

Default Return Address

Set the default return address that Turbine should use on your shipments.

If you need to customize the return address for certain orders, you can save different return addresses to your Store Settings and then use a rule to set the return address to specific orders. If a return address is not added to the order, the default address set here in the Turbine settings will be used.

For information on adding additional return addresses and applying them to specific orders with a rule, read the Store Settings guide.

Product Settings

For more information on what these product settings within the Turbine integration are for, please refer to the Print on Demand Product Settings guide.

Custom Details for Turbine

Initially, getting your orders ready to send to Turbine is going to take some time before everything is in place for it to happen automatically. For detailed instructions on how to use Order Desk with your print on demand orders, please take a few moments to read the print on demand fulfillment guide.

Custom Order Details

The following details can be submitted for an order as either checkout data or order metadata.

Field NameField Description
InsertImageThe URL for a custom insert image.
ShippingProviderUPS, FedEx, or DHL. If not provided, the default setting will be used.
ShippingMethodIf not provided, the default setting will be used.
GarmentsProvidedTRUE or FALSE. If not provided, the default setting will be used.
OrderNotesAny notes that should be passed along with the order.
ProductionPriorityNormal or Express. Defaults to Normal.
PackingSlipURL for the PDF to be included as the packing slip with the order. Details here.
TrackingNumberIf sending a shipping label, please pass the tracking number on the label for customer service reasons
ShippingLabelLink to a shipping label you want to be used with the order
ReferenceNumberSet an internal reference identifier for the order.

If you are unfamiliar with checkout data, see the How to Work with Checkout Data guide.

Custom Item Details

The following fields can be set as variations or item metadata for each item in an order. Replace _x with a number value if more than one artwork file will be sent for a single item (print_url_2, print_location_2, print_preview_2, etc.)

Field NameField Description
print_skuTurbine’s internal SKU for the item.
custom_tag_code_xUse the code given to you by Turbine if using a custom tag. Supports values 1 through 4 for multiple tag codes. Up to 12.
print_location_xDefault is unspecified. Start with F or B (front or back) and continue the descriptor as needed, such as Front Center or Back Bottom. Up to 12.
print_url_xThe URL for your artwork file. Google Drive links will not work with Turbine. Up to 12.
print_preview_xThe URL for the preview of your finished product. The image field will be used if nothing is entered. Up to 12.
print_underbase_xTRUE or FALSE. Indicates whether a white underbase layer should be applied before printing. Defaults to FALSE. Up to 12.
print_xoffset_xInteger value in millimeters (mm) used to position the artwork horizontally from the printer’s origin point. Up to 12.
print_yoffset_xInteger value in millimeters (mm) used to position the artwork vertically from the printer’s origin point. Up to 12.
print_width_xFloating number width in inches (in) for the printed artwork. Up to 12.
print_height_xFloating number height in inches (in) for the printed artwork. Up to 12.
print_note_xAny additional information about the print design. Up to 12.
custom_tag_type_xApply a custom tag to the item. Supported values are hang tag and sticker. Up to 12.
custom_tag_image_xPreview image URL for the custom tag. Up to 12.
custom_tag_print_xTRUE or FALSE. Specifies whether the tag should be printed and attached after production. Up to 12.
tech_pack_url_xURL to a tech pack or garment specification sheet. Up to 12.
personalization_text_xPersonalization text based on the print design. Up to 12.
personalization_font_xPersonalization font based on the print design. Up to 12.
personalization_color_xPersonalization color based on the print design. Up to 12.
personalization_size_xPersonalization size based on the print design. Up to 12.
print_stitch_count_xEstimated stitch count for embroidery files. Used for embroidery prints. x can be a value from 1 to 12.
decoration_typeSets the decoration type. Supported values are dtfdtgembroidery, or none. Set this to none for pre-saved items that only require print_sku.

Need Help?

If you have any questions about any of the information in this guide, we’re here to help!

Click here to email Order Desk support.