@endora-commerce/mod-catalog 0.107.0 → 0.108.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (105) hide show
  1. package/dist/admin/components/PackagingUnitsEditor.d.ts +3 -0
  2. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
  3. package/dist/admin/components/PackagingUnitsEditor.js +51 -5
  4. package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
  5. package/dist/admin/components/ProductOrderRulesCard.d.ts +19 -0
  6. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -0
  7. package/dist/admin/components/ProductOrderRulesCard.js +147 -0
  8. package/dist/admin/components/ProductOrderRulesCard.js.map +1 -0
  9. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
  10. package/dist/admin/components/ProductsBulkEditDialog.js +31 -3
  11. package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
  12. package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
  13. package/dist/admin/pages/ProductEditor.js +12 -33
  14. package/dist/admin/pages/ProductEditor.js.map +1 -1
  15. package/dist/backend/demo/reset.d.ts +1 -1
  16. package/dist/backend/demo/rows.d.ts +7 -3
  17. package/dist/backend/demo/rows.d.ts.map +1 -1
  18. package/dist/backend/demo/rows.js +7 -5
  19. package/dist/backend/demo/rows.js.map +1 -1
  20. package/dist/backend/demo/seed.d.ts.map +1 -1
  21. package/dist/backend/demo/seed.js +1 -4
  22. package/dist/backend/demo/seed.js.map +1 -1
  23. package/dist/backend/entities/product-packaging-unit.entity.d.ts +7 -1
  24. package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +1 -1
  25. package/dist/backend/entities/product-packaging-unit.entity.js +10 -0
  26. package/dist/backend/entities/product-packaging-unit.entity.js.map +1 -1
  27. package/dist/backend/entities/product-variant.entity.d.ts +1 -2
  28. package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
  29. package/dist/backend/entities/product-variant.entity.js +0 -5
  30. package/dist/backend/entities/product-variant.entity.js.map +1 -1
  31. package/dist/backend/entities/product.entity.d.ts +25 -1
  32. package/dist/backend/entities/product.entity.d.ts.map +1 -1
  33. package/dist/backend/entities/product.entity.js +60 -0
  34. package/dist/backend/entities/product.entity.js.map +1 -1
  35. package/dist/backend/index.d.ts +3 -4
  36. package/dist/backend/index.d.ts.map +1 -1
  37. package/dist/backend/index.js +3 -4
  38. package/dist/backend/index.js.map +1 -1
  39. package/dist/backend/plugin.d.ts +2 -2
  40. package/dist/backend/plugin.d.ts.map +1 -1
  41. package/dist/backend/plugin.js.map +1 -1
  42. package/dist/backend/routes.admin.d.ts.map +1 -1
  43. package/dist/backend/routes.admin.js +39 -2
  44. package/dist/backend/routes.admin.js.map +1 -1
  45. package/dist/backend/routes.public.js +3 -3
  46. package/dist/backend/routes.public.js.map +1 -1
  47. package/dist/backend/services/catalog-admin.service.d.ts +14 -0
  48. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  49. package/dist/backend/services/catalog-admin.service.js +69 -22
  50. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  51. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
  52. package/dist/backend/services/catalog-bulk-update.service.js +8 -1
  53. package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
  54. package/dist/backend/services/catalog-org-price-decorator.d.ts +7 -3
  55. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
  56. package/dist/backend/services/catalog-org-price-decorator.js +32 -23
  57. package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
  58. package/dist/backend/services/catalog-product-read.service.d.ts +45 -3
  59. package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
  60. package/dist/backend/services/catalog-product-read.service.js +133 -3
  61. package/dist/backend/services/catalog-product-read.service.js.map +1 -1
  62. package/dist/backend/services/catalog-query.service.d.ts +11 -3
  63. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  64. package/dist/backend/services/catalog-query.service.js +409 -81
  65. package/dist/backend/services/catalog-query.service.js.map +1 -1
  66. package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
  67. package/dist/backend/services/packaging-unit.service.js +39 -4
  68. package/dist/backend/services/packaging-unit.service.js.map +1 -1
  69. package/dist/backend/services/product-link.service.d.ts.map +1 -1
  70. package/dist/backend/services/product-link.service.js +16 -1
  71. package/dist/backend/services/product-link.service.js.map +1 -1
  72. package/dist/backend/services/product-value-resolver.service.d.ts +11 -1
  73. package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
  74. package/dist/backend/services/product-value-resolver.service.js +29 -9
  75. package/dist/backend/services/product-value-resolver.service.js.map +1 -1
  76. package/dist/backend/services/storefront-value-overrides.d.ts +31 -0
  77. package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -0
  78. package/dist/backend/services/storefront-value-overrides.js +48 -0
  79. package/dist/backend/services/storefront-value-overrides.js.map +1 -0
  80. package/dist/manifest.d.ts.map +1 -1
  81. package/dist/manifest.js +18 -3
  82. package/dist/manifest.js.map +1 -1
  83. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts +22 -0
  84. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +1 -0
  85. package/dist/migrations/20261016T082008_catalog_order_rules.js +48 -0
  86. package/dist/migrations/20261016T082008_catalog_order_rules.js.map +1 -0
  87. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts +26 -0
  88. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +1 -0
  89. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js +32 -0
  90. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +1 -0
  91. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts +38 -0
  92. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +1 -0
  93. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js +89 -0
  94. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +1 -0
  95. package/dist/migrations/index.d.ts +4 -1
  96. package/dist/migrations/index.d.ts.map +1 -1
  97. package/dist/migrations/index.js +7 -1
  98. package/dist/migrations/index.js.map +1 -1
  99. package/docs/catalog/attributes.md +11 -6
  100. package/docs/catalog/packaging-units.md +44 -7
  101. package/docs/catalog/per-channel-per-language-overrides.md +36 -9
  102. package/docs/catalog.md +145 -3
  103. package/i18n/en.json +29 -5
  104. package/i18n/pl.json +29 -5
  105. package/package.json +9 -9
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"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"}
@@ -38,7 +38,7 @@ Plus the behavioural flags and a numeric position:
38
38
  | `isVariantAxis` | `false` | Configurable-product variant picker |
