LiftOff Commerce Integration with OrderDesk

 If adding Vantage Apparel products for the first time, take these steps first before
configuring the products. In the section below we will:
1. Create product classification
2. Create custom fields
3. Create Vendor
4. Create fulfillment workflow

1 Navigate to your account (store) in the My Liftoff admin interface.

2 In the navigation menu, click Products.

3 In the navigation menu, click Product Classifications.

4Click Add Product Classification and name the classification “Vantage Apparel”

5 Click Save & Create.

6 In the navigation menu, click Custom Fields.

7 Select the Vantage Apparel option.

8Configure three custom fields as pictured below.
You should have the following fields:
1. artwork_id_1
2. part_id
3. print_sku
The help text is optional but recommended as it will guide your Liftoff admin users in their product configuration.
Be sure to click the green Add button after filling out the field name and help text.

9In the navigation menu, click Vendors.

10 Click Add Vendor.

11 Name the new vendor “Vantage Apparel”.
An address is required – this is typically set to the shipping origin address for the
vendor. However, what you provide here and in other vendor fields may depend
on your unique case.

12 Click Save & Create.

13 In the navigation menu, click Fulfillment Workflows.
14 Click Add Workflow.

15 Configure the new Fulfillment Workflow as seen below. Be sure to choose Vantage
Apparel as the default workflow vendor.

16 Click “Create Workflow”

Enable Vantage Apparel Order Desk Integration

Before we create our Vantage Apparel products in Liftoff Commerce, it will be

17 Log into your Order Desk account at app.orderdesk.me. If you do not yet have an
Order Desk account, you can sign up here.

18 To connect to Vantage Apparel, click on Manage Integrations in the left sidebar.
Under the Print on Demand tab, find and click to enable the Vantage Apparel
integration.

19 Enter your Vantage Apparel credentials and Program ID, then click to connect. If you do not yet have credentials, contact integrations@vantageapparel.com.

20 Once connected, you will be presented with the integration’s settings. Detailed
information on these can be found here. Set them as necessary for your specific
use case.

On this page there is a link at the top to view available products from Vantage Apparel. Clicking it will display a page like the one below. The products you create in Liftoff Commerce must coincide with a Product ID and Part ID in this list.

The Product ID can be thought of as the parent product. Each Product ID is associated with a number of Part ID’s. These can be thought of as the individual SKU, specifying color and/or size.

If you’re having trouble knowing which Product ID is associated with the products you will add to your store, you may search by Product ID at the Vantage Apparel website.

Configure Product in Liftoff Commerce

To configure a product in Liftoff Commerce that will be sent to Order Desk for fulfillment by Vantage Apparel, you will configure the product largely as you would any other. However, there are some specific steps to take below.

21 Set the Fulfillment Workflow to the fulfillment workflow we configured in step
13.

22 Set the Product Classification for the product to the classification we created in
step 3.

23On the Custom Fields tab, assign values to the artwork_id_1, part_id, and print_sku fields. Be sure to assign values to the correct variant using the
dropdown provided.

The artwork_id refers to a design that you have preconfigured with and provided
by Vantage Apparel.

Use the Updates will be applied to field to first select All variants of this product.
The print_sku field should have the same value for all variants. If the product you are configuring only has one Garment Design ID, then you can provide the ID in the artwork_id_1 field as well. Upon saving, both these values will be saved to all
variants of the product.
The print_sku and part_id work together to tell Vantage Apparel what product and which variant of that product to produce. For example, in the image seen in step 23, the print_sku “2600” refers to the Vansport Omega Tech Polo. The part_id “2600BLKSM” refers specifically to the same polo in color Black and size Small.

24 For each product variant, provide a unique part_id, paying attention to which
variant of the product you are saving the value to.

25 Finish product setup as you typically would.

Configure Rules in Order Desk

26 In Order Desk, click Rule Builder in the navigation menu.

27 Create a new Order Item Rule.
28 Select Order Is Imported as the event that will trigger this rule.

29 Next we need to create rules that will map the custom fields from Liftoff to the
fields that Vantage Apparel will expect to receive.

Configure the first action for this rule as seen in the image below.

Action: Set Order Item Metadata
Field Name: print_sku
Field Value: metadata[‘liftoff_print_sku’]

This action creates a new field for the item in Order Desk called “print_sku” and
then maps the Liftoff Commerce value that will come with your orders to this new
field.

Next, we need to do this for the two other custom fields. When finished with the
first action, click Add Another Action

30 Next map the part_id field by configuring a second action as seen below.

Action: Set Order Item Metadata
Field Name: part_id
Field Value: metadata[‘liftoff_part_id’]

Next, we need to do this for the final custom field. When finished with the second
action, click Add Another Action

31 Provide the rule with a name and then click the Save Rule button.

With this rule in place, when the order is imported into Order Desk, the fields that
Vantage Apparel requires will be set with the appropriate values.

Depending on the unique needs of your program and how you use Order Desk, you may want to configure the above rule with a Filter so that only Vantage Apparel items are affected. This can be done using the liftoff_origin_name metadata for each line item.

If your program includes items from other suppliers, consider creating an additional rule that splits the order by liftoff_origin_name as well.

Finally, the rule above only prepares the order to be sent to Vantage Apparel. If you want to automatically send the order after the fields have been set, an additional rule can be configured to run after this one that simply sends the prepared order to Vantage Apparel.

Learn more about Order Desk rules here.