@floristcloud/api-lib 1.2.140 → 1.2.141

package/build/commands/order-product/group/price-correction-analyze.command.js

@@ -9,10 +9,24 @@ const PriceCorrectionAnalyzeRequestSchema = zod_1.z
     .object({
     productUUIDList: zod_1.z.array(zod_1.z.string().uuid()).optional(),
     consignmentUUID: zod_1.z.string().uuid().optional(),
+    /**
+     * Режим цены — обязателен и без умолчания, как в execute.
+     *
+     * Раньше analyze этого поля не знал и считал `onlyChanged` по OR обоих режимов: строка
+     * попадала в выдачу, если разошлась цена со скидкой ИЛИ без. На клиенте с фиксированной
+     * скидкой это выносило в предпросмотр каждую его позицию — цена строки законно ниже
+     * каталожной ровно на скидку, и «без скидок» это выглядит расхождением. Execute при этом
+     * считает предикат в выбранном режиме, то есть предпросмотр и применение расходились на
+     * целую партию.
+     */
+    withDiscount: zod_1.z.boolean(),
     // Поставка на сотни товаров даёт десятки тысяч позиций, из которых после правки прайса
     // меняются единицы. По умолчанию отдаём только те, где цена реально расходится; полный
     // список — режим «показать всё».
     onlyChanged: zod_1.z.boolean().optional().default(true),
+    // Позиции, которые применить нельзя (статус заказа, заказ в передаточном документе).
+    // `true` — скрыть их из выдачи; сколько их всего, видно по `skippedTotal`.
+    excludeSkipped: zod_1.z.boolean().optional().default(false),
     // Страница обязательна по смыслу, а не по схеме: строк здесь товары × заказы, то есть
     // десятки тысяч на партию, и безлимитная выдача кладёт запрос независимо от того, сколько
     // из неё нарисует таблица. Усечение при этом урезает только предпросмотр — execute в
@@ -33,8 +47,20 @@ const PriceCorrectionAnalyzeResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),
     data: zod_1.z.object({
         items: zod_1.z.array(schemas_1.PriceCorrectionAnalyzeItemSchema),
-        // Сколько строк во всём наборе после фильтра `onlyChanged`, а не на странице.
+        /**
+         * Размер выдачи, а не страницы: по нему листают. Учитывает ВСЕ фильтры запроса, включая
+         * `excludeSkipped`.
+         */
         total: zod_1.z.number(),
+        /**
+         * Сколько строк набора применить нельзя — статус заказа или заказ в передаточном документе.
+         *
+         * Считается по набору после `onlyChanged`, но ДО `excludeSkipped`: иначе при скрытых
+         * непроходных строках это всегда был бы ноль и шапку «столько-то не пройдёт» стало бы не из
+         * чего собрать. Отсюда: применимых строк — `total` при `excludeSkipped: true` и
+         * `total − skippedTotal` при `false`.
+         */
+        skippedTotal: zod_1.z.number(),
     }),
 });
 var PriceCorrectionAnalyzeContractCommand;

package/build/commands/order-product/group/price-correction-execute.command.js

