@floristcloud/api-lib 1.2.167 → 1.2.169

package/schemas/payment-invoice/create-payment-invoice-request.schema.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { PositiveMoneySchema } from '../positive-money.schema';
+
+// Потолок числа заказов в счёте. Это защита от абсурдного запроса, а не бизнес-правило: счёт за месяц
+// клиенту с ежедневными поставками — это уже 30 строк, поэтому 10-20 отрезали бы живые сценарии.
+// Сто строк — это 3-4 страницы таблицы, документ такого размера собирается и читается нормально.
+const MAX_INVOICE_ORDER_COUNT = 100;
+
+// Счёт выставляется одним из двух способов:
+//  - по заказам: orderUUIDs непустой, итог считается на бэке как сумма totalCost этих заказов,
+//    а amount — необязательная правка итога (например скидка по счёту), она уходит отдельной строкой;
+//  - вручную: orderUUIDs пуст, тогда amount обязателен и становится единственной строкой счёта.
+export const CreatePaymentInvoiceRequestSchema = z
+    .object({
+        clientUUID: z.uuid(),
+        // Карточка реквизитов покупателя. Не передана — счёт выписывается на основную карточку клиента.
+        clientLegalProfileUUID: z.uuid().optional(),
+        invoiceDate: z.coerce.date(),
+        orderUUIDs: z.uuid().array().max(MAX_INVOICE_ORDER_COUNT).optional(),
+        // Строго положительная сумма: отсекаем минус по знаку строки и нулевые записи вида "0" / "0.00".
+        amount: PositiveMoneySchema.optional(),
+    })
+    .refine(value => Boolean(value.orderUUIDs?.length) || value.amount !== undefined, {
+        message: 'Either orderUUIDs or amount must be provided',
+        path: ['amount'],
+    });

package/schemas/payment-invoice/create-payment-invoice-response.schema.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { PaymentInvoiceSchema } from './payment-invoice.schema';
+
+export const CreatePaymentInvoiceResponseSchema = z.object({
+    message: z.string().optional(),
+    data: PaymentInvoiceSchema,
+});

package/schemas/payment-invoice/payment-invoice.schema.ts

@@ -21,6 +21,8 @@ export const PaymentInvoiceSchema = z.object({
     remainingAmount: MoneySchema,
     status: z.nativeEnum(PaymentInvoiceStatusEnum),
     clientUUID: z.string(),
+    // Карточка реквизитов, на которую выписан счёт; null — у старых счетов и у клиентов без карточек.
+    clientLegalProfileUUID: z.string().nullable(),
     clientName: z.string(),
     contractNumber: z.string().nullable(),
     contractDate: z.coerce.date().nullable(),