> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/print-on-demand/district-photo-integration.md). # 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](http://www.districtphoto.com/) (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. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FLtGynByMNdfOBcHusagJ%2Flegacy-96b272fd165a26da2800.png?alt=media) 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. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F76D1Y3Ok4do7xN84OHjr%2Flegacy-ad8077fed36668030fc8.jpg?alt=media) 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 ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FMaJvveYJwazLDixYjRd4%2Flegacy-cd3ab3a6427e6460b98d.png?alt=media) 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](#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](/start-here/getting-started-series/quick-start-overview.md#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](/guided-walkthroughs/using-order-desk/manage-store-settings.md#return-addresses) guide. #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FoBQVPKgBx2w5okzcCGrC%2Flegacy-0792d7ba5a3adfe942c2.png?alt=media) For more information on what the product settings within the District Photo integration do, please read the [Print on Demand Product Settings](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-integration-product-settings.md) guide. #### Shipping Class Match ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FdskskRMlB9i5Gwz3dgJw%2Flegacy-6d38a39b4f512d8f3b23.png?alt=media) 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](#integration-settings) 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](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) 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](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-fulfillment.md) 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 – 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](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) 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. 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`. | Field Name | Field Description | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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`. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.orderdesk.com/integration-setup-guides/print-on-demand/district-photo-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.