@floristcloud/api-lib 1.2.156 → 1.2.158

package/build/commands/consignment/analyze-consignment-product-update.command.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyzeConsignmentProductUpdateContractCommand = void 0;
+const zod_1 = require("zod");
+const error_message_schema_1 = require("../../schemas/error-message.schema");
+const AnalyzeMatchedRowSchema = zod_1.z.object({
+    uuid: zod_1.z.string(),
+    // Изменения позиции фронт не разбирает, а пересылает как есть в execute: там они и валидируются.
+    updates: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    rowIndex: zod_1.z.number(),
+    originalData: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+});
+const AnalyzeUnmatchedRowSchema = zod_1.z.object({
+    // Индекс от первой строки данных; для показа пользователю — `row`.
+    rowIndex: zod_1.z.number(),
+    // Номер строки в Excel, как его видит пользователь.
+    row: zod_1.z.number(),
+    data: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    // Подробная причина по-английски, для логов и как запасной текст.
+    reason: zod_1.z.string(),
+    // Причина для перевода: `code` из ERRORS и параметры подстановки.
+    error: error_message_schema_1.ErrorMessageSchema,
+});
+const AnalyzeRowErrorSchema = error_message_schema_1.ErrorMessageSchema.extend({
+    row: zod_1.z.number(),
+});
+const AnalyzeConsignmentProductUpdateResponseSchema = zod_1.z.object({
+    data: zod_1.z.object({
+        success: zod_1.z.boolean(),
+        totalRows: zod_1.z.number(),
+        matchedCount: zod_1.z.number(),
+        unmatchedCount: zod_1.z.number(),
+        matched: zod_1.z.array(AnalyzeMatchedRowSchema),
+        unmatched: zod_1.z.array(AnalyzeUnmatchedRowSchema),
+        errors: zod_1.z.array(AnalyzeRowErrorSchema),
+        warnings: zod_1.z.array(AnalyzeRowErrorSchema),
+    }),
+});
+var AnalyzeConsignmentProductUpdateContractCommand;
+(function (AnalyzeConsignmentProductUpdateContractCommand) {
+    AnalyzeConsignmentProductUpdateContractCommand.ResponseSchema = AnalyzeConsignmentProductUpdateResponseSchema;
+})(AnalyzeConsignmentProductUpdateContractCommand || (exports.AnalyzeConsignmentProductUpdateContractCommand = AnalyzeConsignmentProductUpdateContractCommand = {}));

package/build/commands/consignment/index.js

@@ -31,3 +31,4 @@ __exportStar(require("./execute-consignment-product-update.command"), exports);
 __exportStar(require("./determine-consignment-product-images.command"), exports);
 __exportStar(require("./analyze-consignment-product-enrichment.query"), exports);
 __exportStar(require("./execute-consignment-product-enrichment.command"), exports);
+__exportStar(require("./analyze-consignment-product-update.command"), exports);

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

@@ -14,6 +14,7 @@ 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(),

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

@@ -13,6 +13,7 @@ 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(),

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

