> 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/hoplix-integration.md). # Hoplix Integration Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them on to [Hoplix](https://hoplix.com/) for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk and back to your shopping cart if your store is set up for it. ### Setup To connect to Hoplix, click on the **Manage Integrations** link under the **Integrations** menu in the left sidebar, and under the **Print on Demand** tab find and enable Hoplix. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FJdmRUTtixGZZJGI2OJ0v%2Flegacy-e71e13d30731d4423e68.png?alt=media) Once enabled, enter your Hoplix API Key and Secret then click to connect. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FyxMsYgzSms84YewGA0st%2Flegacy-eba34b4bde70d8157208.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 Hoplix. ### Integration Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FiGyTAYMD47BCrD5iH7Dw%2Flegacy-13ebf72e1a99477cc35f.png?alt=media) Once connected, you will have a few settings where you can set your preferences for this integration. #### After Import, Move To Select the folder you want orders to be moved into after they are successfully sent to Hoplix. 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 after Hoplix sends shipment details back to Order Desk. #### Default Mail Class Select the default mail class you want Hoplix to use for your orders. The shipping method chosen here will be used for all orders where the method on the order does not match any of Hoplix’s shipping method names. If you need to apply specific methods for certain orders, match your method names to Hoplix’s names in the [Shipping Class Match section](#shipping-class-match) below. #### Default Payment Type Select your default payment type for Hoplix orders. This can be changed on a per-order basis using the [Custom Order Details](#custom-order-details). #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FM9gjlfOl08eiZaEKfqWT%2Flegacy-1c5371e0e5867c1702a3.png?alt=media) For more information on what these product settings within the Hoplix 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. #### Shipping Class Match ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FffS1TVTQsq5KoRKSeW61%2Flegacy-46ada3c3e88413985a34.png?alt=media) The shipping methods that you have set up in your shopping cart(s) may not match the methods that Hoplix uses. To make sure your shipping preferences are sent through to Hoplix with each order, match your methods to theirs in the shipping class match feature. If matches aren’t made, Hoplix will use your [default preference](#integration-settings) set above. To learn in more detail about how to set up your shipping class matches, see the [shipping class match](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide. ### Custom Details for Hoplix Getting your orders ready to send to Hoplix 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. #### Custom Order Details The following details can be submitted for an order as either checkout data or order metadata. | Field Name | Field Description | | --------------- | -------------------------------------------------------------------------------------------------- | | payment\_method | Set **credit card** or **wallet** if different from your [default setting](#integration-settings). | #### Custom Item Details To find the print details for your products, click the **View Available Products** link at the top of the integration settings page. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FuOQAmDdPGYcR46YSbRK2%2Flegacy-901b4cae99ede349c693.png?alt=media) Set the Campaign ID on the following page to view your products. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FoY8a7ppT57eW0LRIu6y8%2Flegacy-64e612df834f405d08d5.png?alt=media) The following fields can be set as variations or item metadata for each item in an order. | Field Name | Field Description | | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | campaign\_id/print\_design\_id | Set the campaign\_id for the item. When using the campaign\_id, there is no need to include a print\_url on the item. | | print\_sku | Hoplix product code for the item. | | color | Set the color. | | size | Set the size. | | print\_url\_1 | Link to the artwork file that should be printed on the front of the item. When using the print\_urls, there’s no need to include a campaign\_id on the item. | | print\_url\_2 | Link to the artwork file that should be printed on the back of the item. When using the print\_urls, there’s no need to include a campaign\_id on the item. | | print\_location\_1 | Set as “front” or “back”. Defaults to “front” and is not needed if your print\_url\_1 is intended for the front. | | print\_location\_2 | Set as “front” or “back”. Defaults to “back” and is not needed if your print\_url\_2 is intended for the back. | Please note that the orders are sent to different end-points in Hoplix depending on whether the campaign\_id is used or the print\_urls are used. With that in mind, every item in the order should either use a campaign\_id or print\_urls. It wouldn’t be possible to have items that use both in the same order. --- # 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/hoplix-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.