Configurable catalog selections and exact prices
Configure which product combinations can be sold and resolve exact negotiated prices. The API adds selection lookup, stock auditing and bulk price resolution.
Configurable selections and exact negotiated prices are now part of the public contract.
- Products declare
catalog_availability_mode:openkeeps active Cartesian combinations sellable with local opt-in restrictions;closeduses active configurations as the exact allow-list. - Eight REST operations add option/configuration browsing, selection resolution, stock-ledger audit, impact preview, bulk price resolution and retired-price reassignment/purge.
- Price resolution now has seven explicit precedence levels. Any negotiated price-list entry wins over an own catalog price, and the response exposes whether option adjustments were absorbed or added.
- Retired price targets keep an immutable snapshot and never fall back silently. Reassignment creates a new item; purge is explicitly irreversible.
- MCP adds seven tools: four Product reads and three Pricing operations.
Read Product catalog, Price lists and the MCP tool catalog.
New endpoints8
| Endpoint | Description |
|---|---|
GET/v1/companies/{company}/products/{product}/configurations | List product commercial combinations |
GET/v1/companies/{company}/products/{product}/options | List product option groups |
GET/v1/companies/{company}/products/{product}/stock-movements | List stock movements of a product |
POST/v1/companies/{company}/products/{product}/configurations/impact-preview | Preview the impact of restricting a catalog |
POST/v1/companies/{company}/price-lists/{priceList}/items/{item}/purge | Permanently delete a retired price list item |
POST/v1/companies/{company}/price-lists/{priceList}/items/{item}/reassign | Reassign a retired price list item |
POST/v1/companies/{company}/products/{product}/resolve-selection | Resolve a catalog selection |
POST/v1/companies/{company}/price-lists/resolve-many | Resolve many catalog prices |