Skip to main content

Connect to Shopify

Connect your Shopify store to Workforce to import your sales data automatically.


Before you start

Workforce connects to Shopify to import your sales and transaction data automatically, so you can build rotas around real customer demand.

Because of Shopify’s rules for third-party apps, you need to create a custom app in your own Shopify account first, then connect it to Workforce.
​


Set up a custom app in Shopify

  1. Log in to Shopify.

  2. Go to Apps > App settings.

  3. Click Develop apps > Build apps in Dev Dashboard.

  4. Click Create app.

  5. Name the app and click Create.

  6. Under API access, enter: read_locations,read_orders,read_products

    The other settings on this page are optional, but these three scopes must be entered for the integration to work.

  7. Scroll down and click Release.

  8. On the app overview page, click Install app.

  9. Choose the store you want to connect to Workforce.

  10. On the confirmation page, check what the app can access, then click Install.



Connect Shopify in Workforce

To connect shopify in Workforce:

  1. Go to Settings > Integrations > POS Integrations.

  2. Click Add Integration and choose Shopify.

  3. Fill in the connection form:

    • Integration name: optional.

    • Shopify store URL: your myshopify.com address, for example mystore.myshopify.com. You’ll find it in your Shopify settings.

    • Client ID and Client secret: in Shopify, open your app’s settings in the Dev Dashboard.

    • Include tax in revenue data and Include tips when importing revenue: optional.

    • Split revenue by category: optional. See below.

  4. Click Save.

💡 Tip: If the connection fails, check the app is installed on the store you entered, it has all three scopes, and the Client ID and Client secret are from that app.


​


Your sales data streams

Workforce creates a data stream for each of your Shopify locations, usually within about 5 minutes of connecting. After that, sales are imported every 15 minutes.

New data streams are joined to your whole organisation to start with. To see sales for a location or team, go to Rota Planning > Data Streams, open the stream and change its joins. See Configure your Sales, Revenue, Budgets & Demand Data.

Split revenue by category

If you tick Split revenue by category, Workforce creates a separate stream for each Shopify product type at each location. Sales for items with no product type go into an Uncategorised stream.

⚠️ Important: Up to 30 categories per location get their own stream. Sales in any extra categories aren’t imported.

Datastream in Workforce:

Location in Shopify:


Using Shopify sales data in Workforce

Once your sales are coming through, you can use them across Workforce:


FAQs

Shopify is connected but no sales are showing. Why?

  • Joins: the data stream is joined to your organisation by default. If you’re looking at a location or team, join the stream there.

  • Split revenue by category is on: sales go to the category streams, not the main location stream. Check the category streams are joined where you expect.

  • Credentials: the app must be installed on the store you entered, with the read_orders, read_locations and read_products scopes.

If it still isn’t working, contact Workforce support.

Why are there more data streams than I expected?

Workforce creates one stream for each Shopify location. If Split revenue by category is on, it also creates one stream for each product type at each location, plus an Uncategorised stream.


Did this answer your question?