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.

Still need help? Contact Us Contact Us