@fiado/type-kit 3.463.0 → 3.465.0

package/src/moneyTransfer/dtos/MoneyTransferServiceUpdateRequest.ts

@@ -0,0 +1,87 @@
+import { Type } from "class-transformer";
+import {
+    ArrayMinSize,
+    IsArray,
+    IsBoolean,
+    IsInt,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    Length,
+    Min,
+    ValidateNested,
+} from "class-validator";
+import { MoneyTransferProductRequest } from "./MoneyTransferProductRequest";
+
+/**
+ * Actualización parcial de un servicio de transferencia de dinero. Mismos campos que
+ * `MoneyTransferServiceCreateRequest`, todos opcionales (el repo no cuenta con `PartialType`,
+ * por eso se declara a mano). Si viene `productoDTOList` reemplaza la lista completa.
+ */
+export class MoneyTransferServiceUpdateRequest {
+    @IsOptional()
+    @IsInt()
+    @Min(90000)
+    idServicio?: number;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    servicio?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    categoria?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    subcategoria?: string;
+
+    @IsOptional()
+    @IsInt()
+    categoryOrder?: number;
+
+    @IsOptional()
+    @IsInt()
+    subcategoryOrder?: number;
+
+    @IsOptional()
+    @IsInt()
+    serviceOrder?: number;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    beneficeId?: string;
+
+    @IsOptional()
+    @IsBoolean()
+    enabled?: boolean;
+
+    @IsOptional()
+    @IsString()
+    @Length(3, 3)
+    currencyId?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    serviceCountryId?: string;
+
+    @IsOptional()
+    @IsString()
+    logoSrc?: string;
+
+    @IsOptional()
+    @IsInt()
+    idCatTipoServicio?: number;
+
+    @IsOptional()
+    @ValidateNested({ each: true })
+    @Type(() => MoneyTransferProductRequest)
+    @IsArray()
+    @ArrayMinSize(1)
+    productoDTOList?: MoneyTransferProductRequest[];
+}

package/src/moneyTransfer/dtos/PendingDetailsResponse.ts

@@ -0,0 +1,9 @@
+import { TransactionDetailResponse } from "./TransactionDetailResponse";
+
+/** Página de folios pendientes de liquidar, con totales agregados de la página. */
+export class PendingDetailsResponse {
+    items!: TransactionDetailResponse[];
+    count!: number;
+    totalAmount!: number;
+    nextToken?: string;
+}

package/src/moneyTransfer/dtos/RescheduleSettlementRequest.ts

@@ -0,0 +1,9 @@
+import { IsInt, Min } from "class-validator";
+import { SettlementActionRequest } from "./SettlementActionRequest";
+
+/** Reprograma una liquidación en `SCHEDULED`; `scheduledAt` es epoch ms. */
+export class RescheduleSettlementRequest extends SettlementActionRequest {
+    @IsInt()
+    @Min(0)
+    scheduledAt!: number;
+}

package/src/moneyTransfer/dtos/SettlementActionRequest.ts

@@ -0,0 +1,7 @@
+import { IsUUID } from "class-validator";
+
+/** Body común de las acciones sobre una liquidación (enviar, cancelar, reintentar). */
+export class SettlementActionRequest {
+    @IsUUID()
+    idempotencyKey!: string;
+}

package/src/moneyTransfer/dtos/SettlementListResponse.ts

@@ -0,0 +1,7 @@
+import { SettlementResponse } from "./SettlementResponse";
+
+/** Página de liquidaciones (sin `details`). */
+export class SettlementListResponse {
+    items!: SettlementResponse[];
+    nextToken?: string;
+}

package/src/moneyTransfer/dtos/SettlementResponse.ts

@@ -0,0 +1,37 @@
+import { SettlementStatusEnum } from "../enums/SettlementStatusEnum";
+import { TransferChannelEnum } from "../enums/TransferChannelEnum";
+import { TransactionDetailResponse } from "./TransactionDetailResponse";
+
+/**
+ * Liquidación (lote de folios de un producto enviado al riel). Sin decoradores
+ * `class-validator`: el consumidor la lee tal cual viene por la red. Timestamps en epoch ms.
+ */
+export class SettlementResponse {
+    settlementId!: string;
+    tenantId!: string;
+    productId!: string;
+    serviceId!: number;
+    channel!: TransferChannelEnum;
+    currency!: string;
+    beneficiaryName!: string;
+    totalAmount!: number;
+    itemCount!: number;
+    status!: SettlementStatusEnum;
+    scheduledAt?: number;
+    /** Id de la transacción en el riel (ACH) o clave de rastreo (SPEI). */
+    achTransactionId?: string;
+    returnReason?: string;
+    lastError?: string;
+    /** `true` cuando el envío no obtuvo respuesta concluyente del riel (posible duplicado). */
+    uncertain?: boolean;
+    attempts!: number;
+    attemptedAt?: number;
+    sentAt?: number;
+    settledAt?: number;
+    createdBy!: string;
+    sentBy?: string;
+    createdAt!: number;
+    updatedAt!: number;
+    /** Folios incluidos; solo viene en el detalle, no en el listado. */
+    details?: TransactionDetailResponse[];
+}

