District Photo Integration
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.
IN THIS GUIDE
Setup
Basic Settings
Product Settings
Shipping Class Match
Sending Orders to District Photo
Setup
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. Additionally, District Photo provided you with additional credentials you can enter them in the Extended Credential Details section. This is only required if you have been provided with these details.
Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by District Photo.
Basic Settings
Once connected, you'll have some shipment and integration settings to adjust per your preferences.
Environment
While testing, keep this set to Staging. When ready to begin sending real orders to District Photo, switch this to Production.
CoBrand ID
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.
If Canceled, Move To
Select the folder you want orders to be moved into if they are canceled at District Photo.
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.
Use Order Billing Address as Return Address
If you would like the billing address for your orders to be used as the return address, select this option.
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.
Return Address Information
Set the default return address that District Photo 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 District Photo 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 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 |
UseBillingAsReturn | Use a value of 1 in this field to set the billing address as the return address on an order-by-order basis. |
ShippingMethod | Use to override the method set in the Shipping Class Match section of your integration settings. |
CobrandID | Use to override the method set in your integration settings. If no Cobrand ID should be passed, set the value to x. |
If you are unfamiliar with checkout data, please read the How to Work with Checkout Data guide.
Third Party Billing Fields
The following fields can be set as checkout data or order metadata to specify third party billing information:
- bill_third_party_company
- bill_third_party_contact
- bill_third_party_street1
- bill_third_party_city
- bill_third_party_country
- bill_third_party_zip
- bill_third_party_state
- bill_third_party_account_number
- bill_third_party_phone
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. |
page_quantity | Recommended when the product is a book. Use this to specify how many pages are included in the print file for the book. |
LineNumber | Set a status or billing message for the item. |
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.