Introduction

In this article, we describe how to integrate with a Shopify vendor. If your vendor has a Shopify store, Onport can automatically sync products and orders.

Disclaimers

These are the new Shopify instructions as of early 2022. All new vendors and vendors who need to make changes to their current integration should use this method. Please see here for the old method info.

Only the store owner can enable custom app development.

Enable custom app development from the Shopify admin (Shopify Partners site)

Before you can create a custom app for your store, you need to enable custom app development.

1. From your Shopify admin, go to Settings > Apps and sales channels

2. Click Develop apps

3. Click Allow custom app development.

4. Read the warning and information provided, and then click Allow custom app development.

Create and install a custom app

1. From your Shopify admin, go to Settings > Apps and sales channels

2. Click Develop apps:
   

3. Click Create an app:
   

4. In the modal window, enter the App name (Onport or, if you'd like, you can enter the marketplace's name to better identify orders by the app syncing them) and select an App developer. The app developer can be the store owner or any staff or collaborator account with the Develop apps permission.
   

5. Click Create app.

6. Click Configuration, and edit the Admin API access scopes with the following permissions:

   1. Inventory - read_inventory

   2. Orders - write_orders and read_orders 

   3. Products - read_products
   4. Merchant managed fulfilment orders - read_merchant_managed_fulfillment_orders and write_merchant_managed_fulfillment_orders
   5. Third-party fulfilment orders - read_third_party_fulfillment_orders and write_third_party_fulfillment_orders
      
      
7. Click Save
8. Click Install App
   
9. Under the API Credentials tab copy the Admin API access token. This key can only be accessed one time so please make sure to copy it before navigating away from the page. If you do not copy it you will need to click uninstall and then reinstall and copy the new key.
   
   
10. Share this API key and your myshopify.com domain with the Marketplace so they can complete the next steps within their Onport account.
11. In Onport > Contacts > Vendor name > Orders > choose Shopify > Paste keys (In Marketplace’s Onport account)*
    

*If “Allow vendors to choose their platform” is enabled in Setup > Dropship Portal, vendors can self-serve this step.

❗️In the case of Shopify Markets being set, there is an additional permission to be added:

• write_draft_orders
• read_draft_orders

It is important to note that Shopify Market-specific Order Creation would work when: 

• use the price in the vendor's store is chosen as the order price; 
• no tax setting is enabled in the Tax section related to sending tax to the vendor's store;

If these two settings are enabled and a Shopify Market is chosen, Onport will need the 2 extra permissions above.