Wholesale API v2.32.0 (2026-11-02)

Version 2.32.0 of the Le New Black Wholesale API v2 is live. It brings retailer-restricted promotions and tier conditions to the promotions endpoints.

What may need a change in your integration

• Tier conditions now apply to orders. A promotion with a non-zero tier bound applies only when the order meets every bound: pieces of the order for the quantity bounds, order subtotal before promotions and customer discount for the amount bounds.
• Promotions restricted to retailers. A promotion with a non-empty retailer_scope applies only to the orders of the retailers in its scope.
• Line discount and promotion on the same order line. On GET /orders, discount_amount is now computed first, on the gross amount, and promotion_amount on what remains. The net price of the line and the order amounts are unchanged, and orders saved before this version keep their stored values.

New

• retailer_scope on promotions, read and written: the brand references of the retailers a promotion is restricted to, an empty list meaning every retailer.
• order_scope_quantity_maximum on promotions, next to the existing minimum quantity and the amount bounds.
• POST /promotions now writes the four tier conditions, which it ignored until now.

Deprecated

• order_scope_order_mode and order_scope_product_minimum on promotions: their removal moves to 2.33.0, not 2.32.0 as announced with 2.31.0. Both fields are still returned until then.

The details are in the 2.32.0 release notes, and every version is listed on Wholesale API v2 versions.