@floristcloud/api-lib 1.2.116 → 1.2.118

package/build/commands/index.js

@@ -83,3 +83,4 @@ Object.defineProperty(exports, "CreateWsTicketContractCommand", { enumerable: tr
 var validate_ws_ticket_s2s_query_1 = require("./session/validate-ws-ticket-s2s.query");
 Object.defineProperty(exports, "ValidateWsTicketS2SContractQuery", { enumerable: true, get: function () { return validate_ws_ticket_s2s_query_1.ValidateWsTicketS2SContractQuery; } });
 __exportStar(require("./consignment-transfer"), exports);
+__exportStar(require("./transfer-document"), exports);

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

@@ -4,6 +4,7 @@ exports.GetOrderListContractQuery = void 0;
 const zod_1 = require("zod");
 const schemas_1 = require("../../schemas");
 const date_helper_1 = require("../../helpers/date.helper");
+const query_boolean_helper_1 = require("../../helpers/query-boolean.helper");
 const enum_1 = require("../../enum");
 const GetOrderListRequestSchema = zod_1.z
     .object({
@@ -28,6 +29,10 @@ const GetOrderListRequestSchema = zod_1.z
     // Только заказы, ещё не включённые ни в один счёт на оплату — список для пикера при
     // выставлении счёта. Комбинируется с остальными критериями обычным AND.
     withoutPaymentInvoice: zod_1.z.coerce.boolean().optional(),
+    // То же для передаточного документа — пикер заказов при выпуске УПД. Здесь `queryBooleanSchema`,
+    // а не `z.coerce.boolean()`: в query всегда приходит текст, и `Boolean('false') === true`,
+    // то есть флаг соседа невозможно выключить явным значением, только опустив параметр.
+    withoutTransferDocument: query_boolean_helper_1.queryBooleanSchema,
 })
     .refine(value => {
     const { startDate, endDate } = value;

package/build/commands/transfer-document/create-transfer-document.command.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateTransferDocumentContractCommand = void 0;
+const zod_1 = require("zod");
+const transfer_document_detailed_schema_1 = require("../../schemas/transfer-document/transfer-document-detailed.schema");
+// Потолок числа заказов в одном документе — защита от абсурдного запроса, а не бизнес-правило.
+// Тот же порядок, что у счёта: сто заказов в одной отгрузке клиенту не встречаются, а документ
+// такого размера ещё собирается и читается.
+const MAX_TRANSFER_DOCUMENT_ORDER_COUNT = 100;
+/**
+ * Документ выпускается по отгруженным заказам одного клиента.
+ *
+ * `documentDate` — дата составления (строка 1 формы). `shipmentDate` — дата передачи (строка [11]);
+ * не передана — берём максимальную `completedAt` из заказов, а легаси-заказу без даты её же
+ * записываем обратно, иначе заказ и документ разъедутся.
+ */
+const CreateTransferDocumentRequestSchema = zod_1.z.object({
+    clientUUID: zod_1.z.uuid(),
+    orderUUIDs: zod_1.z.uuid().array().min(1).max(MAX_TRANSFER_DOCUMENT_ORDER_COUNT),
+    documentDate: zod_1.z.coerce.date(),
+    shipmentDate: zod_1.z.coerce.date().optional(),
+});
+const CreateTransferDocumentResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: transfer_document_detailed_schema_1.TransferDocumentDetailedSchema,
+});
+var CreateTransferDocumentContractCommand;
+(function (CreateTransferDocumentContractCommand) {
+    CreateTransferDocumentContractCommand.RequestSchema = CreateTransferDocumentRequestSchema;
+    CreateTransferDocumentContractCommand.ResponseSchema = CreateTransferDocumentResponseSchema;
+})(CreateTransferDocumentContractCommand || (exports.CreateTransferDocumentContractCommand = CreateTransferDocumentContractCommand = {}));

package/build/commands/transfer-document/delete-transfer-document.command.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteTransferDocumentContractCommand = void 0;
+const zod_1 = require("zod");
+const query_boolean_helper_1 = require("../../helpers/query-boolean.helper");
+/**
+ * Удаление документа. Заказы отвязываются и снова становятся редактируемыми, номер сгорает —
+ * повтор получит следующий, а не дубль к тому, что уже лежит у контрагента.
+ *
+ * `force` приходит в query-строке и нужен только для выданного (`ISSUED`) документа: без него
+ * такое удаление отклоняется, чтобы фронт успел показать предупреждение.
+ */
+const DeleteTransferDocumentRequestSchema = zod_1.z.object({
+    force: query_boolean_helper_1.queryBooleanSchema,
+});
+const DeleteTransferDocumentResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        success: zod_1.z.boolean(),
+    }),
+});
+var DeleteTransferDocumentContractCommand;
+(function (DeleteTransferDocumentContractCommand) {
+    DeleteTransferDocumentContractCommand.RequestSchema = DeleteTransferDocumentRequestSchema;
+    DeleteTransferDocumentContractCommand.ResponseSchema = DeleteTransferDocumentResponseSchema;
+})(DeleteTransferDocumentContractCommand || (exports.DeleteTransferDocumentContractCommand = DeleteTransferDocumentContractCommand = {}));

package/build/commands/transfer-document/get-transfer-document-list.query.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetTransferDocumentListContractQuery = void 0;
+const zod_1 = require("zod");
+const transfer_document_schema_1 = require("../../schemas/transfer-document/transfer-document.schema");
+const GetTransferDocumentListRequestSchema = zod_1.z.object({
+    page: zod_1.z.string().transform(value => Number(value) || 1),
+    count: zod_1.z.string().transform(value => Number(value) || 10),
+    searchQuery: zod_1.z.string().optional(),
+    clientUUID: zod_1.z.uuid().optional(),
+});
+const GetTransferDocumentListResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        list: transfer_document_schema_1.TransferDocumentSchema.array(),
+        total: zod_1.z.number(),
+    }),
+});
+var GetTransferDocumentListContractQuery;
+(function (GetTransferDocumentListContractQuery) {
+    GetTransferDocumentListContractQuery.RequestSchema = GetTransferDocumentListRequestSchema;
+    GetTransferDocumentListContractQuery.ResponseSchema = GetTransferDocumentListResponseSchema;
+})(GetTransferDocumentListContractQuery || (exports.GetTransferDocumentListContractQuery = GetTransferDocumentListContractQuery = {}));

package/build/commands/transfer-document/get-transfer-document.query.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetTransferDocumentContractQuery = void 0;
+const zod_1 = require("zod");
+const transfer_document_detailed_schema_1 = require("../../schemas/transfer-document/transfer-document-detailed.schema");
+const GetTransferDocumentRequestSchema = zod_1.z.object({});
+const GetTransferDocumentResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: transfer_document_detailed_schema_1.TransferDocumentDetailedSchema,
+});
+var GetTransferDocumentContractQuery;
+(function (GetTransferDocumentContractQuery) {
+    GetTransferDocumentContractQuery.RequestSchema = GetTransferDocumentRequestSchema;
+    GetTransferDocumentContractQuery.ResponseSchema = GetTransferDocumentResponseSchema;
+})(GetTransferDocumentContractQuery || (exports.GetTransferDocumentContractQuery = GetTransferDocumentContractQuery = {}));

package/build/commands/transfer-document/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-transfer-document.command"), exports);
+__exportStar(require("./get-transfer-document.query"), exports);
+__exportStar(require("./get-transfer-document-list.query"), exports);
+__exportStar(require("./issue-transfer-document.command"), exports);
+__exportStar(require("./delete-transfer-document.command"), exports);

