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. |
Images | Image(Url) | An image stored in Perfion (Required the Perfion API is publicly available). The first image will be linked to the variant, 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. |
Images | Field | An image url. Must be a fully qualified URL path, including protocol. The first image will be linked to the variant, 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. |