Circle Graphics Integration
IN THIS GUIDE
Overview
Setup
Integration Settings
Product Settings
Shipping Class Match
Checking for Shipped Orders
Sending Orders to Circle Graphics
Troubleshooting Timeout Errors
Overview
Order Desk can submit your print on demand orders to Circle Graphics. Order Desk can also pull the tracking numbers for your shipments from Circle Graphics.
Setup
To enable the integration, click on Manage Integrations in the left sidebar. Under the Print on Demand tab, find and enable the Circle Graphics integration.
Alternatively, search for Circle Graphics from the available integration search.
Once enabled, enter the Company ID and Access Token provided to you by Circle Graphics 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 Circle Graphics.
Integration Settings
After Import, Move To
Select the folder you want orders to be moved into after they are successfully sent to Circle Graphics.
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 Circle Graphics sends shipments back to Order Desk.
Default Mail Class
Choose the mail class you want Circle Graphics to use for your orders.
If you need to apply specific methods for certain orders, match your method names to the names Circle Graphics uses in the Shipping Class Match section below.
Shipping Accounts
Set the default shipping account you want to use for Circle Graphics orders. Circle Graphics 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 Circle Graphics.
You can also set these on a per-order basis; see more information under the Sending Orders to Circle Graphics section below.
Default Return Address
Set your default return address for Circle Graphics 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 Circle Graphics 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 Circle Graphics 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 Circle Graphics 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 Circle Graphics 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
Circle Graphics 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 Circle Graphics For Shipment button directly on the order page.
If this is a recurring problem, please contact Order Desk support.
Sending Orders to Circle Graphics
Getting your orders ready to send to Circle Graphics 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 Circle Graphics.
Field Name | Field Description |
PackingSlip | A PDF URL to be printed and included with the shipment. Details here. |
ShippingAccount | Use to override the Default Shipping Account on individual orders. ShippingAccount should be used for orders going to printers in addition to Circle Graphics. Use CircleGraphicsShippingAccount to differentiate between the standard account number only format (e.g., F8T3K5) and the Circle Graphics 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 Circle Graphics instead of the Source ID |
ClientJobRef | Alternative reference number for the labels |
If you are unfamiliar with checkout data, please read the How to Work with Checkout Data guide.
Custom Item Data
Circle Graphics 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 Circle Graphics 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 Circle Graphics, 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 Circle Graphics 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.