Update Prices Per Site (Upcoming)

What is Update Prices per Site?

The Update Prices Per Site endpoint allows partners to override item prices at the site level. This enables site-specific pricing without needing to create multiple master catalogues. Overrides can be set for all items, a subset of items, or include modifiers.

By default, all sites use the base (catalogue-wide) price defined in your Master Catalogue. This endpoint allows you to override that default for individual sites.

How to use

The Update Prices Per Site endpoint is used to define or update site-specific item prices. It supports both individual item prices and modifier prices, aligning with the price_info format used in the Master Catalogue. If you have a uniform price across all sites, you don’t need to use this endpoint and you can just define the prices in the master catalogue.

Note: This endpoint is coming soon and not live in production for usage

Timing Guidance

• First-Time Setup: When setting up a brand new site or catalogue, and if you intend to use site-specific pricing, call Update Prices Per Site before calling Listings.
• For New Items: If you want new items to launch with the correct site-specific prices, call the Update Prices Per Site before you call the Upload Listings endpoint for those items.
• Independent Usage for Price Updates: The Update Prices Per Site endpoint can also be used independently of Listings. You do not need to re-upload listings every time you update prices for regular price refreshes.

This ensures the correct prices are shown to customers immediately when items go live.

Steps

1. Call this endpoint to override prices for individual sites.
2. Specify the site ID and the items you want to override.
3. Receive webhook notifications when the price update is successfully processed or if an error occurs.

Important Usage Guidelines

• Use for Pricing Only: This endpoint is strictly for managing price overrides. It does not control item visibility or availability. Prices can be updated independently of catalogue or listings updates.
• Persistent Overrides: Price overrides are persistent until explicitly updated or removed. Changes to the base catalogue price do not override existing site-level overrides.
• Partial Payloads: Items not included in the request will have their overrides deleted and be assigned the default price in the master catalogue. To avoid unintentionally removing overrides, always send the full list of intended overrides with each call.
• Modifiers Supported: Use the overrides field in price_info for modifiers.

Validation Rules

• All item IDs must exist in the latest processed catalogue referenced in the update prices request URL.
• Items must be unique.
• Item prices must follow the price i.e. Positive integer or zero Price in minor units of the currency, eg. pennies for GBP, or cents for EUR.
• Version field is required with value: “update-prices-v1”
• Modifiers must have a valid type and id field within overrides.

Rate Limit

Two types of rate limits apply to this endpoint:

Multiple sites

This endpoint is designed to handle updates one site at a time. For bulk updates across multiple sites, issue separate calls per site using the respective site_id.