User Guide

How to intgrate with OrderDesk

Step 1: Before the integration

OrderDesk provides guides for the integration. The links below help you to quickly get onboard OrderDesk mechanisms and setting up the account for future use.

1. Check if your shopping cart or ordering system supports OrderDesk connection. Find your tool here.

2. Read the generic print-on-demand fulfiller integration guide here.

3. Read the OPT OnDemand Integration guide here.

Step 2: Activate accounts and setup environments

You need to have an OrderDesk account as well as OPT OnDemand partner account in order to integrate.

1. Sign up for OrderDesk at https://app.orderdesk.me/account-setup

2. Send a request to [email protected] and we create new partner account for you.

3. Obtain staging auth credentials from our team

4. Follow the Setup Guide to connect OrderDesk and OPT OnDemand accounts together

5. Share Orderdesk webhook URL back to OPT tech team - we will setup oder update notifications.

6. Connect OrderDesk account to the shopping cart system or CRM you use, following tutorials here.

Note that the credentials you obtain in point 3 are for the PILOT environment for testing purposes so you must enter them in Staging environment form inside OrderDesk.

Step 3: Map the SKUs for blank products

For every product you send within the order, you must include the print_sku number parameter to tell us what blank article we print on. Our sales representative will provide you with the list of assigned articles along with their SKUs.

You might try to include this number manually in OrderDesk, following the OrderDesk's print-on-demand fulfiller guide at Place an Order Manually section.

Step 4: Enter shipping carriers

Each order must include the shipping carrier so OPT OnDemand knows how to send the package. Follow the shipping guide to set the carrier IDs.

Once you have primary or multiple carrier IDs you can set it in two ways.

1. Set a default carrier ID for the integration. Enter the carrier ID in Basic Integration settings in OrderDesk.

2. Set specific carrier ID per order using the ShippingCarrierID field in OrderDesk.

Step 5: Send orders

Follow the generic print-on-demand fulfiller integration guide on how to send orders manually or how to set up an automatic system inside OrderDesk.

Keep in mind to send important information for the printing.

Important fields

Field name	Field Value
print_sku	The OPT OnDemand Product ID. This field is required.
print_url	The printable art file for your design. For multi-location prints, you can send print_url_1 and print_url_2. This field is required
print_preview	For multi-location prints, you can send print_preview_1 and print_preview_2. If you have an image value in your item metadata, that will be used as a backup. This field is required.
print_location	For multi-location prints, you can send print_location_1 and print_location_2. This defaults to 1. You can use 2 for front or 3 for back. See the full list of Article Locations.
print_technology_id	The ID number for the type of print you want. Defaults to 1. See print technologies.
reorder_reason_id	The ID number for the type of reorder this is. Defaults to 0 (not a reorder).
centered	Should the design be centered on the garment? Defaults to 1 (true). You can enter 0 (false).
file_type	If you are using a photo service that does not include the extension in the url (like Google Drive) you can enter "jpg" or "png" or "pdf" in this field.

Step 6: Test orders and switch to production

Send multiple orders via OrderDesk to OPT OnDemand pilot environment and send us a ping at [email protected]. We will verify if order data and printing format are fine.

Once the testing phase is completed, we will send you a production credentials that you enter in OrderDesk Integration settings page. (similar form when you entered staging credentials)