Setting up your Scurri - Shopify integration

To integrate Shopify with Scurri, you will need to get the following from your Shopify account:

1. Shop domain

2. Custom app client ID

3. Custom app client secret

You can gather this information by following the steps below.

Shop domain:

This is the full URL of the Shopify account, for example:

https://your-store-name.myshopify.com

A myshopify.com domain is required. If you are using a custom domain, you can find your myshopify.com domain by following these steps:

1. Go to https://admin.shopify.com/, log in with your Shopify credentials.

2. Click the “Settings” button at the bottom left.

3. Then on the left menu, click on the “Domains” button.

4. You should now see a list of domains assigned to your shop. Please identify and copy the one in https://your-store-name.myshopify.com format

Custom App client ID and Secret

To get the required client ID and secret, you need to go to https://dev.shopify.com/dashboard/, log in with your Shopify credentials and create a new app:

1. Click the “Create App” button.

2. In the next step, use “Start from Dev Dashboard” and input an application name - any name can be used, we recommend using “Scurri” for easy recognition.

3. Navigate to the URLs section to begin configuring your app’s connection settings:

   (a) App URL: Input https://shopify.dev/apps/default-app-home

   (b) App Embedding: Uncheck the box for "Embed App in Shopify Admin".

4. In the “Access” section for “Scopes”, copy and paste the following permissions:

   read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_fulfillments,write_fulfillments,read_inventory,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_orders,write_orders,read_product_listings,write_product_listings,read_products

5. For any fields not mentioned in this guide, please maintain the default values.

For reference, a completed app setup example is shown below.

6. Select the Release button. You are free to use any naming convention for the Version Name.

7. Navigate to Home in the left menu, click on the Install app button, and select your shop to finish the Shopify app setup.

8. Back in the Shopify developer dashboard, navigate to Settings in the left menu to find your required Client ID and Client Secret.
    

Setting up Shopify integration in Scurri.

Once you have generated your credentials in the Shopify Developer Dashboard, follow these steps to link your store to Scurri:

1. Log in to Scurri

2. Click “Setup”, then “Integrations”

3. Click “+Add New Integration”

   • Locate Shopify in the list and click + Add next to it.

   • Note: If Shopify does not appear as an option, please contact our Support Team to enable this feature for your account.

4. Input the details gathered from your Shopify account:

   • Client ID & Client Secret: Use the values obtained in the previous 'Custom App Client ID and Secret'  section.

   • Shop Domain: Enter your full store URL, e.g. https://your-store-name.myshopify.com

5. You can restrict which orders flow through to Scurri by using either: Include by Shipping Method or Exclude by Shipping Method. 

   • If you do wish to restrict which orders flow to Scurri, please use either Include or Exclude, but not both

   • By adding shipping methods to Include by Shipping Method, Scurri will  import only orders with these shipping methods

   • By adding shipping methods to Exclude by Shipping Method, Scurri will import every order except those with these shipping methods

   • If adding a list of shipping methods, separate with a comma (,)

     • For example: Standard, Next Day, Oversized

6. From the Create fulfilment action dropdown, select the trigger for when Scurri should mark the order as fulfilled in Shopify

7. Click Create Integration to save your settings and activate the connection.

This completes the setup for Shopify. You can now select the “Enabled” option in the Scurri view and click the “Save” button to enable the integration.

We believe the best practice is to test the integration by enabling the account when you have finished orders for the day, and then push through some test orders using the fake credit card details option on Shopify.

Shopify and Scurri interaction during shipment generation.

Scurri will pull shipments from Shopify that are in the “unfulfilled” fulfilment status and “paid” financial status.

By default, once the shipment is imported to Scurri, the Fulfilment Status in Shopify is set to "Fulfilled".  As per step 6 above, you can set this to a different trigger point, or not have Scurri update the order. 

Once shipments are manifested in Scurri, they are updated in Shopify with the tracking URL and carrier name.