Skip to main content

Shopify - Settings

Zoltán Mikolás
  • Updated

 

he Shopify Connector has one required setting and some optional settings.

Synchronization

The Shopify Connector can synchronize all products (Full synchronization) or products changed since last synchronization (delta synchronization).

Full synchronization

A full synchronization will take all products in both Perfion and Shopify and add, update or deactivate/delete all products in Shopify.

Delta synchronization

A delta synchronization will take all changed products in Perfion since last synchronization and add, update or deactivate/delete the products in Shopify. To detect changed products the mapped feature to SyncDate must be cleared. To clear the feature use Item Triggers or Actions to create a functionality to mark products changed.

E-Commerce settings

image-20240528-061048.png

 

ECommerce Settings Description
TimeZone = utc (Required)

The time zone must be set to utc.

Parameter is required.
Languages (Required) Perfion language codes (Case sensitive). The setting ShopifyDefaultLanguage must be defined to specify which language Shopify use as the default language. Languages used to translate values in the Shopify need also a Language Deviation in the mapping.
ShopifyDefaultLanguage (Required) Shopify Default Language.

CategorySyncType

SyncType

 

Comma separated synchronization types for Categories (CategorySyncType) and Products (SyncType).

Default value: Add, Update, Deactivate

Values:

  • Add – allow to add new categories/products.
  • Update – allow to update existing categories/products.
  • Deactivate – allow to deactivate existing categories/products which is no longer in Perfion.
  • Delete – allow to delete existing categories/products which is no longer in Perfion.
  • DeactivateOnlyPerfion – allow to deactivate existing categories/products which is created/updated via Perfion and no longer in Perfion. (Added from version 2.1.0.)
  • DeleteOnlyPerfion – allow to delete existing categories/products which is created/updated via Perfion and no longer in Perfion. (Added from version 2.1.0.)
  • IgnoreImages – When enabled, all image synchronization will be stopped: Existing images remain unchanged, new images will not be added, removed images will not be deleted. (Added from version 2.2.1)
  • OnlySetPricesOnAdd – When enabled, prices are only set when a product or variant is created and remain unchanged during updates. This is useful if a third-party system updates products, but an initial price must be set on creation. (Added from version 2.2.2.)

NOTE: “Delete*” and “Deactivate*” cannot be used at the same time. If both are specified, then “Deactivate” will have priority.
MetafieldDefinitionSyncType

Comma separated synchronization types for Categories (CategorySyncType), Products (SyncType) and MetafieldDefinition (MetafieldDefinitionSyncType).

Default value: Add, Update

Values:

  • Add – allow to add new metafield definitions.
  • Update – allow to update existing metafield definitions.
  • Delete – allow to delete existing metafield definitions which is no longer in Perfion.
DeltaSyncFrequencyInMin

Time in minutes between delta synchronization of products.

Default value is 60 minutes. 0 is no delta synchronization unless the DeltaSyncCronSchedule is set.

Note: The SyncCronSchedule and SyncFrequencyInMin can be used in combination. The SyncFrequencyInMin will always start a synchronization immediately after the application are started and recommended for test.
FullSyncFrequencyInMin

Time in minutes between full synchronization of products.

Default value is 0, which is no synchronization unless the FullSyncCronSchedule is set.

Note: The SyncCronSchedule and SyncFrequencyInMin can be used in combination. The SyncFrequencyInMin will always start a synchronization immediately after the application are started and recommended for test.
DeltaSyncCronSchedule

Delta synchronization scheduling via Cron expressions. By default, the Cron expressions use Utc time zone and a time zone can be set via the setting CronScheduleTimeZone. E.g. use 0 4 * * * to stat at 4 pm.

Note: The SyncCronSchedule and SyncFrequencyInMin can be used in combination. The SyncFrequencyInMin will always start a synchronization immediately after the application are started and recommended for test.
FullSyncCronSchedule

Full synchronization scheduling via Cron expressions. By default, the Cron expressions use Utc time zone and a time zone can be set via the setting CronScheduleTimeZone E.g. use 0 4 * * * to stat at 4 pm.

Note: The SyncCronSchedule and SyncFrequencyInMin can be used in combination. The SyncFrequencyInMin will always start a synchronization immediately after the application are started and recommended for test.
RefLoc_<location1>

Shopify locations mapping. Shopify store have locations which are used with Shopify’s inventory system. The inventory system tracks products/variants based on locations. If the inventory quantity is used in Product/Variant Mapping, the locations must be set via RefLoc_<location1>.

Reference locations are defined using custom format:

“RefLoc_<location1>”, where “location1” is a unique label to identify the location. All location references must be unique per channel.

Parameter is required if Quantity_RefLoc_<location1> is mapped in Product or Variants

Values: the exact name of location from Shopify (Options->Locations).
ImageServiceUrl The Url must be in the new API format like https://<ServiceHostName>/image and not the old format https://<ServiceHostName>/Perfion/Image.aspx
FileServiceUrl The Url must be in the new API format like https://<ServiceHostName>/file and not the old format https://<ServiceHostName>/Perfion/File.aspx
General E-Commerce settings e.g. Variant support and Images API. See the E-Commerce API for more information.
ShopifyBulkUpdateMetaFields

True (default) / False

By default, Shopify processes metafield updates in bulk. If any metafield fails, the entire operation is halted. With the new setting, the system will detect errors in the bulk updates and automatically switch to single update mode, allowing successful metafields to be updated individually.
ShopifyTimeZone Used for data and time mappings send without time zone-offset. The Perfion Date type are a date without time zone offset and when this are used to date and time in Shopify the ShopifyTimeZone are needed. The format is IANA time zone names like Europe/Berlin
CronScheduleTimeZone Used for Cron expressions in synchronization scheduling. The synchronization scheduling default use Utc time zone and can be set via the CronScheduleTimeZone. The format is IANA time zone names like Europe/Berlin

 

 

Related articles

Comments

0 comments

Please sign in to leave a comment.