package/src/moneyTransfer/dtos/SettlementStatusMessage.ts

@@ -0,0 +1,23 @@
+import { IsEnum, IsNotEmpty, IsOptional, IsString, MaxLength } from "class-validator";
+import { SpeiOrderStatusEnum } from "../enums/SpeiOrderStatusEnum";
+
+/**
+ * Mensaje asíncrono con el estado de una orden SPEI (lo emite el conector STP y lo consume
+ * `money-transfer-connector` para cerrar la liquidación). `claveRastreo` es la clave de
+ * rastreo SPEI (máx. 30 chars según STP).
+ */
+export class SettlementStatusMessage {
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(30)
+    claveRastreo!: string;
+
+    @IsEnum(SpeiOrderStatusEnum)
+    status!: SpeiOrderStatusEnum;
+
+    /** Motivo reportado por el riel (devolución / cancelación). */
+    @IsOptional()
+    @IsString()
+    @MaxLength(256)
+    reason?: string;
+}

package/src/moneyTransfer/dtos/TransactionDetailResponse.ts

@@ -0,0 +1,25 @@
+import { SettlementModeEnum } from "../enums/SettlementModeEnum";
+import { TransactionDetailStatusEnum } from "../enums/TransactionDetailStatusEnum";
+import { TransferChannelEnum } from "../enums/TransferChannelEnum";
+
+/**
+ * Folio cobrado al usuario pendiente de (o ya incluido en) una liquidación.
+ * Sin decoradores `class-validator`: el consumidor la lee tal cual viene por la red.
+ */
+export class TransactionDetailResponse {
+    transactionNumber!: string;
+    directoryId!: string;
+    tenantId!: string;
+    serviceId!: number;
+    productId!: string;
+    channel!: TransferChannelEnum;
+    amount!: number;
+    currency!: string;
+    reference!: string;
+    settlementMode!: SettlementModeEnum;
+    status!: TransactionDetailStatusEnum;
+    /** Presente cuando el folio ya fue agrupado en una liquidación. */
+    settlementId?: string;
+    /** Epoch ms. */
+    createdAt!: number;
+}

package/src/moneyTransfer/enums/SettlementModeEnum.ts

@@ -0,0 +1,5 @@
+/** Cuándo se liquida al beneficiario: en el momento del pago o agrupado en un lote programado. */
+export enum SettlementModeEnum {
+    IMMEDIATE = 'IMMEDIATE',
+    BATCH = 'BATCH',
+}

package/src/moneyTransfer/enums/SettlementStatusEnum.ts

@@ -0,0 +1,11 @@
+/** Ciclo de vida de una liquidación (lote de folios enviado al riel). */
+export enum SettlementStatusEnum {
+    CREATED = 'CREATED',
+    SCHEDULED = 'SCHEDULED',
+    SENDING = 'SENDING',
+    SENT = 'SENT',
+    SETTLED = 'SETTLED',
+    RETURNED = 'RETURNED',
+    FAILED = 'FAILED',
+    CANCELLED = 'CANCELLED',
+}

package/src/moneyTransfer/enums/SpeiOrderStatusEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado de una orden SPEI tal como lo reporta STP (LQ liquidada, D devuelta, CN cancelada),
+ * más los estados internos PENDING (sin respuesta aún) y UNKNOWN (código no mapeado).
+ */
+export enum SpeiOrderStatusEnum {
+    LQ = 'LQ',
+    D = 'D',
+    CN = 'CN',
+    PENDING = 'PENDING',
+    UNKNOWN = 'UNKNOWN',
+}

package/src/moneyTransfer/enums/TransactionDetailStatusEnum.ts

@@ -0,0 +1,7 @@
+/** Estado de un folio individual (transacción cobrada al usuario) respecto a su liquidación. */
+export enum TransactionDetailStatusEnum {
+    PENDING_SETTLEMENT = 'PENDING_SETTLEMENT',
+    SETTLED = 'SETTLED',
+    RETURNED = 'RETURNED',
+    FAILED = 'FAILED',
+}

package/src/moneyTransfer/enums/TransferChannelEnum.ts