39
39
  | `isRequired` | `false` | Product-save validator (only when the attribute is in the assigned Attribute Set) |
40
40
  | `isPromoRule` | `false` | Promotion Rule criterion picker |
41
- | `isPriceRule` | `false` | Price Lists — whether the attribute may select products in a price list's **price matrix** (the `price_lists` module). Only a single-choice, multiple-choice or yes/no attribute that is neither per-language nor per-channel qualifies. Clearing the flag deactivates the matrix entries that use the attribute — they stop affecting prices and resume when the flag is set again; it never causes a pricing error. |
41
+ | `isPriceRule` | `false` | Price books (the `price_lists` module) — shown as **Price list rules**: whether a price book may price products by this attribute's value, on an *attribute value* line or a *category and attribute value* line. Only a single-choice, multiple-choice or yes/no attribute that is neither per-language nor per-channel qualifies. A variant matches on its own axis values, overlaid on its product's values. Clearing the flag deactivates the lines that use the attribute — they stop affecting prices, the price grid shows them as *Inactive*, and they resume when the flag is set again; it never causes a pricing error. |
42
42
  | `isVisibleOnProductPage` | `false` | PDP "Parametry produktu" tab |
43
43
  | `displayAsSlider` | `false` | Storefront sidebar — renders a range slider; only valid for `valueType ∈ ('number','price')` |
44
44
  | `filterPosition` | `0` | Storefront sidebar sort key (ascending; ties broken alphabetically by the resolved label) |
@@ -234,11 +234,16 @@ internals:
234
234
  - `buildVisibleAttributesProjection()` — internal, used by the PDP
235
235
  detail response to assemble the `visibleAttributes[]` payload.
236
236
 
237
- `isPriceRule` has no method of its own. A pricing consumer reads it
238
- through the `catalogAttributeReadPort` — `listByFlag('isPriceRule')`
239
- for the attributes a price rule may name, and `isPriceRule` on every
240
- attribute view to refuse one that may not — and the admin picker
241
- payload is `GET /api/v1/admin/catalog/attributes/by-flag?flag=isPriceRule`.
237
+ `isPriceRule` has no method of its own. `price_lists` reads it through
238
+ the `catalogAttributeReadPort` — `listByFlag('isPriceRule')` for the
239
+ attributes a price-book line may name, and `isPriceRule` on every
240
+ attribute view to refuse one that may not — once per pricing batch, so a
241
+ flag change takes effect on the next resolution; an `attribute.updated.v1`
242
+ event also clears the pricing caches and marks on the price surface the
243
+ products that price-book rows naming the attribute select. The
244
+ price-book editor's picker is
245
+ `GET /api/v1/admin/price-books/targets/attributes`, which lists only the
246
+ eligible attributes with their option values.
242
247
 
243
248
  ## See also
244
249
 
@@ -17,7 +17,34 @@ Manage packaging units in the **Inventory** section of the product card
17
17
  - a **name** (operator text, e.g. `Paleta`, `Karton`) — unique within the product,
18
18
  - a **base quantity** (whole number ≥ 1) — how many base pieces the unit holds,
19
19
  - a **default** flag — the unit pre-selected on the storefront,
