@floristcloud/api-lib 1.2.160 → 1.2.161

package/schemas/client/client-extended.schema.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { UserSchema } from '../user/user.schema';
+import { ClientIndividualProfileSchema } from './client-individual-profile.schema';
+import { ClientLegalProfileSchema } from './client-legal-profile.schema';
+import { DiscountRulesSchema } from '../discount-rules/discount-rules.schema';
+import { ClientMarkingSchema } from './client-marking.schema';
+
+import { ClientSchema } from './client-base.schema';
+
+export const ClientExtendedSchema = ClientSchema.extend({
+    user: UserSchema.nullable(),
+    clientIndividualProfile: ClientIndividualProfileSchema.nullable(),
+    clientLegalProfile: ClientLegalProfileSchema.nullable(),
+    discountRulesList: DiscountRulesSchema.array().optional(),
+    orderCount: z.number(),
+    responsibleUser: UserSchema.nullable(),
+    clientMarkingList: ClientMarkingSchema.array().optional(),
+    hasOverdueDebt: z.boolean().nullable().optional(),
+    isLoginBlocked: z.boolean(),
+});

package/schemas/client/client-for-client.schema.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { ClientStatusEnum, ClientContractStatusEnum, ClientTypeEnum } from '../../enum';
+import { MoneySchema } from '../money.schema';
+
+export const ClientForClientSchema = z.object({
+    uuid: z.uuid(),
+    name: z.string(),
+    contactName: z.string().nullable(),
+    phone: z.string().nullable(),
+    email: z.string().nullable(),
+    status: z.nativeEnum(ClientStatusEnum),
+    isCommon: z.boolean(),
+    contractNumber: z.string().nullable(),
+    contractDate: z.date().nullable(),
+    contractStatus: z.nativeEnum(ClientContractStatusEnum),
+    address: z.string().nullable(),
+    city: z.string().nullable(),
+    code: z.string().nullable(),
+    alwaysRequiresDelivery: z.boolean(),
+    additionalPhone: z.string().nullable(),
+    paymentGraceDaysAfterCompletion: z.number().nullable(),
+    balance: MoneySchema,
+    deletedAt: z.date().nullable(),
+    createdAt: z.date(),
+    updatedAt: z.date(),
+    clientType: z.nativeEnum(ClientTypeEnum),
+    responsibleUserUUID: z.uuid().nullable(),
+});

package/schemas/client/client-name.schema.ts

@@ -0,0 +1,4 @@
+import { ClientSchema } from './client-base.schema';
+
+// Клиент только по идентификатору и названию — для ссылок из чужого документа (платёж, касса).
+export const ClientNameSchema = ClientSchema.pick({ uuid: true, name: true });

package/schemas/client/client.schema.ts

@@ -1,62 +1,3 @@
-import { z } from 'zod';
-import { ClientStatusEnum } from '../../enum/client-status.enum';
-import { ClientContractStatusEnum } from '../../enum/client-contract-status.enum';
-import { ClientTypeEnum } from '../../enum/client-type.enum';
-import { UserSchema } from '../user/user.schema';
-import { ClientIndividualProfileSchema } from './client-individual-profile.schema';
-import { ClientLegalProfileSchema } from './client-legal-profile.schema';
-import { DiscountRulesSchema } from '../discount-rules/discount-rules.schema';
-import { ClientMarkingSchema } from './client-marking.schema';
-import { MoneySchema } from '../money.schema';
-
-export const ClientSchema = z.object({
-    uuid: z.uuid(),
-    name: z.string(),
-    contactName: z.string().nullable(),
-    phone: z.string().nullable(),
-    email: z.string().nullable(),
-    status: z.nativeEnum(ClientStatusEnum),
-    isCommon: z.boolean(),
-    contractNumber: z.string().nullable(),
-    contractDate: z.date().nullable(),
-    contractStatus: z.nativeEnum(ClientContractStatusEnum),
-    address: z.string().nullable(),
-    city: z.string().nullable(),
-    code: z.string().nullable(),
-    group: z.string().nullable(),
-    marking: z.string().nullable(),
-    alwaysRequiresDelivery: z.boolean(),
-    additionalPhone: z.string().nullable(),
-    comment: z.string().nullable(),
-    paymentGraceDaysAfterCompletion: z.number().nullable(),
-
-    balance: MoneySchema,
-
-    deletedAt: z.date().nullable(),
-    createdAt: z.date(),
-    updatedAt: z.date(),
-    companyUUID: z.uuid(),
-
-    clientType: z.nativeEnum(ClientTypeEnum),
-    responsibleUserUUID: z.uuid().nullable(),
-    responsibleSince: z.date().nullable(),
-});
-
-export const ClientExtendedSchema = ClientSchema.merge(
-    z.object({
-        user: UserSchema.nullable(),
-        clientIndividualProfile: ClientIndividualProfileSchema.nullable(),
-        clientLegalProfile: ClientLegalProfileSchema.nullable(),
-        discountRulesList: DiscountRulesSchema.array().optional(),
-        orderCount: z.number(),
-        responsibleUser: UserSchema.nullable(),
-        clientMarkingList: ClientMarkingSchema.array().optional(),
-        hasOverdueDebt: z.boolean().nullable().optional(),
-        isLoginBlocked: z.boolean(),
-    }),
-);
-
-export const ClientExtendedListSchema = z.object({
-    clientList: ClientExtendedSchema.array(),
-    total: z.number(),
-});
+export { ClientSchema } from './client-base.schema';
+export { ClientExtendedSchema } from './client-extended.schema';
+export { ClientExtendedListSchema } from './client-extended-list.schema';

