Shopify Connection Setup

Edited

With the Brilliant x Shopify integration, your Shopify Ecommerce site can be fulfilled by Brilliant. The integration will send orders from your Shopify Ecommerce store to Brilliant to be fulfilled, and any stock or fulfillment updates will be pushed to your Shopify site.

Prerequisites

Before setting up the integration, please ensure that the Shopify Ecommerce site you want to integrate with Brilliant uses the Shopify Grow plan or higher. The integration will not work with the Basic plan. Please also note that the person who sets up the Shopify store using the following instructions will need to be the owner of the store or will need to have the necessary permissions to complete the steps below.

The integration will associate each order with a single user in your Brilliant store. For this reason, we would recommend working with Brilliant to get a user created with a general email that you can use for this integration.

Shopify User

Note that Shopify may send developer updates to the user who creates the custom app with the instructions below. You may want to create a user for this integration to receive those updates. The user must have at least the following permissions:

User permissions:

  • Orders

    • View

    • Fulfill and ship

    • Cancel

  • Products

    • View

    • Create and edit

    • Manage

  • Customers

    • View

  • Checkout and customer accounts

    • View and edit

  • App development

    • View apps developed by staff and collaborators

      • Develop

      • Enable development

  • Store settings

    • Manage settings

    • Shipping and delivery

    • Locations

  • Finance

    • Manage other payment settings

App permissions:

  • Manage and install apps and channels

Custom App

The first step to integrate Shopify with Brilliant is to create a custom app in your Shopify store. Brilliant will use this app to sync data to and from your store.

  1. In the Shopify admin view of your Shopify store, click Settings at the bottom left.

  2. Click on the Apps and sales channels page.

  3. Click Develop apps.

  4. If prompted, read the information about custom apps and click Allow custom app development.

  5. From the develop apps page, click Create an app.

  6. Give the app a name (e.g. Brilliant Integration) and choose a user to associate with the app.

  7. On the created app's page that appears, go to the Configuration tab.

  8. In the Admin API integration section, click Configure.

  9. Select the following scopes, then click Save:

    • write_assigned_fulfillment_orders

    • read_assigned_fulfillment_orders

    • write_fulfillments

    • read_fulfillments

    • write_inventory

    • read_inventory

    • read_locations

    • read_orders

    • read_products

  10. Go to the API credentials tab, then click Install app.

  11. In the Admin API access token section, click Reveal token once.

  12. Copy the token and paste it in a secure place, as this token will be used when you connect Shopify to Brilliant.

Connect Brilliant

After Brilliant has enabled the Shopify integration for your account, you can connect the integration by following the steps below:

  1. Log in to Brilliant using your email address and password.

  2. On the lefthand side of the page, navigate to the Automations page of the store you wish to connect the automation to via Storefront -> Your Store to Connect -> Automations.

  3. Find the Shopify integration and click Connect. From here, you will be brought to a new tab where you can provide authentication and configure the integration.

  4. You will be asked to authenticate for Shopify. Please enter the following information:

    • Shop Subdomain: This is the subdomain of your Shopify store, which can be obtained by going to your store settings in the Shopify admin and copying the text before ".myshopify.com" from the store link in the top left.

    • Access Token: This is the admin API access token you obtained in the Shopify custom app steps above.

  5. In the Shopify Default Location Name field, add the name of the default location your products get assigned to in Shopify.

  6. After clicking Finish, you can close out of the configuration tab.

After finishing these connection instructions, please see the Store Setup instructions to configure your Shopify store and products to be compatible with the integration.