Shopify (prebuilt connector)

Description

Shopifyarrow-up-right is a cloud-based, fully hosted commerce platform which can be used to create and manage online stores and sell across multiple channels (including web, mobile, social media, online marketplaces, brick-and-mortar locations, and pop-up shops).

A Patchworks app is available in the Shopify marketplacearrow-up-right. When you install this app, you add a Patchworks connector with an authenticated instance, instantly.

API documentation

API documentation for Shopify (used to build this connector) can be found via the link below:

circle-info

If you've been using the Shopify connector with REST API endpoints (either installed via our Shopify app or the Patchworks marketplace), we advise updating the connector from the Patchworks marketplace, so GraphQL endpoints are available.

Having updated the Shopify connector, you should then edit process flows where the Shopify connector is used and switch any REST API endpoints to a GraphQL equivalent. If you can't find a GraphQL endpoint that you need, you can add your own.

Tax handling for sales channels

circle-exclamation

When selling products across different sales channels (online store, social media, marketplace platforms, etc.) and building integrations to accounting, ERP, or other business systems where sales tax is considered, it's important to know where the responsibility for remitting sales tax lies - is it with the merchant, or is it handled via the sales channel?

For example, since January 2025, Shopify automatically calculates, collects, and remits tax for orders placed through the Shop channel in the US. If these orders are treated the same as 'normal' Shopify orders in your integrations, there’s a risk of processing tax twice

What you need to do

In this scenario, check whether the Shopify sales channel is set as being responsible for tax. You can do this via the Shopify admin portal, or via the API.

If using the API, Shopify provides a field called channel_liablearrow-up-right. If this is set to true, it means tax has already been calculated and collected by the channel. In this case, your integration should not recalculate or reapply tax.

Installing the Shopify app

You must have a Patchworks account to install the app. If you don't have an existing account, you can register for a trial accountarrow-up-right or contact our Sales teamarrow-up-right.

circle-exclamation
1

Locate the Patchworks app in Shopify

Log in to your Shopify admin portal and search for the Patchworks app:

2

Review access requirements

Review access requirements and click the install button:

3

Provide your Patchworks account credentials

Click the sign-in button:

Then enter the credentials that you use to sign in to the Patchworks dashboard:

4

Start the installation

Click the install latest version button:

The connector is installed with an instance - click head to Patchworks to access the Patchworks dashboard:

5

Start the installation

In the Patchworks dashboard, you can view your new connector by selecting connectors & instances from the left-hand navigation menu:

All your installed connectors are displayed, including Shopify:

circle-info

The instance name is the same as your Shopify store - you can change this later if necessary.

6

Re-enable multi-factor authentication

If you disabled Multi-Factor authentication before starting this process, you should enable it again now. Further information can be found in our Two-factor authentication guide.

Last updated

Was this helpful?