package/build/commands/transfer-document/issue-transfer-document.command.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IssueTransferDocumentContractCommand = void 0;
+const zod_1 = require("zod");
+const transfer_document_detailed_schema_1 = require("../../schemas/transfer-document/transfer-document-detailed.schema");
+// Перевод документа в состояние ISSUED — «передан контрагенту». Дальше он удаляется только
+// с явным подтверждением: восстановить его нельзя, а номер сгорает.
+const IssueTransferDocumentRequestSchema = zod_1.z.object({});
+const IssueTransferDocumentResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: transfer_document_detailed_schema_1.TransferDocumentDetailedSchema,
+});
+var IssueTransferDocumentContractCommand;
+(function (IssueTransferDocumentContractCommand) {
+    IssueTransferDocumentContractCommand.RequestSchema = IssueTransferDocumentRequestSchema;
+    IssueTransferDocumentContractCommand.ResponseSchema = IssueTransferDocumentResponseSchema;
+})(IssueTransferDocumentContractCommand || (exports.IssueTransferDocumentContractCommand = IssueTransferDocumentContractCommand = {}));

package/build/constant/error-i18n-key.js

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

package/build/constant/error.js

@@ -395,6 +395,13 @@ exports.ERRORS = {
         message: 'Order not deleted, the order is included in a payment invoice',
         httpCode: 409,
     },
+    // Отказ общий для удаления заказа и для вывода его из COMPLETED, поэтому формулировка
+    // без привязки к действию: «not deleted» вводило бы в заблуждение при смене статуса.
+    ORDER_IN_TRANSFER_DOCUMENT: {
+        code: 'O059',
+        message: 'The order is included in a transfer document and cannot be changed or deleted',
+        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 },
@@ -409,6 +416,7 @@ exports.ERRORS = {
     ORDER_MERGE_HAS_WRITE_OFFS: { code: 'O031', message: 'Order has write-offs', httpCode: 400 },
     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 },
     ORDER_MERGE_BALANCE_STATUS_NOT_ALLOWED: {
         code: 'O033',
         message: 'Order status is balance affecting, merge not allowed',
@@ -1451,4 +1459,49 @@ exports.ERRORS = {
         message: 'Failed to assign cash flow item to transactions',
         httpCode: 500,
     },
+    TRANSFER_DOCUMENT_CREATE_FAILED: { code: 'TDOC001', message: 'Failed to create transfer document', httpCode: 500 },
+    TRANSFER_DOCUMENT_NOT_FOUND: { code: 'TDOC002', message: 'Transfer document not found', httpCode: 404 },
+    TRANSFER_DOCUMENT_FETCH_FAILED: { code: 'TDOC003', message: 'Failed to fetch transfer documents', httpCode: 500 },
+    TRANSFER_DOCUMENT_DELETE_FAILED: { code: 'TDOC004', message: 'Failed to delete transfer document', httpCode: 500 },
+    TRANSFER_DOCUMENT_ORDERS_REQUIRED: { code: 'TDOC005', message: 'At least one order is required', httpCode: 400 },
+    TRANSFER_DOCUMENT_ORDERS_NOT_FOUND: {
+        code: 'TDOC006',
+        message: 'Some of the requested orders were not found for this client',
+        httpCode: 404,
+    },
+    TRANSFER_DOCUMENT_ORDER_NOT_COMPLETED: {
+        code: 'TDOC007',
+        message: 'A transfer document can only be issued for completed orders',
+        httpCode: 409,
+    },
+    TRANSFER_DOCUMENT_ORDER_ALREADY_ISSUED: {
+        code: 'TDOC008',
+        message: 'Some of the requested orders are already included in another transfer document',
+        httpCode: 409,
+    },
+    TRANSFER_DOCUMENT_AMOUNT_INVALID: { code: 'TDOC009', message: 'Transfer document amount must be greater than zero', httpCode: 400 },
+    TRANSFER_DOCUMENT_EXPORT_FAILED: { code: 'TDOC010', message: 'Failed to build transfer document file', httpCode: 500 },
+    TRANSFER_DOCUMENT_VAT_NOT_SUPPORTED: {
+        code: 'TDOC011',
+        message: 'Transfer documents are only issued as an act (status 2); VAT payers are not supported yet',
+        httpCode: 409,
+    },
+    // Реквизиты сторон проверяем до выпуска: движок считает пустое значение штатным и напечатал бы
+    // документ без «Продавца», ИНН и подписи — недействительный, и компания узнала бы об этом
+    // от контрагента. `errorData` перечисляет незаполненные поля, чтобы UI назвал их поимённо.
+    TRANSFER_DOCUMENT_SELLER_REQUISITES_MISSING: {
+        code: 'TDOC012',
+        message: 'Seller requisites are not filled in company settings',
+        httpCode: 400,
+    },
+    TRANSFER_DOCUMENT_BUYER_REQUISITES_MISSING: {
+        code: 'TDOC014',
+        message: 'Buyer requisites are not filled in the client legal profile',
+        httpCode: 400,
+    },
+    TRANSFER_DOCUMENT_NUMBER_START_DECREASED: {
+        code: 'TDOC013',
+        message: 'Transfer document number start cannot be decreased',
+        httpCode: 400,
+    },
 };

package/build/constant/index.js

@@ -21,5 +21,7 @@ __exportStar(require("./import.constant"), exports);
 __exportStar(require("./validation-i18n-key"), exports);
 __exportStar(require("./validation-i18n-message"), exports);
 __exportStar(require("./report.constant"), exports);
+__exportStar(require("./oksm"), exports);
+__exportStar(require("./okei"), exports);
 __exportStar(require("./contact-phone.constant"), exports);
 __exportStar(require("./settings.constant"), exports);

package/build/constant/okei.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OKEI_BY_SALES_UNIT = void 0;
+const sales_unit_enum_1 = require("../enum/sales-unit.enum");
+/**
+ * ОКЕИ (ОК 015-94) — общероссийский классификатор единиц измерения. Код идёт в графу 2 УПД,
+ * условное национальное обозначение — в графу 2а.
+ *
+ * Услуги и доставка печатаются как «шт»: отдельной единицы для услуги в ОКЕИ нет, а оставлять
+ * графы пустыми при статусе 1 нельзя.
+ */
+exports.OKEI_BY_SALES_UNIT = {
+    [sales_unit_enum_1.SalesUnitEnum.PIECE]: { code: '796', name: 'шт' },
+    [sales_unit_enum_1.SalesUnitEnum.PACK]: { code: '778', name: 'упак' },
+    [sales_unit_enum_1.SalesUnitEnum.BOX]: { code: '812', name: 'ящик' },
+};