20
- - a **position** — the order units appear in.
20
+ - a **position** — the order units appear in,
21
+ - an optional **minimum** — the fewest of this unit a buyer may order at once
22
+ (whole number from 1 to 1 000 000; empty for none).
23
+
24
+ ## Minimum number of units
25
+
26
+ A unit's minimum is counted over **every line of the product ordered in that
27
+ unit**, across all variants: a line counts its pieces divided by the unit's
28
+ base quantity. Pallet minimum 2 is met by one line of 2 pallets, or by two
29
+ lines of 1 pallet of different variants. It is independent of the product's
30
+ minimum in pieces (set in the product's **Order rules** card): both may be set,
31
+ and an order must satisfy each. Pieces ordered singly or in another unit do not
32
+ count toward this unit's minimum, but every line counts toward the pieces
33
+ minimum.
34
+
35
+ A basket, quote request or order that leaves a unit below its minimum is
36
+ refused with `422 PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY`, whose message names
37
+ the product, the minimum and the unit. The storefront starts the quantity at
38
+ the selected unit's minimum. The admin's Create order screen and the external
39
+ order API carry no packaging unit, so only the pieces minimum is reachable
40
+ there.
41
+
42
+ On a quote request a line names its unit by `packagingUnitId`; the server
43
+ stores the catalogue's name and base quantity for it. A line that sends a
44
+ packaging name and base quantity without an id is accepted only when both
45
+ match one of the product's units. Anything else is refused with
46
+ `422 PACKAGING_UNIT_MISMATCH` — an id that is unknown, deleted or another
47
+ product's unit all give the same reason.
21
48
 
22
49
  ## For buyers
23
50
 
@@ -43,8 +70,9 @@ change historical carts, orders, or quote requests.
43
70
 
44
71
  ## Pricing & availability
45
72
 
46
- Pricing reuses the existing engine on the resulting base-piece quantity
47
- (including price-list quantity tiers) — there is no separate per-unit price.
73
+ A line in a packaging unit is priced by the price books on the resulting
74
+ base-piece quantity (including the books' quantity tiers) — there is no
75
+ separate per-unit price.
48
76
  Stock availability and per-line limits are evaluated on the resulting piece
49
77
  count.
50
78
 
@@ -52,9 +80,15 @@ count.
52
80
 
53
81
  - Admin CRUD: `GET/POST /api/v1/admin/catalog/products/:id/packaging-units`,
54
82
  `PATCH/DELETE …/:unitId`, `PATCH …/packaging-units/reorder`
55
- (gated by `catalog:read` / `catalog:write`).
83
+ (gated by `catalog:read` / `catalog:write`). Create and update accept an
84
+ optional `minOrderUnits` (`1…1000000`, or `null` to clear); the response
85
+ always carries it. The in-process `CatalogPackagingPort`, used by PIM
86
+ connectors, accepts the same optional field and refuses an out-of-range
87
+ value with `422 VALIDATION_FAILED`; a writer that never sends it keeps
88
+ working.
56
89
  - Public: the product detail (`GET /api/v1/catalog/products/:idOrSlug`)
57
- includes an optional `packagingUnits` array.
90
+ includes an optional `packagingUnits` array; each unit carries
91
+ `minOrderUnits` (`null` when none).
58
92
  - Cart: `POST /api/v1/cart/items` accepts an optional `packagingUnitId`; the
59
93
  resulting line quantity is `baseQuantity × quantity`.
60
94
 
@@ -64,7 +98,10 @@ Table `product_packaging_units` (migration
64
98
  `20260611T140412_catalog_product_packaging_units.ts`): `id`, `product_id`
65
99
  (FK → `products`, cascade delete), `name`, `base_quantity`
66
100
  (`CHECK >= 1`), `position`, `is_default`, timestamps; `UNIQUE (product_id,
67
- name)`. Additive snapshot columns, each added by its owning module:
101
+ name)`. Migration `20261016T082008_catalog_order_rules.ts` adds
102
+ `min_order_units` (nullable, `CHECK` 1–1 000 000). Additive snapshot columns, each added by its owning module:
68
103
  `cart_items` (`20260611T140413_carts_cart_item_packaging.ts`), `order_items`
69
104
  (`20260611T140414_orders_order_item_packaging.ts`), `quote_request_items`
70
- (`20260611T140415_quote_requests_qr_item_packaging.ts`).
105
+ (`20260611T140415_quote_requests_qr_item_packaging.ts`; its
106
+ `packaging_unit_id` from
107
+ `20261018T122118_quote_requests_item_packaging_unit_id.ts`).
@@ -159,7 +159,7 @@ additive.
159
159
 
160
160
  ## Read paths
161
161
 
162
- Three consumers go through the resolver:
162
+ These consumers go through the resolver:
163
163
 
164
164
  - **Admin endpoint** — `GET /api/v1/admin/catalog/products/:id?channelId=&languageCode=&includeOverridesMap=true`
165
165
  returns the baseline product PLUS, when context params are passed, a
@@ -168,13 +168,40 @@ Three consumers go through the resolver:
168
168
  is attached for client-side switcher previews.
169
169
  - **Storefront public read** — pulls the channel from the
170
170
  `x-sales-channel` header (the existing convention) and
171
- the language from `Accept-Language`. The override layer is invisible
172
- to the public client.
171
+ the language from `Accept-Language`, else the channel's default
172
+ language. The override layer is invisible to the public client: it
173
+ receives the effective value. The product page (name, description,
174
+ SEO fields, attribute values, the product-page attribute list, grouped
175
+ children and bundle options) and every listing card walk the storefront's own baseline language pick — requested
176
+ language, then the channel's default language, then `en-US`, `en` and
177
+ the first stored language — and at each language take the
178
+ `(channel + language)` slot if it is filled, else stop there if the
179
+ baseline has text for that language. An override therefore answers
180
+ only for the language whose baseline text the page would show, or an
181
+ earlier one in that order: a request in `en-US` on a channel whose
182
+ default is `pl-PL` shows the `en-US` baseline, not the `pl-PL`
183
+ override, while a `de-DE` request for a product with no `de-DE` text
184
+ falls through to `pl-PL` and shows its override. The `(channel-only)`
185
+ slot is asked last and wins over the baseline wherever the walk
186
+ stopped. Product-link tiles keep their own language pick, which has
187
+ no channel-default leg, and walk the override slots over it, so a
188
+ tile can show the `en-US` baseline where the listing card shows the
189
+ channel default's override. A product without overrides shows exactly what
190
+ it showed before. Listing filters, attribute filters and name sorting
191
+ still read the baseline.
173
192
  - **Search indexer (Meilisearch)** — builds one document per
174
193
  `(product, channel)` pair. Each document's `name` and `description`
175
194
  fields are run through the resolver with `channel.defaultLanguage`
176
195
  as the active language, so per-channel overrides flow into
177
- storefront search ranking.
196
+ storefront search ranking and name sorting.
197
+ - **Search result cards** — the search module re-reads every hit from
198
+ Postgres before it answers, and the card name it shows is resolved
199
+ there, not taken from the index: the request's sales channel override
200
+ rows are read once per results page and the card walks the same
201
+ languages and slots, in the same order, as a listing card above. The indexed name is
202
+ resolved for the channel's default language only, so it would be
203
+ wrong for a request in any other language. A product without an
204
+ override for the channel shows exactly what it showed before.
178
205
 
179
206
  ## Admin UI
180
207
 
@@ -223,11 +250,11 @@ exact inverse — drop the two tables and the two columns.
223
250
  surfaces only the system Name + Description today. User attribute
224
251
  overrides are accepted by the PATCH endpoint and resolved on read,
225
252
  but the admin SPA does not yet expose a write affordance for them.
226
- - **Storefront public read shape change** — `products.name` and
227
- `products.description` still ship as `Record<lang, string>` JSONB
228
- on the public catalog endpoint. Switching to a resolved scalar is
229
- a breaking change for storefront consumers and is scoped as a
230
- follow-up.
253
+ - **Override-aware listing filters and sorting** — the public catalog
254
+ endpoint returns `name` and `description` as the resolved string for
255
+ the request's sales channel and language (see *Read paths* above), but
256
+ listing filters, attribute filters and name sorting still read the
257
+ baseline values. Making them follow the overrides is a follow-up.
231
258
  - **Channel-aware reindex enqueue** — the PATCH endpoint does not
232
259
  yet enqueue a Meilisearch reindex job per touched channel; the
233
260
  next per-product upsert (driven by any catalog mutation) picks it
package/docs/catalog.md CHANGED
@@ -54,6 +54,56 @@ otherwise; every price names its currency either way. A malformed code is refuse
54
54
  | `PUT /api/v1/admin/catalog/categories/:id/content` | admin | Replace the category's page content; `null` clears it |
55
55
  | `PUT /api/v1/catalog/products/by-sku/:sku` | API key | Idempotent upsert (PIM sync) |
56
56
 
57
+ ## Prices
58
+
59
+ **A product carries no price of its own.** Every price is a row of a price book of the
60
+ `price_lists` module: the product's base price per currency, its variants' prices, and any
61
+ catalogue, buyer or sale price. Set a product's base price on the product editor's **Pricing** tab
62
+ — the *Base prices* panel there, and the list of the price books that price the product, are
63
+ contributed by `price_lists` — or in the base book's grid. Variant prices are set in the same
64
+ places, never on the variant itself. The `price_lists` module's page explains how the price a
65
+ buyer pays is chosen.
66
+
67
+ - **Listing cards, the product page and related products** show the viewer's own price — their
68
+ organization's and customer group's prices on the request's sales channel and currency. A product
69
+ whose variants cost different amounts shows its lowest price as a *from* price
70
+ (`ProductSummary.price` carries `variesByVariant` and `maxAmount`); a charged sale carries the
71
+ buyer's regular price as the compare-at price; with `pricing.show_list_price` on, a lower buyer
72
+ price carries the catalogue price as `listPrice`. A product nothing prices has no price and
73
+ follows the quote-request path.
74
+ - **Sorting and filtering by price** — `?sort=price`, `?sort=-price`, `minPrice`, `maxPrice` on
75
+ `GET /api/v1/catalog/products` — order and select by the same quantity-1 price the cards show to
76
+ that viewer, the *from* price for a variant product. Priced products always come before unpriced
77
+ ones. A price ordering is always answered from PostgreSQL, never from the search index. Paging
78
+ through a price ordering with the cursor meets every product once, provided its price does not
79
+ change meanwhile; a product repriced during the walk may be met twice or not at all, as with any
80
+ cursor over a live price. A page may be short, or even empty, and still have more after it
81
+ (`hasMore: true`) when most of the rows it read are hidden from the viewer; follow its cursor.
82
+ - **The product detail on a non-public sales channel** omits the price.
83
+
84
+ For developers: the listing paths price a whole page in one batched call —
85
+ `resolveListingPrices`, or `resolveListingPriceDetails` where the page renders the split
86
+ (`ProductSummary.resolvedPrice`: `basePrice`, `salePrice`, `listPrice`, `displayMode`) — through the
87
+ `pricingService` port slices of `@endora-commerce/contracts`, passing the viewer's organization and
88
+ customer account rather than a resolved group. A price ordering reads `ListingPriceOrderPort`
89
+ (`orderByUnitPrice`, `pricedProductIds`) over `price_lists`' precomputed price surface and composes
90
+ the unpriced tail itself (`catalog-query.service.ts`). The external catalogue API prices through
91
+ `resolveLinePrices` and builds a bound organization's tier ladder from `listTierStarts`. Product,
92
+ category and attribute writes publish the events `price_lists` subscribes to, which clear the
93
+ pricing caches and mark on the price surface the products each event concerns, for the surface
94
+ worker to refresh.
95
+
96
+ ### Removed price fields (migration note)
97
+
98
+ The release that introduced price books removed the product's *Default unit price* (the
99
+ `defaultPrice` and `price` keys of `attributeValues`, and the editor field) and the variant price
100
+ override (`product_variants.price_override`, and the variant editor's price field), without
101
+ converting either. Product and variant create and update, and the products import, refuse those
102
+ fields with `400 PRICE_SET_IN_PRICE_BOOKS` (`PRICE_FIELDS_REFUSED_ON_PRODUCTS`,
103
+ `PRICE_FIELDS_REFUSED_ON_VARIANTS` in `@endora-commerce/contracts`), saying that prices are set in
104
+ price books. The catalogue's migration `20261022T111811_catalog_price_fields_removed.ts` dropped the
105
+ column and stripped the keys.
106
+
57
107
  ## Entities
58
108
 
59
109
  `Product`, `ProductVariant`, `Category`, `ProductAttribute`,
@@ -219,13 +269,105 @@ modules are present. The payload is sent whole; the strict schemas are
219
269
 
220
270
  ## Extension points
221
271
 
222
- - **Per-Sales-Channel pricing** — query service receives a SalesChannel
223
- context; new gating (e.g. customer-segment-specific catalogs) is added by
224
- composing into `catalog-query.service.ts`.
272
+ - **Per-Sales-Channel listing** — the query service receives a SalesChannel
273
+ context, and every price it renders is resolved for that channel; new gating
274
+ (e.g. customer-segment-specific catalogs) is added by composing into
275
+ `catalog-query.service.ts`.
225
276
  - **Slug uniqueness** — the slug is unique across all Sales Channels by
226
277
  default; override the slugifier in `catalog-admin.service.ts` if locale
227
278
  collisions become a concern.
228
279
 
280
+ ## Order rules: minimum order quantity and returnable
281
+
282
+ Two rules on a product decide how it may be ordered and whether it may be sent
283
+ back. Both are edited in the **Order rules** card on the product editor's
284
+ **Inventory** tab.
285
+
286
+ > **Upgrading: every existing product starts as not returnable.** A product on
287
+ > which nobody has set **Returnable** reads as not returnable, and that includes
288
+ > every product that existed before the setting was introduced. Lines of orders
289
+ > placed after the upgrade are therefore not returnable until you mark their
290
+ > products. To mark many at once, select them on the product list and use
291
+ > **Bulk edit → Returnable → Yes — returnable**. Orders placed before the
292
+ > upgrade are unaffected: their lines stay returnable under the usual rules.
293
+
294
+ ### Minimum order quantity
295
+
296
+ - **Minimum order quantity (pcs)** — the fewest pieces of the product a buyer
297
+ may order in one order. Optional; a whole number from **1 to 1 000 000**, or
298
+ empty for no minimum. It applies to `simple` and `configurable` products
299
+ only: on a `grouped`, `bundle` or `virtual` product the card says so, and
300
+ the API refuses the field with `422 VALIDATION_FAILED` naming
301
+ `minOrderQuantity`, on create and on update. A value outside the range is
302
+ refused with `400 VALIDATION_FAILED`.
303
+ - **A minimum per packaging unit** — each packaging unit may carry its own
304
+ minimum number of units; see [Packaging Units](./catalog/packaging-units.md).
305
+
306
+ The minimum is judged on the **product total**: every line of the product in
307
+ the basket counts — single-piece and packaging-unit lines, every variant. A
308
+ packaging-unit minimum counts the units of that unit ordered for the product,
309
+ over every variant. The two checks are independent; a basket must satisfy
310
+ every minimum that is set. Variants inherit the product's minimum.
311
+
312
+ Every way into a basket, a quote request or an order applies it — the cart,
313
+ checkout, quick order, one-click buy, shopping lists, quote requests, the
314
+ admin's Create order screen and the external order API. Each of those modules'
315
+ pages says what its path does with a line below the minimum. A refusal answers
316
+ `422 PRODUCT_BELOW_MINIMUM_QUANTITY` (pieces) or
317
+ `422 PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY` (a packaging unit), with a message
318
+ in the buyer's language naming the product and the minimum. Removing a line is
319
+ always allowed.
320
+
321
+ A product a buyer may not see, or that the request's sales channel does not
322
+ publish, is reported as an unknown product on every path — its name and its
323
+ minimum are never disclosed.
324
+
325
+ The storefront product detail, the product list, search results and the
326
+ comparison carry `minOrderQuantity` (`null` when there is none, or when the
327
+ product's type takes no minimum); the product detail's `packagingUnits[]`
328
+ carries each unit's `minOrderUnits`. The storefront starts the quantity at the
329
+ minimum and does not offer less.
330
+
331
+ ### Returnable
332
+
333
+ **Returnable** (yes / no, on every product type) says whether buyers may
334
+ include the product in a **return**. It does not restrict **complaints**. The
335
+ default is no.
336
+
337
+ The value is **recorded on each order line when the order is placed**
338
+ (`order_items.returnable_at_purchase`); changing the flag later changes no
339
+ order already placed. A line whose product could not be read at placement is
340
+ recorded as not returnable. What the Returns module does with the recorded
341
+ value is on its own page.
342
+
343
+ ### Audit and copies
344
+
345
+ Setting or clearing either rule is audited like any product edit, with the old
346
+ and the new value. **Bulk edit → Returnable** writes one audit entry per
347
+ product it changes, for up to 200 products in one synchronous request and
348
+ through the queued bulk edit beyond. Changing a rule never alters an existing
349
+ cart, order, quote request or return. **Duplicate** does not copy either rule:
350
+ the copy starts with no minimum and as not returnable.
351
+
352
+ ### API
353
+
354
+ | Field | Where | Values |
355
+ | --- | --- | --- |
356
+ | `minOrderQuantity` | `POST` / `PATCH /api/v1/admin/catalog/products[/:id]`, the admin product response | integer `1…1000000`, or `null` to clear |
357
+ | `returnable` | the same, and `POST /api/v1/admin/catalog/products/bulk-update` | boolean |
358
+ | `minOrderUnits` | `POST` / `PATCH …/packaging-units[/:unitId]`, the packaging-unit response | integer `1…1000000`, or `null` to clear |
359
+
360
+ The catalogue read port (`CatalogProductReadPort`) reports `minOrderQuantity`
361
+ and `returnable` on each product record and `minOrderUnits` on each packaging
362
+ unit, and gains `listPackagingUnitsByProductIds` for batch reads. Like every
363
+ method of the port it applies no visibility policy: a caller passes only
364
+ product ids it has already vetted.
365
+
366
+ Migration `20261016T082008_catalog_order_rules.ts` adds
367
+ `products.min_order_quantity` (nullable, `CHECK` 1–1 000 000),
368
+ `products.returnable` (not null, default `false`) and
369
+ `product_packaging_units.min_order_units` (nullable, `CHECK` 1–1 000 000).
370
+
229
371
  ## Product structure and composition surfaces
230
372
 
231
373
  The catalog grew several capability surfaces, each with its own page:
package/i18n/en.json CHANGED
@@ -42,6 +42,10 @@
42
42
  "productsList.bulkEdit.section.categories": "Categories",
43
43
  "productsList.bulkEdit.section.attributeSet": "Attribute Set",
44
44
  "productsList.bulkEdit.section.attributes": "Attribute values",
45
+ "productsList.bulkEdit.section.returnable": "Returnable",
46
+ "productsList.bulkEdit.returnable.yes": "Yes — returnable",
47
+ "productsList.bulkEdit.returnable.no": "No — not returnable",
48
+ "productsList.bulkEdit.returnable.hint": "Products are not returnable until you mark them — including every product that existed before the Returnable setting was introduced. Select the products buyers may send back and set them returnable here. Orders placed earlier keep the setting they were placed with.",
45
49
  "productsList.bulkEdit.attributeSet.none": "— No attribute set —",
46
50
  "productsList.bulkEdit.untouched": "(leave unchanged)",
47
51
  "productsList.bulkEdit.mode.add": "Add",
@@ -327,6 +331,7 @@
327
331
  "inventoryTab.stockMgmt.backorderGloballyDisabled": "Enable “Allow ordering below stock” in the Settings module (Inventory) first.",
328
332
  "inventoryTab.stockMgmt.backorderUnmanaged": "Not applicable while stock management is disabled — any quantity is already allowed.",
329
333
  "productEditor.loading": "Loading…",
334
+ "productEditor.tab.pricing": "Pricing",
330
335
  "productEditor.scopeEditor.title": "Scope: Sales Channel + Language",
331
336
  "productEditor.scopeEditor.help": "Preview how this product resolves per (channel, language) using the platform's resolver.",
332
337
  "productEditor.scopeEditor.overridesCount": "{count} channel-aware override(s) in place.",
@@ -383,8 +388,6 @@
383
388
  "productEditor.field.status.help": "Choose draft, active, or inactive. Inactive withdraws the product from merchandising without deleting it.",
384
389
  "productEditor.action.delete": "Delete",
385
390
  "productEditor.deleteConfirm": "Permanently delete this product from the catalog? This cannot be undone in the admin.",
386
- "productEditor.field.defaultPrice": "Default unit price",
387
- "productEditor.field.defaultPrice.help": "Price-list overrides take precedence at checkout.",
388
391
  "productEditor.field.localizedName": "Name [{locale}]",
389
392
  "productEditor.field.localizedDescription": "Description [{locale}]",
390
393
  "productEditor.seo.title": "Per-locale SEO",
@@ -400,7 +403,6 @@
400
403
  "productEditor.variants.deleteConfirm": "Delete variant \"{sku}\"?",
401
404
  "productEditor.variants.column.sku": "SKU",
402
405
  "productEditor.variants.column.attributes": "Attributes",
403
- "productEditor.variants.column.priceOverride": "Price override",
404
406
  "productEditor.variants.column.stock": "Stock",
405
407
  "productEditor.variants.column.actions": "Actions",
406
408
  "productEditor.variants.action.delete": "Delete",
@@ -409,7 +411,6 @@
409
411
  "productEditor.variants.field.sku": "SKU",
410
412
  "productEditor.variants.field.attributes": "Attributes",
411
413
  "productEditor.variants.field.attributesPlaceholder": "color=red, size=M",
412
- "productEditor.variants.field.priceOverride": "Price override",
413
414
  "productEditor.variants.field.stock": "Stock",
414
415
  "productEditor.gallery.title": "Gallery",
415
416
  "productEditor.gallery.productImages.title": "Product images",
@@ -578,6 +579,9 @@
578
579
  "errors.PRODUCT_NOT_IN_COMPARISON": "Product Not In Comparison.",
579
580
  "errors.PRODUCT_UNMANAGED_STOCK": "Product Unmanaged Stock.",
580
581
  "errors.SYSTEM_ATTRIBUTE_SET_IMMUTABLE": "This attribute set is part of the platform's own configuration. Its code is a stable integration key and cannot be changed, and the set itself cannot be deleted. Create your own attribute set and move the products onto it if you need a different one.",
582
+ "errors.PRODUCT_BELOW_MINIMUM_QUANTITY": "\"{productName}\" has a minimum order quantity of {minimum} pcs.",
583
+ "errors.PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY": "\"{productName}\" must be ordered in at least {minimum} × {packagingUnitName}.",
584
+ "errors.PACKAGING_UNIT_MISMATCH": "The packaging unit on line {lineNumber} (\"{productName}\") does not match the product's packaging units.",
581
585
  "auditLog.product.update": "Product updated",
582
586
  "auditLog.attribute_set.create": "Attribute set created",
583
587
  "auditLog.attribute_set.update": "Attribute set updated",
@@ -622,6 +626,25 @@
622
626
  "packagingUnits.error.load": "Failed to load packaging units.",
623
627
  "packagingUnits.error.save": "Save failed.",
624
628
  "packagingUnits.error.invalid": "Enter a name and a whole number of pieces (at least 1).",
629
+ "packagingUnits.col.minOrderUnits": "Minimum (units)",
630
+ "packagingUnits.newMinimum": "Minimum (optional)",
631
+ "packagingUnits.minOrderUnitsHelp": "Minimum: the fewest of this unit a buyer may order at once. Leave it empty for no minimum.",
632
+ "packagingUnits.error.invalidMinimum": "The minimum must be a whole number from 1 to {max}, or empty for none.",
633
+ "orderRules.title": "Order rules",
634
+ "orderRules.loading": "Loading order rules…",
635
+ "orderRules.error.load": "Could not load the order rules. Reload the page to try again.",
636
+ "orderRules.error.save": "Could not save the order rules. Try again.",
637
+ "orderRules.saving": "Saving…",
638
+ "orderRules.saved": "Order rules saved.",
639
+ "orderRules.returnable.label": "Returnable",
640
+ "orderRules.returnable.help": "Buyers can include this product in a return. Products are not returnable until marked; to mark many at once, select them on the product list and use Bulk edit → Returnable.",
641
+ "orderRules.minimum.label": "Minimum order quantity (pcs)",
642
+ "orderRules.minimum.help": "The fewest pieces a buyer may order in one order. Leave it empty for no minimum.",
643
+ "orderRules.minimum.placeholder": "No minimum",
644
+ "orderRules.minimum.invalid": "Enter a whole number from 1 to {max}, or leave the field empty.",
645
+ "orderRules.minimum.save": "Save minimum",
646
+ "orderRules.minimum.clear": "Remove minimum",
647
+ "orderRules.minimum.notApplicable": "A minimum order quantity applies to simple and configurable products only.",
625
648
  "bulkOperations.undo.action": "Undo",
626
649
  "bulkOperations.undo.running": "Undoing…",
627
650
  "bulkOperations.undo.confirm": "Undo this bulk edit and restore {count} product(s) to their previous values?",
@@ -673,5 +696,6 @@
673
696
  "adminSearch.product.status.inactive": "Inactive",
674
697
  "adminSearch.category.group.label": "Categories",
675
698
  "adminSearch.category.field.name": "Name",
676
- "adminSearch.category.field.slug": "URL key (slug)"
699
+ "adminSearch.category.field.slug": "URL key (slug)",
700
+ "errors.PRICE_SET_IN_PRICE_BOOKS": "Prices are set in price books, not on the product."
677
701
  }
package/i18n/pl.json CHANGED
@@ -42,6 +42,10 @@
42
42
  "productsList.bulkEdit.section.categories": "Kategorie",
43
43
  "productsList.bulkEdit.section.attributeSet": "Zestaw atrybutów",
44
44
  "productsList.bulkEdit.section.attributes": "Wartości atrybutów",
45
+ "productsList.bulkEdit.section.returnable": "Podlega zwrotowi",
46
+ "productsList.bulkEdit.returnable.yes": "Tak — podlega zwrotowi",
47
+ "productsList.bulkEdit.returnable.no": "Nie — nie podlega zwrotowi",
48
+ "productsList.bulkEdit.returnable.hint": "Produkty nie podlegają zwrotowi, dopóki ich nie oznaczysz — dotyczy to także wszystkich produktów istniejących przed wprowadzeniem tego ustawienia. Zaznacz produkty, które kupujący mogą odesłać, i oznacz je tutaj jako podlegające zwrotowi. Zamówienia złożone wcześniej zachowują ustawienie z chwili złożenia.",
45
49
  "productsList.bulkEdit.attributeSet.none": "— Brak zestawu atrybutów —",
46
50
  "productsList.bulkEdit.untouched": "(pozostaw bez zmian)",
47
51
  "productsList.bulkEdit.mode.add": "Dodaj",
@@ -327,6 +331,7 @@
327
331
  "inventoryTab.stockMgmt.backorderGloballyDisabled": "Najpierw włącz „Zezwól na zamawianie poniżej stanu” w module Settings (Magazyn).",
328
332
  "inventoryTab.stockMgmt.backorderUnmanaged": "Nie dotyczy, gdy zarządzanie stanem jest wyłączone — dowolna ilość jest już dozwolona.",
329
333
  "productEditor.loading": "Wczytywanie…",
334
+ "productEditor.tab.pricing": "Ceny",
330
335
  "productEditor.scopeEditor.title": "Kontekst: Kanał sprzedaży + Język",
331
336
  "productEditor.scopeEditor.help": "Podgląd jak ten produkt jest rozstrzygany dla danej pary (kanał, język) przez resolver platformy.",
332
337
  "productEditor.scopeEditor.overridesCount": "{count} nadpis(ań|anie) zależnych od kanału.",
@@ -383,8 +388,6 @@
383
388
  "productEditor.field.status.help": "Wybierz szkic, aktywny lub nieaktywny. Nieaktywny wycofuje produkt z oferty bez usuwania go z katalogu.",
384
389
  "productEditor.action.delete": "Usuń",
385
390
  "productEditor.deleteConfirm": "Trwale usunąć ten produkt z katalogu? W panelu admin nie będzie można tego cofnąć.",
386
- "productEditor.field.defaultPrice": "Domyślna cena jednostkowa",
387
- "productEditor.field.defaultPrice.help": "Nadpisania z cenników mają pierwszeństwo przy kasie.",
388
391
  "productEditor.field.localizedName": "Nazwa [{locale}]",
389
392
  "productEditor.field.localizedDescription": "Opis [{locale}]",
390
393
  "productEditor.seo.title": "SEO per locale",
@@ -400,7 +403,6 @@
400
403
  "productEditor.variants.deleteConfirm": "Usunąć wariant „{sku}”?",
401
404
  "productEditor.variants.column.sku": "SKU",
402
405
  "productEditor.variants.column.attributes": "Atrybuty",
403
- "productEditor.variants.column.priceOverride": "Nadpisanie ceny",
404
406
  "productEditor.variants.column.stock": "Stan",
405
407
  "productEditor.variants.column.actions": "Akcje",
406
408
  "productEditor.variants.action.delete": "Usuń",
@@ -409,7 +411,6 @@
409
411
  "productEditor.variants.field.sku": "SKU",
410
412
  "productEditor.variants.field.attributes": "Atrybuty",
411
413
  "productEditor.variants.field.attributesPlaceholder": "color=red, size=M",
412
- "productEditor.variants.field.priceOverride": "Nadpisanie ceny",
413
414
  "productEditor.variants.field.stock": "Stan",
414
415
  "productEditor.gallery.title": "Galeria",
415
416
  "productEditor.gallery.productImages.title": "Zdjęcia produktu",
@@ -578,6 +579,9 @@
578
579
  "errors.PRODUCT_NOT_IN_COMPARISON": "Błąd: product not in comparison.",
579
580
  "errors.PRODUCT_UNMANAGED_STOCK": "Błąd: product unmanaged stock.",
580
581
  "errors.SYSTEM_ATTRIBUTE_SET_IMMUTABLE": "Ten zestaw atrybutów należy do konfiguracji samej platformy. Jego kod jest stałym kluczem integracyjnym i nie można go zmienić, a samego zestawu nie można usunąć. Jeśli potrzebujesz innego, utwórz własny zestaw atrybutów i przenieś na niego produkty.",
582
+ "errors.PRODUCT_BELOW_MINIMUM_QUANTITY": "Minimalna ilość zamówienia produktu „{productName}” to {minimum} szt.",
583
+ "errors.PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY": "Produkt „{productName}” należy zamówić w ilości co najmniej {minimum} × {packagingUnitName}.",
584
+ "errors.PACKAGING_UNIT_MISMATCH": "Jednostka opakowania w pozycji {lineNumber} („{productName}”) nie odpowiada jednostkom opakowania produktu.",
581
585
  "auditLog.product.update": "Zaktualizowano produkt",
582
586
  "auditLog.attribute_set.create": "Utworzono zestaw atrybutów",
583
587
  "auditLog.attribute_set.update": "Zaktualizowano zestaw atrybutów",
@@ -622,6 +626,25 @@
622
626
  "packagingUnits.error.load": "Nie udało się wczytać jednostek opakowaniowych.",
623
627
  "packagingUnits.error.save": "Zapis nie powiódł się.",
624
628
  "packagingUnits.error.invalid": "Podaj nazwę i całkowitą liczbę sztuk (co najmniej 1).",
629
+ "packagingUnits.col.minOrderUnits": "Minimum (w jednostkach)",
630
+ "packagingUnits.newMinimum": "Minimum (opcjonalnie)",
631
+ "packagingUnits.minOrderUnitsHelp": "Minimum: najmniejsza liczba tej jednostki, jaką kupujący może zamówić naraz. Zostaw puste, aby nie ustawiać minimum.",
632
+ "packagingUnits.error.invalidMinimum": "Minimum musi być liczbą całkowitą od 1 do {max} albo pozostać puste.",
633
+ "orderRules.title": "Zasady zamawiania",
634
+ "orderRules.loading": "Wczytywanie zasad zamawiania…",
635
+ "orderRules.error.load": "Nie udało się wczytać zasad zamawiania. Odśwież stronę, aby spróbować ponownie.",
636
+ "orderRules.error.save": "Nie udało się zapisać zasad zamawiania. Spróbuj ponownie.",
637
+ "orderRules.saving": "Zapisywanie…",
638
+ "orderRules.saved": "Zapisano zasady zamawiania.",
639
+ "orderRules.returnable.label": "Podlega zwrotowi",
640
+ "orderRules.returnable.help": "Kupujący mogą zgłosić ten produkt do zwrotu. Produkty nie podlegają zwrotowi, dopóki ich nie oznaczysz; aby oznaczyć wiele naraz, zaznacz je na liście produktów i użyj Edycji masowej → Podlega zwrotowi.",
641
+ "orderRules.minimum.label": "Minimalna ilość zamówienia (szt.)",
642
+ "orderRules.minimum.help": "Najmniejsza liczba sztuk, jaką kupujący może zamówić w jednym zamówieniu. Zostaw puste, aby nie ustawiać minimum.",
643
+ "orderRules.minimum.placeholder": "Brak minimum",
644
+ "orderRules.minimum.invalid": "Wpisz liczbę całkowitą od 1 do {max} albo zostaw pole puste.",
645
+ "orderRules.minimum.save": "Zapisz minimum",
646
+ "orderRules.minimum.clear": "Usuń minimum",
647
+ "orderRules.minimum.notApplicable": "Minimalna ilość zamówienia dotyczy tylko produktów prostych i konfigurowalnych.",
625
648
  "bulkOperations.undo.action": "Cofnij",
626
649
  "bulkOperations.undo.running": "Cofanie…",
627
650
  "bulkOperations.undo.confirm": "Cofnąć tę edycję masową i przywrócić {count} produkt(ów) do poprzednich wartości?",
@@ -673,5 +696,6 @@
673
696
  "adminSearch.product.status.inactive": "Nieaktywny",
674
697
  "adminSearch.category.group.label": "Kategorie",
675
698
  "adminSearch.category.field.name": "Nazwa",
676
- "adminSearch.category.field.slug": "Klucz URL (slug)"
699
+ "adminSearch.category.field.slug": "Klucz URL (slug)",
700
+ "errors.PRICE_SET_IN_PRICE_BOOKS": "Ceny ustala się w cennikach, a nie w produkcie."
677
701
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@endora-commerce/mod-catalog",
3
- "version": "0.107.0",
3
+ "version": "0.108.0",
4
4
  "type": "module",
5
5
  "sideEffects": false,
6
6
  "description": "Products, variants, categories, attributes, attribute sets, gallery, attachments, links, and bundles.",
@@ -61,10 +61,10 @@
61
61
  "react": "^19",
62
62
  "react-router-dom": "^7",
63
63
  "zod": "^4",
64
- "@endora-commerce/admin-kit": "0.107.0",
65
- "@endora-commerce/contracts": "0.107.0",
66
- "@endora-commerce/mod-custom-fields": "0.107.0",
67
- "@endora-commerce/platform": "0.107.0"
64
+ "@endora-commerce/admin-kit": "0.108.0",
65
+ "@endora-commerce/contracts": "0.108.0",
66
+ "@endora-commerce/mod-custom-fields": "0.108.0",
67
+ "@endora-commerce/platform": "0.108.0"
68
68
  },
69
69
  "peerDependenciesMeta": {
70
70
  "@endora-commerce/admin-kit": {
@@ -95,10 +95,10 @@
95
95
  "typescript": "^5.9.3",
96
96
  "vitest": "^4.1.11",
97
97
  "zod": "^4.2.0",
98
- "@endora-commerce/admin-kit": "0.107.0",
99
- "@endora-commerce/contracts": "0.107.0",
100
- "@endora-commerce/mod-custom-fields": "0.107.0",
101
- "@endora-commerce/platform": "0.107.0"
98
+ "@endora-commerce/admin-kit": "0.108.0",
99
+ "@endora-commerce/contracts": "0.108.0",
100
+ "@endora-commerce/mod-custom-fields": "0.108.0",
101
+ "@endora-commerce/platform": "0.108.0"
102
102
  },
103
103
  "scripts": {
104
104
  "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.ui.json",