Shopify
  • 13 Sep 2022
  • 4 Minutes to read
  • Dark
    Light
  • PDF

Shopify

  • Dark
    Light
  • PDF

Required Permissions

An employee must be assigned to the shop with a Shop Owner Admin role to perform actions referred to in this article.

Shopify integration connector lets you import orders and products from your Shopify online store using API integration directly to ShopCtrl.

Shopify module synchronization features

Shopify integration connector lets you import orders and products from your Shopify online store using API integration directly to ShopCtrl.

Setting up integration with Shopify

Create a private app in your Shopify account

To set up the integration, you first need to create a new ShopCtrl App within your Shopify admin panel and grant it access to the API of your store. For more information on Shopify Private Apps, visit Shopify Help Center Private apps

You might need to enable the possibility to create a new private app in your Shopify admin settings first. Please check Enable private app development from the Shopify admin for more information.

To generate credentials to your store and give ShopCtrl access to your open API:

  1. Log in to your Shopify account as a store owner.
  2. On the navigation menu, select Apps.
  3. Click on the Manage private apps link below the list of apps.
    shopify-apps
  4. Click Create private app.
  5. In the App details section, enter a name for your private app and a contact email address.
    shopify-create-private-app
  6. In the Admin API section, click Show inactive Admin API permissions. Grant ShopCtrl with access to the following areas:
Areas of Shopify store Access level needed for integration
Assigned fulfillment Read and write
Customers Read and write
Fulfillment services Read access
Inventory Read and write
Locations Read access
Orders Read and write
Products Read and write
Shipping Read access
Store content Read and write
Third-party fulfillment Read access
  1. Set Webhook API version to 2021-10.
  2. Click Save to create a new ShopCtrl private app.
    The API key, the password, and Example URL are now displayed on the screen. Please keep them in a safe place as you would normally do with passwords.
    shopify-create-private-app-api-credentials

Please see Generate credentials from the Shopify admin for more information.

Setup your Shopify synchronization in ShopCtrl

Before start

Before enabling synchronization with Shopify, please set up the corresponding shop currency, VAT tariffs, and payment types for your ShopCtrl shop.

Once you have enabled integration in your Shopify account, you can set up synchronization in ShopCtrl.

  1. Log in to your ShopCtrl account as a user with the Shop Owner Admin role.
  2. In the navigation menu select Configuration > Shops to open the list of shops created.
    shopctrl-shop-settings
  3. Select a shop you would like to set up Shopify synchronization for and click Edit to open shop settings.
  4. Within topic menu select Shop synchronization > Shopify Synchronization
    shop-shopify-settings
  5. In the Connection settings pane, provide the API key and API password generated for the ShopCtrl private app in Shopify.
  6. Provide an Api url, which is https://{hostname}/admin/api/{version}/. Both {hostname}and {version} could be extracted from the Example Url provided by Shopify for the ShopCtrl app.
  7. Choose whether Taxes are included in product price. This setting depends on your Shopify store settings. Learn more on Shopify Taxes.
  8. Click the Connect button to check the connection settings. A popup window will appear identifying whether the connection was established successfully or if there is a problem with credentials provided incorrectly.
  9. In the Functional settings pane, check the features you would like to use:
    • Import Orders from Shopify - imports new orders at the specified interval
    • Auto-check missing orders for order import - check this feature to exclude all possible synchronization mistakes and import orders that went missing for any reasons
    • Send Track&Trace info - exports tracking code, carrier and trackng url to Shopify
    • Export Products - exports new and updates existing products to Shopify
    • Export Products stock to Shopify - export available product stock
      • Use sku for not mapped product when export product stock - required if initial product import was not performed via Shopify module.
      • Sync hs code along with product stock
      • Enable Inventory track quantity when export product stock - enables track quantity for a product in Shopify, if stock for this product increases in ShopCtrl
    • Import Products - imports new and updates existing products from Shopify
Note

Send Track&Trace info. To enable this feature, you also need to map Warehouses to Shopify Locations and create a Carrier mapping below.

  1. To guarantee that the ShopCtrl carrier account names correspond to the ones used in Shopify, we need to create a Carrier account mapping.
    • Click Add and in the new row select from a dropdown a ShopCtrl Carrier account used for this shop.
    • Type in a Shopify Carrier account name. This carrier will be sent along with the tracking code back to Shopify when the order is marked as shipped.
  2. Configure Warehouse to Location mapping: Choose a warehouse enabled for the shop and a corresponding Shopify location.
    shopify-warehouse-to-location-mapping-config
  3. Enable the synchronization.
  4. Click Save or Save and Close to apply changes to the shop.

What's Next