@fiado/type-kit 3.464.0 → 3.466.0

package/bin/retailCatalog/enums/TransferStateEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferStateEnum = void 0;
+/** Estado de un traspaso entre tiendas (TRF#); solo uno OPEN se recibe o cancela. */
+var TransferStateEnum;
+(function (TransferStateEnum) {
+    TransferStateEnum["OPEN"] = "OPEN";
+    TransferStateEnum["RECEIVED"] = "RECEIVED";
+    TransferStateEnum["CANCELLED"] = "CANCELLED";
+})(TransferStateEnum || (exports.TransferStateEnum = TransferStateEnum = {}));

package/bin/retailCatalog/index.d.ts

@@ -7,7 +7,10 @@ export * from './enums/InventoryLensFilterEnum';
 export * from './enums/InventoryLensUnavailableReasonEnum';
 export * from './enums/InventoryTransferReasonEnum';
 export * from './constants/SkuPattern';
+export * from './constants/NonBundleCategories';
+export * from './constants/AdjustmentReasons';
 export * from './validators/IsMdmCoherentConstraint';
+export * from './validators/IsPieceRefConstraint';
 export * from './dtos/Product';
 export * from './dtos/InventoryItem';
 export * from './dtos/requests/CreateProductRequest';
@@ -35,6 +38,8 @@ export * from './enums/InventoryLensPeriodEnum';
 export * from './dtos/ProductComponent';
 export * from './dtos/requests/ReservationLineRef';
 export * from './dtos/requests/StockLine';
+export * from './dtos/requests/ReturnPieceCondition';
+export * from './dtos/requests/ReturnStockLine';
 export * from './dtos/requests/ReserveStockRequest';
 export * from './dtos/requests/RenewReservationsRequest';
 export * from './dtos/requests/SuggestPiecesQuery';
@@ -54,3 +59,18 @@ export * from './dtos/responses/StoreCatalogItem';
 export * from './dtos/responses/SkuPriceEntry';
 export * from './dtos/responses/GetInventorySkuResponse';
 export * from './dtos/responses/ListSkuPricesResponse';
+export * from './enums/ItemTypeEnum';
+export * from './enums/ReturnConditionEnum';
+export * from './enums/TransferStateEnum';
+export * from './enums/InventoryMovementReasonEnum';
+export * from './dtos/requests/BackofficeCreateProductRequest';
+export * from './dtos/requests/BackofficeCreateKitRequest';
+export * from './dtos/requests/BackofficeCreateServiceRequest';
+export * from './dtos/requests/BackofficeUpdateProductRequest';
+export * from './dtos/requests/BackofficeCreateSkuPriceRequest';
+export * from './dtos/requests/BackofficeRegisterEntryRequest';
+export * from './dtos/requests/BackofficeRegisterAdjustmentRequest';
+export * from './dtos/requests/BackofficeCreateTransferRequest';
+export * from './dtos/requests/BackofficeListTransfersQuery';
+export * from './dtos/responses/TransferResponse';
+export * from './dtos/responses/ListTransfersResponse';

package/bin/retailCatalog/index.js

@@ -25,8 +25,11 @@ __exportStar(require("./enums/InventoryLensUnavailableReasonEnum"), exports);
 __exportStar(require("./enums/InventoryTransferReasonEnum"), exports);
 // Constantes del dominio
 __exportStar(require("./constants/SkuPattern"), exports);
+__exportStar(require("./constants/NonBundleCategories"), exports);
+__exportStar(require("./constants/AdjustmentReasons"), exports);
 // Validators custom
 __exportStar(require("./validators/IsMdmCoherentConstraint"), exports);
