Syncing your Shopify inventory with Talon.One

Let's set up Shopify to sync your product inventory with a cart item catalog in Talon.One.

Talon.One requirements

• You are an admin user.
• You have set up an Application.
• You have created a Third-party API key for use with Shopify.

Shopify requirements

• You are an administrator user.
• You have completed the basic setup of the Talon.One Shopify app.

Setting up the integration

1

Connect a cart item catalog

1. Create a cart item catalog and connect it to your Application. Remember the catalog ID, for example, 34.

   tip

   To see the catalog ID, click Account > Tools > Cart Item Catalogs.

   The ID is displayed in the second column of the list.

2. In Shopify, open Apps > Talon.One.

3. On the Talon.One page, configure the following parameters:

   • In API Key, paste the Third-party API key you created.
   • In Deployment URL, type the base URL of your Talon.One deployment, for example, mycompany.europe-west1.talon.one.
   • In Catalog ID, enter the ID of the cart item catalog you created, for example, 34.

4. To test the connection with the values provided, click Connect.

5. If the test is successful, click Save.

2

Verify the initial product sync

Connecting the catalog starts an initial product sync.

Refresh your catalog page in Talon.One until you see new products being added. If nothing changes within a few minutes, see Troubleshooting.

The full sync may take several minutes, or even hours if you have millions of products. The process will continue in the background.

After the sync is complete, your cart item catalog contains the products from your Shopify catalog.

3

Next steps

You can now use your synchronized cart item catalog, for example, to apply strikethrough pricing to your Shopify products.

Considerations when syncing collections

If you are using collections in Shopify to organize your products and want to sync them with Talon.One, keep the following considerations in mind:

• Before syncing, a custom cart item attribute named collections must exist in Talon.One.
• After syncing, the collections attribute contains a list of collections to which a product belongs in Shopify.
• When you remove a product from a collection in Shopify, the collections attribute is not updated. To trigger an update, change the product in Shopify, for example by updating its description.
• The integration supports both manual and smart collections. However, there's a limitation regarding smart collections. When you create or update a product, and it matches or no longer matches the criteria of an existing smart collection, the collections attribute in Talon.One is not updated.

Troubleshooting

If some or all of your products are missing from the cart item catalog, do the following:

1. Open the Integration API logs.
2. Click Filter > Application > [Name of your Application].
3. Click Filter > Status > Error.
4. Next to the most recent entry with the path /v1/catalogs/1/sync, click +.
5. Open the Response tab and check the error messages:
   • If there are Attribute not found error messages, create the missing attributes in Talon.One. As soon as the attributes are created, the sync restarts.
   • If there are other error messages, contact your Customer Support Manager.