@@ -42,7 +42,17 @@ const PriceCorrectionExecuteResponseSchema = zod_1.z.object({
         // равно перезапрашивает analyze, чтобы обновить таблицу.
         results: zod_1.z.array(schemas_1.PriceCorrectionExecuteResultItemSchema),
         orders: zod_1.z.array(schemas_1.PriceCorrectionExecuteOrderItemSchema),
+        /**
+         * «Строк в нужной цене после прогона», а не «строк изменено».
+         *
+         * Применение сходящееся: позиция, уже стоящая в нужной цене, — успех, а не отказ, поэтому
+         * повтор запроса и ретрай после таймаута безопасны и дают тот же ответ. Из-за этого при
+         * `onlyChanged: false` в счётчик попадают и нетронутые позиции. При `onlyChanged: true`
+         * таких строк здесь не будет: они отсеиваются до обработки и в счётчики не идут вовсе.
+         */
         successCount: zod_1.z.number(),
+        // Строки, которые прогон не применил: статус заказа, заказ в передаточном документе, отказ
+        // применения. Каждая из них есть в `results` — с точностью до потолка (см. `isTruncated`).
         skippedCount: zod_1.z.number(),
         // `results` в scope-форме обрезан по лимиту. Полные числа — в счётчиках и в `orders`.
         isTruncated: zod_1.z.boolean(),

package/commands/order-product/group/price-correction-analyze.command.ts

@@ -8,11 +8,28 @@ const PriceCorrectionAnalyzeRequestSchema = z
     .object({
         productUUIDList: z.array(z.string().uuid()).optional(),
         consignmentUUID: z.string().uuid().optional(),
+
+        /**
+         * Режим цены — обязателен и без умолчания, как в execute.
+         *
+         * Раньше analyze этого поля не знал и считал `onlyChanged` по OR обоих режимов: строка
+         * попадала в выдачу, если разошлась цена со скидкой ИЛИ без. На клиенте с фиксированной
+         * скидкой это выносило в предпросмотр каждую его позицию — цена строки законно ниже
+         * каталожной ровно на скидку, и «без скидок» это выглядит расхождением. Execute при этом
+         * считает предикат в выбранном режиме, то есть предпросмотр и применение расходились на
+         * целую партию.
+         */
+        withDiscount: z.boolean(),
+
         // Поставка на сотни товаров даёт десятки тысяч позиций, из которых после правки прайса
         // меняются единицы. По умолчанию отдаём только те, где цена реально расходится; полный
         // список — режим «показать всё».
         onlyChanged: z.boolean().optional().default(true),
 
+        // Позиции, которые применить нельзя (статус заказа, заказ в передаточном документе).
+        // `true` — скрыть их из выдачи; сколько их всего, видно по `skippedTotal`.
+        excludeSkipped: z.boolean().optional().default(false),
+
         // Страница обязательна по смыслу, а не по схеме: строк здесь товары × заказы, то есть
         // десятки тысяч на партию, и безлимитная выдача кладёт запрос независимо от того, сколько
         // из неё нарисует таблица. Усечение при этом урезает только предпросмотр — execute в
@@ -34,8 +51,22 @@ const PriceCorrectionAnalyzeResponseSchema = z.object({
     message: z.string().optional(),
     data: z.object({
         items: z.array(PriceCorrectionAnalyzeItemSchema),
-        // Сколько строк во всём наборе после фильтра `onlyChanged`, а не на странице.
+
+        /**
+         * Размер выдачи, а не страницы: по нему листают. Учитывает ВСЕ фильтры запроса, включая
+         * `excludeSkipped`.
+         */
         total: z.number(),
+
+        /**
+         * Сколько строк набора применить нельзя — статус заказа или заказ в передаточном документе.
+         *
+         * Считается по набору после `onlyChanged`, но ДО `excludeSkipped`: иначе при скрытых
+         * непроходных строках это всегда был бы ноль и шапку «столько-то не пройдёт» стало бы не из
+         * чего собрать. Отсюда: применимых строк — `total` при `excludeSkipped: true` и
+         * `total − skippedTotal` при `false`.
+         */
+        skippedTotal: z.number(),
     }),
 });
 

package/commands/order-product/group/price-correction-execute.command.ts

@@ -47,7 +47,19 @@ const PriceCorrectionExecuteResponseSchema = z.object({
         // равно перезапрашивает analyze, чтобы обновить таблицу.
         results: z.array(PriceCorrectionExecuteResultItemSchema),
         orders: z.array(PriceCorrectionExecuteOrderItemSchema),
+
+        /**
+         * «Строк в нужной цене после прогона», а не «строк изменено».
+         *
+         * Применение сходящееся: позиция, уже стоящая в нужной цене, — успех, а не отказ, поэтому
+         * повтор запроса и ретрай после таймаута безопасны и дают тот же ответ. Из-за этого при
+         * `onlyChanged: false` в счётчик попадают и нетронутые позиции. При `onlyChanged: true`
+         * таких строк здесь не будет: они отсеиваются до обработки и в счётчики не идут вовсе.
+         */
         successCount: z.number(),
+
+        // Строки, которые прогон не применил: статус заказа, заказ в передаточном документе, отказ
+        // применения. Каждая из них есть в `results` — с точностью до потолка (см. `isTruncated`).
         skippedCount: z.number(),
         // `results` в scope-форме обрезан по лимиту. Полные числа — в счётчиках и в `orders`.
         isTruncated: z.boolean(),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@floristcloud/api-lib",
-    "version": "1.2.140",
+    "version": "1.2.141",
     "description": "",
     "main": "./build/index.js",
     "scripts": {