@floristcloud/api-lib 1.2.155 → 1.2.156

package/build/commands/order/create-order.command.js

@@ -14,6 +14,9 @@ const CreateOrderRequestSchema = zod_1.z.object({
     comment: zod_1.z.string().nullable(),
     clientComment: zod_1.z.string().nullable(),
     tag: zod_1.z.string().nullable(),
+    // Дата отгрузки/выдачи — одна для самовывоза и доставки. Приоритет над устаревшим
+    // `delivery.deliveryDate`.
+    plannedShipmentDate: schemas_1.CalendarDaySchema.nullable().optional(),
     delivery: schemas_1.OrderDeliverySchema.omit({ uuid: true }).nullable(),
 });
 const CreateOrderResponseSchema = zod_1.z.object({

package/build/commands/order/get-order-list.query.js

@@ -24,8 +24,8 @@ const GetOrderListRequestSchema = zod_1.z
      * ссылок и MCP-клиентов: трактуется как период из одного дня (from = to = deliveryDate).
      */
     deliveryDate: zod_1.z.coerce.date().optional(),
-    // Календарные даты, а не моменты: сутки разворачиваются на бэке по таймзоне компании
-    // (`resolveLocalDayPeriod`), поэтому здесь достаточно дня, закодированного полночью UTC.
+    // Период даты отгрузки/выдачи заказа (`plannedShipmentDate`) — и доставка, и самовывоз; имена
+    // остались от фильтра по дате доставки. Календарные дни `YYYY-MM-DD`, обе границы включительно.
     deliveryDateFrom: zod_1.z.coerce.date().optional(),
     deliveryDateTo: zod_1.z.coerce.date().optional(),
     byProductSearchQuery: zod_1.z.string().optional(),

package/build/commands/order/group/pin-group-order-planned-shipment-date.command.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PinGroupOrderPlannedShipmentDateContractCommand = void 0;
+const zod_1 = require("zod");
+// Подтянуть дату отгрузки/выдачи выбранных заказов к приходу товара в пути — например, после того как
+// сдвинули дату прихода задержавшейся партии. Заказы целиком в наличии не меняются.
+const PinGroupOrderPlannedShipmentDateRequestSchema = zod_1.z.object({
+    orderUUIDList: zod_1.z.array(zod_1.z.uuid()).min(1),
+});
+const PinGroupOrderPlannedShipmentDateResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        // Сколько заказов получили новую дату.
+        updatedCount: zod_1.z.number(),
+    }),
+});
+var PinGroupOrderPlannedShipmentDateContractCommand;
+(function (PinGroupOrderPlannedShipmentDateContractCommand) {
+    PinGroupOrderPlannedShipmentDateContractCommand.RequestSchema = PinGroupOrderPlannedShipmentDateRequestSchema;
+    PinGroupOrderPlannedShipmentDateContractCommand.ResponseSchema = PinGroupOrderPlannedShipmentDateResponseSchema;
+})(PinGroupOrderPlannedShipmentDateContractCommand || (exports.PinGroupOrderPlannedShipmentDateContractCommand = PinGroupOrderPlannedShipmentDateContractCommand = {}));

package/build/commands/order/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./group/split-group-order.command"), exports);
 __exportStar(require("./group/merge-orders.command"), exports);
 __exportStar(require("./group/get-group-order-invoice-info.query"), exports);
 __exportStar(require("./group/send-group-order-invoice.command"), exports);
+__exportStar(require("./group/pin-group-order-planned-shipment-date.command"), exports);
 //webshop
 __exportStar(require("./webshop/get-order-for-client.query"), exports);
 __exportStar(require("./webshop/create-cart.command"), exports);

package/build/commands/order/update-order.command.js