package/schemas/client/get-client-me-webshop-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { ClientExtendedForClientSchema } from './client-extended-for-client.schema';
+
+export const GetClientMeWebshopResponseSchema = z.object({
+    message: z.string().optional(),
+    data: ClientExtendedForClientSchema,
+});

package/schemas/client/index.ts

@@ -1,7 +1,17 @@
 export * from './client.schema';
+export * from './client-name.schema';
 export * from './client-individual-profile.schema';
 export * from './client-legal-profile.schema';
 export * from './client-marking.schema';
 export * from './client-debt.schema';
 export * from './client-responsible-assignment.schema';
 export * from './client-responsible-assignment-result.schema';
+export * from './client-for-client.schema';
+export * from './client-extended-for-client.schema';
+export * from './get-client-me-webshop-response.schema';
+export * from './register-client-webshop-request.schema';
+export * from './register-client-webshop-response.schema';
+export * from './update-client-for-client-request.schema';
+export * from './update-client-for-client-response.schema';
+export * from './client-extended-list.schema';
+export * from './client-extended.schema';

package/schemas/client/register-client-webshop-request.schema.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { ClientTypeEnum } from '../../enum/client-type.enum';
+
+export const RegisterClientWebshopRequestSchema = z.object({
+    name: z.string(),
+    password: z.string(),
+    contactName: z.string().nullable(),
+    phone: z.string(),
+    email: z.email().toLowerCase(),
+    type: z.nativeEnum(ClientTypeEnum),
+});

package/schemas/client/register-client-webshop-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { ClientForClientSchema } from './client-for-client.schema';
+
+export const RegisterClientWebshopResponseSchema = z.object({
+    message: z.string().optional(),
+    data: ClientForClientSchema.nullable(),
+});

package/schemas/client/update-client-for-client-request.schema.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+export const UpdateClientForClientRequestSchema = z.object({
+    name: z.string(),
+    contactName: z.string().nullable(),
+    phone: z.string(),
+    email: z.email().toLowerCase(),
+    alwaysRequiresDelivery: z.boolean(),
+});

package/schemas/client/update-client-for-client-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { ClientForClientSchema } from './client-for-client.schema';
+
+export const UpdateClientForClientResponseSchema = z.object({
+    message: z.string().optional(),
+    data: ClientForClientSchema,
+});

package/schemas/consignment/consignment-distribution-validation.schema.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { ProductSchema } from '../product/product.schema';
+import { ProductSchema } from '../product/product-base.schema';
 import { ConsignmentDistributionValidationStatusEnum, ConsignmentDistributionValidationTypeEnum } from '../../enum';
