> 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/sensaria-integration.md). # Sensaria Integration Order Desk can submit your print on demand orders to [Sensaria](https://www.sensaria.com/) (formerly known as **Circle Graphics**). Order Desk can also pull the tracking numbers for your shipments from Sensaria. ### Setup To enable the integration, click on **Manage Integrations** in the left sidebar. Under the **Print on Demand** tab, find and enable the Sensaria integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FfiI94gHHjwsyuGsU4Yx7%2Flegacy-6e20e41e062ba5f425d6.png?alt=media) Alternatively, search for Sensaria from the available integration search. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FFwszNmEEPRUFjQdOp5qD%2Flegacy-7d73330cd10e5191792c.jpg?alt=media) Once enabled, enter the Company ID and Access Token provided to you by Sensaria and click to connect. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fq5Ty54Rq10sLP9VvCvJW%2Flegacy-315189f614ff9ece1465.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 Sensaria. ### Integration Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F1OQzte5nkWnEJ4iqs75K%2Flegacy-1e54dd46d4fccbe309ed.png?alt=media) #### After Import, Move To Select the folder you want orders to be moved into after they are successfully sent to Sensaria. 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 Sensaria sends shipments back to Order Desk. #### Default Mail Class Choose the mail class you want Sensaria to use for your orders. If you need to apply specific methods for certain orders, match your method names to the names Sensaria uses in the [Shipping Class Match section](#shipping-class-match) below. #### Shipping Accounts Set the default shipping account you want to use for Sensaria orders. Sensaria also has a special format for account numbers; this format looks like `BTP_ACCOUNTNUMBER_ZIPCODE`. Order Desk can preload the correct formatting for different accounts that you’ll be using. For example, you can set `BTP_1Z94XR_55555, BTP_F8T3K5_55555` in the Shipping Accounts field, then if you add F8T3K5 as a shipping account, we’ll convert it to the `BTP_F8T3K5_55555` format before passing through to Sensaria. You can also set these on a per-order basis; see more information under the [Sending Orders to Sensaria](#sending-orders-to-sensaria) section below. #### Default Return Address Set your default return address for Sensaria to use on your order shipments. If you need to customize the return address for certain orders, you can save different return addresses to your Store Settings and use a rule to set the return address on specific orders. If a return address is not added to the order, the default address set here in the Sensaria 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. The phone number set here will be used for any orders where a phone number has not been provided by the customer. If shipping with FedEx, a phone number is required. #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FIJ2ageixWBrTfmCttCAM%2Flegacy-40a1482321461e25f78b.png?alt=media) For more information on what the product settings within the Sensaria 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%2FNJGdNEKFV3AewiF94xMd%2Flegacy-7f741de5ba8f366c5976.jpg?alt=media) If the shipping methods you set up in your shopping cart(s) don’t match the shipping method names Sensaria uses, they won’t know what methods you intend for them to use. When this happens, the [default mail class applied above](#integration-settings) will be used instead for all of your orders. To tell Sensaria 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. #### Checking For Shipped Orders Sensaria is checked once a day for shipments on all orders from the previous three days. If the SLA is past three days, you can check for the shipment manually by clicking the **Check Sensaria For Shipment** button directly on the order page. If this is a recurring problem, please contact Order Desk support. ### Sending Orders to Sensaria Getting your orders ready to send to Sensaria 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 Data The following details can be submitted with an order as either checkout data or order metadata. For more information on what each field means, please talk to Sensaria. | Field Name | Field Description | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ShippingAccount | Use to override the [Default Shipping Account](#shipping-accounts) on individual orders. ShippingAccount should be used for orders going to printers in addition to Sensaria. Use SensariaShippingAccount to differentiate between the standard account number only format (e.g., F8T3K5) and the Sensaria extended format (e.g., BTP\_F8T3K5\_55555), or preload your Shipping Accounts in the [settings](#shipping-accounts) above in order to use the standard account number only format. | | PackageLabel | Custom 4×6 package label to be added to the box. This will not replace the shipping label. URL should be a JPG file. | | PONumber | The alternative order ID to pass to Sensaria instead of the Source ID | | ClientJobRef | Alternative reference number for the labels | | BagLabel | Add a URL for the image you would like to use as a label, which will be attached to the bags the item will ship in. | 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. #### Custom Item Data Sensaria offers many different customization options which are fully supported by Order Desk. These fields can be set in the item variation or metadata. | Field Name | Field Description | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | print\_sku | **Required.** Internal Sensaria product SKU. These will always be integers. | | print\_url | **Required.** The link to your artwork file to be printed. | | print\_design\_id | The Customer SKU that you want to submit instead of `print_url`. If used, print\_sku and print\_url are not necessary. | | CustomCut | `true` or `false`. Default is `false`. | | AdditionalHardware | Default is `0`. | | AssemblyRequired | `true` or `false`. Default is `false`. | | ShipMethod | Use this field to set a different shipping method for each order item. This will override the order’s main shipping method.The value entered here will also be matched against any [Shipping Class Matches](#shipping-class-match) you’ve set up in your integration settings. | | GrommetCount | The number of grommets. | | BungeePkgCount | The number of bungee package count. | | MetalHangerPkgCount | The number of metal hanger packages. | | LiveHorizontalIn | Numeric | | LiveVerticalIn | Numeric | | BleedTopIn | Numeric | | BleedRightIn | Numeric | | BleedBottomIn | Numeric | | BleedLeftIn | Numeric | | GrommetTop | Numeric | | GrommetRight | Numeric | | GrommetBottom | Numeric | | GrommetLeft | Numeric | | PocketTop | Numeric | | PocketRight | Numeric | | PocketBottom | Numeric | | PocketLeft | Numeric | | HemTop | Numeric | | HemRight | Numeric | | HemBottom | Numeric | | HemLeft | Numeric | ### Troubleshooting Timeout Errors Occasionally when an order is sent to Sensaria, it will time out after 30 seconds. When this happens, there is a good chance that the order eventually went through, but there is no way to know from within Order Desk. When this happens, we will contact you to let you know that you need to confirm with Sensaria that they received the order. When this happens, there is no way to automatically pull the tracking number back in for the order. It will need to be entered manually on the order when it ships. --- # 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/sensaria-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.