Perfion Connector for Shopify

This package contains the Perfion Connector for Shopify version 2.2 for Shopify API 2025-07.

Open

Related guides:

Shopify - InstallPreview

In version 2.2.0, the update to Shopify API version 2025-07 only included the schema changes, but not the endpoints. With this release, the endpoints have now also been updated to use API version 2025-07.

Product Reference Metafield - It is now possible to use Perfion "Related Product" to map directly to Product Reference Metafield.

Variant dimension are now translatable.

Variant dimension showing wrong language - Fixed a bug where the variant dimension showing the wrong language value. It now correctly shows the correct language value.

Changing the logging when waiting for the next synchronization to only log the first "The next delta synchronization will start in..." and updating NuGet packages.

A new setting OnlySetPricesOnAdd has been added to SyncType - 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.

Metafield type Money - It is now possible to use Metafield type Money with Perfions units/currency and not only the json string.

Metafields - Fixed a bug that prevented the use of special characters. It is now possible to include special characters in Metafields.

A new setting IgnoreImages has been added for both SyncType and CategorySyncType. When enabled, all image synchronization will be stopped: Existing images remain unchanged, New images will not be added, Removed images will not be deleted.

It is now possible to have translated SEO title and description at Collections.

Market Prices - Previously, market prices were deleted if they were not mapped. This has been changed so that market prices are now only updated if they are mapped to products or variants.

Improved image synchronization - Image synchronization has been optimized to reduce timeouts in Shopify. Previously, new images not yet cached in the Perfion Image API could cause timeouts. The connector now handles caching more efficiently, improving overall stability.

Update to Shopify API version 2025-07 - No breaking change for the new Shopify API.

Updating the Shopify Connector to http://ASP.Net Core 8 and updating NuGet packages. Ensure the http://ASP.Net Core 8 are installed.

Setting for fixed product prices via Market - It is now possible to set product and variant prices for each Market. Use the new mapping Price_<MarketName>

Schedule publishing for Online Store added for Collections and Products. Use the mapping OnlineStorePublishDate.

MetaFields Error Handling Enhancement - A new setting, ShopifyBulkUpdateMetaFields, has been introduced to improve error handling when updating metafields via Shopify. 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.

Variant position - Reordering variants via Position mapping now works as expected.

Improved Error Handling for Rich Text Meta Fields - Previously, product synchronization would stop if a Rich Text Meta field contained invalid XML. This issue has been resolved. Now, invalid Rich Text content will be logged and the product synchronization to continue.

SyncMsg messages are cleared

When a product are synchronized without errors or warnings, the SyncMsg are cleared for old messages.

Translated SEO title and description are added

It is now possible to have translated SEO title and description.

Renaming Variant Options bug

It is now possible to rename and reorder Variant Options.

Limitation of 250 collections has been removed

A bug is fixed and it is now possible to have more the 250 collections. It is still not possible to have more the 250 collection at one product.

The file appsettings.json renamed to appsettings.json.example

To prevent overwriting the configuration file appsettings.json the file is renamed to appsettings.json.example.

Rich text synchronization

It is now possible to synchronize rich text features as rich text metafields

Localizable Features synchronization bug

Localizable Features synchronization for more the one language is now possible.

More then 25 Metafields

A bug is fixed in Metafields synchronization and now it is possible to have more then 25 Metafields.

Metafields with file_reference

It is now possible to use Shopify Id like gid://shopify/ImageMedia/1234 in file_reference.

A bug when adding images to variants is fixed.

Adding new thumbnail image to variants adds the image to the Product in first sync run, but the thumbnail is first added to the Variant in second sync run.

Update to Shopify API version 2024-10

News in version 2024-10:

• Prepare for support up to 2000 variants at one product. Remark the 2000 variants will first be possible when Shopify open the function. Read more from Shopify https://community.shopify.com/c/new-graphql-product-apis/variant-limit-still-100/m-p/2531758  

• To use Locations, the Admin API access scopes need to have read_locations

Deprecated by Shopify:

• CustomProductType. Use the ProductType field instead.

• ProductCategory. Use the category field instead.

• StandardizedProductType. Use the ProductType field instead.

New Metafield namespace "Perfion-App-Data"

To track data between Perfion and Shopify. Metafields with the namespace "Perfion-App-Data" are added for technical internal use.

Deletes or deactivates non Perfion products

Two new SyncType DeactivateOnlyPerfion and DeleteOnlyPerfion are added. With these types, it is possible to have products that are not maintained via Perfion.

Add and delete Variant Dimensions

It is now possible to add and delete Variant Dimensions via the Shopify Connector.

Error handling in E-Commerce API

Added error handling so the synchronization handle all products or no products if the E-commerce API send an error.

Delete Metafields onfy for Namespace = Perfion

To prevent deleting Metafields created from other 3. parts apps, only Metafields with a Namespace = 'Perfion' will be deleted if the value is deleted in Perfion.

Shopify API rate limits

If the Shopify API rate limits is reached, the connector will wait and retry.

Fields can be controllable from 3. part apps.

Fields like Taxable can be controllable from 3. part apps if it is not mapped in the connector.

Images - Only upload unique images

If the same images/Image URLs are used on several variants, the image will only be uploaded to the product ones.

More error handling is added

A bug around API error handling is fixed. In some cases a file upload error was not reported to the log

It is now passible to create metafields of type Dimension and Volume

A bug is fixed, so it is now possible to create metafields of type Dimension and Volume.