> 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/merchize-integration.md). # Merchize Integration Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them to any printer using [Merchize](https://merchize.com/). When orders are shipped, the tracking details will be sent back to Order Desk automatically. ### Setup To enable the integration, click on **Manage Integrations** in the left sidebar. Under the **Print on Demand** tab, find and enable the Merchize integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FWHLWcI7F9u8piBiDZZIo%2Flegacy-3f02d696171029e62b42.png?alt=media) Alternatively, search for Merchize from the available integration search. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F9EYJyNz6vJOoFtpFI5Bo%2Flegacy-1365aed88aa84fc3a72b.jpg?alt=media) Enter your Merchize API Key and Base URL and then click to connect. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FBNv39Jf78gGtnnIXQ18Z%2Flegacy-b24d6b83142cb0b0ad5b.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 Merchize. If needed, you may [navigate here](https://seller.merchize.com/a/integrations/api) to obtain your credentials. ### Integration Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FR9NK8O3i65rAyGlwtCOD%2Flegacy-f4191b95f90c46a3c83f.png?alt=media) Once connected, you’ll have some shipment and integration settings to adjust per your preferences. #### View Available Products Click this link to view all available Merchize products. #### Merchize Help Click *Need Help Getting Started?* for access to helpful resources for using Merchize. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FxtInjSlJ7Bp07gjV71Vh%2Flegacy-3d7453beb20778403e41.gif?alt=media) #### After Import, Move To Select the folder you want orders to be moved into after they are successfully sent to Merchize. 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 when Merchize sends tracking details back. #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FPzsbP5dioVAsxu1TF0Ht%2Flegacy-f8bea7a515055b3df418.png?alt=media) For more information on what these product settings within the Merchize integration are for, please refer to the [Print on Demand Product Settings](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-integration-product-settings.md) guide. ### Sending Orders to Merchize Getting your orders ready to send to Merchize 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. #### Item Details The following fields can be set as variations or item metadata for each item in an order. | Field Name | Field Description | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | product\_id | Unique identifier for a product. When multiple orders are created, Merchize will use this identifier to point to a single product. | | merchize\_sku | The direct SKU of the item in Merchize. | | print\_sku | **Required**. The SKU of the item being printed on. Available items can be viewed by clicking the View Available Products link in your Merchize integration settings. | | print\_url\_x | Link to your artwork files. Up to 4 can be used for each item, corresponding to print\_location\_x (e.g. print\_url\_1 and print\_location\_1). | | print\_location\_x | Sets the print location for the corresponding print\_url\_x. Up to 4 available (e.g. front, back, hood, sleeve). | | print\_preview | **Required**. Sets the preview image. | | attribute\_name\_x | **Required**. Sets an attribute name (e.g. size, color) that corresponds to attribute\_value\_x. Up to 4 available. | | attribute\_value\_x | **Required**. Sets an attribute value (e.g. M, black) that corresponds to attribute\_name\_x. Up to 4 available. | | currency | Sets the currency for the item price. | #### Customize Order Details You can add custom details to your orders to be passed through to Merchize. Add these details as checkout data or metadata fields. The field names must be an exact match to this table. | Field Name | Field Description | | ---------- | ----------------------------------------------------------------------------------------------------------------------------------- | | tags | Use this field to set tags for orders. Multiple tags must be separated by commas. | | OrderID | Use this field to set the order number. If no value is set in this field, the Order Desk internal order ID will be used as default. | For instructions on how to apply these fields to checkout data, please read the [How to Work with Checkout Data guide](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md). ### Failed Orders Orders that are sent to Merchize undergo a production validation process and if the validation fails, your orders might not execute the workflow set up in your Order Desk store. Merchize will contact you when orders haven’t been validated as expected. To ensure that you have the opportunity to review or re-submit these orders, you have the option to use the rule event **Order Import Failed at Merchize**. This event can be utilized to trigger rule actions that will allow you to review your failed orders (e.g. Change Folder or Tag Order) or resubmit using the **Submit Order to Merchize** action. ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/642f633fa3236b1edbce937c/file-gpEMhEx9VP.png) For more information on how to work with rules, please refer to the [Rule Builder guide](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md). --- # 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/merchize-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.