Dutch German Portuguese
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 and sales channel settings
  4. From there, go to Develop apps, click "Build apps in Dev Dashboard"
  5. Once you're in the dashboard, click on the top right on "Create app"

2 Add app name

  1. Enter an app name, this can be Service Points or any preferred name, this is for your own reference.
  2. Click "Create" to create the app

3 Fill in the correct settings

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

  1. App URL: https://app.servicepoints.nl/
  2. Make sure "Embed app in Shopify admin" is OFF
  3. Keep Preferences URL empty
  4. Keep Webhooks API Version on the version which is automatically selected
  5. Under Access, fill in the following scopes (Copy-paste):
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
  1. Keep Optional scopes empty
  2. Make sure "Use legacy install flow" is OFF
  3. Don't fill in a redirect URL
  4. Don't change anything in POS / App proxy
  5. Click on Release, fill in the version, and click again on release.

4 Get API credentials

  1. In the left menu go to 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.