@@ -0,0 +1,5 @@
+/** Riel por el que se dispersa el dinero al beneficiario del producto. */
+export enum TransferChannelEnum {
+    SPEI = 'SPEI',
+    ACH = 'ACH',
+}

package/src/moneyTransfer/index.ts

@@ -0,0 +1,27 @@
+// moneyTransfer — money-transfer-connector (Centro de Beneficios)
+// Contrato del conector de transferencias de dinero: catálogo de servicios/productos con riel
+// (SPEI/ACH) y modo de liquidación (inmediata/lote), liquidaciones y estado de órdenes SPEI.
+
+//Enums
+export * from './enums/TransferChannelEnum';
+export * from './enums/SettlementModeEnum';
+export * from './enums/SettlementStatusEnum';
+export * from './enums/TransactionDetailStatusEnum';
+export * from './enums/SpeiOrderStatusEnum';
+
+//Mensajes async (SQS FIFO money-transfer-settlement-status, DEC-013)
+export * from './dtos/SettlementStatusMessage';
+//DTOs — requests
+export * from './dtos/BatchScheduleRequest';
+export * from './dtos/MoneyTransferProductRequest';
+export * from './dtos/MoneyTransferServiceCreateRequest';
+export * from './dtos/MoneyTransferServiceUpdateRequest';
+export * from './dtos/CreateSettlementRequest';
+export * from './dtos/SettlementActionRequest';
+export * from './dtos/RescheduleSettlementRequest';
+
+//DTOs — responses
+export * from './dtos/TransactionDetailResponse';
+export * from './dtos/SettlementResponse';
+export * from './dtos/PendingDetailsResponse';
+export * from './dtos/SettlementListResponse';

package/src/productCatalog/enums/ProductTypeEnum.ts

@@ -58,5 +58,10 @@ export enum ProductTypeEnum {
      * Reversa de un reembolso anterior — se devuelve el dinero del reembolso al cliente
      * cuando el dictamen fue incorrecto o se detectó fraude post-reembolso.
      */
-    REFUND_PCF_REVERSE = "REFUND_PCF_REVERSE"
+    REFUND_PCF_REVERSE = "REFUND_PCF_REVERSE",
+    /**
+     * Dispersión SPEI de liquidaciones de beneficios (money-transfer-connector).
+     * Producto del catálogo para la orden STP que sale con `source=BENEFITS_SETTLEMENT`.
+     */
+    MONEY_TRANSFER_SA = "MONEY_TRANSFER_SA"
 }

package/src/provider/enums/Provider.ts

@@ -10,5 +10,6 @@ export enum Provider {
     MULTICENTER_SERVICE_PAYMENT = "MULTICENTER_SERVICE_PAYMENT",
     UNITELLER = "UNITELLER",
     EQUALITY = "EQUALITY",
-    SYNERGYPAY = "SYNERGYPAY"
+    SYNERGYPAY = "SYNERGYPAY",
+    MONEY_TRANSFER = "MONEY_TRANSFER"
 }

package/src/retailCatalog/constants/AdjustmentReasons.ts

@@ -0,0 +1,8 @@
+import { InventoryMovementReasonEnum } from '../enums/InventoryMovementReasonEnum';
+
+/** Motivos que el admin puede registrar en un ajuste; DAMAGED_RETURN lo genera la devolución. */
+export const ADJUSTMENT_REASONS = [
+    InventoryMovementReasonEnum.SHRINKAGE,
+    InventoryMovementReasonEnum.ADJUSTMENT,
+    InventoryMovementReasonEnum.WARRANTY,
+];

package/src/retailCatalog/constants/NonBundleCategories.ts

@@ -0,0 +1,4 @@
+import { ProductCategoryEnum } from '../enums/ProductCategoryEnum';
+
+/** Categorías que admite el alta y la edición de producto; el kit (BUNDLE) tiene su propio endpoint. */
+export const NON_BUNDLE_CATEGORIES = Object.values(ProductCategoryEnum).filter((c) => c !== ProductCategoryEnum.BUNDLE);

package/src/retailCatalog/dtos/Product.ts

@@ -4,6 +4,7 @@ import { ProductStatusEnum } from '../enums/ProductStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
 import { ProductCategoryEnum } from '../enums/ProductCategoryEnum';
 import { TrackingModeEnum } from '../enums/TrackingModeEnum';
+import { ItemTypeEnum } from '../enums/ItemTypeEnum';
 import { ProductComponent } from './ProductComponent';
 
 /**
@@ -48,4 +49,6 @@ export class Product {
     components?: ProductComponent[] | null;
     /** Llave del registro PRICE# del que salen basePriceCents y listPriceCents. */
     currentPriceSk?: string | null;
