@floristcloud/api-lib 1.2.156 → 1.2.157

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

@@ -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 },
@@ -437,6 +443,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/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

@@ -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 },
@@ -451,6 +457,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.157",
     "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({