@fiado/type-kit 3.464.0 → 3.465.0

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.465.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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])

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

@@ -17,7 +17,10 @@ import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { IsMdmCoherentConstraint } from '../../validators/IsMdmCoherentConstraint';
 
-/** Body de POST /retailers/:retailerId/products — alta de producto (retailerId/status/audit son server-set). */
+/**
+ * Body de POST /retailers/:retailerId/products — alta de producto (retailerId/status/audit son server-set).
+ * @deprecated Modelo viejo por IMEI; usar BackofficeCreateProductRequest. Se conserva porque otras ramas lo importan.
+ */
 export class CreateProductRequest {
     @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
     @Length(1, 64)

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

@@ -1,6 +1,9 @@
 import { ArrayNotEmpty, IsArray, IsString } from 'class-validator';
 
-/** Body de POST /retailers/:retailerId/stores/:storeId/inventory — registrar IMEIs nuevos (lote). */
+/**
+ * Body de POST /retailers/:retailerId/stores/:storeId/inventory — registrar IMEIs nuevos (lote).
+ * @deprecated Modelo viejo por IMEI; usar BackofficeRegisterEntryRequest. Se conserva porque otras ramas lo importan.
+ */
 export class RegisterInventoryRequest {
     @IsString()
     productSku!: string;

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

@@ -0,0 +1,48 @@
+import { Expose, Transform } from 'class-transformer';
+import {
+    IsEnum,
+    IsInt,
+    IsString,
+    Length,
+    Matches,
+    MaxLength,
+    Min,
+    Validate,
+    ValidateIf,
+} from 'class-validator';
+import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { ReturnConditionEnum } from '../../enums/ReturnConditionEnum';
+import { IsPieceRefConstraint } from '../../validators/IsPieceRefConstraint';
+
+/** Condición de una pieza devuelta; ausente = GOOD. Un accesorio por cantidad se declara con sku + qty. */
+export class ReturnPieceCondition {
+    @Expose()
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    @Expose()
+    @Validate(IsPieceRefConstraint)
+    identifier?: string;
+
+    /** Unidades del SKU por cantidad con esta condición; las no declaradas vuelven GOOD. */
+    @Expose()
+    @ValidateIf((o: ReturnPieceCondition) => o.qty !== undefined)
+    @IsInt()
+    @Min(1)
+    qty?: number;
+
+    @Expose()
+    @Transform(({ value }) => value ?? ReturnConditionEnum.GOOD)
+    @IsEnum(ReturnConditionEnum)
+    condition: ReturnConditionEnum = ReturnConditionEnum.GOOD;
+
+    /** Motivo del daño; obligatorio con DAMAGED, opcional con GOOD. */
+    @Expose()
+    @ValidateIf((o: ReturnPieceCondition) => o.condition === ReturnConditionEnum.DAMAGED || o.reason != null)
+    @MaxLength(200)
+    @Matches(/\S/)
+    @IsString()
+    reason?: string;
+}

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

@@ -0,0 +1,13 @@
+import { Type } from 'class-transformer';
+import { IsArray, IsOptional, ValidateNested } from 'class-validator';
+import { ReturnPieceCondition } from './ReturnPieceCondition';
+import { StockLine } from './StockLine';
+
+/** Línea de devolución: la línea vendida más la condición de sus piezas; las no listadas vuelven GOOD. */
+export class ReturnStockLine extends StockLine {
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => ReturnPieceCondition)
+    conditions?: ReturnPieceCondition[];
+}

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

@@ -1,6 +1,6 @@
 import { Type } from 'class-transformer';
 import { ArrayMinSize, IsArray, IsISO8601, IsString, ValidateNested } from 'class-validator';
-import { StockLine } from './StockLine';
+import { ReturnStockLine } from './ReturnStockLine';
 
 /** Body de PUT /private/stores/{storeId}/returns (privateReturnStock); componentes guardados en la venta. */
 export class ReturnStockRequest {
@@ -17,6 +17,6 @@ export class ReturnStockRequest {
     @IsArray()
     @ArrayMinSize(1)
     @ValidateNested({ each: true })
-    @Type(() => StockLine)
-    lines!: StockLine[];
+    @Type(() => ReturnStockLine)
+    lines!: ReturnStockLine[];
 }

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

@@ -1,6 +1,9 @@
 import { IsString } from 'class-validator';
 
-/** Body de PUT /retailers/:retailerId/inventory/:imei/transfer — mover IMEI a otro store. */
+/**
+ * Body de PUT /retailers/:retailerId/inventory/:imei/transfer — mover IMEI a otro store.
+ * @deprecated Modelo viejo por IMEI; usar BackofficeCreateTransferRequest. Se conserva porque otras ramas lo importan.
+ */
 export class TransferInventoryRequest {
     @IsString()
     newStoreId!: string;

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

@@ -14,7 +14,10 @@ import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { IsMdmCoherentConstraint } from '../../validators/IsMdmCoherentConstraint';
 
-/** Body de PUT /retailers/:retailerId/products/:sku — actualización parcial (sku y status son inmutables acá). */
+/**
+ * Body de PUT /retailers/:retailerId/products/:sku — actualización parcial (sku y status son inmutables acá).
+ * @deprecated Modelo viejo por IMEI; usar BackofficeUpdateProductRequest. Se conserva porque otras ramas lo importan.
+ */
 export class UpdateProductRequest {
     @IsOptional()
     @IsString()

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

@@ -1,7 +1,10 @@
 import { IsEnum } from 'class-validator';
 import { ProductStatusEnum } from '../../enums/ProductStatusEnum';
 
-/** Body de PUT /retailers/:retailerId/products/:sku/status — ACTIVE | DISCONTINUED. */
+/**
+ * Body de PUT /retailers/:retailerId/products/:sku/status — ACTIVE | DISCONTINUED.
+ * @deprecated Modelo viejo por IMEI; usar backofficeDeactivateProduct (sin body). Se conserva porque otras ramas lo importan.
+ */
 export class UpdateProductStatusRequest {
     @IsEnum(ProductStatusEnum)
     status!: ProductStatusEnum;

package/src/retailCatalog/dtos/responses/InventoryLensResponse.ts

@@ -4,6 +4,7 @@ import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
 import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { InventoryLensUnavailableReasonEnum } from '../../enums/InventoryLensUnavailableReasonEnum';
 import type { InventoryTransferReasonEnum } from '../../enums/InventoryTransferReasonEnum';
+import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
 
 /**
  * Los contadores que la pantalla «Inventario» del Admin VL pinta arriba, siempre — los cuatro viajan
@@ -127,6 +128,8 @@ export interface InventoryLensListItem {
     coverage: InventoryLensCoverage;
     alerts: InventoryLensAlerts;
     sold30d: number;
+    /** Producto físico o servicio. Ausente = PRODUCT. */
+    itemType?: ItemTypeEnum;
 }
 
 /** Fila del lente — el tipo depende del tab pedido. */

package/src/retailCatalog/dtos/responses/ListTransfersResponse.ts

@@ -0,0 +1,6 @@
+import type { TransferResponse } from './TransferResponse';
+
+/** Response de backofficeListTransfers. */
+export interface ListTransfersResponse {
+    items: TransferResponse[];
+}

package/src/retailCatalog/dtos/responses/ReserveStockResponse.ts

@@ -8,6 +8,8 @@ export interface ReservedComponent {
     qty: number;
     category: ProductCategoryEnum;
     trackingMode: TrackingModeEnum;
+    /** Precio vigente del componente, para repartir el precio del kit. */
+    priceCents?: number;
 }
 
 /** Response de privateReserveStock; el precio de la línea es `basePriceCents`. */

package/src/retailCatalog/dtos/responses/SkuPriceEntry.ts

@@ -5,6 +5,8 @@ export interface SkuPriceEntry {
     effectiveFrom: string;
     listPriceCents: number | null;
     basePriceCents: number;
+    /** Precio del SKU dentro de un kit; informativo, no se aplica. */
+    comboPriceCents?: number;
     source: PriceSourceEnum;
     createdBy: string;
 }

package/src/retailCatalog/dtos/responses/StoreCatalogItem.ts

@@ -3,6 +3,7 @@ import type { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
 import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { TrackingModeEnum } from '../../enums/TrackingModeEnum';
+import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
 import type { ProductComponent } from '../ProductComponent';
 
 /** Fila por SKU del catálogo de venta de una tienda (privateGetStoreStockCatalog). */
@@ -25,6 +26,8 @@ export interface StoreCatalogItem {
     mdmLockMode: MdmLockModeEnum | null;
     /** Solo si es kit. */
     components?: ProductComponent[];
+    /** Producto físico o servicio. Ausente = PRODUCT. */
+    itemType?: ItemTypeEnum;
 }
 
 /** Response de privateGetStoreStockCatalog. */