Price Lists V2

Price list update structure.

⚠️ Note The previous version of this endpoint is deprecated. Price Lists - deprecated
This documentation refers to V2, which introduces a different behavior for managing markets and catalogs.

General Information

Price List ID and Currency Code should NOT be provided in the data payload. These values are automatically retrieved via Shopify queries.

Price updates can occur:

• on the base price list (primary or backup region)
• on market-specific price lists (catalogs)

Fields

Required Fields

• sku
• price

Optional Fields

• compareAtPrice: reference price (base list price)
• marketId: ID of the target market

On Shopify, the market ID is the last number in the market page URL (e.g., https://admin.shopify.com/store/yourShopifyStore/markets/123456789)

Price Update Behavior

Base Price List Update (Primary or Backup Region)

To update the base price list (primary or backup region):

• Do NOT provide marketId
• The update occurs at the product's base price level
• The price field cannot be 0

The base price:

• is the main reference
• is used by all non-customized markets

Market-Specific Price Lists (Catalogs)

If marketId is provided:

• the update does NOT affect the base price
• the update occurs on the catalogs associated with the market
• a market can have multiple catalogs
• all catalogs linked to the market will be updated

Handling price = 0 in markets

• If marketId is present:
• price = 0 means removing the price adjustment
• the catalog will revert to using the base price

Price Priority

• If a product has:
• a base price
• and a market-specific price
• the market-specific price always takes precedence

Data Structure

{
    "data":[
        // Base price list update (primary or backup region)
        {
            "sku": "FS-03-1",
            "price": 182.00,
            "compareAtPrice": 100.00
        },
        {
            "sku": "FS-03-2",
            "price": 183.00
        },
        // Market-specific price list update
        {
            "sku": "FS-03-1",
            "marketId": "83005178131",
            "price": 190.00,
            "compareAtPrice": 200.00
        },
        {
            "sku": "FS-03-2",
            "marketId": "83005178131",
            "price": 191.00
        }
    ]
}

Destination configuration

Configure a Shopify destination and associate it with the flow, in addition to the basic data flow configuration.

Field	Value	Notes
Destination Type	Shopify
Operation	Price sync v2	POST /egress/v2/sync-price-to-shopify
GraphQL endpoint URL	https://SHOPIFYURL.myshopify.com/	Shopify Admin GraphQL endpoint URL
Admin API access token	shpat_CODICEALFANUMERICO	Or Client ID (API key) + Client secret — see Authentication
Client ID (API key)	YOUR_CLIENT_ID
Client secret	YOUR_CLIENT_SECRET

Deprecated — previous configuration (HTTP Adapter)

Deprecated

Configuration via HTTP Adapter with Base Url, Resource Path, and x-api-key header in Settings Override is deprecated. Use the Shopify destination configuration described above.

In addition to the basic data flow configuration, the following Settings Override settings were required:

Field	Value	Notes
Base Url	https://adapter.flowlyze.io	Adapter URL
Resource Path	/api/adp/shopify/egress/v2/sync-price-to-shopify	Adapter path for price lists
Headers :: x-api-key	**********	API key to verify endpoint interaction
Headers :: x-shopify-graphql-url	https://SHOPIFYURL.myshopify.com/	Shopify store URL to connect to
Headers :: x-shopify-access-token	shpat_CODICEALFANUMERICO	Secret of the custom app created for integration