@floristcloud/api-lib 1.2.115 → 1.2.117

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/report/get-write-off-summary.query.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { dateRangeCheck, isStatementPeriodWithinLimit } from '../../helpers/date.helper';
+import { MoneySchema } from '../../schemas/money.schema';
+import { WriteOffReportDateBasisEnum } from '../../enum/write-off-report-date-basis.enum';
+import {
+    REPORT_EXCLUDE_CLIENT_LIMIT,
+    REPORT_WRITE_OFF_CLIENT_LIMIT_DEFAULT,
+    REPORT_WRITE_OFF_CLIENT_LIMIT_MAX,
+} from '../../constant/report.constant';
+
+const GetWriteOffSummaryRequestSchema = z
+    .object({
+        startDate: z.coerce.date(),
+        endDate: z.coerce.date(),
+        dateBasis: z.nativeEnum(WriteOffReportDateBasisEnum).default(WriteOffReportDateBasisEnum.WRITE_OFF_DATE),
+        // Тот же формат, что в ReportOrderFilterSchema: CSV или повтор параметра. Применяется
+        // только к разрезу по клиентам — у складских списаний клиента нет.
+        excludeClientUUID: z
+            .union([z.string(), z.array(z.string())])
+            .transform(value => (Array.isArray(value) ? value : value.split(',')).map(item => item.trim()).filter(Boolean))
+            .pipe(z.array(z.string().uuid()).max(REPORT_EXCLUDE_CLIENT_LIMIT))
+            .optional(),
+        clientLimit: z.coerce
+            .number()
+            .int()
+            .positive()
+            .max(REPORT_WRITE_OFF_CLIENT_LIMIT_MAX)
+            .default(REPORT_WRITE_OFF_CLIENT_LIMIT_DEFAULT),
+    })
+    .refine(value => dateRangeCheck(value.startDate, value.endDate), {
+        message: 'validation.dateRange',
+        path: ['endDate', 'startDate'],
+    })
+    .refine(value => isStatementPeriodWithinLimit(value.startDate, value.endDate), {
+        message: 'validation.reportPeriodMax',
+        path: ['endDate', 'startDate'],
+    });
+
+const WriteOffSummaryReasonRowSchema = z.object({
+    // Свободный текст из справочника причин, схлопнут только по краевым пробелам (TRIM).
+    // Регистр не нормализуем: «Брак» и «брак» останутся разными строками.
+    reason: z.string(),
+    units: z.number(),
+    cost: MoneySchema,
+});
+
+const WriteOffSummaryClientRowSchema = z.object({
+    clientUUID: z.string(),
+    clientName: z.string(),
+    orderCount: z.number(),
+    units: z.number(),
+    cost: MoneySchema,
+    orderAmount: MoneySchema,
+});
+
+const GetWriteOffSummaryResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.object({
+        // totals = warehouse + byClient, считается по всем строкам — усечение `clientLimit`
+        // на итоги не влияет.
+        totals: z.object({
+            units: z.number(),
+            cost: MoneySchema,
+        }),
+        // Списания без заказа: до этого отчёта они не попадали ни в одну сводку.
+        warehouse: z.object({
+            units: z.number(),
+            cost: MoneySchema,
+            byReason: WriteOffSummaryReasonRowSchema.array(),
+        }),
+        // Списания по заказу: клиенту они уже вернулись на баланс, то есть это выручка,
+        // которой по факту не было.
+        byClient: z.object({
+            units: z.number(),
+            cost: MoneySchema,
+            orderAmount: MoneySchema,
+            rows: WriteOffSummaryClientRowSchema.array(),
+            // Сколько клиентов всего — чтобы отличить усечённый ответ от полного.
+            rowsTotal: z.number(),
+        }),
+    }),
+});
+
+export namespace GetWriteOffSummaryContractQuery {
+    export const RequestSchema = GetWriteOffSummaryRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = GetWriteOffSummaryResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/report/index.ts

@@ -12,6 +12,7 @@ export * from './export-client-statement.query';
 export * from './get-report-by-client-weeks.query';
 export * from './get-daily-orders-summary.query';
 export * from './get-cash-flow.query';
+export * from './get-write-off-summary.query';
 export * from './get-inventory-stock.query';
 export * from './get-inventory-turnover.query';
 export * from './get-sales-by-client.query';

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',
@@ -1185,6 +1193,7 @@ export const ERRORS = {
     REPORT_FETCH_FAILED: { code: 'REP001', message: 'Failed to fetch report', httpCode: 500 },
     REPORT_EXPORT_FAILED: { code: 'REP002', message: 'Failed to export report', httpCode: 500 },
     REPORT_NO_DATA: { code: 'REP003', message: 'No data available for the selected period', httpCode: 404 },
+    WRITE_OFF_SUMMARY_REPORT_FAILED: { code: 'REP004', message: 'Failed to build write-off summary report', httpCode: 500 },
     STATEMENT_PERIOD_TOO_LONG: { code: 'REP004', message: 'Statement period must not exceed 1 year', httpCode: 400 },
 
     // PAYMENT INVOICE
@@ -1518,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/constant/report.constant.ts

@@ -4,3 +4,12 @@
  * с массивом в тысячи элементов.
  */
 export const REPORT_EXCLUDE_CLIENT_LIMIT = 500;
+
+/**
+ * Сколько клиентов отдаётся в разрезе списаний по умолчанию и максимум. Итоги считаются по всем
+ * строкам независимо от лимита, поэтому усечение влияет только на список; отличить усечённый
+ * ответ от полного позволяет `rowsTotal`.
+ */
+export const REPORT_WRITE_OFF_CLIENT_LIMIT_DEFAULT = 50;
+
+export const REPORT_WRITE_OFF_CLIENT_LIMIT_MAX = 500;

package/enum/index.ts

@@ -100,3 +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/enum/write-off-report-date-basis.enum.ts

@@ -0,0 +1,14 @@
+/**
+ * По какой дате списание попадает в период отчёта.
+ *
+ * `WRITE_OFF_DATE` — дата самого списания. На ней живёт блок списаний вкладки «По продажам»:
+ * выручка там считается по дате заказа, поэтому списание, оформленное в июле по июньскому
+ * заказу, уменьшит операционную прибыль июля. Это осознанное допущение, оно подписано в UI.
+ *
+ * `CONSIGNMENT_DELIVERY_DATE` — дата поставки партии. На ней построен `/report/profit`, поэтому
+ * на этой оси итоги сходятся с его строками «Всего списано» и «Списано по заказам».
+ */
+export enum WriteOffReportDateBasisEnum {
+    WRITE_OFF_DATE = 'WRITE_OFF_DATE',
+    CONSIGNMENT_DELIVERY_DATE = 'CONSIGNMENT_DELIVERY_DATE',
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@floristcloud/api-lib",
-    "version": "1.2.115",
+    "version": "1.2.117",
     "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';