Quantity Pricing Synchronization (B2B)

This endpoint handles the update of volume-based pricing and specific price lists for Shopify B2B catalogs. It allows you to define both the unit price for a specific list and the discount thresholds based on quantity.

⚠️ Important Note To synchronize quantity prices, the product must already have a modified price (Fixed Price) in the reference price list. The system cannot apply quantity discounts to lists that dynamically inherit the base price without a pre-existing price exception.

General Information

This endpoint allows you to define purchase thresholds and relative discounted prices (e.g., "If you buy at least 50 pieces, the unit cost drops from €70 to €60").

The target identification occurs via marketId or priceListId:

• marketId: The update is propagated to all price lists associated with that specific market.
• priceListId: The update is targeted specifically to the provided price list.
• Priority: If both fields are present in the payload, the system will exclusively use the priceListId, ignoring the market.

Field Management Logic

Synchronization follows specific rules for each field, allowing for data updates, maintenance, or total removal.

1. Unit Price (price)

This field defines the main price (Fixed Price) within the destination list or market.

• Value greater than 0: The price is updated with the provided numerical value.
• Value equal to 0: Indicates the removal of the price exception. The list will no longer have a specific price, and the product will revert to inheriting the base price from the general Shopify catalog.
• Value null: The system ignores the field. The price currently present on Shopify will remain unchanged.

2. Compare-at Price(compareAtPrice)

Used to manage the promotional aspect (strikethrough price) within the list.

• Value ≥ price: The submitted value is set, correctly displaying the discount in the catalog.
• Value < price: To avoid logical errors (discounted price higher than the original price), the value is forced and set equal to the value passed in the price field, effectively canceling the visual discount.
• Value equal to 0: The compare-at price is reset to 0, removing the strikethrough price indication.
• Value null: No modification applied; any existing value remains unchanged.

3. Quantity Pricing (qtyPricing)

Manages purchase tiers to unlock volume discounts.

• Populated (Array): The system adopts a "total overwrite" logic. All quantity prices previously saved for that list will be deleted and replaced exclusively by those provided in the new JSON.
• Empty array []: Acts as a bulk delete command. All existing quantity prices for that product and list are removed.
• Value null: No action applied. Useful if you want to update only the unit price without modifying existing volumetric thresholds.

Destination Fields (At least one required)

• marketId: Shopify Market ID.
• priceListId: Specific Price List ID.

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

Example Payload

[
  {
    "sku": "VARIANT_SKU_001",
    "marketId": "italy-main",
    "priceListId": "PL_001",
    "price": 35.50,
    "compareAtPrice": 45.00,
    "qtyPricing": [
      {
        "price": 25.50,
        "quantity": 10
      },
      {
        "price": 20.50,
        "quantity": 15
      }
    ]
  }
]

Flow Configurations

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

Field	Value	Notes
Base Url	https://adapter.flowlyze.io	Adapter URL
Resource Path	/api/adp/shopify/egress/sync-price-to-shopify	Adapter path for quantity pricing (B2B)
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