@@ -262,7 +262,16 @@ exports.ERRORS = {
     CONSIGNMENT_PRODUCT_UPDATE_INVALID_CONFIG: { code: 'CON018', message: 'Invalid config format', httpCode: 400 },
     CONSIGNMENT_PRODUCT_UPDATE_NO_DATA_ROWS: { code: 'CON019', message: 'File has no data rows', httpCode: 400 },
     CONSIGNMENT_PRODUCT_UPDATE_TOO_MANY_ROWS: { code: 'CON020', message: 'Too many rows', httpCode: 400 },
-    CONSIGNMENT_PRODUCT_UPDATE_DUPLICATE_MATCH: { code: 'CON021', message: 'Multiple matches for row, first used', httpCode: 200 },
+    // Причины, по которым строка файла не попала в обновление: `httpCode` 200 — это не ошибка запроса,
+    // а построчный результат анализа. Параметры для перевода — в `i18nParams` у строки.
+    CONSIGNMENT_PRODUCT_UPDATE_UUID_NOT_PROVIDED: { code: 'CON030', message: 'UUID not provided', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_INVALID_CELL: { code: 'CON031', message: 'Invalid cell value', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_UNRECOGNIZED_BOOLEAN_CELL: { code: 'CON032', message: 'Value is not recognized as yes/no', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_CONSIGNMENT_EMPTY: { code: 'CON033', message: 'No products in consignment', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_NO_MATCH_CRITERIA: { code: 'CON034', message: 'No matching criteria filled in the row', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_NO_MATCH: { code: 'CON035', message: 'No product matches the row', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_AMBIGUOUS_MATCH: { code: 'CON036', message: 'Several products match the row', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_ROWS_SHARE_PRODUCT: { code: 'CON037', message: 'Several rows target the same product', httpCode: 200 },
     CONSIGNMENT_PRODUCT_UPDATE_ANALYSIS_FAILED: { code: 'CON022', message: 'Update analysis failed', httpCode: 500 },
     CONSIGNMENT_PRODUCT_UPDATE_BATCH_TOO_LARGE: { code: 'CON023', message: 'Batch size too large', httpCode: 400 },
     CONSIGNMENT_IMPORT_TOO_MANY_ROWS: { code: 'CON024', message: 'Too many rows for this import mode', httpCode: 400 },
@@ -414,6 +423,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 },
@@ -437,6 +452,8 @@ exports.ERRORS = {
         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

@@ -21,4 +21,5 @@ var OrderUpdatedFieldEnum;
     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/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);

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

@@ -41,6 +41,8 @@ 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`.
@@ -51,12 +53,13 @@ exports.OrderSchema = zod_1.z.object({
     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/commands/consignment/analyze-consignment-product-update.command.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { ErrorMessageSchema } from '../../schemas/error-message.schema';
+
+const AnalyzeMatchedRowSchema = z.object({
+    uuid: z.string(),
+    // Изменения позиции фронт не разбирает, а пересылает как есть в execute: там они и валидируются.
+    updates: z.record(z.string(), z.unknown()),
+    rowIndex: z.number(),
+    originalData: z.record(z.string(), z.unknown()),
+});
+
+const AnalyzeUnmatchedRowSchema = z.object({
+    // Индекс от первой строки данных; для показа пользователю — `row`.
+    rowIndex: z.number(),
+    // Номер строки в Excel, как его видит пользователь.
+    row: z.number(),
+    data: z.record(z.string(), z.unknown()),
+    // Подробная причина по-английски, для логов и как запасной текст.
+    reason: z.string(),
+    // Причина для перевода: `code` из ERRORS и параметры подстановки.
+    error: ErrorMessageSchema,
+});
+
+const AnalyzeRowErrorSchema = ErrorMessageSchema.extend({
+    row: z.number(),
+});
+
+const AnalyzeConsignmentProductUpdateResponseSchema = z.object({
+    data: z.object({
+        success: z.boolean(),
+        totalRows: z.number(),
+        matchedCount: z.number(),
+        unmatchedCount: z.number(),
+        matched: z.array(AnalyzeMatchedRowSchema),
+        unmatched: z.array(AnalyzeUnmatchedRowSchema),
+        errors: z.array(AnalyzeRowErrorSchema),
+        warnings: z.array(AnalyzeRowErrorSchema),
+    }),
+});
+
+export namespace AnalyzeConsignmentProductUpdateContractCommand {
+    export const ResponseSchema = AnalyzeConsignmentProductUpdateResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/consignment/index.ts

@@ -15,3 +15,4 @@ export * from './execute-consignment-product-update.command';
 export * from './determine-consignment-product-images.command';
 export * from './analyze-consignment-product-enrichment.query';
 export * from './execute-consignment-product-enrichment.command';
+export * from './analyze-consignment-product-update.command';

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

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

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { OrderStatusEnum, OrderTypeEnum } from '../../enum';
-import { CalendarDaySchema, OrderSchema } from '../../schemas';
+import { CalendarDaySchema, OrderExternalNumberRequestSchema, OrderSchema } from '../../schemas';
 import { MoneySchema } from '../../schemas/money.schema';
 
 const UpdateOrderRequestSchema = z.object({
@@ -11,6 +11,7 @@ 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(),

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

@@ -271,7 +271,16 @@ export const ERRORS = {
     CONSIGNMENT_PRODUCT_UPDATE_INVALID_CONFIG: { code: 'CON018', message: 'Invalid config format', httpCode: 400 },
     CONSIGNMENT_PRODUCT_UPDATE_NO_DATA_ROWS: { code: 'CON019', message: 'File has no data rows', httpCode: 400 },
     CONSIGNMENT_PRODUCT_UPDATE_TOO_MANY_ROWS: { code: 'CON020', message: 'Too many rows', httpCode: 400 },
-    CONSIGNMENT_PRODUCT_UPDATE_DUPLICATE_MATCH: { code: 'CON021', message: 'Multiple matches for row, first used', httpCode: 200 },
+    // Причины, по которым строка файла не попала в обновление: `httpCode` 200 — это не ошибка запроса,
+    // а построчный результат анализа. Параметры для перевода — в `i18nParams` у строки.
+    CONSIGNMENT_PRODUCT_UPDATE_UUID_NOT_PROVIDED: { code: 'CON030', message: 'UUID not provided', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_INVALID_CELL: { code: 'CON031', message: 'Invalid cell value', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_UNRECOGNIZED_BOOLEAN_CELL: { code: 'CON032', message: 'Value is not recognized as yes/no', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_CONSIGNMENT_EMPTY: { code: 'CON033', message: 'No products in consignment', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_NO_MATCH_CRITERIA: { code: 'CON034', message: 'No matching criteria filled in the row', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_NO_MATCH: { code: 'CON035', message: 'No product matches the row', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_AMBIGUOUS_MATCH: { code: 'CON036', message: 'Several products match the row', httpCode: 200 },
+    CONSIGNMENT_PRODUCT_UPDATE_ROWS_SHARE_PRODUCT: { code: 'CON037', message: 'Several rows target the same product', httpCode: 200 },
     CONSIGNMENT_PRODUCT_UPDATE_ANALYSIS_FAILED: { code: 'CON022', message: 'Update analysis failed', httpCode: 500 },
     CONSIGNMENT_PRODUCT_UPDATE_BATCH_TOO_LARGE: { code: 'CON023', message: 'Batch size too large', httpCode: 400 },
     CONSIGNMENT_IMPORT_TOO_MANY_ROWS: { code: 'CON024', message: 'Too many rows for this import mode', httpCode: 400 },
@@ -428,6 +437,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 },
@@ -451,6 +466,8 @@ export const ERRORS = {
         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

@@ -17,4 +17,5 @@ export enum OrderUpdatedFieldEnum {
     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.156",
+    "version": "1.2.158",
     "description": "",
     "main": "./build/index.js",
     "scripts": {

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';

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

@@ -43,6 +43,8 @@ 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(),
@@ -56,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({