podOS Integration
Order Desk can submit your print on demand orders to podOS. As orders are fulfilled, shipment details will automatically be pulled back into Order Desk and sent to the original shopping cart.
Setup
To connect to podOS, click on Manage Integrations in the left sidebar. Under the Print on Demand tab, find and click to enable the podOS integration.
Alternatively, search for podOS from the available integrations search.
Enter your podOS Project Name and API Token, then click Connect:
Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by the podOS team.
Integration Settings
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 sent to podOS.
If you want to use a custom folder, create your own from Store Settings. See the Working with Folders guide for more information.
Default Mail Class
Select your preferred default mail class. The shipping class you set here will be used for all of your orders where the shipping method on the order does not match one of shipping method names used by podOS exactly or that has not been mapped to one of the shipping method names that podOS uses.
If you need to apply specific methods for certain orders, match your method names to podOS names in the Shipping Class Match section below.
After Shipment, Move To
Select the folder you want orders to be moved into when podOS sends shipment details back into Order Desk.
View Base Products
If you already know your product style codes but need to find the GFN Product IDs (podos_gfn_product_id), you can use this option. It will take you to a page where you can look up the GFN Product IDs by searching with those style codes.
Once you have the GFN Product IDs, you can use them to look up the related podos_gfn_variant_id if you need the specific variations later on.
View GFN Variants
This option links you to a page where you can see all of your podOS products. You'll be able to find their podos_gfn_variant_id and all other related information:
You can also narrow down the list by searching for specific GFN Product IDs. The details you find on this page can be used to prepare your items before you send orders for fulfillment.
Product Settings
For detailed information on what the product settings within the podOS integration do, please read the Print on Demand Product Settings guide.
Shipping Class Match
The shipping methods that you have set up in your shopping cart(s) may not match the methods that podOS uses. To make sure your shipping preferences are sent through to podOS with each order, match your methods to theirs in the shipping class match feature. If your shipping method name does not match their shipping method name exactly, your default mail class will be used instead.
For information on how to set up your shipping preferences, please read the Shipping Class Match guide.
Sending Orders to podOS
Getting your orders ready to send to podOS 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.
Preparing Your Items
The following fields can be set as variations or item metadata for each order item.
The fields below tell podOS exactly which product to print for each order item. Depending on how your products are set up in your inventory, you’ll use a different field. Pick the one that best matches how your products are stored in Order Desk.
| Field Name | Description |
|---|---|
| podos_variant_id | Use this if you already know the exact pre-designed product to print in podOS. This points podOS straight to that single, specific product variation. |
| podos_gfn_variant_id | Use this for custom products where each SKU in your inventory represents one unique variation. For example: "A Men’s Plain T-Shirt with Color: White, and Size: XS". This data can be found by using the View GFN Variants option on the integration settings page. |
| podos_gfn_product_id | Use this if your inventory stores only the general product (like "Men’s Plain T-Shirt"), and the item’s variation details (like size or color) come from the order itself. This data can be found using the View Base Products option on the integration settings page. Order Desk will look at all available variations in podOS and automatically pick the one that matches the variation data on your order item. |
Rules Reference
In addition to the general set of rule events and actions in Order Desk, podOS includes a number of rule events and actions that are specific to the integration. These aren’t found directly on the integration page. Instead, you’ll need to use the Rule Builder to access them.
If you’re new to using rules in Order Desk, we recommend starting with our How to Work With Rules guide.
Rule Events
The following events are specific to podOS. To find them, type podOS in the Event dropdown menu in the Rule Builder:
| Event | Description |
|---|---|
| Order Scheduled to podOS | Triggered when an order is scheduled to be sent from Order Desk to podOS. This triggers immediately after the order is scheduled to be sent, so it can be used when you want to take immediate action on the order at that point. |
| After Order Submitted to podOS | Triggers after an order has been successfully submitted to podOS. |
| Before Order Submitted to podOS | Triggered just before an order is sent from Order Desk to podOS. This is useful in cases where you want to make last-minute updates before an order is sent. |
| Order Not Submitted to podOS Because of Invalid SKU | Triggers when an order submission fails because one or more SKUs aren’t valid in podOS. |
| Order Not Submitted to podOS Because of General Error | Triggers when a general error prevents the order from being submitted to podOS. |
| Order Not Submitted to podOS Because No Products Available | Triggers when an order submission fails because no valid products were found for submission. |
Rule Actions
podOS also supports specific rule actions that you can apply to your orders. These can be found in the Actions dropdown by searching for podOS:
| Action | Description |
|---|---|
| Submit Order to podOS | Sends an order from Order Desk to podOS. |