Vendor integration - Shopify

Kelly
Kelly
  • Updated

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 Apps.

  2. Click Develop apps:

    mceclip0.jpg

  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 Apps.

  2. Click Develop apps.

    mceclip0.jpg

  3. Click Create an app.

    Shopify 2022-01-26 at 10.51.30 AM

  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 Select Configure Admin API scopes, and select 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

      Shopify_2022-01-26_at_10.54.46_AM.jpg


      Screenshot 2023-08-03 at 12.17.02.png

  7. Click Save

  8. Click Install App

    mceclip1.jpg

  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.

    533196d5-e46d-4cd5-a44c-f66295bb7c3b.png

  10. In Onport > Contacts > Vendor name > Orders > choose Shopify > Paste keys (In Marketplace’s Onport account)*

    Jetti_2022-01-26_at_1.23.28_PM.jpg

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

 

❗️In 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 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 chose, Onport will need the 2 extra permissions above. 

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.