To enable variants in the E-Commerce API set the setting ‘VariantSupportEnabled’, Adding features ‘ECommerceType’ and ‘ECommerceVariantOfProduct’ and create the below mapping. See the E-Commerce variant documentation.
The table below lists all the possible mappings supported via the Shopify Connector. For a more detailed description for each field see the Shopify GraphQL API documentation.
Mapping to field | Output Kind | Description |
|---|---|---|
SyncID (Required) | Field | The SyncID will be updated with Shopify Id for the variant. NOTE: if more than one channel is used, then this parameter must be independent for each channel. |
SyncDate (Required) | Field | The SyncDate will be updated with Shopify “Updated At” for the product. NOTE: Deleting SyncDate value for chosen product or variant will lead to product update in Shopify on next synchronization. NOTE: If more than one channel is used, then this parameter must be independent for each channel. |
SyncMsg | Field | SyncMsg will be used for reporting errors back to product variants in Perfion. |
Barcode | Field | The value of the barcode associated with the product variant. |
CompareAtPrice | Field | The compare-at price of the product variant. |
Image | Image(Url) | An image stored in Perfion (Required the Perfion API is publicly available). The image will be thumbnail to the variant. |
Images | Image(Url) | Images stored in Perfion (Required the Perfion API is publicly available). The first image will be thumbnail to the variant if an Image mapping is missing, the rest will be added to the product. |
Images(<ImageFeature>)@AltText | Attribute | For Images via Image(Url) it is possible to include an attribute “AltTest” for adding an Alternative text to the image. See Outputting Multi Value-attributes for more information's about attributes on multi values. |
Image | Field | An image url. Must be a fully qualified URL path, including protocol. The image will be thumbnail to the variant. |
Images | Field | Image url’s. Must be a fully qualified URL path, including protocol. The first image will be thumbnail to the variant if an Image mapping is missing, the rest will be added to the product. |
InventoryPolicy | Field | Whether customers are allowed to place an order for the product variant when it's out of stock. Allowed values:
|
Cost | Field | Unit cost associated with the inventory item, the currency is the shop's default currency. |
HarmonizedSystemCode | Field | The harmonized system code of the inventory. |
RequiresShipping | Field | A boolean true/false to determine whether the product variant requires shipping |
Tracked | Field | A boolean true/false to determine whether the inventory quantities is tracked. |
Weight | Field | The weight of the product variant. |
WeightUnit | Field | The weight unit of the product variant. Allowed values:
|
Position | Field | The order of the product variant in the list of product variants. The first position in the list is 1. |
Price | Field | The price of the product variant. |
RequiresComponents | Field | A boolean true/false to determine whethera product variant requires components. The default value is false. If true, then the product variant can only be purchased as a parent bundle with components and it will be omitted from channels that don't support bundles. |
Sku | Field | The SKU for the product variant. Case-sensitive string. |
TaxCode | Field | The tax code associated with the product variant. |
Taxable | Field | A boolean true/false to determine whether the product variant is taxable. |
Metafield|<namespace>|<key>|<type> | Field | See Shopify - Metafield Mapping for more information. |
Quantity_<location1> | Field | The inventory quantity at the location where the product variant is stocked. |