-import { OrderProductExtendedSchema } from '../order-product/order-product.schema';
+import { OrderProductExtendedSchema } from '../order-product/order-product-extended.schema';
 
 export const ValidationProductSchema = z.object({
     type: z.literal(ConsignmentDistributionValidationTypeEnum.PACKAGE),

package/schemas/consignment/consignment.schema.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ConsignmentImportSchemaRelationEntityPropertyEnum, ConsignmentStatusEnum, ConsingmentImportErrorsEnum } from '../../enum';
-import { ClientSchema } from '../client';
+import { ClientSchema } from '../client/client-base.schema';
 import { MoneySchema } from '../money.schema';
 
 export const ConsignmentSchema = z.object({

package/schemas/discount-rules/discount-rules-data-for-client.schema.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+
+// Величина скидки клиента — только процент: остальная конфигурация правила ему не отдаётся.
+export const DiscountRulesDataForClientSchema = z.object({
+    discountPercent: z.number(),
+});

package/schemas/discount-rules/discount-rules-for-client.schema.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { DiscountRulesTypeEnum } from '../../enum';
+import { DiscountRulesDataForClientSchema } from './discount-rules-data-for-client.schema';
+
+// Покупателю доступны только процентные правила.
+export const DiscountRulesForClientSchema = z.object({
+    type: z.nativeEnum(DiscountRulesTypeEnum),
+    data: DiscountRulesDataForClientSchema,
+});

package/schemas/discount-rules/discount-rules.schema.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { DiscountRulesTypeEnum, DiscountRulesApplyTypeEnum, DiscountRulesStatusEnum, DiscountRulesModeTypeEnum } from '../../enum';
-import { ClientSchema } from '../client';
-import { ProductSchema } from '../product/product.schema';
+import { ClientSchema } from '../client/client-base.schema';
+import { ProductSchema } from '../product/product-base.schema';
 import { MoneySchema } from '../money.schema';
 import { NonNegativeMoneySchema } from '../non-negative-money.schema';
 import { PositiveMoneySchema } from '../positive-money.schema';

package/schemas/discount-rules/get-product-discount-price-request.schema.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+
+export const GetProductDiscountPriceRequestSchema = z.object({
+    productUUID: z.uuid(),
+    clientUUID: z.preprocess(val => {
+        return val === 'null' ? null : val;
+    }, z.uuid().nullable().optional()),
+});

package/schemas/discount-rules/get-product-discount-price-response.schema.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { ProductDiscountPriceDataSchema } from './product-discount-price-data.schema';
+
+/**
+ * Готовые цены товара для клиента: то, что нужно при работе с товаром, а не при настройке правил.
+ *
+ * Считает бэк тем же движком, что и для витрины, — панель формулу скидок не повторяет и
+ * себестоимость не получает. Настройка правил живёт отдельно, в `GetDiscountRulesAllContractQuery`.
+ *
+ * `null` в ценах со скидкой означает «скидка неприменима», а не «ноль».
+ */
+export const GetProductDiscountPriceResponseSchema = z.object({
+    message: z.string().optional(),
+    data: ProductDiscountPriceDataSchema,
+});

package/schemas/discount-rules/index.ts

@@ -0,0 +1,8 @@
+export * from './discount-rules.schema';
+export * from './discount-rules-data-for-client.schema';
+export * from './discount-rules-for-client.schema';
+export * from './get-product-discount-price-request.schema';
+export * from './get-product-discount-price-response.schema';
+export * from './product-discount-price-item.schema';
+export * from './product-discount-price-data.schema';
+export * from './product-discount-price-multiplicity-option.schema';

package/schemas/discount-rules/product-discount-price-data.schema.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { MoneySchema } from '../money.schema';
+import { ProductDiscountPriceItemSchema } from './product-discount-price-item.schema';
+import { ProductDiscountPriceMultiplicityOptionSchema } from './product-discount-price-multiplicity-option.schema';
+
+export const ProductDiscountPriceDataSchema = z.object({
+    productUUID: z.string(),
+    price: MoneySchema,
+    priceWithBestDiscount: MoneySchema.nullable(),
+    multiplicityOptions: ProductDiscountPriceMultiplicityOptionSchema.array(),
+    /**
+     * Варианты по базовой цене товара. Как и у фасовок, порядок не гарантирован: лучшую цену
+     * отдаёт `priceWithBestDiscount`.
+     */
+    discountDataList: ProductDiscountPriceItemSchema.array(),
+});

package/schemas/discount-rules/product-discount-price-item.schema.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { DiscountRulesTypeEnum } from '../../enum';
+import { discountPriceOutcomeSchema } from './discount-rules.schema';
+import { MoneySchema } from '../money.schema';
+
+/**
+ * Цена товара по одному правилу — для показа вариантов.
+ *
+ * `discountValueData` описывает, чем правило обернулось для этого товара, а не как оно настроено:
+ * у правила от себестоимости это готовая цена, и самой наценки здесь нет.
+ *
+ * В списки попадают только варианты, которые действительно снижают цену: правило, оставляющее базу
+ * как есть, выбором не является.
+ */
+export const ProductDiscountPriceItemSchema = z.object({
+    discountRulesUUID: z.string(),
+    type: z.nativeEnum(DiscountRulesTypeEnum),
+    discountValueData: discountPriceOutcomeSchema,
+    priceWithDiscount: MoneySchema,
+});

package/schemas/discount-rules/product-discount-price-multiplicity-option.schema.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { MoneySchema } from '../money.schema';
+import { ProductDiscountPriceItemSchema } from './product-discount-price-item.schema';
+
+export const ProductDiscountPriceMultiplicityOptionSchema = z.object({
+    uuid: z.string(),
+    optionPrice: MoneySchema.nullable(),
+    optionPriceWithDiscount: MoneySchema.nullable(),
+    isDiscountApplicable: z.boolean(),
+    /**
+     * Варианты по этой фасовке: те же правила, но посчитанные от её цены.
+     *
+     * Список свой у каждой кратности, потому что база у них разная — у правила нет
+     * одной цены на товар, пока не выбрана форма отгрузки. Пустой список означает
+     * «выбирать нечего»: скидки к этой кратности запрещены продавцом либо ни одно
+     * правило её цену не снижает.
+     *
+     * Порядок элементов не отсортирован по цене — он унаследован от сортировки правил
+     * товара, а база у фасовки другая. Лучшую цену берите из `optionPriceWithDiscount`,
+     * а не из первого элемента.
+     */
+    discountDataList: ProductDiscountPriceItemSchema.array(),
+});

package/schemas/index.ts

@@ -1,65 +1,43 @@
 export * from './i18n/localized-name.schema';
-export * from './category/category-create.schema';
-export * from './category/category-filter-value.schema';
+export * from './category';
 export * from './product-image/product-image-category-filter-value.schema';
-export * from './category/category-update.schema';
-export * from './category/category-list-filter.schema';
-export * from './category/category-list.schema';
 export * from './type/type-create.schema';
 export * from './type/type-update.schema';
 export * from './company/company.schema';
-export * from './client/client.schema';
-export * from './user/user.schema';
-export * from './product/product.schema';
-export * from './product/product-list.schema';
-export * from './product/get-product-list-request.schema';
-export * from './product/get-product-list-response.schema';
-export * from './product/export-stock-products-request.schema';
-export * from './product/export-stock-products-response.schema';
-export * from './write-off/write-off.schema';
-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 './client';
+export * from './user';
+export * from './product';
+export * from './write-off';
+export * from './order';
 export * from './order-delivery/order-delivery.schema';
-export * from './order-product/order-product.schema';
-export * from './order-product/order-product-list.schema';
-export * from './order-product/order-product-multiplicity-optiom.schema';
-export * from './order-product/price-correction-analyze-item.schema';
-export * from './order-product/price-correction-execute-result-item.schema';
-export * from './order-product/price-correction-execute-order-item.schema';
-export * from './transaction/transaction.schema';
-export * from './transaction/transaction-list.schema';
+export * from './order-product';
+export * from './transaction';
 export * from './cash-flow-item/cash-flow-item.schema';
 export * from './file';
 export * from './product-image/product-image.schema';
 export * from './settings/settings.schema';
 export * from './payment-invoice/payment-invoice.schema';
-export * from './money-account/money-account.schema';
-export * from './money-account/money-account-with-balance.schema';
+export * from './money-account';
 export * from './domain/domain.schema';
-export * from './category/category.schema';
 export * from './branch/branch.schema';
 export * from './category-alias/category-alias.schema';
 export * from './category-template/category-template.schema';
 export * from './consignment/consignment.schema';
 export * from './consignment-import-schema/consignment-import-schema.scheme';
-export * from './money-account/money-account.schema';
 export * from './type/type.schema';
 export * from './package/package.schema';
 export * from './product-in-package/product-in-package.schema';
 export * from './category-template';
 export * from './distribution/distribution.schema';
-export * from './pre-order-collection/pre-order-collection.schema';
-export * from './pre-order-collection-item/pre-order-collection-item.schema';
-export * from './pre-order/pre-order.schema';
-export * from './pre-order-product/pre-order-product.schema';
+export * from './pre-order-collection';
+export * from './pre-order-collection-item';
+export * from './pre-order';
+export * from './pre-order-product';
 export * from './delete-data-response.schema';
 export * from './consignment-import-schema-relation/consignment-import-schema-relation.schema';
 export * from './employee-schedule/employee-schedule.schema';
 export * from './work-session/work-session.schema';
-export * from './discount-rules/discount-rules.schema';
+export * from './discount-rules';
 export * from './package/validate-package.schema';
 export * from './service/service.schema';
 export * from './order-service-line/order-service-line.schema';
@@ -78,15 +56,10 @@ export * from './report/sales-by-client-top-item.schema';
 export * from './report/sales-by-client-row.schema';
 export * from './action-log/index';
 export * from './delivery-route/delivery-route.schema';
-export * from './product/product-multiplicity-option.schema';
-export * from './product/product-multiplicity-option-for-client.schema';
-export * from './pre-order/pre-order-copy.schema';
-export * from './pre-order-collection-item/pre-order-collection-item-multiplicity-option.schema';
 export * from './message';
 export * from './product-configuration/product-configuration.schema';
 export * from './bank-payment';
 export * from './bank-payment-rule/bank-payment-rule.schema';
-export * from './client';
 export * from './client-payment-identifier/client-payment-identifier.schema';
 export * from './bank-payment/get-bank-payment-match-suggestions.schema';
 export * from './messenger-profile';
@@ -113,3 +86,4 @@ export * from './attribute-normalization/product-image-duplicate-forecast.schema
 export * from './report/user-activity-by-section.schema';
 export * from './report/user-activity-summary-row.schema';
 export * from './report/user-activity-timeline-row.schema';
+export * from './pagination-request.schema';

package/schemas/money-account/index.ts

@@ -0,0 +1,3 @@
+export * from './money-account.schema';
+export * from './money-account-name.schema';
+export * from './money-account-with-balance.schema';

package/schemas/money-account/money-account-name.schema.ts

@@ -0,0 +1,4 @@
+import { MoneyAccountSchema } from './money-account.schema';
+
+// Касса глазами покупателя — только название: роли и компания счёта внутренние.
+export const MoneyAccountNameSchema = MoneyAccountSchema.pick({ uuid: true, name: true });

package/schemas/order/create-cart-request.schema.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+
+export const CreateCartRequestSchema = z.object({});

package/schemas/order/create-cart-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { OrderForClientSchema } from './order-for-client.schema';
+
+export const CreateCartResponseSchema = z.object({
+    message: z.string().optional(),
+    data: OrderForClientSchema,
+});

package/schemas/order/get-order-for-client-list-request.schema.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { dateRangeCheck, setEndDay, setStartDay } from '../../helpers/date.helper';
+import { OrderStatusEnum } from '../../enum/order-status.enum';
+import { OrderWebshopAvailableStatusList } from '../../enum';
+
+export const GetOrderForClientListRequestSchema = z
+    .object({
+        page: z.coerce.number().default(1),
+        count: z.coerce.number().default(10),
+        startDate: z.coerce
+            .date()
+            .optional()
+            .transform(val => (val ? setStartDay(val) : val)),
+        endDate: z.coerce
+            .date()
+            .optional()
+            .transform(val => (val ? setEndDay(val) : val)),
+        isPaid: z.coerce.boolean().optional(),
+        statuses: z
+            .nativeEnum(OrderStatusEnum)
+            .array()
+            .optional()
+            .transform(arr => (arr && arr.length === 0 ? OrderWebshopAvailableStatusList : (arr ?? OrderWebshopAvailableStatusList)))
+            .default(OrderWebshopAvailableStatusList)
+            .refine(arr => arr.every(s => OrderWebshopAvailableStatusList.includes(s)), {
+                message: 'validation.statusNotAllowedWebshop',
+            }),
+    })
+    .refine(
+        value => {
+            const { startDate, endDate } = value;
+            if (startDate && endDate) {
+                return dateRangeCheck(startDate, endDate);
+            }
+            return true;
+        },
+        {
+            message: 'validation.dateRange',
+            path: ['endDate', 'startDate'],
+        },
+    );

package/schemas/order/get-order-for-client-list-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { OrderExtendedForClientListSchema } from './order-extended-for-client-list.schema';
+
+export const GetOrderForClientListResponseSchema = z.object({
+    message: z.string().optional(),
+    data: OrderExtendedForClientListSchema,
+});

package/schemas/order/get-order-for-client-request.schema.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+
+export const GetOrderForClientRequestSchema = z.object({});

package/schemas/order/get-order-for-client-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { OrderExtendedForClientSchema } from './order-extended-for-client.schema';
+
+export const GetOrderForClientResponseSchema = z.object({
+    message: z.string().optional(),
+    data: OrderExtendedForClientSchema.nullable(),
+});

package/schemas/order/index.ts

@@ -0,0 +1,14 @@
+export * from './create-cart-request.schema';
+export * from './create-cart-response.schema';
+export * from './get-order-for-client-list-request.schema';
+export * from './get-order-for-client-list-response.schema';
+export * from './get-order-for-client-request.schema';
+export * from './get-order-for-client-response.schema';
+export * from './order-extended-for-client-list.schema';
+export * from './order-extended-for-client.schema';
+export * from './order-external-number.schema';
+export * from './order-for-client.schema';
+export * from './order.schema';
+export * from './update-cart-delivery-request.schema';
+export * from './update-cart-request.schema';
+export * from './update-cart-response.schema';

package/schemas/order/order-base.schema.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { OrderStatusEnum, OrderTypeEnum } from '../../enum';
+import { MoneySchema } from '../money.schema';
+import { CalendarDaySchema } from '../calendar-day.schema';
+
+export const OrderSchema = z.object({
+    uuid: z.uuid(),
+    orderNumber: z.number(),
+    clientUUID: z.uuid(),
+    branchUUID: z.uuid().nullable(),
+    creatorUserUUID: z.uuid(),
+
+    totalCost: MoneySchema,
+    subtotal: MoneySchema,
+    deliveryCost: MoneySchema,
+    deliveryCheckAmount: MoneySchema,
+    deliveryVatAmount: MoneySchema,
+    deliveryVat: z.number().nullable(),
+    vatAmount: MoneySchema,
+    discountAmount: MoneySchema,
+    discount: z.number().nullable(),
+
+    status: z.nativeEnum(OrderStatusEnum),
+    type: z.nativeEnum(OrderTypeEnum),
+    isPaid: z.boolean(),
+
+    comment: z.string().nullable(),
+    clientComment: z.string().nullable(),
+    tag: z.string().nullable(),
+
+    totalQuantity: z.number(),
+    totalProductNumber: z.number(),
+    invoiceSendAt: z.date().nullable(),
+    deliveryRouteUUID: z.uuid().nullable(),
+    // Счёт на оплату, в который включён заказ. Сам счёт (номер, файл, статус оплаты) читается
+    // отдельным запросом GET /payment-invoice/:uuid — здесь только ссылка, чтобы не утяжелять список заказов.
+    paymentInvoiceUUID: z.uuid().nullable(),
+    // Передаточный документ (УПД), в который включён заказ. Тем же приёмом, что и счёт: здесь только
+    // ссылка, документ читается через GET /transfer-document/:uuid. Непустое значение означает, что
+    // заказ заморожен — состав, статус, доставка, дата отгрузки и скидка ему уже недоступны.
+    transferDocumentUUID: z.uuid().nullable(),
+    // Номер заказа в ERP/CRM компании, которым сотрудники сверяют заказ со своей учётной системой.
+    externalNumber: z.string().nullable(),
+
+    completedAt: z.date().nullable(),
+    paymentDueAt: z.date().nullable(),
+    // План отгрузки/выдачи — одна дата для самовывоза и доставки, календарный день `YYYY-MM-DD`.
+    // Не путать с `completedAt` (факт отгрузки) и датой прихода партии.
+    plannedShipmentDate: CalendarDaySchema.nullable(),
+
+    createdAt: z.date(),
+    updatedAt: z.date(),
+    deletedAt: z.date().nullable(),
+});

package/schemas/order/order-extended-for-client-list.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { OrderExtendedForClientSchema } from './order-extended-for-client.schema';
+
+export const OrderExtendedForClientListSchema = z.object({
+    orderList: OrderExtendedForClientSchema.array(),
+    total: z.number(),
+});

package/schemas/order/order-extended-for-client.schema.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { OrderForClientSchema } from './order-for-client.schema';
+import { ClientForClientSchema } from '../client/client-for-client.schema';
+import { BranchSchema } from '../branch/branch.schema';
+import { OrderDeliverySchema } from '../order-delivery/order-delivery.schema';
+import { MoneySchema } from '../money.schema';
+
+export const OrderExtendedForClientSchema = OrderForClientSchema.extend({
+    client: ClientForClientSchema,
+    branch: BranchSchema.nullable(),
+    delivery: OrderDeliverySchema.nullable(),
+    writeOffSum: MoneySchema,
+    consignmentDeliveryDates: z.union([z.date(), z.literal('in-stock')]).array(),
+    // Server-computed delivery cost for the current subtotal when the tier rule is on (null when off).
+    // Convenience preview for the cart page; the storefront still recomputes locally on the delivery/pickup toggle.
+    deliveryCostPreview: MoneySchema.nullable(),
+});