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.
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.
Integration 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:
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 – Book490900 – Card491000 – Calendar491191 – Photos691190 – Mug950510 – Ornament630140 – Blankets940490 – Pillow610910 – 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.
shipping_label
This is the shipping label image URL. Must be in PNG format.
shipping_label_tracking
The shipping label tracking number.
shipping_label_carrier
The carrier associated with the shipping label.
shipping_label_service
The service associated with the shipping label.
shipping_label_weight
The default weight is 0.
shipping_label_dimensions
The default dimensions are 6x9x0.5.
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_companybill_third_party_contactbill_third_party_street1bill_third_party_citybill_third_party_countrybill_third_party_zipbill_third_party_statebill_third_party_account_numberbill_third_party_phone
Preparing Your Items
The following fields can be set as variations or item metadata for each order item. For fields ending in _x, replace x with a number that matches the related print_url field. For example, use print_location_1 and print_instructions_1 for the artwork file in print_url_1.
print_sku
District Photo’s item code. This is not the same as your product SKU.
print_url_x
URL of your artwork file.
print_location_x
Location where the design should be printed. Use one of the following values: FrontCenter FrontPocket FrontBelly BackCenter BackShoulder FrontBottom FrontTop FrontCenter3/4 FrontCenter1/2
print_instructions_x
Instructions for your print design. The number should match the related print_url and print_location fields.
backprint
Backprint value for the item, if needed.
file_extension_x
Image extension for the associated print_url if the file name doesn’t already include an extension.
page_quantity
Recommended for book products. Use this to specify how many pages are included in the print file for the book.
LineNumber
Status or billing message for the item.
For print_url_x, values 1 through 28 are accepted. District Photo supports up to 28 print URLs.
If you’re only sending one printable artwork file to District Photo, you can use print_url or print_url_1.
Last updated
Was this helpful?