> 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/bay-photo-integration.md). # Bay 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 [Bay Photo](https://www.bayphoto.com/). As Bay 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 and use the Bay Photo integration. ### Setup To use the Bay Photo integration in Order Desk, you will need Bay Photo to approve you as a Fulfillment Partner prior to set up. Once that is taken care of, to enable the integration in Order Desk, click on **Manage Integrations** in the left sidebar. Under the **Print on Demand** tab, find and enable the Bay Photo integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FbK5DpU8uB5e7aoLEEVeW%2Flegacy-5d31ea26eca5e037a42a.png?alt=media) Alternatively, search for Bay Photo from the available integration search. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FDevT203lO5MfrFGdgbFu%2Flegacy-1ba6b4a3a82fb7d62168.png?alt=media) Enter your API Token from Bay Photo and connect the integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FxHv7FG9djO8cJKuNbD5B%2Flegacy-541483d31743683f9758.png?alt=media) Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by Bay Photo. #### Reset API Token If your API token with Bay Photo Lab needs to be updated, scroll down to the bottom of your integration settings and click the Disconnect button. Then, go through the above setup process to integrate Bay Photo Lab again with your new API token. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FoOygiONoo9Wg8zGnjCVP%2Flegacy-c98558f92285e960aa59.png?alt=media) ### Integration Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FdUk5PZWsSIvfR0fSxeEP%2Flegacy-21465fa4381cec7b4d5d.png?alt=media) #### After Import, Move To Select the folder you want orders to be moved into after they are successfully sent to Bay Photo. You can use one of the default folders already in your store or create your own. 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 Select the folder you want orders to be moved into as Bay Photo sends back shipment details. #### If Canceled, Move To Select the folder you want orders to be moved into if they are canceled at Bay Photo. #### Default Shipping Classes Choose the shipping classes you want Bay Photo to use for your domestic, Canadian and International orders. If you need to apply specific methods for certain orders, match your method names to Bay Photo’s names in the [Shipping Class Match section](#shipping-class-match) below. #### Shipper Phone Some shipping companies require a phone number. Add your phone number here as a backup in case a customer left theirs off the order. #### Return Shipping ID If Bay Photo has given you a Return Shipping ID for customized shipping labels, add that here. This can also be set directly on an order. Details in the [Preparing Orders](#order-level-details) section below. #### Notification URL Give this notification URL to Bay Photo. They will use it to connect to your Order Desk account and send shipment details back to your orders automatically. #### Send Customer Email Address to Bay Photo If you would like the customer’s email address to be sent with the order details, select this option. #### Don’t Send Image Crop Data to Bay Photo Enable this setting if you are rendering your artwork images to size or aspect ratio and you do not need Bay Photo to crop or rotate the images before printing. If you leave this disabled, Order Desk will apply the default crop and rotate information on your items unless specified on a per-item basis. Default information and how to override it are explained in more detail[ below](#custom-details-for-bay-photo). #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fb1vujVpIDWVUuGpgVO3c%2Flegacy-9e332a1bf56271c58115.png?alt=media) For more information on what the product settings within the Bay 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%2FSoYe49s1Twtun3KDFw6G%2Flegacy-655374e17638ba1bfdb9.png?alt=media) If the shipping methods you set up in your shopping cart(s) don’t match the shipping method names Bay 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 Bay 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. ### Custom Details for Bay Photo Getting your orders ready to send to Bay 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. #### Order Level Details Bay Photo will not accept the same order twice so be careful that it only gets submitted once. All orders will be submitted with the drop ship value set to true to remove branding and the pickup value set to false. If you’d like to send custom data about the order to Bay Photo, you can set the following checkout data field: | Field Name | Field Description | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ReturnShippingID | Set the return shipping ID on an individual order. | | OrderServices | If Bay Photo provides any service IDs for you to use with your orders, set those here as a single number or a list of numbers separated by a comma. Example, set 21285 for the Bay Photo service ID for Ship in Tube. | | GiftMessageImage | Set a link to an image file with the gift message on it for Bay Photo to print out and include with the order. | 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. #### Item Level Details The following fields can be set as variations or item metadata for each order item. Replace “x” with a value specified in the table, i.e. print\_url\_1 or print\_url\_2. | Field Name | Field Description | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | print\_sku | Internal Bay Photo product SKU (integer). | | print\_services | If Bay Photo has provided service IDs to perform on the order, please enter these IDs separated by a comma. | | print\_url\_x | The publicly available URL from which your artwork can be downloaded. Only used for DigitalPrint. | | print\_location\_x | The Node UID for the location of this print. In most cases it is 1. If you do not include it, 1 will be used. | | crop\_height\_x | Height percentage, 100 by default if not included. If you do not need images cropped, enable the Don’t Send Image Crop Data to Bay Photo setting [above](#integration-settings). | | crop\_width\_x | Width percentage, 100 by default if not included. If you do not need images cropped, enable the Don’t Send Image Crop Data to Bay Photo setting [above](#integration-settings). | | crop\_x\_x | Crop location vertically, 50 is center and will be used if not included. The second x should be 1, 2, 3 etc. to number which print should be affected. If you do not need images cropped, enable the Don’t Send Image Crop Data to Bay Photo setting [above](#integration-settings). | | crop\_y\_x | Crop location horizontally, 50 is center and will be used if not included. The x should be 1, 2, 3 etc. to number which print should be affected. If you do not need images cropped, enable the Don’t Send Image Crop Data to Bay Photo setting [above](#integration-settings). | | degrees\_rotated\_x | The degrees that the original artwork should be rotated. If nothing is entered 0 will be used. If you do not need images rotated, enable the Don’t Send Image Crop Data to Bay Photo setting [above](#integration-settings). | --- # 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/bay-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.