Shopify - Variant

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.

 

image-20240523-090004.png

 

Mapping to field

Output Kind

Description

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.

CountryCodeOfOrigin

Field

The country code of where the item originated from.

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:

  • Continue

  • Deny

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:

  • Grams

  • Kilograms

  • Ounces

  • Pounds

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 like Quantity_RefLoc_<label>.