+    /** Producto físico o servicio; inmutable tras el alta. Ausente = PRODUCT. */
+    itemType?: ItemTypeEnum;
 }

package/src/retailCatalog/dtos/requests/BackofficeCreateKitRequest.ts

@@ -0,0 +1,47 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsBoolean, IsOptional, IsString, Length, Matches, ValidateNested } from 'class-validator';
+import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { ProductComponent } from '../ProductComponent';
+
+/** Body de POST /backoffice/catalog/kits (backofficeCreateKit); category BUNDLE y origen BACKOFFICE los fija el servidor. */
+export class BackofficeCreateKitRequest {
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    @IsBoolean()
+    sellable!: boolean;
+
+    @IsBoolean()
+    showInSalesFlow!: boolean;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => ProductComponent)
+    components!: ProductComponent[];
+
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    description?: string;
+
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    imageUrl?: string;
+
+    /** Id del SKU en el sistema del retailer. */
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    externalId?: string;
+
+    /** Financieras que pueden financiar este SKU; vacío = no financiable. */
+    @IsOptional()
+    @IsArray()
+    @Matches(/\S/, { each: true })
+    @IsString({ each: true })
+    eligibleFinanciers?: string[];
+}

package/src/retailCatalog/dtos/requests/BackofficeCreateProductRequest.ts

@@ -0,0 +1,92 @@
+import { IsArray, IsBoolean, IsEnum, IsIn, IsOptional, IsString, Length, Matches, Validate, ValidateIf } from 'class-validator';
+import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { NON_BUNDLE_CATEGORIES } from '../../constants/NonBundleCategories';
+import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../enums/ProductTierEnum';
+import { TrackingModeEnum } from '../../enums/TrackingModeEnum';
+import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
+import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
+import { IsMdmCoherentConstraint } from '../../validators/IsMdmCoherentConstraint';
+
+/** Body de POST /backoffice/catalog/products (backofficeCreateProduct); itemType PRODUCT y origen BACKOFFICE los fija el servidor. */
+export class BackofficeCreateProductRequest {
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    /** El kit (BUNDLE) se da de alta en backofficeCreateKit. */
+    @IsIn(NON_BUNDLE_CATEGORIES)
+    category!: ProductCategoryEnum;
+
+    /** Inmutable tras el alta. */
+    @IsEnum(TrackingModeEnum)
+    trackingMode!: TrackingModeEnum;
+
+    @IsBoolean()
+    sellable!: boolean;
+
+    @IsBoolean()
+    showInSalesFlow!: boolean;
+
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    tier?: ProductTierEnum;
+
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    brand?: string;
+
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    model?: string;
+
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    capacity?: string;
+
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    color?: string;
+
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    description?: string;
+
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    imageUrl?: string;
+
+    /** Id del SKU en el sistema del retailer. */
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    externalId?: string;
+
+    /** Financieras que pueden financiar este SKU; vacío = no financiable. */
+    @IsOptional()
+    @IsArray()
+    @Matches(/\S/, { each: true })
+    @IsString({ each: true })
+    eligibleFinanciers?: string[];
+
+    /** En el alta se evalúa aunque falte: si vienen mdmProvider o mdmLockMode, exige mdmEnabled=true. */
+    @Validate(IsMdmCoherentConstraint)
+    @ValidateIf((o: BackofficeCreateProductRequest) => o.mdmEnabled != null || o.mdmProvider != null || o.mdmLockMode != null)
+    @IsBoolean()
+    mdmEnabled?: boolean;
+
+    @IsOptional()
+    @IsEnum(MdmProviderEnum)
+    mdmProvider?: MdmProviderEnum | null;
+
+    @IsOptional()
+    @IsEnum(MdmLockModeEnum)
+    mdmLockMode?: MdmLockModeEnum | null;
+}

package/src/retailCatalog/dtos/requests/BackofficeCreateServiceRequest.ts

@@ -0,0 +1,26 @@
+import { IsBoolean, IsOptional, IsString, Length, Matches } from 'class-validator';
+import { SKU_PATTERN } from '../../constants/SkuPattern';
+
+/** Body de POST /backoffice/catalog/services (backofficeCreateService); itemType SERVICE y trackingMode QUANTITY los fija el servidor. */
+export class BackofficeCreateServiceRequest {
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    @Matches(/\S/)
+    @IsString()
+    description!: string;
+
+    @IsBoolean()
+    sellable!: boolean;
+
+    @IsBoolean()
+    showInSalesFlow!: boolean;
+
+    /** Id del SKU en el sistema del retailer. */
+    @IsOptional()
+    @Matches(/\S/)
+    @IsString()
+    externalId?: string;
+}

