Shopify connector
The Shopify Connector allows you to connect your Shopify to Constructor. It enables you to quickly synchronize your catalog data with Constructor, including your products, variations, categories, and more.
Why use it?
Constructor Connect App for Shopify accelerates the path to value for joint customers through a ready made product catalog integration. In just a few clicks, connect your Shopify catalog for ingestion and regular updates to Constructor (collections, products, and variations included).
How it works
The connector uses the Shopify API to fetch the catalog data from your Shopify account. It provides a base transformation layer to import data into Constructor to sync and update your catalog.
It's also important to note that the connector is read-only. We'll never update or write any data to Shopify.
Features
- Markets
- B2B
- Location-specific inventory
- Localization and translations
- Sales channels' availability
- Product media
- Product and Variant metafields
- Combined Listings compatible
- and much more.
Installation
Install the app
In the Shopify App Store, install the Constructor Connect App.
Note: You'll need to accept the terms and give permissions to the API scopes the app uses.
You're all set 🎉
That's it. We'll handle the remainder of the setup from our side and we will contact you in case we need any information.
After that's done, you will be notified and you should also start seeing your Shopify product data in your Constructor account:
The image preceding is just an example of what you should see in your Constructor account. Use our visual dashboard to validate your product data within the Constructor platform.
Data mapping
By default, data is mapped from Shopify attributes to the Constructor fields. You can refer to the Shopify API docs and Constructor API Docs for more information about the data types.
Collections
Shopify's Collections map to Constructor item groups.
We support both manual and smart collections
| Constructor Entity | Constructor Field | Shopify Field |
|---|---|---|
item_groups | id | collection.handle |
item_groups | name | collection.title |
item_groups | parent_id | all |
As Shopify lacks a group hierarchy, we map all collections as top-level groups.
Products
Here's how we map products and variations.
Product information
The base data from a Shopify Product will always be transformed to an item at constructor, defining the base product:
| Constructor Entity | Constructor Field | Shopify Field |
|---|---|---|
items | id | product.handle |
items | active | if product.status equals to ACTIVE |
items | item_name | product.title |
items | image_url | product.featuredImage |
items | url | product.onlineStoreUrl or product.onlineStorePreviewUrl |
items | description | product.description |
items | keywords | product.tags |
items | group_ids | mapped from product.collections |
items | metadata | see metadata |
Then, every single Product Variant will be transformed to a constructor variation:
| Constructor Entity | Constructor Field | Shopify Field |
|---|---|---|
variations | variation_id | variant.sku |
variations | item_id | product.handle |
variations | item_name | variant.title |
variations | active | variant.availableForSale |
variations | image_url | variant.image |
variations | url | no value set |
variations | metadata | see metadata |
Product metadata
The connector does not map any specific attributes by default. Specific attributes are those which will vary from integration to integration, like color, price, availability or others.
Instead, we provide a powerful template ecosystem via the Connect CLI that allows you to interface with the connector and map the data to ingest those attributes as metadata in any way you need.
Updated about 1 month ago