What is Shopify Stores?

The "Shopify Stores" tool allows you to synchronize products from your Shopify store directly into Reprtoir. This synchronization automatically creates Product Assets in your Reprtoir catalog using the information retrieved from Shopify.

🚧

Note that synchronization works in one direction only: from Shopify to Reprtoir. Changes made in Reprtoir will not be pushed back to Shopify.

---

Create a Shopify app

To sync products from Shopify to Reprtoir, you must create an app in your Shopify account and grant it permission to access product data.

Follow the steps below.

Create the App

1. In your Shopify admin, open the navigation menu on the left.
2. Click “Settings” at the bottom of the menu.
3. Click “Apps and sales channels”.
4. Click “Develop apps”.
5. Click “Create an app”.
6. Enter a name for the app.
7. Click “Create app”.

Once the app is created, you will be redirected to the app configuration page.

Configure API Permissions

1. Click “Configuration”.
2. Under Admin API integration, click “Configure”.
3. In the Admin API access scopes section, search for “Products”.
4. Enable the permission “read_products“.
5. Click “Save”.

Generate the API Token

1. Open the “API Credentials” tab.
2. Click “Install app” under the Access Tokens section.
3. Confirm by clicking “Install”.
4. Under Admin API access token, click “Reveal token once”.
5. Copy and securely store the token.

This token will only be displayed once for security reasons.

Once this step is complete, you can connect your Shopify store in Reprtoir.

---

Connect Your Shopify Store to Reprtoir

Follow the steps below to connect your Shopify store.

1. Open the navigation menu on the left.
2. Click “Catalog Management”.
3. Open “Import Tools”.
4. Click “Shopify Stores”.
5. Click “Sync a new Shopify Store”.

Fill the required fields.

Fields

Find Your Store ID

1. Log into your Shopify admin dashboard.
2. Look at the URL displayed in your browser.

Example:

https://admin.shopify.com/store/xxx/settings/general

The value xxx appearing after /store/ is your Store ID.

3. Copy this value and paste it into the Store ID field in Reprtoir.
4. Click “Save”.

Your Shopify store is now connected to Reprtoir.

All products from Shopify will automatically be imported into your Reprtoir catalog.

Each time you create a new product in Shopify, it will automatically appear in Reprtoir.

---

How Products Are Created in Reprtoir

When synchronization is active, Reprtoir automatically creates Product Assets for each Shopify product variant.

The Shopify Variant ID is used as the unique identifier in Reprtoir.

This identifier is later used to match Shopify sales when importing Shopify sales reports.

---

Organizing Products for Music Sales

To ensure correct matching between Shopify products and your music catalog, define the product types clearly in Shopify.

Use the Product Type field in Shopify as follows:

When the type is set to Album or Track, Reprtoir can associate the corresponding sales with your music catalog and calculate royalties accordingly.

If the product type is anything else, the product will be treated as a generic merchandise product.

---

How Shopify Variants Map to Reprtoir Products

In Shopify, each product can contain multiple variants. Each variant has its own unique identifier called the Shopify Variant ID.

Reprtoir uses this Variant ID to create and identify Products in your catalog.

This means that:

• Each Shopify variant becomes a Product Asset in Reprtoir.
• The Shopify Variant ID is stored as the Identifier in Reprtoir.
• This identifier is later used to match Shopify sales when importing sales reports.

Example:

If a Shopify product contains multiple variants, each variant will create a separate Product in Reprtoir.

For example, if a vinyl record exists in two variants (Black Vinyl and Limited Red Vinyl), two Product Assets will be created in Reprtoir.

---

Sync Behavior and Limitations

Shopify synchronization follows several rules that should be understood before using the feature.

One-way synchronization

Product synchronization works only from Shopify to Reprtoir.

Changes made in Reprtoir will not update Shopify products.

Automatic product creation

When synchronization is active:

• New Shopify products are automatically created as Product Assets in Reprtoir.
• New Shopify variants are automatically created as separate Products.

Updates

If a product or variant is modified in Shopify, the corresponding Product in Reprtoir will be updated during the next synchronization.

Deletions

If a product or variant is deleted in Shopify, the corresponding Product in Reprtoir will not automatically be deleted.

This behavior prevents accidental catalog data loss.

Products must be deleted manually from Reprtoir if required.

---

Common Synchronization Issues

Missing Products in Reprtoir

If a Shopify product does not appear in Reprtoir, verify that:

• The Shopify store is correctly connected.
• The API token has the read_products permission.
• The product contains at least one variant.

Shopify products without variants cannot be imported.

Duplicate Products

Duplicate Products may appear if the same Shopify store is connected multiple times.

Ensure that each Shopify store is connected only once.

Incorrect Product Type

If a Shopify product is intended to represent a Track or Album, ensure the Shopify Product Type field is set correctly.

If the type is not correctly configured, the product will be treated as a generic merchandise product.

---