Skip to main content

Set Amazon Business Overrides

PUT 

/api/v2/sales-channels/:integrationInstance/prices/business/overrides

Give listings and/or products their own Amazon Business pricing policy on this Amazon account, replacing any override they already have. Only the Business policy changes; the consumer guardrails stay as they are.

Required scope: integrations:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token.

Requires the integrations.update permission (API tokens: integrations:write scope).

A Business override replaces only the Business pricing policy for its listing or product on this Amazon account; the consumer price and its floor, ceiling and maximum-change guardrails stay as they are. The Business policy in force for a listing is, in order: the listing's override › its product's override on this account › the Business policy of the listing's pricing sync profile › the channel's own Business setting.

Request body:

  • product_listing_ids (array of integers, max 5000, distinct): listings to override. Every one must be a listing on this Amazon account, or the request is refused with 422. Required unless product_ids is sent.
  • product_ids (array of integers, max 5000, distinct): products to override; the override applies to the product's listings on this Amazon account. Each product must exist. Required unless product_listing_ids is sent.
  • business_pricing (object, required): the policy. {"mode": "off"} stops the Business price for these listings or products. Fields:
  • mode (string, required when the object is sent): off (never send a Business price — whatever Seller Central holds stays live; the default), percent_off_consumer (the consumer price less percent_off), tier_sequence (the first of tier_ids that prices the product, falling back to percent_off when fallback_percent_off is true) or match_consumer (the Business price equals the consumer price).
  • percent_off (number|null, 0–50, up to 2 decimals): percent off the consumer price. Required for percent_off_consumer, and for tier_sequence while fallback_percent_off is true.
  • tier_ids (array of integers, max 10): pricing level IDs to read the Business price from, in order. Each must exist and not be archived. At least one is required for tier_sequence.
  • fallback_percent_off (boolean, default true): with tier_sequence, use percent_off for a product none of the levels prices; when false that product gets no Business price.
  • rounding (string, default none): none, .99, .95 or .49 — the ending applied to the Business price.
  • quantity_discounts (object): the quantity-discount ladder sent with the Business price.
    • mode (string, default leave): leave (never send quantity discounts; Seller Central keeps whatever it has), clear (remove any quantity discounts Amazon shows), percent_ladder (the levels below, sent as percent off the Business price) or quantity_breaks (the product's quantity-break prices in the pricing level quantity_break_tier_id, sent as fixed unit prices). Anything other than leave needs a Business price mode other than off.
    • levels (array, max 5): {min_quantity, percent_off} — min_quantity an integer of at least 2, percent_off greater than 0 and at most 50. Each level needs a higher quantity AND a bigger discount than the one before it. At least one is required for percent_ladder.
    • quantity_break_tier_id (integer|null): the pricing level whose quantity breaks become the ladder. Required for quantity_breaks; must exist and not be archived.
    • fallback_to_levels (boolean, default false): with quantity_breaks, use levels for a product that has no quantity breaks in that level.

A level that would not be a real discount — a quantity under 2, a price not below the Business price or the level before it, a price below the floor, or more than 5 levels — is left out of what is sent rather than refusing the whole offer; the price push records each one left out.

Response data: listings and products (how many of each were set), mode (the saved mode) and dry_run_pending (true when the next price push will preview Business prices first; setting a policy that turns a Business price on always does this).

Returns 422 for an invalid policy, a listing on another account, a missing product, or an account with no sales channel.

Request​

Responses​

OK

Response Headers
    Content-Type