package/src/retailCatalog/dtos/requests/BackofficeCreateSkuPriceRequest.ts

@@ -0,0 +1,19 @@
+import { IsInt, IsOptional, Min } from 'class-validator';
+
+/** Body de POST /backoffice/inventory/skus/{sku}/prices (backofficeCreateSkuPrice); crea un PRICE# nuevo con origen BACKOFFICE. */
+export class BackofficeCreateSkuPriceRequest {
+    @IsInt()
+    @Min(0)
+    basePriceCents!: number;
+
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    listPriceCents?: number | null;
+
+    /** Precio dentro de un kit; se guarda, ninguna venta lo aplica. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    comboPriceCents?: number;
+}

package/src/retailCatalog/dtos/requests/BackofficeCreateTransferRequest.ts

@@ -0,0 +1,31 @@
+import { ArrayMinSize, ArrayUnique, IsArray, IsInt, IsOptional, IsString, Length, Matches, Min } from 'class-validator';
+import { SKU_PATTERN } from '../../constants/SkuPattern';
+
+/** Body de POST /backoffice/inventory/transfers (backofficeCreateTransfer); origen = destino lo rechaza el dominio. */
+export class BackofficeCreateTransferRequest {
+    @Matches(/^\S+$/)
+    @IsString()
+    fromStoreId!: string;
+
+    @Matches(/^\S+$/)
+    @IsString()
+    toStoreId!: string;
+
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+
+    /** IMEI o serie de cada pieza; ausente si el SKU se rastrea por cantidad. */
+    @IsOptional()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayUnique()
+    @Matches(/^\S+$/, { each: true })
+    @IsString({ each: true })
+    identifiers?: string[];
+}

package/src/retailCatalog/dtos/requests/BackofficeListTransfersQuery.ts

@@ -0,0 +1,9 @@
+import { IsEnum, IsOptional } from 'class-validator';
+import { TransferStateEnum } from '../../enums/TransferStateEnum';
+
+/** Query de GET /backoffice/inventory/transfers (backofficeListTransfers); el retailer sale del token. */
+export class BackofficeListTransfersQuery {
+    @IsOptional()
+    @IsEnum(TransferStateEnum)
+    state?: TransferStateEnum;
+}

package/src/retailCatalog/dtos/requests/BackofficeRegisterAdjustmentRequest.ts

@@ -0,0 +1,34 @@
+import { ArrayMinSize, ArrayUnique, IsArray, IsIn, IsInt, IsOptional, IsString, Length, Matches, Min } from 'class-validator';
+import { ADJUSTMENT_REASONS } from '../../constants/AdjustmentReasons';
+import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { InventoryMovementReasonEnum } from '../../enums/InventoryMovementReasonEnum';
+
+/** Body de POST /backoffice/inventory/adjustments (backofficeRegisterAdjustment); resta del disponible con motivo. */
+export class BackofficeRegisterAdjustmentRequest {
+    /** Debe pertenecer al retailer del token. */
+    @Matches(/^\S+$/)
+    @IsString()
+    storeId!: string;
+
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+
+    /** DAMAGED_RETURN no aplica: lo genera la devolución, no el admin. */
+    @IsIn(ADJUSTMENT_REASONS)
+    reason!: InventoryMovementReasonEnum;
+
+    /** IMEI o serie de cada pieza; ausente si el SKU se rastrea por cantidad. */
+    @IsOptional()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayUnique()
+    @Matches(/^\S+$/, { each: true })
+    @IsString({ each: true })
+    identifiers?: string[];
+}

package/src/retailCatalog/dtos/requests/BackofficeRegisterEntryRequest.ts

@@ -0,0 +1,28 @@
+import { ArrayMinSize, ArrayUnique, IsArray, IsInt, IsOptional, IsString, Length, Matches, Min } from 'class-validator';
+import { SKU_PATTERN } from '../../constants/SkuPattern';
+
+/** Body de POST /backoffice/inventory/entries (backofficeRegisterEntry); suma al saldo de la tienda con un MOV# ENTRY. */
+export class BackofficeRegisterEntryRequest {
+    /** Debe pertenecer al retailer del token. */
+    @Matches(/^\S+$/)
+    @IsString()
+    storeId!: string;
+
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+
+    /** IMEI o serie de cada pieza; ausente si el SKU se rastrea por cantidad. */
+    @IsOptional()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayUnique()
+    @Matches(/^\S+$/, { each: true })
+    @IsString({ each: true })
+    identifiers?: string[];
+}