BigCommerce - Settings

Owned by Morten Lindequist Køhler
Feb 14, 2024
3 min read

The BigCommerce Connector has one required setting and some optional settings.

Synchronization

The BigCommerce 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 BigCommerce and add, update or deactivate/delete all products in BigCommerce.

Delta synchronization

A delta synchronization will take all changed products in Perfion since last synchronization and add, update or deactivate the products in BigCommerce. A Delta synchronization can not deactivate/delete products deleted in Perfion.

Depending on the product key type, the delta synchronization is based on “Item modified date” or “SyncDate” on the item.

For Sku or Name as product key the delta synchronization use the “Item modified date”, which will result in synchronization of any change on the product in Perfion.

For Id as product key the delta synchronization use the “SyncDate” feature, which will result in synchronization of any change on SyncDate. To control the SyncDate, some functionality must be introduced like an Item Trigger or an Action to clear the SyncDate when the products need to be updated in BigCommerce.

E-Commerce settings

ECommerce Settings

Description

ECommerce Settings

Description

TimeZone = utc (Required)

The time zone must be set to utc.

Parameter is required.

Languages

Perfion language code. Since BigCommerce Connector only support one language it is only possible to setup one language.

Default value is 'EN'.

CategorySyncType

Comma separated synchronization types for categories.

Default value: Add, Update, Deactivate

Values:

  • Add – allow to add new categories.

  • Update – allow to update existing categories.

  • Deactivate – allow to deactivate existing categories which is no longer in Perfion.

  • Delete – allow to delete existing categories which is no longer in Perfion.

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

ProductSyncType

Comma separated synchronization types for products.

Default value: Add, Update, Deactivate

Values:

  • Add – allow to add new products.

  • Update – allow to update existing products.

  • Deactivate – allow to deactivate existing products which is no longer in Perfion. The deactivation will only be available in full synchronization

  • Delete – allow to delete existing categories which is no longer in Perfion. The deletion will only be available in full synchronization

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

DeltaSyncFrequencyInMin

Time in minutes between delta synchronization of products. See setting BigCommerceProductKeyType for information about delta synchronization scope.

Default value is 60 minutes. 0 is no delta synchronization

FullSyncFrequencyInMin

Time in minutes between full synchronization of products.

Default value is 0, which is no synchronization.

BigCommerceCategoryKeyType

The key to link categories between Perfion and BigCommerce.

Default value is Name

Values:

  • Name – Use the category name as key. This require all categories has a unique name.

  • Id – Use category id as key. This require a mapping to a SyncID. See SyncID mapping

BigCommerceProductKeyType

The key to link products between Perfion and BigCommerce.

Default value is “Id” if the SyncID and SyncDate is a part of the product mapping or else the default value is Sku.

Values:

  • Sku – Use the product Sku (Stock keeping unit) as key. This require all products has a Sku and Sku is a part of the mapping.

  • Name – Use the product name as key. This key is only recommended for initial synchronization to a product id.

  • Id – Use product id as key. This require a mapping to a SyncID and SyncDate. See SyncID and SyncDate mapping.

BigCommerceDefaultProductChannels

The products are default attached to the Channels/Storefronts. Values are a comma separated list of the Channels/Storefronts.

The product mapping to Channels will overwrite this setting.

Default value is the default channel (channel_id=1). If it is set to blank, the products will not be attached to a storefront.

Note: Only products can be attached to multi channel BigCommerce. The categories can only be attached to the default channel (channel_id=1)

BigCommerceVariantOptionsType:{Feature}

The display type of a variant option.

Allowed values:

  • radio_buttons

  • rectangles

  • dropdown

  • product_list

  • product_list_with_images

  • swatch.

Default value is radio_buttons.

BigCommerceCaptionTemplate and BigCommerceValueTemplate

Custom Field has a Caption and a Value. Both Captions and Values can be formatted e.g. %CAPTION% %UNIT%.

Default value is %NAME% for Caption and %VALUE% for Value

Tags available:

  • CAPTION – Caption from the feature definition in the language set in Languages setting

  • CAPTIONALTERNATIVE – Caption alternative from the feature definition in the language set in Languages setting

  • UNIT – Unit from the feature definition in the language set in Languages setting

  • ABBREVIATION – Abbreviation from the feature definition in the language set in Languages setting

  • HELPTEXT – Help text from the feature definition in the language set in Languages setting

  • NAME – Name from the mapping

  • VALUE – Value formatted to the culture defined in Languages setting (Decimal separator and date format)

General E-Commerce settings

e.g. Variant support and Images API. See the E-Commerce API for more information.