Integration Guide

Shopify Integration Guide

This guide explains how to create a Custom Shopify App using the NEW Shopify Developer Dashboard flow and then integrate it with Service Points

Check our detailed example video on how to create a custom app:

https://www.loom.com/share/b37d63dc62a84d3a912a264914a3b5e3
1

Create the app in the dev dashboard

1 Log in to Shopify Admin

  1. Log in to your Shopify Admin.
  2. Click on Apps
  3. Click on App settings
  4. From there, go to Develop apps, click "Build apps in Dev Dashboard"
  5. Once you're in the dashboard, go to Apps on the left menu
  6. Click on the top right on Create app , after that Create app manually

2 Fill in the correct settings

The settings are really important that they're correct, and different per system, so make sure that you're filling in the correct URLs and scopes.

  1. Enter an app name, this can be Service Points or any preferred name, this is for your own reference.
  2. After that, keep Version name empty
  3. By URLs, fill in the App URL https://app.servicepoints.nl/ Copy
  4. Uncheck "Embed app in Shopify admin"
  5. Keep Allowed redirection URL(s) empty
  1. Under Access, fill in the following scopes (Copy-paste):
  2. write_inventory,read_inventory,write_locations,read_locations,read_products,write_products,read_orders,write_orders,read_fulfillments,write_fulfillments,read_discounts,write_discounts,read_third_party_fulfillment_orders,write_merchant_managed_fulfillment_orders,write_third_party_fulfillment_orders
  3. Keep Webhooks API Version on the version which is automatically selected
  4. Click "Create app" to create the app, then click on Release

3 Get API credentials

  1. In the left menu go to "App Settings"
  2. Under "Credentials" copy the Client ID and Secret, you'll need them later.
2

Integrate with our system

1 Open the dashboard

  1. Open https://app.servicepoints.nl/
  2. Log in to your account

2 Connect your store

  1. Navigate to the stores section and click on "Add new store"
  2. Enter the following information:
    Domain name: Your Shopify store domain (Example: your-store.myshopify.com)
    Alias: How you want the store to be named within the system
    Client ID & Secret: Fill in the credentials from the Shopify Dev Dashboard
    Tracking URL: You can leave this unchanged if you do not have your own tracking link
    Order fetch date: The date from which orders needs to be loaded into our system
  3. Click on "Save & Connect"
  4. After the connection is complete, click on the store and add countries by using the Add new country option in the bottom-right corner

3 Authorize the App

  1. After saving the store, authorize the app by following the on-screen instructions

Troubleshooting

Note: Please use the same browser for both the flows to make the integration work without any issues.

Invalid credentials

  • Ensure Client ID and Secret are correct.
  • Ensure the app is released and authorized.

Missing scopes

  • Verify all required scopes are enabled + Release a new version if scopes were changed.

OAuth session expired

  • Restart the integration flow.

Store already exists

  • Remove the store and connect again.