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
skuprice
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
pricefield 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
marketIdis present: price = 0means 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:
| Campo | Valore | Note |
|---|---|---|
Base Url | https://adapt.flowlyze.com | 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 |