Skip to main content

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
}
]
}

Price Flow Configuration

In addition to the base flow settings add the following Settings Override:

CampoValoreNote
Base Urlhttps://adapt.flowlyze.comAdapter URL
Resource Path/api/adp/shopify/egress/v2/sync-price-to-shopifyAdapter path for price lists
Headers :: x-api-key**********API key to verify endpoint interaction
Headers :: x-shopify-graphql-urlhttps://SHOPIFYURL.myshopify.com/Shopify store URL to connect to
Headers :: x-shopify-access-tokenshpat_CODICEALFANUMERICOSecret of the custom app created for integration