District Photo Integration
IN THIS GUIDE
Order Desk can pull your print on demand orders in from your shopping cart(s), sync your print details into them, and then submit them to District Photo (also known as Custom Color Solutions). As District Photo fulfills the orders, the shipment details will be pulled back into Order Desk and sent back to the original shopping cart if your store is set up for it.
This guide explains how to set up the District Photo integration and covers the settings and features available with it.
To connect to your District Photo account, click on Manage Integrations in the left sidebar. Under the Print on Demand tab, look for and enable the District Photo integration.
Once enabled, you will need to enter the Dealer Number you received when setting up your District Photo account.
Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by District Photo.
Once connected, you'll have some shipment and integration settings to adjust per your preferences.
While testing, keep this set to Staging. When ready to begin sending real orders to District Photo, switch this to Production.
If supplied with a CoBrand ID, add it here. If District Photo has not provided one, leave this field blank.
Default Mail Classes
Default Mail Class | Default Intl Mail Class
Select your preferred domestic and international mail classes. The shipping methods selected will be used for all orders sent to District Photo unless, where different, the shipping method on the order matches District Photo's method name exactly.
If you need District Photo to use a specific shipping method on an order by order basis rather than defaulting to the settings here, set your preferences in the Shipping Class Match section.
A note about District Photo's shipping options: Standard Ground will automatically use Mail Innovations for orders under 1 pound making this a good variable shipping option.
After Import, Move To
The folder set here is where orders will move after they are successfully sent to District Photo.
You can choose the default Prepared folder for this, or create your own folders in your Store Settings. Read the Working with Folders guide for more information.
After Shipment, Move To
The folder set here is where orders will move after District Photo sends back fulfillment and tracking details.
Merchant Phone Number
Some shipping companies require a phone number. Add your phone number here as a backup in case a customer left theirs off the order.
Send Customer Email Address to District Photo
If you would like the customer's email address to be sent with the order details, select this option.
For more information on what the product settings within the District Photo integration do, please read the Print on Demand Product Settings guide.
Shipping Class Match
If the shipping methods you set up in your shopping cart(s) don't match the shipping method names District Photo uses, they won't know what methods you intend for them to use. When this happens, the default mail classes applied above will be used instead for all of your orders.
To tell District Photo what methods you want them to use, you will need to match your method names to theirs. This can be done in the shipping class match section. For detailed instructions on setting this up, please read through the shipping class match guide.
Sending Orders to District Photo
Getting your orders ready to send to District Photo will take some set up time. For a detailed walkthrough of how to use Order Desk with your Print on Demand orders, please read through our Print on Demand Fulfillment guide.
Preparing Your Orders
The following fields can be set as checkout data or order metadata to specify what gets sent to District Photo:
|Field Name||Field Description|
|OrderImageEnhance||If you need to pass an Image Enhance Code, enter it here|
|OrderAdImage||If you need to pass an Order Ad Image, enter it here|
|IOSS||Send the IOSS number that you want to be used on the order to District Photo. If not set, the default IOSS number from the Store Settings will be used instead.|
|DeclaredValue||For customs purposes. If you want to set a custom declared value, enter it here. Otherwise, we'll pass the product total.|
|DutyAmount||For customs purposes. We will pass 0 unless you set a number here.|
|DutyPrepaid||For customs purposes. 1 or 0 -- we will pass 0 by default.|
|ContentDescription|| For customs purposes. We will default to 491191 - Photos. Other options are:
490110 - Book
490900 - Card
491000 - Calendar
491191 - Photos
691190 - Mug
950510 - Ornament
630140 - Blankets
940490 - Pillow
610910 - Apparel
If you are unfamiliar with checkout data, please read 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. Replace the "x" with a value specified in the table, i.e. print_url_1 or print_url_2.
|Field Name||Field Description|
|print_sku||The District Photo item code. Not the same as your product SKU.|
|print_url_ x||The URL for your artwork file.|
|print_location_*||Specify where you want a design printed by using FrontCenter, FrontPocket, FrontBelly, BackCenter, or BackShoulder.|
|backprint||If necessary, add a backprint value for the item here|
|file_extension_ x||Set the image extension for the associated print_url if the file name doesn't have an extension on it.|
For print_url_x, values 1-8 are accepted. District Photo supports up to 28 print URLs.
If you are only sending one printable artwork file to District Photo, you can use print_url or print_url_1.