package/build/constant/oksm.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OKSM = void 0;
+/**
+ * ОКСМ (ОК 025-2001) — общероссийский классификатор стран мира. Цифровой код идёт в графу 10
+ * УПД, краткое наименование — в графу 10а. Коды совпадают с ISO 3166-1 numeric.
+ *
+ * Список неполный намеренно: здесь страны происхождения, реально встречающиеся у цветочного опта,
+ * плюс основные торговые партнёры. Новая страна добавляется сюда, её написания — в OKSM_ALIAS.
+ */
+exports.OKSM = [
+    { code: '643', name: 'Россия', alpha2: 'RU' },
+    { code: '528', name: 'Нидерланды', alpha2: 'NL' },
+    { code: '218', name: 'Эквадор', alpha2: 'EC' },
+    { code: '170', name: 'Колумбия', alpha2: 'CO' },
+    { code: '404', name: 'Кения', alpha2: 'KE' },
+    { code: '231', name: 'Эфиопия', alpha2: 'ET' },
+    { code: '834', name: 'Танзания', alpha2: 'TZ' },
+    { code: '800', name: 'Уганда', alpha2: 'UG' },
+    { code: '716', name: 'Зимбабве', alpha2: 'ZW' },
+    { code: '710', name: 'Южная Африка', alpha2: 'ZA' },
+    { code: '376', name: 'Израиль', alpha2: 'IL' },
+    { code: '380', name: 'Италия', alpha2: 'IT' },
+    { code: '792', name: 'Турция', alpha2: 'TR' },
+    { code: '156', name: 'Китай', alpha2: 'CN' },
+    { code: '764', name: 'Таиланд', alpha2: 'TH' },
+    { code: '704', name: 'Вьетнам', alpha2: 'VN' },
+    { code: '356', name: 'Индия', alpha2: 'IN' },
+    { code: '144', name: 'Шри-Ланка', alpha2: 'LK' },
+    { code: '458', name: 'Малайзия', alpha2: 'MY' },
+    { code: '360', name: 'Индонезия', alpha2: 'ID' },
+    { code: '188', name: 'Коста-Рика', alpha2: 'CR' },
+    { code: '484', name: 'Мексика', alpha2: 'MX' },
+    { code: '076', name: 'Бразилия', alpha2: 'BR' },
+    { code: '604', name: 'Перу', alpha2: 'PE' },
+    { code: '152', name: 'Чили', alpha2: 'CL' },
+    { code: '840', name: 'Соединённые Штаты', alpha2: 'US' },
+    { code: '554', name: 'Новая Зеландия', alpha2: 'NZ' },
+    { code: '036', name: 'Австралия', alpha2: 'AU' },
+    { code: '276', name: 'Германия', alpha2: 'DE' },
+    { code: '616', name: 'Польша', alpha2: 'PL' },
+    { code: '056', name: 'Бельгия', alpha2: 'BE' },
+    { code: '250', name: 'Франция', alpha2: 'FR' },
+    { code: '724', name: 'Испания', alpha2: 'ES' },
+    { code: '620', name: 'Португалия', alpha2: 'PT' },
+    { code: '208', name: 'Дания', alpha2: 'DK' },
+    { code: '246', name: 'Финляндия', alpha2: 'FI' },
+    { code: '752', name: 'Швеция', alpha2: 'SE' },
+    { code: '578', name: 'Норвегия', alpha2: 'NO' },
+    { code: '826', name: 'Соединённое Королевство', alpha2: 'GB' },
+    { code: '756', name: 'Швейцария', alpha2: 'CH' },
+    { code: '040', name: 'Австрия', alpha2: 'AT' },
+    { code: '203', name: 'Чехия', alpha2: 'CZ' },
+    { code: '440', name: 'Литва', alpha2: 'LT' },
+    { code: '428', name: 'Латвия', alpha2: 'LV' },
+    { code: '233', name: 'Эстония', alpha2: 'EE' },
+    { code: '112', name: 'Беларусь', alpha2: 'BY' },
+    { code: '398', name: 'Казахстан', alpha2: 'KZ' },
+    { code: '860', name: 'Узбекистан', alpha2: 'UZ' },
+    { code: '051', name: 'Армения', alpha2: 'AM' },
+    { code: '031', name: 'Азербайджан', alpha2: 'AZ' },
+    { code: '268', name: 'Грузия', alpha2: 'GE' },
+    { code: '498', name: 'Молдова', alpha2: 'MD' },
+    { code: '804', name: 'Украина', alpha2: 'UA' },
+    { code: '818', name: 'Египет', alpha2: 'EG' },
+    { code: '504', name: 'Марокко', alpha2: 'MA' },
+    { code: '788', name: 'Тунис', alpha2: 'TN' },
+    { code: '784', name: 'Объединённые Арабские Эмираты', alpha2: 'AE' },
+    { code: '364', name: 'Иран', alpha2: 'IR' },
+    { code: '392', name: 'Япония', alpha2: 'JP' },
+    { code: '410', name: 'Республика Корея', alpha2: 'KR' },
+];

package/build/enum/index.js

@@ -116,4 +116,8 @@ __exportStar(require("./payment-invoice-status.enum"), exports);
 __exportStar(require("./order-by.enum"), exports);
 __exportStar(require("./report-sort-by.enum"), exports);
 __exportStar(require("./report-order-date-basis.enum"), exports);
+__exportStar(require("./invoice-product-field.enum"), exports);
+__exportStar(require("./transfer-document-state.enum"), exports);
+__exportStar(require("./transfer-document-kind.enum"), exports);
+__exportStar(require("./transfer-document-item-kind.enum"), exports);
 __exportStar(require("./write-off-report-date-basis.enum"), exports);

package/build/enum/invoice-product-field.enum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoiceProductFieldEnum = void 0;
+/**
+ * Поля товара, из которых собирается его наименование в документах (накладная, УПД).
+ * Порядок значений в настройке = порядок элементов в строке.
+ */
+var InvoiceProductFieldEnum;
+(function (InvoiceProductFieldEnum) {
+    InvoiceProductFieldEnum["CATEGORY"] = "CATEGORY";
+    InvoiceProductFieldEnum["NAME"] = "NAME";
+    InvoiceProductFieldEnum["GROWER"] = "GROWER";
+    InvoiceProductFieldEnum["SIZE"] = "SIZE";
+    InvoiceProductFieldEnum["SIZE2"] = "SIZE2";
+    InvoiceProductFieldEnum["COLOR"] = "COLOR";
+    InvoiceProductFieldEnum["COUNTRY"] = "COUNTRY";
+    InvoiceProductFieldEnum["ARTICLE"] = "ARTICLE";
+})(InvoiceProductFieldEnum || (exports.InvoiceProductFieldEnum = InvoiceProductFieldEnum = {}));

package/build/enum/transfer-document-item-kind.enum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferDocumentItemKindEnum = void 0;
+/**
+ * Природа строки табличной части УПД.
+ *
+ * По ней билдер понимает, где ставить прочерки в графах страны происхождения и номера ДТ:
+ * у услуги и доставки их нет.
+ */
+var TransferDocumentItemKindEnum;
+(function (TransferDocumentItemKindEnum) {
+    TransferDocumentItemKindEnum["PRODUCT"] = "PRODUCT";
+    TransferDocumentItemKindEnum["SERVICE"] = "SERVICE";
+    TransferDocumentItemKindEnum["DELIVERY"] = "DELIVERY";
+})(TransferDocumentItemKindEnum || (exports.TransferDocumentItemKindEnum = TransferDocumentItemKindEnum = {}));

package/build/enum/transfer-document-kind.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferDocumentKindEnum = void 0;
+var TransferDocumentKindEnum;
+(function (TransferDocumentKindEnum) {
+    TransferDocumentKindEnum["PRIMARY"] = "PRIMARY";
+    TransferDocumentKindEnum["REVISION"] = "REVISION";
+    TransferDocumentKindEnum["CORRECTION"] = "CORRECTION";
+})(TransferDocumentKindEnum || (exports.TransferDocumentKindEnum = TransferDocumentKindEnum = {}));

package/build/enum/transfer-document-state.enum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferDocumentStateEnum = void 0;
+var TransferDocumentStateEnum;
+(function (TransferDocumentStateEnum) {
+    TransferDocumentStateEnum["DRAFT"] = "DRAFT";
+    TransferDocumentStateEnum["ISSUED"] = "ISSUED";
+})(TransferDocumentStateEnum || (exports.TransferDocumentStateEnum = TransferDocumentStateEnum = {}));

package/build/schemas/index.js

@@ -97,3 +97,5 @@ __exportStar(require("./money.schema"), exports);
 __exportStar(require("./non-negative-money.schema"), exports);
 __exportStar(require("./positive-money.schema"), exports);
 __exportStar(require("./report/report-order-filter.schema"), exports);
+__exportStar(require("./transfer-document/transfer-document.schema"), exports);
+__exportStar(require("./transfer-document/transfer-document-detailed.schema"), exports);

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

