Sensaria Integration

Order Desk can submit your print on demand orders to Sensaria (formerly known as Circle Graphics). Order Desk can also pull the tracking numbers for your shipments from Sensaria.


Integration Settings
Product Settings
Shipping Class Match
Checking for Shipped Orders
Sending Orders to Sensaria
Troubleshooting Timeout Errors


To enable the integration, click on Manage Integrations in the left sidebar. Under the Print on Demand tab, find and enable the Sensaria integration.

Alternatively, search for Sensaria from the available integration search.

Once enabled, enter the Company ID and Access Token provided to you by Sensaria and click to connect.

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

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 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 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 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 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

For more information on what the product settings within the Sensaria integration do, please read the Print on Demand Product Settings guide.

Shipping Class Match

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 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 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 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 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 above in order to use the standard account number only format.
PackageLabel Custom 4x6 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 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.
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.

Still need help? Contact Us Contact Us