For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Rule
Description

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.

Key
Type
Default
Effect

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?