Zift (Fifth Sun) Integration
IN THIS GUIDE
Order Desk can pull your print on demand orders in from your shopping cart(s), sync your print details into them, and then submit them to Zift (Fifth Sun). As Zift fulfills the orders, the shipment details will be pulled back into Order Desk and sent back to the original shopping cart if your store is set up for it.
This guide explains how to set up and use the Zift integration.
To enable the integration, click on Manage Integrations in the left sidebar. Under the Print on Demand tab, find and enable the Zift integration.
Select either Production (live) or Sandbox (test) and enter your Zift API Key and click to connect.
You will also need to give the Notification URL to Zift so they can send shipment notices back to Order Desk as they fulfill your orders. The Notification URL will still be accessible in your settings after connecting to the integration.
Select Production (live) or Sandbox (test) depending on which environment your store is currently in.
Select which of your Zift stores, if you have more than one, you want orders to be sent to.
Default Mail Class
Choose the mail class you want Zift to use for your orders.
If you need to apply specific methods for certain orders, match your method names to Zift's names in the Shipping Class Match section below.
After Import, Move To
Select the folder you want orders to be moved into after they are successfully sent to Zift.
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 Zift sends back shipment details.
If Failed, Move To
Select the folder you want orders to be moved into if they are canceled at Zift.
Give this Notification URL to Zift so they can send shipment notices back to Order Desk as they fulfill your orders.
Default Return Address
Set the return address that Zift should use on your shipments.
If you need to customize the return address for certain orders, you can save different return addresses to your Store Settings and then use a rule to set the return address to specific orders. If a return address is not added to the order, the default address set here in the Zift 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.
For more information on what the product settings within the Zift 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 Zift 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 Zift 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.
Sending Orders to Zift
Getting your orders ready to send to Zift takes some setup time. For a detailed walkthrough of how to use Order Desk with your print on demand orders, please take a few moments to read through the Print on Demand Fulfillment guide.
Preparing Your Orders
If you'd like to send custom data about the order to Zift, you can set the following checkout data field.
|Field Name||Field Description|
|ShippingCarrier||The default shipping class will be used unless this is set on an order, then this will be used instead. If the values don't exist, the cheapest rate will automatically be selected based on Zift's available rates.|
|ShippingService||The default shipping class will be used unless this is set on an order, then this will be used instead. If the values don't exist, the cheapest rate will automatically be selected based on Zift's available rates.|
|StoreID||Use a custom store ID for a specific order.|
If you are unfamiliar with checkout data, please read the How to Work with Checkout Data guide.
Preparing Your Items
Colors and sizes must be passed in the variation or metadata for each product and are required on all items. The proper size formatting will be handled and the color names will be matched to available colors if possible. If you have any trouble getting a match for these variations, please contact Order Desk support.
In addition to colors and sizes, the following fields should be set as variations or item metadata for each order item:
|Field Name||Field Description|
|print_sku|| Must be the exact ID for your blank or formatted as
|print_url_1, print_url_2||URL for artwork file or an asset ID. If using a URL, the file will be uploaded for you. All artwork must be in PNG format.|
|print_location_1, print_location_2||print_location_1 is Front and print_location_2 is Back unless otherwise specified by using these fields as item metadata or variations.|
|brand||optional - if you need to pass a brand value along with the assets|