Loxley Colour Integration
IN THIS GUIDE
Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them to Loxley Colour 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.
This guide explains how to set up and use the Loxley Colour integration and the features available.
To enable the integration, click on Manage Integrations in the left sidebar. Under the Print on Demand tab, find and enable the Loxley Colour integration.
Enter your Loxley Colour credentials and click to connect. The Lab ID value of "LoxleyColour" likely can be left as is.
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 Loxley Colour.
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 as Loxley Colour sends shipment details back.
Backup Phone Number
To prevent any shipping delays, add the phone number to be used for orders where the customer did not include one.
Give this notification URL to Loxley Colour. This is what connects them back to Order Desk so they can send shipment details automatically as they fulfill your orders.
Send Customer Email Address to Loxley Colour
Select this option if you want the customer's email address to be included with the order details that are sent to Loxley Colour.
Please see the Loxley Colour shipping code spreadsheet (available from Loxley Colour) for reference on all the shipping codes available.
By default, all orders will be sent with the last shipping code available for the country or zone. Not all countries are automatically supported, but most are, including all European countries and the US and Canada. If you have other countries that need to be supported, please contact Order Desk.
If you would like to set a specific shipping code for an order, use the rules to set the checkout data for ShippingMethod to the code you want. For more information on how to do this, please read the How to Work with Checkout Data guide.
Sending Orders to Loxley Colour
Initially, getting your orders ready to send to Loxley Colour 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.
Required Item Details
Sending order item data to Loxley Colour is a little different from some of the other print integrations. There are a number of fields that will need to be set on a per-product level. Loxley Colour will provide you with all of the data you need.
Because there are several fields to include, please consider importing your products from a spreadsheet rather than manually entering them into Order Desk.
The following fields must be set as variations or item metadata for each item in an order:
|Field Name||Field Description|
|PrintURL||URL of the artwork file. Must have a file extension (querystring is acceptable) at the end of the path. Dropbox links work. Google Drive links will not work.|
|ItemLabel||Name of the product to be printed on with the size at the beginning. Example: 16 x 24 Lustre Photographic Print.|
|LayoutFile||This value will be supplied by Loxley Colour.|
|TemplateWidth||Decimal number for the width in inches of your template. Example: 16.|
|TemplateHeight||Decimal number for the height in inches of your template. Example: 24.|
|RoesKPLExecuteString||String that will be provided by Loxley Colour.|
Optional Item Fields
In addition to the required fields above, the following optional values can be used if the item being printed requires them. Loxley Colour will let you know if any of these values need to be set:
|Field Name||Field Description|
|TemplateBounds||Set of numbers that should include the Template Width and Height. If not entered, this will be calculated automatically. Example: 0.0,0.0,16.00,24.00.|
|NodeBounds||For a specific image node that is a different size than the main template (such as a frame), set the provided NodeBounds value. If not entered, the calculated TemplateBounds value will be used.|
|50000NodeBounds||If your 50000 node bounds needs to be different from the regular one, set that here.|
|TemplateID||Set a custom template ID here. If nothing is set, the "custom" value will be used.|
|NodeID||This value is usually 10000. If you need to use 50000, set it here. If nothing is set, 10000 will be used.|
|NodeInput||This is usually "image" and will default to this value if nothing is entered.|
|VariesFromLabLayout||This is usually "true" and will default to this value if nothing is entered.|
|ImageCrop||This will default to "0.0,0.0,1.0,1.0,0.0". If you need to enter something else, use this field.|
|The width (px), height (px) and size (bytes) of the image needs to sent to Loxley Colour. Order Desk will attempt to download the image file to get these details, but a large image can take awhile and/or time out, causing the entire process to fail. To guard against this, you can set these values in this field to skip the image from being downloaded to get this information. Set the width, height, and size like this: "1000,2500,21488775". That's width, height, bytes.|
|OptionID1||Set an option ID/Label pair if needed. OptionIDs and OptionLabels 1-10 are accepted.|
|OptionLabel1||Same as above. Supports 1-10.|
If you need to add a second image to a print, add another set of records with a _2 or _3 appended, etc. This must be done for the following fields: PrintURL, NodeBounds, 50000NodeBounds, NodeID, NodeInput, ImageCrop, and ImageSettings.
Example: printURL_2, printURL_3, NodeBounds_2, NodeBounds_3, etc.