@@ -19,6 +19,9 @@ const UpdateOrderRequestSchema = zod_1.z.object({
     deliveryVatAmount: money_schema_1.MoneySchema,
     completedAt: zod_1.z.coerce.date().nullable().optional(),
     paymentDueAt: zod_1.z.coerce.date().nullable().optional(),
+    // Дата отгрузки/выдачи — одна для самовывоза и доставки. Не раньше прихода товара в пути
+    // (O061, в errorData — самый ранний день). Не передано — не меняется, null — снять.
+    plannedShipmentDate: schemas_1.CalendarDaySchema.nullable().optional(),
 });
 const UpdateOrderResponseSchema = zod_1.z.object({
     message: zod_1.z.string().optional(),

package/build/commands/order/webshop/update-cart.command.js

@@ -6,8 +6,13 @@ const schemas_1 = require("../../../schemas");
 const UpdateCartRequestSchema = zod_1.z.object({
     clientComment: zod_1.z.string().nullable().optional().default(null),
     branchUUID: zod_1.z.uuid().optional().nullable().default(null),
+    // Дата выдачи/доставки заказа — одна для самовывоза и доставки. Относится к товару в наличии:
+    // заказы с товаром в пути после оформления получают дату прихода. Имеет приоритет над
+    // устаревшим `delivery.deliveryDate`.
+    plannedShipmentDate: schemas_1.CalendarDaySchema.nullable().optional(),
     delivery: zod_1.z
         .object({
+        /** @deprecated Используйте `plannedShipmentDate` — единую дату для самовывоза и доставки. */
         deliveryDate: zod_1.z.coerce.date().optional().nullable().default(null),
         address: zod_1.z.string().nullable().optional().default(null),
         time: zod_1.z.string().nullable().optional().default(null),

package/build/constant/error.js

@@ -429,6 +429,14 @@ exports.ERRORS = {
     ORDER_MERGE_HAS_DISTRIBUTION: { code: 'O032', message: 'Order has products with distribution', httpCode: 400 },
     ORDER_MERGE_HAS_PAYMENT_INVOICE: { code: 'O040', message: 'Order is included in a payment invoice', httpCode: 400 },
     ORDER_MERGE_HAS_TRANSFER_DOCUMENT: { code: 'O060', message: 'Order is included in a transfer document', httpCode: 400 },
+    // Дата отгрузки/выдачи раньше прихода товара на склад. В errorData — самый ранний допустимый день
+    // (`YYYY-MM-DD`), чтобы UI мог его подсказать, а не отправлял угадывать.
+    ORDER_PLANNED_SHIPMENT_DATE_BEFORE_ARRIVAL: {
+        code: 'O061',
+        message: 'Planned shipment date cannot be earlier than the arrival of the goods',
+        httpCode: 400,
+    },
+    ORDER_PLANNED_SHIPMENT_DATE_NOT_UPDATED: { code: 'O062', message: 'Failed to update order planned shipment date', httpCode: 500 },
     ORDER_MERGE_BALANCE_STATUS_NOT_ALLOWED: {
         code: 'O033',
         message: 'Order status is balance affecting, merge not allowed',

package/build/enum/order-updated-field.enum.js

@@ -20,4 +20,5 @@ var OrderUpdatedFieldEnum;
     OrderUpdatedFieldEnum["IS_PAID"] = "IS_PAID";
     OrderUpdatedFieldEnum["COMPLETED_AT"] = "COMPLETED_AT";
     OrderUpdatedFieldEnum["PAYMENT_DUE_AT"] = "PAYMENT_DUE_AT";
+    OrderUpdatedFieldEnum["PLANNED_SHIPMENT_DATE"] = "PLANNED_SHIPMENT_DATE";
 })(OrderUpdatedFieldEnum || (exports.OrderUpdatedFieldEnum = OrderUpdatedFieldEnum = {}));

package/build/schemas/calendar-day.schema.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarDaySchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Единственное описание календарного дня в контрактах — даты без времени и таймзоны.
+ *
+ * День пересекает границу строкой `YYYY-MM-DD` в обе стороны. Не `Date` и не ISO-момент: момент
+ * требует таймзоны, чтобы из него вернуть день, а у клиента (браузер, устройство) она своя и
+ * с таймзоной компании не обязана совпадать — `2026-09-24T21:00:00Z` это 25-е в Москве и 24-е в
+ * Лондоне. Строка дня однозначна везде.
+ *
+ * Сервер хранит такие поля колонкой `DATE`; в JS они живут как полночь UTC, читать и писать их —
+ * только через `calendar-day.helper.ts` на бэке.
+ *
+ * Модификаторы `.optional()` и `.nullable()` работают напрямую.
+ */
+exports.CalendarDaySchema = zod_1.z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/)
+    .refine(isExistingCalendarDay, { message: 'Invalid calendar day' });
+// Регэксп пропускает `2026-02-30`: такой день парсер либо отвергает, либо переносит на март —
+// в обоих случаях строка обратно не совпадёт.
+function isExistingCalendarDay(value) {
+    const date = new Date(`${value}T00:00:00.000Z`);
+    return !Number.isNaN(date.getTime()) && date.toISOString().startsWith(value);
+}

package/build/schemas/index.js

@@ -106,6 +106,7 @@ __exportStar(require("./account-deletion-request/account-deletion-request.schema
 __exportStar(require("./consignment-transfer"), exports);
 __exportStar(require("./api-error.schema"), exports);
 __exportStar(require("./access-policy"), exports);
+__exportStar(require("./calendar-day.schema"), exports);
 __exportStar(require("./money.schema"), exports);
 __exportStar(require("./non-negative-money.schema"), exports);
 __exportStar(require("./positive-money.schema"), exports);

package/build/schemas/order/order.schema.js

@@ -8,6 +8,7 @@ const branch_schema_1 = require("../branch/branch.schema");
 const order_delivery_schema_1 = require("../order-delivery/order-delivery.schema");
 const delivery_route_schema_1 = require("../delivery-route/delivery-route.schema");
 const money_schema_1 = require("../money.schema");
+const calendar_day_schema_1 = require("../calendar-day.schema");
 exports.OrderSchema = zod_1.z.object({
     uuid: zod_1.z.uuid(),
     orderNumber: zod_1.z.number(),
@@ -42,6 +43,9 @@ exports.OrderSchema = zod_1.z.object({
     transferDocumentUUID: zod_1.z.uuid().nullable(),
     completedAt: zod_1.z.date().nullable(),
     paymentDueAt: zod_1.z.date().nullable(),
+    // План отгрузки/выдачи — одна дата для самовывоза и доставки, календарный день `YYYY-MM-DD`.
+    // Не путать с `completedAt` (факт отгрузки) и датой прихода партии.
+    plannedShipmentDate: calendar_day_schema_1.CalendarDaySchema.nullable(),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
     deletedAt: zod_1.z.date().nullable(),

package/build/schemas/order-delivery/order-delivery.schema.js

@@ -6,6 +6,11 @@ const enum_1 = require("../../enum");
 exports.OrderDeliverySchema = zod_1.z.object({
     uuid: zod_1.z.uuid(),
     city: zod_1.z.string().nullable(),
+    /**
+     * @deprecated Дата доставки живёт в заказе: `Order.plannedShipmentDate` (`YYYY-MM-DD`) — одна для
+     * самовывоза и доставки. Поле принимается и отдаётся ради совместимости: запись перекладывается
+     * в заказ, чтение возвращает дату заказа.
+     */
     deliveryDate: zod_1.z.coerce.date().nullable(),
     address: zod_1.z.string().nullable(),
     time: zod_1.z.string().nullable(),

package/commands/order/create-order.command.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { OrderTypeEnum } from '../../enum';
-import { OrderDeliverySchema, OrderSchema } from '../../schemas';
+import { CalendarDaySchema, OrderDeliverySchema, OrderSchema } from '../../schemas';
 import { MoneySchema } from '../../schemas/money.schema';
 
 const CreateOrderRequestSchema = z.object({
@@ -12,6 +12,9 @@ const CreateOrderRequestSchema = z.object({
     comment: z.string().nullable(),
     clientComment: z.string().nullable(),
     tag: z.string().nullable(),
+    // Дата отгрузки/выдачи — одна для самовывоза и доставки. Приоритет над устаревшим
+    // `delivery.deliveryDate`.
+    plannedShipmentDate: CalendarDaySchema.nullable().optional(),
     delivery: OrderDeliverySchema.omit({ uuid: true }).nullable(),
 });
 

package/commands/order/get-order-list.query.ts

@@ -22,8 +22,8 @@ const GetOrderListRequestSchema = z
          * ссылок и MCP-клиентов: трактуется как период из одного дня (from = to = deliveryDate).
          */
         deliveryDate: z.coerce.date().optional(),
-        // Календарные даты, а не моменты: сутки разворачиваются на бэке по таймзоне компании
-        // (`resolveLocalDayPeriod`), поэтому здесь достаточно дня, закодированного полночью UTC.
+        // Период даты отгрузки/выдачи заказа (`plannedShipmentDate`) — и доставка, и самовывоз; имена
+        // остались от фильтра по дате доставки. Календарные дни `YYYY-MM-DD`, обе границы включительно.
         deliveryDateFrom: z.coerce.date().optional(),
         deliveryDateTo: z.coerce.date().optional(),
         byProductSearchQuery: z.string().optional(),

package/commands/order/group/pin-group-order-planned-shipment-date.command.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+
+// Подтянуть дату отгрузки/выдачи выбранных заказов к приходу товара в пути — например, после того как
+// сдвинули дату прихода задержавшейся партии. Заказы целиком в наличии не меняются.
+const PinGroupOrderPlannedShipmentDateRequestSchema = z.object({
+    orderUUIDList: z.array(z.uuid()).min(1),
+});
+
+const PinGroupOrderPlannedShipmentDateResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.object({
+        // Сколько заказов получили новую дату.
+        updatedCount: z.number(),
+    }),
+});
+
+export namespace PinGroupOrderPlannedShipmentDateContractCommand {
+    export const RequestSchema = PinGroupOrderPlannedShipmentDateRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = PinGroupOrderPlannedShipmentDateResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/order/index.ts

@@ -18,6 +18,7 @@ export * from './group/split-group-order.command';
 export * from './group/merge-orders.command';
 export * from './group/get-group-order-invoice-info.query';
 export * from './group/send-group-order-invoice.command';
+export * from './group/pin-group-order-planned-shipment-date.command';
 //webshop
 export * from './webshop/get-order-for-client.query';
 export * from './webshop/create-cart.command';

package/commands/order/update-order.command.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { OrderStatusEnum, OrderTypeEnum } from '../../enum';
-import { OrderSchema } from '../../schemas';
+import { CalendarDaySchema, OrderSchema } from '../../schemas';
 import { MoneySchema } from '../../schemas/money.schema';
 
 const UpdateOrderRequestSchema = z.object({
@@ -17,6 +17,9 @@ const UpdateOrderRequestSchema = z.object({
     deliveryVatAmount: MoneySchema,
     completedAt: z.coerce.date().nullable().optional(),
     paymentDueAt: z.coerce.date().nullable().optional(),
+    // Дата отгрузки/выдачи — одна для самовывоза и доставки. Не раньше прихода товара в пути
+    // (O061, в errorData — самый ранний день). Не передано — не меняется, null — снять.
+    plannedShipmentDate: CalendarDaySchema.nullable().optional(),
 });
 
 const UpdateOrderResponseSchema = z.object({

package/commands/order/webshop/update-cart.command.ts

@@ -1,11 +1,16 @@
 import { z } from 'zod';
-import { OrderForClientSchema } from '../../../schemas';
+import { CalendarDaySchema, OrderForClientSchema } from '../../../schemas';
 
 const UpdateCartRequestSchema = z.object({
     clientComment: z.string().nullable().optional().default(null),
     branchUUID: z.uuid().optional().nullable().default(null),
+    // Дата выдачи/доставки заказа — одна для самовывоза и доставки. Относится к товару в наличии:
+    // заказы с товаром в пути после оформления получают дату прихода. Имеет приоритет над
+    // устаревшим `delivery.deliveryDate`.
+    plannedShipmentDate: CalendarDaySchema.nullable().optional(),
     delivery: z
         .object({
+            /** @deprecated Используйте `plannedShipmentDate` — единую дату для самовывоза и доставки. */
             deliveryDate: z.coerce.date().optional().nullable().default(null),
             address: z.string().nullable().optional().default(null),
             time: z.string().nullable().optional().default(null),

package/constant/error.ts

@@ -443,6 +443,14 @@ export const ERRORS = {
     ORDER_MERGE_HAS_DISTRIBUTION: { code: 'O032', message: 'Order has products with distribution', httpCode: 400 },
     ORDER_MERGE_HAS_PAYMENT_INVOICE: { code: 'O040', message: 'Order is included in a payment invoice', httpCode: 400 },
     ORDER_MERGE_HAS_TRANSFER_DOCUMENT: { code: 'O060', message: 'Order is included in a transfer document', httpCode: 400 },
+    // Дата отгрузки/выдачи раньше прихода товара на склад. В errorData — самый ранний допустимый день
+    // (`YYYY-MM-DD`), чтобы UI мог его подсказать, а не отправлял угадывать.
+    ORDER_PLANNED_SHIPMENT_DATE_BEFORE_ARRIVAL: {
+        code: 'O061',
+        message: 'Planned shipment date cannot be earlier than the arrival of the goods',
+        httpCode: 400,
+    },
+    ORDER_PLANNED_SHIPMENT_DATE_NOT_UPDATED: { code: 'O062', message: 'Failed to update order planned shipment date', httpCode: 500 },
     ORDER_MERGE_BALANCE_STATUS_NOT_ALLOWED: {
         code: 'O033',
         message: 'Order status is balance affecting, merge not allowed',

package/enum/order-updated-field.enum.ts

@@ -16,4 +16,5 @@ export enum OrderUpdatedFieldEnum {
     IS_PAID = 'IS_PAID',
     COMPLETED_AT = 'COMPLETED_AT',
     PAYMENT_DUE_AT = 'PAYMENT_DUE_AT',
+    PLANNED_SHIPMENT_DATE = 'PLANNED_SHIPMENT_DATE',
 }

package/package.json

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

package/schemas/calendar-day.schema.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+
+/**
+ * Единственное описание календарного дня в контрактах — даты без времени и таймзоны.
+ *
+ * День пересекает границу строкой `YYYY-MM-DD` в обе стороны. Не `Date` и не ISO-момент: момент
+ * требует таймзоны, чтобы из него вернуть день, а у клиента (браузер, устройство) она своя и
+ * с таймзоной компании не обязана совпадать — `2026-09-24T21:00:00Z` это 25-е в Москве и 24-е в
+ * Лондоне. Строка дня однозначна везде.
+ *
+ * Сервер хранит такие поля колонкой `DATE`; в JS они живут как полночь UTC, читать и писать их —
+ * только через `calendar-day.helper.ts` на бэке.
+ *
+ * Модификаторы `.optional()` и `.nullable()` работают напрямую.
+ */
+export const CalendarDaySchema = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/)
+    .refine(isExistingCalendarDay, { message: 'Invalid calendar day' });
+
+// Регэксп пропускает `2026-02-30`: такой день парсер либо отвергает, либо переносит на март —
+// в обоих случаях строка обратно не совпадёт.
+function isExistingCalendarDay(value: string): boolean {
+    const date = new Date(`${value}T00:00:00.000Z`);
+    return !Number.isNaN(date.getTime()) && date.toISOString().startsWith(value);
+}

package/schemas/index.ts

@@ -90,6 +90,7 @@ export * from './account-deletion-request/account-deletion-request.schema';
 export * from './consignment-transfer';
 export * from './api-error.schema';
 export * from './access-policy';
+export * from './calendar-day.schema';
 export * from './money.schema';
 export * from './non-negative-money.schema';
 export * from './positive-money.schema';

package/schemas/order/order.schema.ts

@@ -5,6 +5,7 @@ import { BranchSchema } from '../branch/branch.schema';
 import { OrderDeliverySchema } from '../order-delivery/order-delivery.schema';
 import { DeliveryRouteSchema } from '../delivery-route/delivery-route.schema';
 import { MoneySchema } from '../money.schema';
+import { CalendarDaySchema } from '../calendar-day.schema';
 
 export const OrderSchema = z.object({
     uuid: z.uuid(),
@@ -45,6 +46,9 @@ export const OrderSchema = z.object({
 
     completedAt: z.date().nullable(),
     paymentDueAt: z.date().nullable(),
+    // План отгрузки/выдачи — одна дата для самовывоза и доставки, календарный день `YYYY-MM-DD`.
+    // Не путать с `completedAt` (факт отгрузки) и датой прихода партии.
+    plannedShipmentDate: CalendarDaySchema.nullable(),
 
     createdAt: z.date(),
     updatedAt: z.date(),

package/schemas/order-delivery/order-delivery.schema.ts

@@ -4,6 +4,11 @@ import { OrderDeliveryStatusEnum } from '../../enum';
 export const OrderDeliverySchema = z.object({
     uuid: z.uuid(),
     city: z.string().nullable(),
+    /**
+     * @deprecated Дата доставки живёт в заказе: `Order.plannedShipmentDate` (`YYYY-MM-DD`) — одна для
+     * самовывоза и доставки. Поле принимается и отдаётся ради совместимости: запись перекладывается
+     * в заказ, чтение возвращает дату заказа.
+     */
     deliveryDate: z.coerce.date().nullable(),
     address: z.string().nullable(),
     time: z.string().nullable(),