Group Product Items
Administrative endpoints for group product items — the membership rows that link a Grouped product (the from_product, sold as a set) to each Simple product it contains (the to_product), together with the quantity of that member included in the set.
Core Capabilities
1. Group Item Listing & Filtering
Retrieve a paginated list of group product items.
Filter by the grouped master product (
from_product) and by the member product (to_product).
2. Group Item Lifecycle Management
Add a member to a grouped product, retrieve, update (PUT/PATCH), or remove one.
Whenever an item is created or updated, the grouped master product's price is recomputed from its members' prices (see the dynamic setting below).
Membership Rules
Master type
from_product must be a Grouped product. Otherwise the request is rejected with group_product_item_100_1.
Member type
to_product must be a Simple product. Otherwise the request is rejected with group_product_item_100_2.
Uniqueness
A given (from_product, to_product) pair may exist only once. A duplicate is rejected with the "already exists" error.
Dynamic Settings & Environment Variables
The behavior of the create and update operations is influenced by the following dynamic setting, configured in the management panel.
GROUPED_PRODUCT_PRICE_SELECTOR
string (one of three dotted import paths, chosen from a fixed list)
omnishop.catalogs.selector.group_product_min_price_selector (Minimum Price)
Selects the strategy used to derive a grouped product's price from its members' prices. It is applied on create (POST /group_product_items/) and update (PUT/PATCH /group_product_items/{id}/), when the grouped master product's price is recomputed after its membership changes. Allowed values are ...group_product_min_price_selector (lowest member price), ...group_product_max_price_selector (highest member price), and ...group_product_sum_price_selector (sum of member prices).
Environment variables: No environment variables affect these endpoints.
Last updated
Was this helpful?

