@floristcloud/api-lib 1.2.155 → 1.2.157

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

@@ -14,6 +14,10 @@ const CreateOrderRequestSchema = zod_1.z.object({
     comment: zod_1.z.string().nullable(),
     clientComment: zod_1.z.string().nullable(),
     tag: zod_1.z.string().nullable(),
+    externalNumber: schemas_1.OrderExternalNumberRequestSchema,
+    // Дата отгрузки/выдачи — одна для самовывоза и доставки. Приоритет над устаревшим
+    // `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

@@ -13,12 +13,16 @@ const UpdateOrderRequestSchema = zod_1.z.object({
     comment: zod_1.z.string().nullable(),
     clientComment: zod_1.z.string().nullable(),
     tag: zod_1.z.string().nullable(),
+    externalNumber: schemas_1.OrderExternalNumberRequestSchema,
     status: zod_1.z.nativeEnum(enum_1.OrderStatusEnum),
     isPaid: zod_1.z.coerce.boolean(),
     deliveryVat: zod_1.z.coerce.number().nullable(),
     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-i18n-key.js

@@ -12,6 +12,7 @@ exports.ErrorI18nKey = {
     mergeOrderHasDistribution: 'mergeOrder.hasDistribution',
     mergeOrderHasPaymentInvoice: 'mergeOrder.hasPaymentInvoice',
     mergeOrderHasTransferDocument: 'mergeOrder.hasTransferDocument',
+    mergeOrderSourceHasExternalNumber: 'mergeOrder.sourceHasExternalNumber',
     mergeOrderPaymentsTransfer: 'mergeOrder.paymentsTransfer',
     mergeOrderDeliveryMerge: 'mergeOrder.deliveryMerge',
     mergeOrderDeliveryTransfer: 'mergeOrder.deliveryTransfer',

package/build/constant/error.js

@@ -414,6 +414,12 @@ exports.ERRORS = {
         message: 'The order is included in a transfer document and cannot be changed or deleted',
         httpCode: 409,
     },
+    // В data — номер заказа, за которым номер уже закреплён: UI пишет «привязан к заказу №…».
+    ORDER_EXTERNAL_NUMBER_TAKEN: {
+        code: 'O063',
+        message: 'The external number is already assigned to another order',
+        httpCode: 409,
+    },
     ORDER_SPLIT_NOT_COMPLETELY_ERROR: { code: 'O019', message: 'Error splitting orders, not all orders were split', httpCode: 500 },
     ORDER_TOTAL_COST_NEGATIVE: { code: 'O020', message: 'Order total cost is negative', httpCode: 400 },
     ORDER_SUBTOTAL_NEGATIVE: { code: 'O021', message: 'Order subtotal is negative', httpCode: 400 },
@@ -429,6 +435,16 @@ 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 },
+    // Источник объединения удаляется, и его связь с документом ERP пропала бы молча.
+    ORDER_MERGE_SOURCE_HAS_EXTERNAL_NUMBER: { code: 'O064', message: 'Source order has an external number', httpCode: 400 },
     ORDER_MERGE_BALANCE_STATUS_NOT_ALLOWED: {
         code: 'O033',
         message: 'Order status is balance affecting, merge not allowed',

package/build/constant/index.js

@@ -30,3 +30,4 @@ __exportStar(require("./attribute-normalization.constant"), exports);
 __exportStar(require("./product-image-merge.constant"), exports);
 __exportStar(require("./client-group-actions.constant"), exports);
 __exportStar(require("./standing-order-positions.constant"), exports);
+__exportStar(require("./order-external-number.constant"), exports);

package/build/constant/order-external-number.constant.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ORDER_EXTERNAL_NUMBER_MAX_LENGTH = void 0;
+// Номера документов ERP/CRM короткие («ЗК-00123», GUID в 36 символов), 100 — с запасом. Колонка
+// TEXT длину не держит, поэтому граница — только схема запроса.
+exports.ORDER_EXTERNAL_NUMBER_MAX_LENGTH = 100;

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

@@ -20,4 +20,6 @@ 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["EXTERNAL_NUMBER"] = "EXTERNAL_NUMBER";
 })(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

@@ -33,6 +33,7 @@ __exportStar(require("./write-off/write-off-list.schema"), exports);
 __exportStar(require("./write-off/write-off-archive-file.schema"), exports);
 __exportStar(require("./write-off/write-off-export.schema"), exports);
 __exportStar(require("./order/order.schema"), exports);
+__exportStar(require("./order/order-external-number.schema"), exports);
 __exportStar(require("./order-delivery/order-delivery.schema"), exports);
 __exportStar(require("./order-product/order-product.schema"), exports);
 __exportStar(require("./order-product/order-product-list.schema"), exports);
@@ -106,6 +107,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-external-number.schema.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderExternalNumberRequestSchema = void 0;
+const zod_1 = require("zod");
+const order_external_number_constant_1 = require("../../constant/order-external-number.constant");
+// Номер заказа в ERP/CRM компании на входе create/update. Поле не пришло — номер не меняется;
+// null или строка из пробелов — номер снимается (пустую строку сервер сохраняет как null, иначе
+// вторая пустая строка упрётся в уникальность номера в пределах компании).
+exports.OrderExternalNumberRequestSchema = zod_1.z.string().trim().max(order_external_number_constant_1.ORDER_EXTERNAL_NUMBER_MAX_LENGTH).nullable().optional();

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(),
@@ -40,19 +41,25 @@ exports.OrderSchema = zod_1.z.object({
     // ссылка, документ читается через GET /transfer-document/:uuid. Непустое значение означает, что
     // заказ заморожен — состав, статус, доставка, дата отгрузки и скидка ему уже недоступны.
     transferDocumentUUID: zod_1.z.uuid().nullable(),
+    // Номер заказа в ERP/CRM компании, которым сотрудники сверяют заказ со своей учётной системой.
+    externalNumber: zod_1.z.string().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(),
 });
 // Витрина клиента не показывает внутреннюю кухню документов, поэтому ссылки на счёт и на УПД
-// сюда не попадают.
+// сюда не попадают. Номер в ERP компании — тоже её внутренний учёт.
 exports.OrderForClientSchema = exports.OrderSchema.omit({
     comment: true,
     tag: true,
     paymentInvoiceUUID: true,
     transferDocumentUUID: true,
+    externalNumber: true,
 });
 exports.OrderExtendedSchema = exports.OrderSchema.extend({
     client: client_1.ClientSchema,

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, OrderExternalNumberRequestSchema, OrderSchema } from '../../schemas';
 import { MoneySchema } from '../../schemas/money.schema';
 
 const CreateOrderRequestSchema = z.object({
@@ -12,6 +12,10 @@ const CreateOrderRequestSchema = z.object({
     comment: z.string().nullable(),
     clientComment: z.string().nullable(),
     tag: z.string().nullable(),
+    externalNumber: OrderExternalNumberRequestSchema,
+    // Дата отгрузки/выдачи — одна для самовывоза и доставки. Приоритет над устаревшим
+    // `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, OrderExternalNumberRequestSchema, OrderSchema } from '../../schemas';
 import { MoneySchema } from '../../schemas/money.schema';
 
 const UpdateOrderRequestSchema = z.object({
@@ -11,12 +11,16 @@ const UpdateOrderRequestSchema = z.object({
     comment: z.string().nullable(),
     clientComment: z.string().nullable(),
     tag: z.string().nullable(),
+    externalNumber: OrderExternalNumberRequestSchema,
     status: z.nativeEnum(OrderStatusEnum),
     isPaid: z.coerce.boolean(),
     deliveryVat: z.coerce.number().nullable(),
     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-i18n-key.ts

@@ -9,6 +9,7 @@ export const ErrorI18nKey = {
     mergeOrderHasDistribution: 'mergeOrder.hasDistribution',
     mergeOrderHasPaymentInvoice: 'mergeOrder.hasPaymentInvoice',
     mergeOrderHasTransferDocument: 'mergeOrder.hasTransferDocument',
+    mergeOrderSourceHasExternalNumber: 'mergeOrder.sourceHasExternalNumber',
     mergeOrderPaymentsTransfer: 'mergeOrder.paymentsTransfer',
     mergeOrderDeliveryMerge: 'mergeOrder.deliveryMerge',
     mergeOrderDeliveryTransfer: 'mergeOrder.deliveryTransfer',

package/constant/error.ts

@@ -428,6 +428,12 @@ export const ERRORS = {
         message: 'The order is included in a transfer document and cannot be changed or deleted',
         httpCode: 409,
     },
+    // В data — номер заказа, за которым номер уже закреплён: UI пишет «привязан к заказу №…».
+    ORDER_EXTERNAL_NUMBER_TAKEN: {
+        code: 'O063',
+        message: 'The external number is already assigned to another order',
+        httpCode: 409,
+    },
     ORDER_SPLIT_NOT_COMPLETELY_ERROR: { code: 'O019', message: 'Error splitting orders, not all orders were split', httpCode: 500 },
     ORDER_TOTAL_COST_NEGATIVE: { code: 'O020', message: 'Order total cost is negative', httpCode: 400 },
     ORDER_SUBTOTAL_NEGATIVE: { code: 'O021', message: 'Order subtotal is negative', httpCode: 400 },
@@ -443,6 +449,16 @@ 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 },
+    // Источник объединения удаляется, и его связь с документом ERP пропала бы молча.
+    ORDER_MERGE_SOURCE_HAS_EXTERNAL_NUMBER: { code: 'O064', message: 'Source order has an external number', httpCode: 400 },
     ORDER_MERGE_BALANCE_STATUS_NOT_ALLOWED: {
         code: 'O033',
         message: 'Order status is balance affecting, merge not allowed',

package/constant/index.ts

@@ -14,3 +14,4 @@ export * from './attribute-normalization.constant';
 export * from './product-image-merge.constant';
 export * from './client-group-actions.constant';
 export * from './standing-order-positions.constant';
+export * from './order-external-number.constant';

package/constant/order-external-number.constant.ts

@@ -0,0 +1,3 @@
+// Номера документов ERP/CRM короткие («ЗК-00123», GUID в 36 символов), 100 — с запасом. Колонка
+// TEXT длину не держит, поэтому граница — только схема запроса.
+export const ORDER_EXTERNAL_NUMBER_MAX_LENGTH = 100;

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@floristcloud/api-lib",
-    "version": "1.2.155",
+    "version": "1.2.157",
     "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

@@ -17,6 +17,7 @@ export * from './write-off/write-off-list.schema';
 export * from './write-off/write-off-archive-file.schema';
 export * from './write-off/write-off-export.schema';
 export * from './order/order.schema';
+export * from './order/order-external-number.schema';
 export * from './order-delivery/order-delivery.schema';
 export * from './order-product/order-product.schema';
 export * from './order-product/order-product-list.schema';
@@ -90,6 +91,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-external-number.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { ORDER_EXTERNAL_NUMBER_MAX_LENGTH } from '../../constant/order-external-number.constant';
+
+// Номер заказа в ERP/CRM компании на входе create/update. Поле не пришло — номер не меняется;
+// null или строка из пробелов — номер снимается (пустую строку сервер сохраняет как null, иначе
+// вторая пустая строка упрётся в уникальность номера в пределах компании).
+export const OrderExternalNumberRequestSchema = z.string().trim().max(ORDER_EXTERNAL_NUMBER_MAX_LENGTH).nullable().optional();

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(),
@@ -42,9 +43,14 @@ export const OrderSchema = z.object({
     // ссылка, документ читается через GET /transfer-document/:uuid. Непустое значение означает, что
     // заказ заморожен — состав, статус, доставка, дата отгрузки и скидка ему уже недоступны.
     transferDocumentUUID: z.uuid().nullable(),
+    // Номер заказа в ERP/CRM компании, которым сотрудники сверяют заказ со своей учётной системой.
+    externalNumber: z.string().nullable(),
 
     completedAt: z.date().nullable(),
     paymentDueAt: z.date().nullable(),
+    // План отгрузки/выдачи — одна дата для самовывоза и доставки, календарный день `YYYY-MM-DD`.
+    // Не путать с `completedAt` (факт отгрузки) и датой прихода партии.
+    plannedShipmentDate: CalendarDaySchema.nullable(),
 
     createdAt: z.date(),
     updatedAt: z.date(),
@@ -52,12 +58,13 @@ export const OrderSchema = z.object({
 });
 
 // Витрина клиента не показывает внутреннюю кухню документов, поэтому ссылки на счёт и на УПД
-// сюда не попадают.
+// сюда не попадают. Номер в ERP компании — тоже её внутренний учёт.
 export const OrderForClientSchema = OrderSchema.omit({
     comment: true,
     tag: true,
     paymentInvoiceUUID: true,
     transferDocumentUUID: true,
+    externalNumber: true,
 });
 
 export const OrderExtendedSchema = OrderSchema.extend({

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(),