+__exportStar(require("./validators/IsPieceRefConstraint"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/Product"), exports);
 __exportStar(require("./dtos/InventoryItem"), exports);
@@ -59,6 +62,8 @@ __exportStar(require("./enums/InventoryLensPeriodEnum"), exports);
 __exportStar(require("./dtos/ProductComponent"), exports);
 __exportStar(require("./dtos/requests/ReservationLineRef"), exports);
 __exportStar(require("./dtos/requests/StockLine"), exports);
+__exportStar(require("./dtos/requests/ReturnPieceCondition"), exports);
+__exportStar(require("./dtos/requests/ReturnStockLine"), exports);
 __exportStar(require("./dtos/requests/ReserveStockRequest"), exports);
 __exportStar(require("./dtos/requests/RenewReservationsRequest"), exports);
 __exportStar(require("./dtos/requests/SuggestPiecesQuery"), exports);
@@ -78,3 +83,19 @@ __exportStar(require("./dtos/responses/StoreCatalogItem"), exports);
 __exportStar(require("./dtos/responses/SkuPriceEntry"), exports);
 __exportStar(require("./dtos/responses/GetInventorySkuResponse"), exports);
 __exportStar(require("./dtos/responses/ListSkuPricesResponse"), exports);
+// Operación independiente (ciclo 2)
+__exportStar(require("./enums/ItemTypeEnum"), exports);
+__exportStar(require("./enums/ReturnConditionEnum"), exports);
+__exportStar(require("./enums/TransferStateEnum"), exports);
+__exportStar(require("./enums/InventoryMovementReasonEnum"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateProductRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateKitRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateServiceRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeUpdateProductRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateSkuPriceRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeRegisterEntryRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeRegisterAdjustmentRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCreateTransferRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeListTransfersQuery"), exports);
+__exportStar(require("./dtos/responses/TransferResponse"), exports);
+__exportStar(require("./dtos/responses/ListTransfersResponse"), exports);

package/bin/retailCatalog/validators/IsPieceRefConstraint.d.ts

@@ -0,0 +1,6 @@
+import { type ValidationArguments, type ValidatorConstraintInterface } from 'class-validator';
+/** Exige identifier (pieza con IMEI o serie) o qty (SKU por cantidad), nunca los dos. */
+export declare class IsPieceRefConstraint implements ValidatorConstraintInterface {
+    validate(identifier: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/retailCatalog/validators/IsPieceRefConstraint.js

@@ -0,0 +1,26 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsPieceRefConstraint = void 0;
+const class_validator_1 = require("class-validator");
+/** Exige identifier (pieza con IMEI o serie) o qty (SKU por cantidad), nunca los dos. */
+let IsPieceRefConstraint = class IsPieceRefConstraint {
+    validate(identifier, args) {
+        const { qty } = args.object;
+        if (qty !== undefined)
+            return identifier === undefined;
+        return typeof identifier === 'string' && /^\S+$/.test(identifier);
+    }
+    defaultMessage() {
+        return 'identifier (pieza con IMEI o serie) o qty (por cantidad), exactamente uno';
+    }
+};
+exports.IsPieceRefConstraint = IsPieceRefConstraint;
+exports.IsPieceRefConstraint = IsPieceRefConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isPieceRef', async: false })
+], IsPieceRefConstraint);

package/bin/retailWizard/dtos/requests/BackofficeCancelSaleRequest.d.ts

@@ -1,3 +1,4 @@
+import { ReturnPieceCondition } from '../../../retailCatalog/dtos/requests/ReturnPieceCondition';
 /**
  * POST /backoffice/sales/:saleId/cancel — cancelación del Admin VL. SureKeep Fase 3 — pista Retail.
  *
@@ -23,4 +24,6 @@ export declare class BackofficeCancelSaleRequest {
      * la venta YA está fuera de ventana; dentro de ventana se ignora.
      */
     outOfWindowExceptionId?: string;
+    /** Condición de cada pieza que regresa al inventario; las no listadas vuelven GOOD. */
+    returnConditions?: ReturnPieceCondition[];
 }

package/bin/retailWizard/dtos/requests/BackofficeCancelSaleRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackofficeCancelSaleRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const ReturnPieceCondition_1 = require("../../../retailCatalog/dtos/requests/ReturnPieceCondition");
 /**
  * POST /backoffice/sales/:saleId/cancel — cancelación del Admin VL. SureKeep Fase 3 — pista Retail.
  *
@@ -46,3 +47,11 @@ __decorate([
     (0, class_validator_1.MaxLength)(64),
     __metadata("design:type", String)
 ], BackofficeCancelSaleRequest.prototype, "outOfWindowExceptionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ReturnPieceCondition_1.ReturnPieceCondition),
+    __metadata("design:type", Array)
+], BackofficeCancelSaleRequest.prototype, "returnConditions", void 0);

package/bin/retailWizard/dtos/requests/CancelSaleRequest.d.ts

@@ -1,3 +1,4 @@
+import { ReturnPieceCondition } from '../../../retailCatalog/dtos/requests/ReturnPieceCondition';
 /**
  * POST /sales/:saleId/cancel — cancela una venta (flujo C, solo BO dentro de ventana param). `reason`
  * OBLIGATORIO (AuditTrail). Retorna el IMEI al silo (`SOLD → AVAILABLE`) y emite `SaleCancelledV1`.
@@ -19,4 +20,6 @@ export declare class CancelSaleRequest {
      * que el string `"false"` se rechaza en vez de colarse como truthy.
      */
     equipmentVerified?: boolean;
+    /** Condición de cada pieza que regresa al inventario; las no listadas vuelven GOOD. */
+    returnConditions?: ReturnPieceCondition[];
 }

package/bin/retailWizard/dtos/requests/CancelSaleRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CancelSaleRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const ReturnPieceCondition_1 = require("../../../retailCatalog/dtos/requests/ReturnPieceCondition");
 /**
  * POST /sales/:saleId/cancel — cancela una venta (flujo C, solo BO dentro de ventana param). `reason`
  * OBLIGATORIO (AuditTrail). Retorna el IMEI al silo (`SOLD → AVAILABLE`) y emite `SaleCancelledV1`.
@@ -32,3 +33,11 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], CancelSaleRequest.prototype, "equipmentVerified", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ReturnPieceCondition_1.ReturnPieceCondition),
+    __metadata("design:type", Array)
+], CancelSaleRequest.prototype, "returnConditions", void 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.464.0",
+  "version": "3.466.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/remittance/enums/RemittanceCorridor.ts

@@ -1,16 +1,17 @@
 /**
  * Corredores de remesa soportados (Dashboard Ops · Variables Operativas).
  *
- * D-PB-3: nomenclatura por MONEDA ISO-4217 (`USD-<destino>`). `USD_SVC` es un
- * símbolo para El Salvador (su payout real es USD; usar la moneda colisionaría
- * como "USD-USD"). Por eso el destino real vive en CORRIDOR_INFO y el filtro de
- * transacciones usa countryISO (no ambiguo).
+ * D-PB-3: nomenclatura por MONEDA ISO-4217 (`USD-<destino>`). `USD_SVC` (El Salvador)
+ * y `USD_NIC` (Nicaragua) son símbolos: su payout real es USD y usar la moneda
+ * colisionaría como "USD-USD". Por eso el destino real vive en CORRIDOR_INFO y el
+ * filtro de transacciones usa countryISO (no ambiguo).
  */
 export enum RemittanceCorridor {
     USD_GTQ = "USD-GTQ",
     USD_MXN = "USD-MXN",
     USD_HNL = "USD-HNL",
     USD_SVC = "USD-SVC",
+    USD_NIC = "USD-NIC",
 }
 
 /** Destino real del corredor. El filtro de tx usa countryISO; currencyISO es el payout. */
@@ -19,4 +20,5 @@ export const CORRIDOR_INFO: Record<RemittanceCorridor, { countryISO: string; cur
     [RemittanceCorridor.USD_MXN]: { countryISO: "MX", currencyISO: "MXN" },
     [RemittanceCorridor.USD_HNL]: { countryISO: "HN", currencyISO: "HNL" },
     [RemittanceCorridor.USD_SVC]: { countryISO: "SV", currencyISO: "USD" },
+    [RemittanceCorridor.USD_NIC]: { countryISO: "NI", currencyISO: "USD" },
 };

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[];
+}

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

@@ -0,0 +1,93 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsBoolean, IsEnum, IsIn, IsOptional, IsString, Matches, Validate, ValidateNested } from 'class-validator';
+import { NON_BUNDLE_CATEGORIES } from '../../constants/NonBundleCategories';
+import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../enums/ProductTierEnum';
+import { ProductComponent } from '../ProductComponent';
+import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
+import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
+import { IsMdmCoherentConstraint } from '../../validators/IsMdmCoherentConstraint';
+
+/** Body de PATCH /backoffice/inventory/skus/{sku} (backofficeUpdateProduct); parcial, sin itemType ni trackingMode (inmutables) ni precio. */
+export class BackofficeUpdateProductRequest {
+    @IsOptional()
+    @IsIn(NON_BUNDLE_CATEGORIES)
+    category?: ProductCategoryEnum;
+
+    @IsOptional()
+    @IsBoolean()
+    sellable?: boolean;
+
+    @IsOptional()
+    @IsBoolean()
+    showInSalesFlow?: boolean;
+
+    /** Solo en kits; reemplaza la lista completa sin tocar los apartados vivos. */
+    @IsOptional()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => ProductComponent)
+    components?: ProductComponent[];
+
+    @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[];
+
+    // PATCH parcial: la coherencia contra el producto guardado la valida el dominio.
+    @Validate(IsMdmCoherentConstraint)
+    @IsOptional()
+    @IsBoolean()
+    mdmEnabled?: boolean;
+
+    @IsOptional()
+    @IsEnum(MdmProviderEnum)
+    mdmProvider?: MdmProviderEnum | null;
+
+    @IsOptional()
+    @IsEnum(MdmLockModeEnum)
+    mdmLockMode?: MdmLockModeEnum | null;
+}

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

@@ -4,6 +4,7 @@ import { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnum';
 /**
  * Body de PUT /retailers/:retailerId/inventory/:imei/status — cambio manual de estado.
  * Acotado a RETURNED | DAMAGED (los otros estados los mueve la máquina de venta, no el operador).
+ * @deprecated Modelo viejo por IMEI; usar BackofficeRegisterAdjustmentRequest. Se conserva porque otras ramas lo importan.
  */
 export class ChangeInventoryStatusRequest {
     @IsIn([InventoryItemStatusEnum.RETURNED, InventoryItemStatusEnum.DAMAGED])