@@ -36,17 +36,23 @@ exports.OrderSchema = zod_1.z.object({
     // Счёт на оплату, в который включён заказ. Сам счёт (номер, файл, статус оплаты) читается
     // отдельным запросом GET /payment-invoice/:uuid — здесь только ссылка, чтобы не утяжелять список заказов.
     paymentInvoiceUUID: zod_1.z.uuid().nullable(),
+    // Передаточный документ (УПД), в который включён заказ. Тем же приёмом, что и счёт: здесь только
+    // ссылка, документ читается через GET /transfer-document/:uuid. Непустое значение означает, что
+    // заказ заморожен — состав, статус, доставка, дата отгрузки и скидка ему уже недоступны.
+    transferDocumentUUID: zod_1.z.uuid().nullable(),
     completedAt: zod_1.z.date().nullable(),
     paymentDueAt: zod_1.z.date().nullable(),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
     deletedAt: zod_1.z.date().nullable(),
 });
-// Витрина клиента не показывает внутреннюю кухню счетов, поэтому ссылка на счёт сюда не попадает.
+// Витрина клиента не показывает внутреннюю кухню документов, поэтому ссылки на счёт и на УПД
+// сюда не попадают.
 exports.OrderForClientSchema = exports.OrderSchema.omit({
     comment: true,
     tag: true,
     paymentInvoiceUUID: true,
+    transferDocumentUUID: true,
 });
 exports.OrderExtendedSchema = exports.OrderSchema.extend({
     client: client_1.ClientSchema,

package/build/schemas/settings/settings.schema.js

@@ -97,6 +97,18 @@ exports.SettingsSchema = zod_1.z.object({
     bankBic: zod_1.z.string().nullable(),
     correspondentAccount: zod_1.z.string().nullable(),
     invoiceNumberPrefix: zod_1.z.string(),
+    kpp: zod_1.z.string().nullable(),
+    ogrn: zod_1.z.string().nullable(),
+    signatoryName: zod_1.z.string().nullable(),
+    signatoryPosition: zod_1.z.string().nullable(),
+    accountantName: zod_1.z.string().nullable(),
+    responsibleName: zod_1.z.string().nullable(),
+    responsiblePosition: zod_1.z.string().nullable(),
+    shipperName: zod_1.z.string().nullable(),
+    shipperAddress: zod_1.z.string().nullable(),
+    transferDocumentStatus: zod_1.z.number().int().nullable(),
+    transferDocumentNumberStart: zod_1.z.number().int().positive().nullable(),
+    invoiceProductFields: zod_1.z.array(zod_1.z.nativeEnum(enum_1.InvoiceProductFieldEnum)).nullable(),
     isShowPriceAnonymous: zod_1.z.boolean(),
     orderExpirationWarningMin: zod_1.z.number().nullable(),
     orderExpirationMin: zod_1.z.number().nullable(),
@@ -179,6 +191,18 @@ exports.CreateSettingsSchema = zod_1.z.object({
     bankBic: zod_1.z.string().nullable().optional(),
     correspondentAccount: zod_1.z.string().nullable().optional(),
     invoiceNumberPrefix: zod_1.z.string().optional(),
+    kpp: zod_1.z.string().nullable().optional(),
+    ogrn: zod_1.z.string().nullable().optional(),
+    signatoryName: zod_1.z.string().nullable().optional(),
+    signatoryPosition: zod_1.z.string().nullable().optional(),
+    accountantName: zod_1.z.string().nullable().optional(),
+    responsibleName: zod_1.z.string().nullable().optional(),
+    responsiblePosition: zod_1.z.string().nullable().optional(),
+    shipperName: zod_1.z.string().nullable().optional(),
+    shipperAddress: zod_1.z.string().nullable().optional(),
+    transferDocumentStatus: zod_1.z.number().int().nullable().optional(),
+    transferDocumentNumberStart: zod_1.z.number().int().positive().nullable().optional(),
+    invoiceProductFields: zod_1.z.array(zod_1.z.nativeEnum(enum_1.InvoiceProductFieldEnum)).nullable().optional(),
     orderExpirationWarningMin: zod_1.z.coerce.number().nullable().optional(),
     orderExpirationMin: zod_1.z.coerce.number().nullable().optional(),
     paymentGraceDaysAfterCompletion: zod_1.z.coerce.number().nullable().optional(),
@@ -249,6 +273,19 @@ exports.UpdateSettingsRequestSchema = zod_1.z.object({
     bankBic: zod_1.z.string().optional().nullable(),
     correspondentAccount: zod_1.z.string().optional().nullable(),
     invoiceNumberPrefix: zod_1.z.string().optional(),
+    kpp: zod_1.z.string().optional().nullable(),
+    ogrn: zod_1.z.string().optional().nullable(),
+    signatoryName: zod_1.z.string().optional().nullable(),
+    signatoryPosition: zod_1.z.string().optional().nullable(),
+    accountantName: zod_1.z.string().optional().nullable(),
+    responsibleName: zod_1.z.string().optional().nullable(),
+    responsiblePosition: zod_1.z.string().optional().nullable(),
+    shipperName: zod_1.z.string().optional().nullable(),
+    shipperAddress: zod_1.z.string().optional().nullable(),
+    transferDocumentStatus: zod_1.z.number().int().optional().nullable(),
+    // Понижать нельзя — это дало бы дубли к уже выданным документам; проверка в обработчике.
+    transferDocumentNumberStart: zod_1.z.number().int().positive().optional().nullable(),
+    invoiceProductFields: zod_1.z.array(zod_1.z.nativeEnum(enum_1.InvoiceProductFieldEnum)).optional().nullable(),
     isShowPriceAnonymous: zod_1.z.coerce.boolean().optional(),
     orderExpirationWarningMin: zod_1.z.coerce.number().nullable().optional(),
     orderExpirationMin: zod_1.z.coerce.number().nullable().optional(),

package/build/schemas/transfer-document/transfer-document-detailed.schema.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferDocumentDetailedSchema = void 0;
+const zod_1 = require("zod");
+const transfer_document_item_kind_enum_1 = require("../../enum/transfer-document-item-kind.enum");
+const money_schema_1 = require("../money.schema");
+const transfer_document_schema_1 = require("./transfer-document.schema");
+// Строка табличной части — снимок графы в графу на момент выпуска. Значения уже готовы к печати:
+// пересчитывать их из заказа нельзя, выданная первичка обязана воспроизводиться неизменной.
+const TransferDocumentItemSchema = zod_1.z.object({
+    kind: zod_1.z.nativeEnum(transfer_document_item_kind_enum_1.TransferDocumentItemKindEnum),
+    orderUUID: zod_1.z.string(),
+    orderId: zod_1.z.number(),
+    // Графа А — код товара; графы 2 / 2а — код и обозначение ОКЕИ.
+    code: zod_1.z.string().nullable(),
+    name: zod_1.z.string(),
+    unitCode: zod_1.z.string().nullable(),
+    unitName: zod_1.z.string().nullable(),
+    quantity: zod_1.z.number(),
+    priceWithoutVat: money_schema_1.MoneySchema,
+    amountWithoutVat: money_schema_1.MoneySchema,
+    // null — «Без НДС»: прочерк в графе 8. Ноль значил бы «ставка есть, налог нулевой».
+    vatRate: zod_1.z.number().nullable(),
+    vatAmount: money_schema_1.MoneySchema.nullable(),
+    amountWithVat: money_schema_1.MoneySchema,
+    // Графы 10 / 10а / 11. Пусто у услуг и доставки, а также когда страну не удалось определить.
+    countryCode: zod_1.z.string().nullable(),
+    countryName: zod_1.z.string().nullable(),
+    customsDeclarationNumber: zod_1.z.string().nullable(),
+});
+/** Документ вместе с табличной частью — карточка и ответ на создание. */
+exports.TransferDocumentDetailedSchema = transfer_document_schema_1.TransferDocumentSchema.extend({
+    items: TransferDocumentItemSchema.array(),
+    // Позиции, у которых не определилась страна происхождения: документ выпущен, графы 10/10а
+    // напечатаны прочерком, а UI показывает, какие карточки товара стоит поправить.
+    warnings: zod_1.z.string().array(),
+});

package/build/schemas/transfer-document/transfer-document.schema.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferDocumentSchema = void 0;
+const zod_1 = require("zod");
+const transfer_document_state_enum_1 = require("../../enum/transfer-document-state.enum");
+const money_schema_1 = require("../money.schema");
+// Заказы, вошедшие в документ. Список короткий — документ выпускается по одной отгрузке клиенту,
+// поэтому он есть и в строке списка: по нему UI показывает, какие заказы уже закрыты первичкой.
+const TransferDocumentOrderSchema = zod_1.z.object({
+    orderUUID: zod_1.z.string(),
+    orderId: zod_1.z.number(),
+    completedAt: zod_1.z.coerce.date().nullable(),
+});
+/**
+ * Документ без табличной части — форма списка.
+ *
+ * Позиции сюда не входят намеренно: в УПД их столько же, сколько строк в заказах,
+ * и страница списка из двадцати документов везла бы тысячи строк. За позициями —
+ * `TransferDocumentDetailedSchema` на карточке.
+ */
+exports.TransferDocumentSchema = zod_1.z.object({
+    uuid: zod_1.z.string(),
+    // Номер с ведущими нулями — `01887`, ровно как он напечатан в документе.
+    number: zod_1.z.string(),
+    documentDate: zod_1.z.coerce.date(),
+    shipmentDate: zod_1.z.coerce.date(),
+    // 1 — счёт-фактура + передаточный документ, 2 — только передаточный документ (акт).
+    // В MVP выпускается только 2.
+    documentStatus: zod_1.z.number(),
+    state: zod_1.z.nativeEnum(transfer_document_state_enum_1.TransferDocumentStateEnum),
+    amount: money_schema_1.MoneySchema,
+    amountWithoutVat: money_schema_1.MoneySchema,
+    vatAmount: money_schema_1.MoneySchema,
+    clientUUID: zod_1.z.string(),
+    // Имя покупателя, напечатанное в документе (строка 6 формы). Может отличаться от текущего
+    // имени в карточке клиента: у юрлица печатается `fullCompanyName`, а карточку с тех пор
+    // могли переименовать. Список называет контрагента так же, как переданная ему бумага.
+    buyerName: zod_1.z.string(),
+    orders: TransferDocumentOrderSchema.array(),
+    fileUrl: zod_1.z.string().nullable(),
+    createdAt: zod_1.z.coerce.date(),
+});

package/commands/index.ts

@@ -60,3 +60,4 @@ export { ValidateSessionS2SContractQuery } from './session/validate-session-s2s.
 export { CreateWsTicketContractCommand } from './session/create-ws-ticket.command';
 export { ValidateWsTicketS2SContractQuery } from './session/validate-ws-ticket-s2s.query';
 export * from './consignment-transfer';
+export * from './transfer-document';

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

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { OrderExtendedSchema } from '../../schemas';
 import { dateRangeCheck } from '../../helpers/date.helper';
+import { queryBooleanSchema } from '../../helpers/query-boolean.helper';
 import { OrderStatusEnum, OrderTypeEnum } from '../../enum';
 
 const GetOrderListRequestSchema = z
@@ -26,6 +27,10 @@ const GetOrderListRequestSchema = z
         // Только заказы, ещё не включённые ни в один счёт на оплату — список для пикера при
         // выставлении счёта. Комбинируется с остальными критериями обычным AND.
         withoutPaymentInvoice: z.coerce.boolean().optional(),
+        // То же для передаточного документа — пикер заказов при выпуске УПД. Здесь `queryBooleanSchema`,
+        // а не `z.coerce.boolean()`: в query всегда приходит текст, и `Boolean('false') === true`,
+        // то есть флаг соседа невозможно выключить явным значением, только опустив параметр.
+        withoutTransferDocument: queryBooleanSchema,
     })
     .refine(
         value => {

package/commands/transfer-document/create-transfer-document.command.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { TransferDocumentDetailedSchema } from '../../schemas/transfer-document/transfer-document-detailed.schema';
+
+// Потолок числа заказов в одном документе — защита от абсурдного запроса, а не бизнес-правило.
+// Тот же порядок, что у счёта: сто заказов в одной отгрузке клиенту не встречаются, а документ
+// такого размера ещё собирается и читается.
+const MAX_TRANSFER_DOCUMENT_ORDER_COUNT = 100;
+
+/**
+ * Документ выпускается по отгруженным заказам одного клиента.
+ *
+ * `documentDate` — дата составления (строка 1 формы). `shipmentDate` — дата передачи (строка [11]);
+ * не передана — берём максимальную `completedAt` из заказов, а легаси-заказу без даты её же
+ * записываем обратно, иначе заказ и документ разъедутся.
+ */
+const CreateTransferDocumentRequestSchema = z.object({
+    clientUUID: z.uuid(),
+    orderUUIDs: z.uuid().array().min(1).max(MAX_TRANSFER_DOCUMENT_ORDER_COUNT),
+    documentDate: z.coerce.date(),
+    shipmentDate: z.coerce.date().optional(),
+});
+
+const CreateTransferDocumentResponseSchema = z.object({
+    message: z.string().optional(),
+    data: TransferDocumentDetailedSchema,
+});
+
+export namespace CreateTransferDocumentContractCommand {
+    export const RequestSchema = CreateTransferDocumentRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = CreateTransferDocumentResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/transfer-document/delete-transfer-document.command.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { queryBooleanSchema } from '../../helpers/query-boolean.helper';
+
+/**
+ * Удаление документа. Заказы отвязываются и снова становятся редактируемыми, номер сгорает —
+ * повтор получит следующий, а не дубль к тому, что уже лежит у контрагента.
+ *
+ * `force` приходит в query-строке и нужен только для выданного (`ISSUED`) документа: без него
+ * такое удаление отклоняется, чтобы фронт успел показать предупреждение.
+ */
+const DeleteTransferDocumentRequestSchema = z.object({
+    force: queryBooleanSchema,
+});
+
+const DeleteTransferDocumentResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.object({
+        success: z.boolean(),
+    }),
+});
+
+export namespace DeleteTransferDocumentContractCommand {
+    export const RequestSchema = DeleteTransferDocumentRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = DeleteTransferDocumentResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/transfer-document/get-transfer-document-list.query.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { TransferDocumentSchema } from '../../schemas/transfer-document/transfer-document.schema';
+
+const GetTransferDocumentListRequestSchema = z.object({
+    page: z.string().transform(value => Number(value) || 1),
+    count: z.string().transform(value => Number(value) || 10),
+    searchQuery: z.string().optional(),
+    clientUUID: z.uuid().optional(),
+});
+
+const GetTransferDocumentListResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.object({
+        list: TransferDocumentSchema.array(),
+        total: z.number(),
+    }),
+});
+
+export namespace GetTransferDocumentListContractQuery {
+    export const RequestSchema = GetTransferDocumentListRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = GetTransferDocumentListResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/transfer-document/get-transfer-document.query.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { TransferDocumentDetailedSchema } from '../../schemas/transfer-document/transfer-document-detailed.schema';
+
+const GetTransferDocumentRequestSchema = z.object({});
+
+const GetTransferDocumentResponseSchema = z.object({
+    message: z.string().optional(),
+    data: TransferDocumentDetailedSchema,
+});
+
+export namespace GetTransferDocumentContractQuery {
+    export const RequestSchema = GetTransferDocumentRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = GetTransferDocumentResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/transfer-document/index.ts

@@ -0,0 +1,5 @@
+export * from './create-transfer-document.command';
+export * from './get-transfer-document.query';
+export * from './get-transfer-document-list.query';
+export * from './issue-transfer-document.command';
+export * from './delete-transfer-document.command';

package/commands/transfer-document/issue-transfer-document.command.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { TransferDocumentDetailedSchema } from '../../schemas/transfer-document/transfer-document-detailed.schema';
+
+// Перевод документа в состояние ISSUED — «передан контрагенту». Дальше он удаляется только
+// с явным подтверждением: восстановить его нельзя, а номер сгорает.
+const IssueTransferDocumentRequestSchema = z.object({});
+
+const IssueTransferDocumentResponseSchema = z.object({
+    message: z.string().optional(),
+    data: TransferDocumentDetailedSchema,
+});
+
+export namespace IssueTransferDocumentContractCommand {
+    export const RequestSchema = IssueTransferDocumentRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = IssueTransferDocumentResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/constant/error-i18n-key.ts

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

package/constant/error.ts

@@ -409,6 +409,13 @@ export const ERRORS = {
         message: 'Order not deleted, the order is included in a payment invoice',
         httpCode: 409,
     },
+    // Отказ общий для удаления заказа и для вывода его из COMPLETED, поэтому формулировка
+    // без привязки к действию: «not deleted» вводило бы в заблуждение при смене статуса.
+    ORDER_IN_TRANSFER_DOCUMENT: {
+        code: 'O059',
+        message: 'The order is included in a transfer document and cannot be changed or deleted',
+        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 },
@@ -423,6 +430,7 @@ export const ERRORS = {
     ORDER_MERGE_HAS_WRITE_OFFS: { code: 'O031', message: 'Order has write-offs', httpCode: 400 },
     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 },
     ORDER_MERGE_BALANCE_STATUS_NOT_ALLOWED: {
         code: 'O033',
         message: 'Order status is balance affecting, merge not allowed',
@@ -1519,4 +1527,49 @@ export const ERRORS = {
         message: 'Failed to assign cash flow item to transactions',
         httpCode: 500,
     },
+    TRANSFER_DOCUMENT_CREATE_FAILED: { code: 'TDOC001', message: 'Failed to create transfer document', httpCode: 500 },
+    TRANSFER_DOCUMENT_NOT_FOUND: { code: 'TDOC002', message: 'Transfer document not found', httpCode: 404 },
+    TRANSFER_DOCUMENT_FETCH_FAILED: { code: 'TDOC003', message: 'Failed to fetch transfer documents', httpCode: 500 },
+    TRANSFER_DOCUMENT_DELETE_FAILED: { code: 'TDOC004', message: 'Failed to delete transfer document', httpCode: 500 },
+    TRANSFER_DOCUMENT_ORDERS_REQUIRED: { code: 'TDOC005', message: 'At least one order is required', httpCode: 400 },
+    TRANSFER_DOCUMENT_ORDERS_NOT_FOUND: {
+        code: 'TDOC006',
+        message: 'Some of the requested orders were not found for this client',
+        httpCode: 404,
+    },
+    TRANSFER_DOCUMENT_ORDER_NOT_COMPLETED: {
+        code: 'TDOC007',
+        message: 'A transfer document can only be issued for completed orders',
+        httpCode: 409,
+    },
+    TRANSFER_DOCUMENT_ORDER_ALREADY_ISSUED: {
+        code: 'TDOC008',
+        message: 'Some of the requested orders are already included in another transfer document',
+        httpCode: 409,
+    },
+    TRANSFER_DOCUMENT_AMOUNT_INVALID: { code: 'TDOC009', message: 'Transfer document amount must be greater than zero', httpCode: 400 },
+    TRANSFER_DOCUMENT_EXPORT_FAILED: { code: 'TDOC010', message: 'Failed to build transfer document file', httpCode: 500 },
+    TRANSFER_DOCUMENT_VAT_NOT_SUPPORTED: {
+        code: 'TDOC011',
+        message: 'Transfer documents are only issued as an act (status 2); VAT payers are not supported yet',
+        httpCode: 409,
+    },
+    // Реквизиты сторон проверяем до выпуска: движок считает пустое значение штатным и напечатал бы
+    // документ без «Продавца», ИНН и подписи — недействительный, и компания узнала бы об этом
+    // от контрагента. `errorData` перечисляет незаполненные поля, чтобы UI назвал их поимённо.
+    TRANSFER_DOCUMENT_SELLER_REQUISITES_MISSING: {
+        code: 'TDOC012',
+        message: 'Seller requisites are not filled in company settings',
+        httpCode: 400,
+    },
+    TRANSFER_DOCUMENT_BUYER_REQUISITES_MISSING: {
+        code: 'TDOC014',
+        message: 'Buyer requisites are not filled in the client legal profile',
+        httpCode: 400,
+    },
+    TRANSFER_DOCUMENT_NUMBER_START_DECREASED: {
+        code: 'TDOC013',
+        message: 'Transfer document number start cannot be decreased',
+        httpCode: 400,
+    },
 } as const;

package/constant/index.ts

@@ -5,5 +5,7 @@ export * from './import.constant';
 export * from './validation-i18n-key';
 export * from './validation-i18n-message';
 export * from './report.constant';
+export * from './oksm';
+export * from './okei';
 export * from './contact-phone.constant';
 export * from './settings.constant';

package/constant/okei.ts

@@ -0,0 +1,14 @@
+import { SalesUnitEnum } from '../enum/sales-unit.enum';
+
+/**
+ * ОКЕИ (ОК 015-94) — общероссийский классификатор единиц измерения. Код идёт в графу 2 УПД,
+ * условное национальное обозначение — в графу 2а.
+ *
+ * Услуги и доставка печатаются как «шт»: отдельной единицы для услуги в ОКЕИ нет, а оставлять
+ * графы пустыми при статусе 1 нельзя.
+ */
+export const OKEI_BY_SALES_UNIT: Readonly<Record<SalesUnitEnum, { code: string; name: string }>> = {
+    [SalesUnitEnum.PIECE]: { code: '796', name: 'шт' },
+    [SalesUnitEnum.PACK]: { code: '778', name: 'упак' },
+    [SalesUnitEnum.BOX]: { code: '812', name: 'ящик' },
+};

package/constant/oksm.ts

@@ -0,0 +1,69 @@
+/**
+ * ОКСМ (ОК 025-2001) — общероссийский классификатор стран мира. Цифровой код идёт в графу 10
+ * УПД, краткое наименование — в графу 10а. Коды совпадают с ISO 3166-1 numeric.
+ *
+ * Список неполный намеренно: здесь страны происхождения, реально встречающиеся у цветочного опта,
+ * плюс основные торговые партнёры. Новая страна добавляется сюда, её написания — в OKSM_ALIAS.
+ */
+export const OKSM = [
+    { code: '643', name: 'Россия', alpha2: 'RU' },
+    { code: '528', name: 'Нидерланды', alpha2: 'NL' },
+    { code: '218', name: 'Эквадор', alpha2: 'EC' },
+    { code: '170', name: 'Колумбия', alpha2: 'CO' },
+    { code: '404', name: 'Кения', alpha2: 'KE' },
+    { code: '231', name: 'Эфиопия', alpha2: 'ET' },
+    { code: '834', name: 'Танзания', alpha2: 'TZ' },
+    { code: '800', name: 'Уганда', alpha2: 'UG' },
+    { code: '716', name: 'Зимбабве', alpha2: 'ZW' },
+    { code: '710', name: 'Южная Африка', alpha2: 'ZA' },
+    { code: '376', name: 'Израиль', alpha2: 'IL' },
+    { code: '380', name: 'Италия', alpha2: 'IT' },
+    { code: '792', name: 'Турция', alpha2: 'TR' },
+    { code: '156', name: 'Китай', alpha2: 'CN' },
+    { code: '764', name: 'Таиланд', alpha2: 'TH' },
+    { code: '704', name: 'Вьетнам', alpha2: 'VN' },
+    { code: '356', name: 'Индия', alpha2: 'IN' },
+    { code: '144', name: 'Шри-Ланка', alpha2: 'LK' },
+    { code: '458', name: 'Малайзия', alpha2: 'MY' },
+    { code: '360', name: 'Индонезия', alpha2: 'ID' },
+    { code: '188', name: 'Коста-Рика', alpha2: 'CR' },
+    { code: '484', name: 'Мексика', alpha2: 'MX' },
+    { code: '076', name: 'Бразилия', alpha2: 'BR' },
+    { code: '604', name: 'Перу', alpha2: 'PE' },
+    { code: '152', name: 'Чили', alpha2: 'CL' },
+    { code: '840', name: 'Соединённые Штаты', alpha2: 'US' },
+    { code: '554', name: 'Новая Зеландия', alpha2: 'NZ' },
+    { code: '036', name: 'Австралия', alpha2: 'AU' },
+    { code: '276', name: 'Германия', alpha2: 'DE' },
+    { code: '616', name: 'Польша', alpha2: 'PL' },
+    { code: '056', name: 'Бельгия', alpha2: 'BE' },
+    { code: '250', name: 'Франция', alpha2: 'FR' },
+    { code: '724', name: 'Испания', alpha2: 'ES' },
+    { code: '620', name: 'Португалия', alpha2: 'PT' },
+    { code: '208', name: 'Дания', alpha2: 'DK' },
+    { code: '246', name: 'Финляндия', alpha2: 'FI' },
+    { code: '752', name: 'Швеция', alpha2: 'SE' },
+    { code: '578', name: 'Норвегия', alpha2: 'NO' },
+    { code: '826', name: 'Соединённое Королевство', alpha2: 'GB' },
+    { code: '756', name: 'Швейцария', alpha2: 'CH' },
+    { code: '040', name: 'Австрия', alpha2: 'AT' },
+    { code: '203', name: 'Чехия', alpha2: 'CZ' },
+    { code: '440', name: 'Литва', alpha2: 'LT' },
+    { code: '428', name: 'Латвия', alpha2: 'LV' },
+    { code: '233', name: 'Эстония', alpha2: 'EE' },
+    { code: '112', name: 'Беларусь', alpha2: 'BY' },
+    { code: '398', name: 'Казахстан', alpha2: 'KZ' },
+    { code: '860', name: 'Узбекистан', alpha2: 'UZ' },
+    { code: '051', name: 'Армения', alpha2: 'AM' },
+    { code: '031', name: 'Азербайджан', alpha2: 'AZ' },
+    { code: '268', name: 'Грузия', alpha2: 'GE' },
+    { code: '498', name: 'Молдова', alpha2: 'MD' },
+    { code: '804', name: 'Украина', alpha2: 'UA' },
+    { code: '818', name: 'Египет', alpha2: 'EG' },
+    { code: '504', name: 'Марокко', alpha2: 'MA' },
+    { code: '788', name: 'Тунис', alpha2: 'TN' },
+    { code: '784', name: 'Объединённые Арабские Эмираты', alpha2: 'AE' },
+    { code: '364', name: 'Иран', alpha2: 'IR' },
+    { code: '392', name: 'Япония', alpha2: 'JP' },
+    { code: '410', name: 'Республика Корея', alpha2: 'KR' },
+] as const;

package/enum/index.ts

@@ -100,4 +100,8 @@ export * from './payment-invoice-status.enum';
 export * from './order-by.enum';
 export * from './report-sort-by.enum';
 export * from './report-order-date-basis.enum';
+export * from './invoice-product-field.enum';
+export * from './transfer-document-state.enum';
+export * from './transfer-document-kind.enum';
+export * from './transfer-document-item-kind.enum';
 export * from './write-off-report-date-basis.enum';

package/enum/invoice-product-field.enum.ts

@@ -0,0 +1,14 @@
+/**
+ * Поля товара, из которых собирается его наименование в документах (накладная, УПД).
+ * Порядок значений в настройке = порядок элементов в строке.
+ */
+export enum InvoiceProductFieldEnum {
+    CATEGORY = 'CATEGORY',
+    NAME = 'NAME',
+    GROWER = 'GROWER',
+    SIZE = 'SIZE',
+    SIZE2 = 'SIZE2',
+    COLOR = 'COLOR',
+    COUNTRY = 'COUNTRY',
+    ARTICLE = 'ARTICLE',
+}

package/enum/transfer-document-item-kind.enum.ts

@@ -0,0 +1,11 @@
+/**
+ * Природа строки табличной части УПД.
+ *
+ * По ней билдер понимает, где ставить прочерки в графах страны происхождения и номера ДТ:
+ * у услуги и доставки их нет.
+ */
+export enum TransferDocumentItemKindEnum {
+    PRODUCT = 'PRODUCT',
+    SERVICE = 'SERVICE',
+    DELIVERY = 'DELIVERY',
+}

package/enum/transfer-document-kind.enum.ts

@@ -0,0 +1,5 @@
+export enum TransferDocumentKindEnum {
+    PRIMARY = 'PRIMARY',
+    REVISION = 'REVISION',
+    CORRECTION = 'CORRECTION',
+}

package/enum/transfer-document-state.enum.ts

@@ -0,0 +1,4 @@
+export enum TransferDocumentStateEnum {
+    DRAFT = 'DRAFT',
+    ISSUED = 'ISSUED',
+}

package/package.json

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

package/schemas/index.ts

@@ -81,3 +81,5 @@ export * from './money.schema';
 export * from './non-negative-money.schema';
 export * from './positive-money.schema';
 export * from './report/report-order-filter.schema';
+export * from './transfer-document/transfer-document.schema';
+export * from './transfer-document/transfer-document-detailed.schema';

package/schemas/order/order.schema.ts

@@ -38,6 +38,10 @@ export const OrderSchema = z.object({
     // Счёт на оплату, в который включён заказ. Сам счёт (номер, файл, статус оплаты) читается
     // отдельным запросом GET /payment-invoice/:uuid — здесь только ссылка, чтобы не утяжелять список заказов.
     paymentInvoiceUUID: z.uuid().nullable(),
+    // Передаточный документ (УПД), в который включён заказ. Тем же приёмом, что и счёт: здесь только
+    // ссылка, документ читается через GET /transfer-document/:uuid. Непустое значение означает, что
+    // заказ заморожен — состав, статус, доставка, дата отгрузки и скидка ему уже недоступны.
+    transferDocumentUUID: z.uuid().nullable(),
 
     completedAt: z.date().nullable(),
     paymentDueAt: z.date().nullable(),
@@ -47,11 +51,13 @@ export const OrderSchema = z.object({
     deletedAt: z.date().nullable(),
 });
 
-// Витрина клиента не показывает внутреннюю кухню счетов, поэтому ссылка на счёт сюда не попадает.
+// Витрина клиента не показывает внутреннюю кухню документов, поэтому ссылки на счёт и на УПД
+// сюда не попадают.
 export const OrderForClientSchema = OrderSchema.omit({
     comment: true,
     tag: true,
     paymentInvoiceUUID: true,
+    transferDocumentUUID: true,
 });
 
 export const OrderExtendedSchema = OrderSchema.extend({

package/schemas/settings/settings.schema.ts

@@ -4,6 +4,7 @@ import {
     ChatNoManagerModeEnum,
     ContactMessengerEnum,
     DiscountPriceRoundingEnum,
+    InvoiceProductFieldEnum,
     LanguageEnum,
     WebshopModeEnum,
 } from '../../enum';
@@ -117,6 +118,18 @@ export const SettingsSchema = z.object({
     bankBic: z.string().nullable(),
     correspondentAccount: z.string().nullable(),
     invoiceNumberPrefix: z.string(),
+    kpp: z.string().nullable(),
+    ogrn: z.string().nullable(),
+    signatoryName: z.string().nullable(),
+    signatoryPosition: z.string().nullable(),
+    accountantName: z.string().nullable(),
+    responsibleName: z.string().nullable(),
+    responsiblePosition: z.string().nullable(),
+    shipperName: z.string().nullable(),
+    shipperAddress: z.string().nullable(),
+    transferDocumentStatus: z.number().int().nullable(),
+    transferDocumentNumberStart: z.number().int().positive().nullable(),
+    invoiceProductFields: z.array(z.nativeEnum(InvoiceProductFieldEnum)).nullable(),
     isShowPriceAnonymous: z.boolean(),
     orderExpirationWarningMin: z.number().nullable(),
     orderExpirationMin: z.number().nullable(),
@@ -201,6 +214,18 @@ export const CreateSettingsSchema = z.object({
     bankBic: z.string().nullable().optional(),
     correspondentAccount: z.string().nullable().optional(),
     invoiceNumberPrefix: z.string().optional(),
+    kpp: z.string().nullable().optional(),
+    ogrn: z.string().nullable().optional(),
+    signatoryName: z.string().nullable().optional(),
+    signatoryPosition: z.string().nullable().optional(),
+    accountantName: z.string().nullable().optional(),
+    responsibleName: z.string().nullable().optional(),
+    responsiblePosition: z.string().nullable().optional(),
+    shipperName: z.string().nullable().optional(),
+    shipperAddress: z.string().nullable().optional(),
+    transferDocumentStatus: z.number().int().nullable().optional(),
+    transferDocumentNumberStart: z.number().int().positive().nullable().optional(),
+    invoiceProductFields: z.array(z.nativeEnum(InvoiceProductFieldEnum)).nullable().optional(),
     orderExpirationWarningMin: z.coerce.number().nullable().optional(),
     orderExpirationMin: z.coerce.number().nullable().optional(),
     paymentGraceDaysAfterCompletion: z.coerce.number().nullable().optional(),
@@ -274,6 +299,19 @@ export const UpdateSettingsRequestSchema = z.object({
     bankBic: z.string().optional().nullable(),
     correspondentAccount: z.string().optional().nullable(),
     invoiceNumberPrefix: z.string().optional(),
+    kpp: z.string().optional().nullable(),
+    ogrn: z.string().optional().nullable(),
+    signatoryName: z.string().optional().nullable(),
+    signatoryPosition: z.string().optional().nullable(),
+    accountantName: z.string().optional().nullable(),
+    responsibleName: z.string().optional().nullable(),
+    responsiblePosition: z.string().optional().nullable(),
+    shipperName: z.string().optional().nullable(),
+    shipperAddress: z.string().optional().nullable(),
+    transferDocumentStatus: z.number().int().optional().nullable(),
+    // Понижать нельзя — это дало бы дубли к уже выданным документам; проверка в обработчике.
+    transferDocumentNumberStart: z.number().int().positive().optional().nullable(),
+    invoiceProductFields: z.array(z.nativeEnum(InvoiceProductFieldEnum)).optional().nullable(),
     isShowPriceAnonymous: z.coerce.boolean().optional(),
     orderExpirationWarningMin: z.coerce.number().nullable().optional(),
     orderExpirationMin: z.coerce.number().nullable().optional(),

package/schemas/transfer-document/transfer-document-detailed.schema.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { TransferDocumentItemKindEnum } from '../../enum/transfer-document-item-kind.enum';
+import { MoneySchema } from '../money.schema';
+import { TransferDocumentSchema } from './transfer-document.schema';
+
+// Строка табличной части — снимок графы в графу на момент выпуска. Значения уже готовы к печати:
+// пересчитывать их из заказа нельзя, выданная первичка обязана воспроизводиться неизменной.
+const TransferDocumentItemSchema = z.object({
+    kind: z.nativeEnum(TransferDocumentItemKindEnum),
+    orderUUID: z.string(),
+    orderId: z.number(),
+    // Графа А — код товара; графы 2 / 2а — код и обозначение ОКЕИ.
+    code: z.string().nullable(),
+    name: z.string(),
+    unitCode: z.string().nullable(),
+    unitName: z.string().nullable(),
+    quantity: z.number(),
+    priceWithoutVat: MoneySchema,
+    amountWithoutVat: MoneySchema,
+    // null — «Без НДС»: прочерк в графе 8. Ноль значил бы «ставка есть, налог нулевой».
+    vatRate: z.number().nullable(),
+    vatAmount: MoneySchema.nullable(),
+    amountWithVat: MoneySchema,
+    // Графы 10 / 10а / 11. Пусто у услуг и доставки, а также когда страну не удалось определить.
+    countryCode: z.string().nullable(),
+    countryName: z.string().nullable(),
+    customsDeclarationNumber: z.string().nullable(),
+});
+
+/** Документ вместе с табличной частью — карточка и ответ на создание. */
+export const TransferDocumentDetailedSchema = TransferDocumentSchema.extend({
+    items: TransferDocumentItemSchema.array(),
+    // Позиции, у которых не определилась страна происхождения: документ выпущен, графы 10/10а
+    // напечатаны прочерком, а UI показывает, какие карточки товара стоит поправить.
+    warnings: z.string().array(),
+});

package/schemas/transfer-document/transfer-document.schema.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { TransferDocumentStateEnum } from '../../enum/transfer-document-state.enum';
+import { MoneySchema } from '../money.schema';
+
+// Заказы, вошедшие в документ. Список короткий — документ выпускается по одной отгрузке клиенту,
+// поэтому он есть и в строке списка: по нему UI показывает, какие заказы уже закрыты первичкой.
+const TransferDocumentOrderSchema = z.object({
+    orderUUID: z.string(),
+    orderId: z.number(),
+    completedAt: z.coerce.date().nullable(),
+});
+
+/**
+ * Документ без табличной части — форма списка.
+ *
+ * Позиции сюда не входят намеренно: в УПД их столько же, сколько строк в заказах,
+ * и страница списка из двадцати документов везла бы тысячи строк. За позициями —
+ * `TransferDocumentDetailedSchema` на карточке.
+ */
+export const TransferDocumentSchema = z.object({
+    uuid: z.string(),
+    // Номер с ведущими нулями — `01887`, ровно как он напечатан в документе.
+    number: z.string(),
+    documentDate: z.coerce.date(),
+    shipmentDate: z.coerce.date(),
+    // 1 — счёт-фактура + передаточный документ, 2 — только передаточный документ (акт).
+    // В MVP выпускается только 2.
+    documentStatus: z.number(),
+    state: z.nativeEnum(TransferDocumentStateEnum),
+    amount: MoneySchema,
+    amountWithoutVat: MoneySchema,
+    vatAmount: MoneySchema,
+    clientUUID: z.string(),
+    // Имя покупателя, напечатанное в документе (строка 6 формы). Может отличаться от текущего
+    // имени в карточке клиента: у юрлица печатается `fullCompanyName`, а карточку с тех пор
+    // могли переименовать. Список называет контрагента так же, как переданная ему бумага.
+    buyerName: z.string(),
+    orders: TransferDocumentOrderSchema.array(),
+    fileUrl: z.string().nullable(),
+    createdAt: z.coerce.date(),
+});