@fiado/type-kit 3.473.0 → 3.474.0

package/_test_/unit/retailCatalog/accessorySubcategory.test.ts

@@ -0,0 +1,65 @@
+import 'reflect-metadata';
+import { plainToInstance, type ClassConstructor } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import {
+  AccessorySubcategoryEnum,
+  BackofficeCreateProductRequest,
+  BackofficeUpdateProductRequest,
+  Product,
+  ProductCategoryEnum,
+  type StoreCatalogItem,
+  TrackingModeEnum,
+} from '../../../src/retailCatalog';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+  return errors.flatMap((e) => {
+    const p = prefix ? `${prefix}.${e.property}` : e.property;
+    return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+  });
+}
+
+function errorsOf<T extends object>(cls: ClassConstructor<T>, payload: object): string[] {
+  return paths(validateSync(plainToInstance(cls, payload) as object));
+}
+
+describe('AccessorySubcategoryEnum', () => {
+  it('expone las subcategorías de accesorio', () =>
+    expect(Object.values(AccessorySubcategoryEnum)).toEqual([
+      'AUDIO', 'CHARGING', 'PROTECTION', 'CABLES', 'WEARABLES', 'OTHER',
+    ]));
+});
+
+describe('accessorySubcategory en alta y edición', () => {
+  const create = {
+    sku: 'ACC-1',
+    category: ProductCategoryEnum.ACCESSORY,
+    trackingMode: TrackingModeEnum.QUANTITY,
+    sellable: true,
+    showInSalesFlow: true,
+  };
+
+  it('es opcional en el alta', () => expect(errorsOf(BackofficeCreateProductRequest, create)).toEqual([]));
+  it('acepta una subcategoría válida en el alta', () =>
+    expect(errorsOf(BackofficeCreateProductRequest, { ...create, accessorySubcategory: 'AUDIO' })).toEqual([]));
+  it('rechaza una subcategoría inválida en el alta', () =>
+    expect(errorsOf(BackofficeCreateProductRequest, { ...create, accessorySubcategory: 'TOYS' })).toContain(
+      'accessorySubcategory',
+    ));
+  it('acepta una subcategoría válida en la edición', () =>
+    expect(errorsOf(BackofficeUpdateProductRequest, { accessorySubcategory: 'CHARGING' })).toEqual([]));
+  it('rechaza una subcategoría inválida en la edición', () =>
+    expect(errorsOf(BackofficeUpdateProductRequest, { accessorySubcategory: 'toys' })).toContain('accessorySubcategory'));
+});
+
+describe('accessorySubcategory en lecturas', () => {
+  it('Product la lleva opcional', () => {
+    const p: Pick<Product, 'accessorySubcategory'> = { accessorySubcategory: AccessorySubcategoryEnum.PROTECTION };
+    const empty: Pick<Product, 'accessorySubcategory'> = {};
+    expect([p.accessorySubcategory, empty.accessorySubcategory]).toEqual(['PROTECTION', undefined]);
+  });
+
+  it('StoreCatalogItem la lleva opcional', () => {
+    const item: Pick<StoreCatalogItem, 'accessorySubcategory'> = { accessorySubcategory: AccessorySubcategoryEnum.CABLES };
+    expect(item.accessorySubcategory).toBe('CABLES');
+  });
+});

package/_test_/unit/retailCatalog/ventaSaga.test.ts

@@ -54,6 +54,10 @@ describe('HoldStockRequest', () => {
     expect(errorsOf(HoldStockRequest, rest)).toEqual(expect.arrayContaining(['sessionId', 'retailerId']));
   });
   it('rechaza sin componentes', () => expect(errorsOf(HoldStockRequest, { ...ok, components: [] })).toContain('components'));
+  it.each(['sessionId', 'retailerId'])('rechaza %s vacío', (field) =>
+    expect(errorsOf(HoldStockRequest, { ...ok, [field]: '' })).toContain(field));
+  it('rechaza el sku vacío de un componente', () =>
+    expect(errorsOf(HoldStockRequest, { ...ok, components: [{ sku: '', identifiers: [] }] })).toContain('components.0.sku'));
   it('valida cada componente anidado', () => {
     expect(errorsOf(HoldStockRequest, { ...ok, components: [{ sku: 'PHONE-1', identifiers: [3] }] })).toContain(
       'components.0.identifiers',

package/_test_/unit/retailPromotions/constants.test.ts

@@ -38,12 +38,19 @@ describe('resolveSalePromotionTransition', () => {
 describe('catálogo de errores', () => {
   it('cada code tiene su status del catálogo cerrado', () => {
     for (const code of Object.values(RetailPromotionsErrorCodeEnum)) {
-      expect([404, 409, 422]).toContain(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS[code]);
+      expect([403, 404, 409, 422]).toContain(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS[code]);
     }
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.CODE_NOT_FOUND).toBe(404);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.DISCOUNT_AFTER_QUOTE).toBe(409);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.CODE_NOT_OWNED).toBe(422);
-    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(16);
+    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(20);
+  });
+
+  it('promo o cupón de venta inexistentes son 404; sesión sin retailer o tienda es 403', () => {
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.SALE_PROMOTION_NOT_FOUND).toBe(404);
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.SALE_COUPON_NOT_FOUND).toBe(404);
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.MISSING_RETAILER_SCOPE).toBe(403);
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.MISSING_STORE_SCOPE).toBe(403);
   });
 
   it('promo y código con rangos, signo o palancas inválidos son 422', () => {

package/_test_/unit/retailPromotions/discountCodeAndWizardRequests.test.ts

@@ -5,6 +5,7 @@ import {
   ChangeDiscountCodeStatusRequest,
   CreateDiscountCodeRequest,
   EvaluateSalePromotionsRequest,
+  GetSaleCouponQuery,
   HoldSalePromotionRequest,
   ListDiscountCodesQuery,
   ListStoreSalePromotionsQuery,
@@ -82,3 +83,15 @@ describe('piezas del wizard', () => {
     expect(await errorPaths(HoldSalePromotionRequest, { promotionId: 'p1' })).toContain('promotionVersion');
   });
 });
+
+describe('GetSaleCouponQuery', () => {
+  it('acepta sessionId o ninguno', async () => {
+    expect(await errorPaths(GetSaleCouponQuery, { sessionId: 'ses-1' })).toHaveLength(0);
+    expect(await errorPaths(GetSaleCouponQuery, {})).toHaveLength(0);
+  });
+
+  it('rechaza sessionId vacío o no texto', async () => {
+    expect(await errorPaths(GetSaleCouponQuery, { sessionId: '' })).toContain('sessionId');
+    expect(await errorPaths(GetSaleCouponQuery, { sessionId: 12 })).toContain('sessionId');
+  });
+});

package/_test_/unit/retailPromotions/salePromotionRequests.test.ts

@@ -66,7 +66,7 @@ describe('CreateSalePromotionRequest', () => {
     expect(percent).toHaveLength(0);
   });
 
-  it('regalo por lista exige SKUs; por gama exige categoría y precio máximo', async () => {
+  it('regalo por lista exige SKUs; por gama exige subcategoría de accesorio y precio máximo', async () => {
     const list = await errorPaths(CreateSalePromotionRequest, {
       ...base,
       levers: { gift: { mode: 'LIST', chooseCount: 1 } },
@@ -76,14 +76,22 @@ describe('CreateSalePromotionRequest', () => {
       ...base,
       levers: { gift: { mode: 'RANGE', chooseCount: 1 } },
     });
-    expect(range).toEqual(expect.arrayContaining(['levers.gift.category', 'levers.gift.maxPriceCents']));
+    expect(range).toEqual(expect.arrayContaining(['levers.gift.accessorySubcategory', 'levers.gift.maxPriceCents']));
     const ok = await errorPaths(CreateSalePromotionRequest, {
       ...base,
-      levers: { gift: { mode: 'RANGE', category: 'AUDIO', maxPriceCents: 30000, chooseCount: 1 } },
+      levers: { gift: { mode: 'RANGE', accessorySubcategory: 'AUDIO', maxPriceCents: 30000, chooseCount: 1 } },
     });
     expect(ok).toHaveLength(0);
   });
 
+  it('la gama del regalo solo acepta subcategorías de accesorio del catálogo', async () => {
+    const paths = await errorPaths(CreateSalePromotionRequest, {
+      ...base,
+      levers: { gift: { mode: 'RANGE', accessorySubcategory: 'Audífonos', maxPriceCents: 30000, chooseCount: 1 } },
+    });
+    expect(paths).toEqual(['levers.gift.accessorySubcategory']);
+  });
+
   it('valida las 7 palancas juntas', async () => {
     const paths = await errorPaths(CreateSalePromotionRequest, {
       ...base,

package/_test_/unit/retailWizard/promotionM2mRequests.test.ts

@@ -65,6 +65,8 @@ describe('SetAnchorGiftsRequest', () => {
   const ok = { promotionId: 'promo-1', promotionVersion: 1, items: [{ sku: 'CASE-1' }] };
 
   it('acepta un regalo con su promo', () => expect(errorsOf(SetAnchorGiftsRequest, ok)).toEqual([]));
+  it('acepta el mismo SKU repetido: son dos regalos iguales', () =>
+    expect(errorsOf(SetAnchorGiftsRequest, { ...ok, items: [{ sku: 'CASE-1' }, { sku: 'CASE-1' }] })).toEqual([]));
   it('acepta dos regalos', () =>
     expect(errorsOf(SetAnchorGiftsRequest, { ...ok, items: [{ sku: 'CASE-1' }, { sku: 'MICA-1' }] })).toEqual([]));
   it('acepta items vacío con promo y versión en null (suelta todos)', () =>
@@ -136,17 +138,23 @@ describe('respuestas de los M2M de Promociones', () => {
   });
 
   it('una línea GIFT exige role GIFT, ancla y precio original', () => {
-    const { linkedLineId: _l, ...sinAncla } = gift;
-    const { originalPriceCents: _o, ...sinPrecio } = gift;
-    const { role: _r, ...sinRole } = gift;
+    const { linkedLineId: _l, ...withoutAnchor } = gift;
+    const { originalPriceCents: _o, ...withoutPrice } = gift;
+    const { role: _r, ...withoutRole } = gift;
     // @ts-expect-error linkedLineId es obligatorio en un GIFT
-    const a: WizardGiftLine = sinAncla;
+    const a: WizardGiftLine = withoutAnchor;
     // @ts-expect-error originalPriceCents es obligatorio en un GIFT
-    const b: WizardGiftLine = sinPrecio;
+    const b: WizardGiftLine = withoutPrice;
     // @ts-expect-error role GIFT es obligatorio
-    const c: WizardGiftLine = sinRole;
+    const c: WizardGiftLine = withoutRole;
+    const { promotionId: _p, ...withoutPromotion } = gift;
+    const { promotionVersion: _v, ...withoutVersion } = gift;
+    // @ts-expect-error promotionId es obligatorio en un GIFT
+    const d: WizardGiftLine = withoutPromotion;
+    // @ts-expect-error promotionVersion es obligatorio en un GIFT
+    const e: WizardGiftLine = withoutVersion;
     const line: WizardReservedLine = gift;
-    expect([a, b, c, line]).toHaveLength(4);
+    expect([a, b, c, d, e, line]).toHaveLength(6);
   });
 
   it('la lectura privada trae líneas, ancla, crédito, paso y promo de venta', () => {

package/_test_/unit/retailWizard/ventaSagaMessages.test.ts

@@ -161,3 +161,26 @@ describe('RetailCommissionInboundMessage', () => {
       errorsOf(RetailCommissionInboundMessage, { ...ok, lines: [{ sku: 'X', qty: 0, netCents: -1, itemType: 'KIT' }] }),
     ).toEqual(expect.arrayContaining(['lines.0.qty', 'lines.0.netCents', 'lines.0.itemType'])));
 });
+
+describe('RetailPromotionInboundMessage — tipos nullables y ids no vacíos', () => {
+  const base = {
+    type: RetailPromotionInboundMessageTypeEnum.SALE_CONFIRMED,
+    tenantId: 't',
+    retailerId: 'ret',
+    storeId: 'st',
+    saleId: 'sale-1',
+    sessionId: 'ses-1',
+    customerId: 'cus-1',
+    soldAt: '2026-09-28T20:00:00.000Z',
+    occurredAt: '2026-09-28T20:00:00.000Z',
+    lines: [{ lineId: 'L1', sku: 'PHONE-1', qty: 1, originalPriceCents: 100, identifiers: [] }],
+  };
+
+  it('tipa salePromotionId y salePromotionVersion como nullables', () => {
+    const msg: RetailPromotionInboundMessage = { ...base, salePromotionId: null, salePromotionVersion: null };
+    expect(errorsOf(RetailPromotionInboundMessage, msg)).toEqual([]);
+  });
+
+  it.each(['creditId', 'fiadoDirectoryId'])('rechaza %s vacío', (field) =>
+    expect(errorsOf(RetailPromotionInboundMessage, { ...base, [field]: '' })).toContain(field));
+});

package/bin/retailCatalog/dtos/Product.d.ts

@@ -3,6 +3,7 @@ import { MdmProviderEnum } from '../enums/MdmProviderEnum';
 import { ProductStatusEnum } from '../enums/ProductStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
 import { ProductCategoryEnum } from '../enums/ProductCategoryEnum';
+import { AccessorySubcategoryEnum } from '../enums/AccessorySubcategoryEnum';
 import { TrackingModeEnum } from '../enums/TrackingModeEnum';
 import { ItemTypeEnum } from '../enums/ItemTypeEnum';
 import { ProductComponent } from './ProductComponent';
@@ -37,6 +38,8 @@ export declare class Product {
     createdAt: string;
     updatedAt: string;
     category?: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     trackingMode?: TrackingModeEnum;
     /** Se puede vender suelto (fuera de un kit). */
     sellable?: boolean;

package/bin/retailCatalog/dtos/requests/BackofficeCreateProductRequest.d.ts

@@ -1,4 +1,5 @@
 import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { TrackingModeEnum } from '../../enums/TrackingModeEnum';
 import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
@@ -8,6 +9,8 @@ export declare class BackofficeCreateProductRequest {
     sku: string;
     /** El kit (BUNDLE) se da de alta en backofficeCreateKit. */
     category: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     /** Inmutable tras el alta. */
     trackingMode: TrackingModeEnum;
     sellable: boolean;

package/bin/retailCatalog/dtos/requests/BackofficeCreateProductRequest.js

@@ -14,6 +14,7 @@ const class_validator_1 = require("class-validator");
 const SkuPattern_1 = require("../../constants/SkuPattern");
 const NonBundleCategories_1 = require("../../constants/NonBundleCategories");
 const ProductCategoryEnum_1 = require("../../enums/ProductCategoryEnum");
+const AccessorySubcategoryEnum_1 = require("../../enums/AccessorySubcategoryEnum");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
 const TrackingModeEnum_1 = require("../../enums/TrackingModeEnum");
 const MdmLockModeEnum_1 = require("../../enums/MdmLockModeEnum");
@@ -33,6 +34,11 @@ __decorate([
     (0, class_validator_1.IsIn)(NonBundleCategories_1.NON_BUNDLE_CATEGORIES),
     __metadata("design:type", String)
 ], BackofficeCreateProductRequest.prototype, "category", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(AccessorySubcategoryEnum_1.AccessorySubcategoryEnum),
+    __metadata("design:type", String)
+], BackofficeCreateProductRequest.prototype, "accessorySubcategory", void 0);
 __decorate([
     (0, class_validator_1.IsEnum)(TrackingModeEnum_1.TrackingModeEnum),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/BackofficeUpdateProductRequest.d.ts

@@ -1,4 +1,5 @@
 import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { ProductComponent } from '../ProductComponent';
 import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
@@ -6,6 +7,8 @@ import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 /** Body de PATCH /backoffice/inventory/skus/{sku} (backofficeUpdateProduct); parcial, sin itemType ni trackingMode (inmutables) ni precio. */
 export declare class BackofficeUpdateProductRequest {
     category?: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     sellable?: boolean;
     showInSalesFlow?: boolean;
     /** Solo en kits; reemplaza la lista completa sin tocar los apartados vivos. */

package/bin/retailCatalog/dtos/requests/BackofficeUpdateProductRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const NonBundleCategories_1 = require("../../constants/NonBundleCategories");
 const ProductCategoryEnum_1 = require("../../enums/ProductCategoryEnum");
+const AccessorySubcategoryEnum_1 = require("../../enums/AccessorySubcategoryEnum");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
 const ProductComponent_1 = require("../ProductComponent");
 const MdmLockModeEnum_1 = require("../../enums/MdmLockModeEnum");
@@ -28,6 +29,11 @@ __decorate([
     (0, class_validator_1.IsIn)(NonBundleCategories_1.NON_BUNDLE_CATEGORIES),
     __metadata("design:type", String)
 ], BackofficeUpdateProductRequest.prototype, "category", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(AccessorySubcategoryEnum_1.AccessorySubcategoryEnum),
+    __metadata("design:type", String)
+], BackofficeUpdateProductRequest.prototype, "accessorySubcategory", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsBoolean)(),

package/bin/retailCatalog/dtos/requests/HoldStockRequest.js

@@ -19,6 +19,7 @@ class HoldStockComponent {
 exports.HoldStockComponent = HoldStockComponent;
 __decorate([
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], HoldStockComponent.prototype, "sku", void 0);
 __decorate([
@@ -32,10 +33,12 @@ class HoldStockRequest extends ReservationLineRef_1.ReservationLineRef {
 exports.HoldStockRequest = HoldStockRequest;
 __decorate([
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], HoldStockRequest.prototype, "sessionId", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], HoldStockRequest.prototype, "retailerId", void 0);
 __decorate([

package/bin/retailCatalog/dtos/responses/StoreCatalogItem.d.ts

@@ -1,6 +1,7 @@
 import type { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
 import type { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import type { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
 import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { TrackingModeEnum } from '../../enums/TrackingModeEnum';
 import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
@@ -16,6 +17,8 @@ export interface StoreCatalogItem {
     available: number;
     basePriceCents: number;
     category: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     trackingMode: TrackingModeEnum;
     brand: string;
     model: string;

package/bin/retailCatalog/enums/AccessorySubcategoryEnum.d.ts

@@ -0,0 +1,9 @@
+/** Subcategoría de un producto ACCESSORY; sirve para regalar «por gama» en Promociones. */
+export declare enum AccessorySubcategoryEnum {
+    AUDIO = "AUDIO",
+    CHARGING = "CHARGING",
+    PROTECTION = "PROTECTION",
+    CABLES = "CABLES",
+    WEARABLES = "WEARABLES",
+    OTHER = "OTHER"
+}

package/bin/retailCatalog/enums/AccessorySubcategoryEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessorySubcategoryEnum = void 0;
+/** Subcategoría de un producto ACCESSORY; sirve para regalar «por gama» en Promociones. */
+var AccessorySubcategoryEnum;
+(function (AccessorySubcategoryEnum) {
+    AccessorySubcategoryEnum["AUDIO"] = "AUDIO";
+    AccessorySubcategoryEnum["CHARGING"] = "CHARGING";
+    AccessorySubcategoryEnum["PROTECTION"] = "PROTECTION";
+    AccessorySubcategoryEnum["CABLES"] = "CABLES";
+    AccessorySubcategoryEnum["WEARABLES"] = "WEARABLES";
+    AccessorySubcategoryEnum["OTHER"] = "OTHER";
+})(AccessorySubcategoryEnum || (exports.AccessorySubcategoryEnum = AccessorySubcategoryEnum = {}));

package/bin/retailCatalog/index.d.ts

@@ -29,6 +29,7 @@ export * from './dtos/responses/InventoryLensResponse';
 export * from './dtos/validation/ValidateProductResponse';
 export * from './dtos/validation/ValidateInventoryResponse';
 export * from './enums/ProductCategoryEnum';
+export * from './enums/AccessorySubcategoryEnum';
 export * from './enums/TrackingModeEnum';
 export * from './enums/InventoryMovementTypeEnum';
 export * from './enums/InventorySyncResultStatusEnum';

package/bin/retailCatalog/index.js

@@ -53,6 +53,7 @@ __exportStar(require("./dtos/validation/ValidateProductResponse"), exports);
 __exportStar(require("./dtos/validation/ValidateInventoryResponse"), exports);
 // Inventario multi-item (ciclo 1)
 __exportStar(require("./enums/ProductCategoryEnum"), exports);
+__exportStar(require("./enums/AccessorySubcategoryEnum"), exports);
 __exportStar(require("./enums/TrackingModeEnum"), exports);
 __exportStar(require("./enums/InventoryMovementTypeEnum"), exports);
 __exportStar(require("./enums/InventorySyncResultStatusEnum"), exports);
@@ -99,7 +100,7 @@ __exportStar(require("./dtos/requests/BackofficeCreateTransferRequest"), exports
 __exportStar(require("./dtos/requests/BackofficeListTransfersQuery"), exports);
 __exportStar(require("./dtos/responses/TransferResponse"), exports);
 __exportStar(require("./dtos/responses/ListTransfersResponse"), exports);
-// Venta saga (ciclo 3)
+// Saga de venta: hold y avisos de la cola
 __exportStar(require("./enums/ReservePurposeEnum"), exports);
 __exportStar(require("./enums/InventoryInboundMessageTypeEnum"), exports);
 __exportStar(require("./dtos/requests/HoldStockRequest"), exports);

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.d.ts

@@ -1,3 +1,3 @@
 import { RetailPromotionsErrorCodeEnum as C } from '../enums/RetailPromotionsErrorCodeEnum';
-/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
-export declare const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 | 422>>;
+/** Status HTTP de cada code: 403 sesión sin alcance · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+export declare const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 403 | 404 | 409 | 422>>;

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = void 0;
 const RetailPromotionsErrorCodeEnum_1 = require("../enums/RetailPromotionsErrorCodeEnum");
-/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+/** Status HTTP de cada code: 403 sesión sin alcance · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
 exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_PROMOTION_TRANSITION]: 409,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.CODE_TEXT_TAKEN]: 409,
@@ -20,4 +20,8 @@ exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.DISCOUNT_AFTER_QUOTE]: 409,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_SALE_PROMOTION]: 422,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.INVALID_DISCOUNT_CODE]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SALE_PROMOTION_NOT_FOUND]: 404,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SALE_COUPON_NOT_FOUND]: 404,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.MISSING_RETAILER_SCOPE]: 403,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.MISSING_STORE_SCOPE]: 403,
 };

package/bin/retailPromotions/dtos/SalePromotionLevers.d.ts

@@ -1,3 +1,4 @@
+import { AccessorySubcategoryEnum } from '../../retailCatalog/enums/AccessorySubcategoryEnum';
 import { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
 import { CouponScopeEnum } from '../enums/CouponScopeEnum';
@@ -8,11 +9,11 @@ export interface AccessoryDiscountLever {
     percentBps: number;
     maxAmountCents: number | null;
 }
-/** Regalo por lista (`skus`) o por gama (`category` + `maxPriceCents`); el cliente elige `chooseCount`. */
+/** Regalo por lista (`skus`) o por gama (`accessorySubcategory` + `maxPriceCents`); el cliente elige `chooseCount`. */
 export interface GiftLever {
     mode: GiftModeEnum;
     skus: string[] | null;
-    category: string | null;
+    accessorySubcategory: AccessorySubcategoryEnum | null;
     maxPriceCents: number | null;
     chooseCount: number;
 }

package/bin/retailPromotions/dtos/requests/GetSaleCouponQuery.d.ts

@@ -0,0 +1,4 @@
+/** Query de publicGetSaleCoupon (`GET /public/sales/{saleId}/coupon`). */
+export declare class GetSaleCouponQuery {
+    sessionId?: string;
+}

package/bin/retailPromotions/dtos/requests/GetSaleCouponQuery.js

@@ -0,0 +1,25 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetSaleCouponQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Query de publicGetSaleCoupon (`GET /public/sales/{saleId}/coupon`). */
+class GetSaleCouponQuery {
+}
+exports.GetSaleCouponQuery = GetSaleCouponQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], GetSaleCouponQuery.prototype, "sessionId", void 0);

package/bin/retailPromotions/dtos/requests/SalePromotionLeversInput.d.ts

@@ -1,3 +1,4 @@
+import { AccessorySubcategoryEnum } from '../../../retailCatalog/enums/AccessorySubcategoryEnum';
 import { CouponScopeEnum } from '../../enums/CouponScopeEnum';
 import { GiftModeEnum } from '../../enums/GiftModeEnum';
 import { DiscountValueInput } from './DiscountValueInput';
@@ -5,11 +6,11 @@ export declare class AccessoryDiscountLeverInput {
     percentBps: number;
     maxAmountCents?: number | null;
 }
-/** Regalo por lista exige `skus`; por gama exige `category` y `maxPriceCents`. */
+/** Regalo por lista exige `skus`; por gama exige `accessorySubcategory` y `maxPriceCents`. */
 export declare class GiftLeverInput {
     mode: GiftModeEnum;
     skus?: string[] | null;
-    category?: string | null;
+    accessorySubcategory?: AccessorySubcategoryEnum | null;
     maxPriceCents?: number | null;
     chooseCount: number;
 }

package/bin/retailPromotions/dtos/requests/SalePromotionLeversInput.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SalePromotionLeversInput = exports.WalletBonusLeverInput = exports.ExtendedWarrantyLeverInput = exports.AirtimeLeverInput = exports.CouponLeverInput = exports.GiftLeverInput = exports.AccessoryDiscountLeverInput = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const AccessorySubcategoryEnum_1 = require("../../../retailCatalog/enums/AccessorySubcategoryEnum");
 const CouponScopeEnum_1 = require("../../enums/CouponScopeEnum");
 const GiftModeEnum_1 = require("../../enums/GiftModeEnum");
 const DiscountValueInput_1 = require("./DiscountValueInput");
@@ -29,7 +30,7 @@ __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)
 ], AccessoryDiscountLeverInput.prototype, "maxAmountCents", void 0);
-/** Regalo por lista exige `skus`; por gama exige `category` y `maxPriceCents`. */
+/** Regalo por lista exige `skus`; por gama exige `accessorySubcategory` y `maxPriceCents`. */
 class GiftLeverInput {
 }
 exports.GiftLeverInput = GiftLeverInput;
@@ -49,10 +50,9 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)((o) => o.mode === GiftModeEnum_1.GiftModeEnum.RANGE),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsEnum)(AccessorySubcategoryEnum_1.AccessorySubcategoryEnum),
     __metadata("design:type", String)
-], GiftLeverInput.prototype, "category", void 0);
+], GiftLeverInput.prototype, "accessorySubcategory", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)((o) => o.mode === GiftModeEnum_1.GiftModeEnum.RANGE),

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.d.ts

@@ -19,5 +19,11 @@ export declare enum RetailPromotionsErrorCodeEnum {
     CODE_ALREADY_APPLIED = "CODE_ALREADY_APPLIED",
     DISCOUNT_AFTER_QUOTE = "DISCOUNT_AFTER_QUOTE",
     INVALID_SALE_PROMOTION = "INVALID_SALE_PROMOTION",
-    INVALID_DISCOUNT_CODE = "INVALID_DISCOUNT_CODE"
+    INVALID_DISCOUNT_CODE = "INVALID_DISCOUNT_CODE",
+    SALE_PROMOTION_NOT_FOUND = "SALE_PROMOTION_NOT_FOUND",
+    SALE_COUPON_NOT_FOUND = "SALE_COUPON_NOT_FOUND",
+    /** La sesión no trae retailer: no se puede acotar la consulta. */
+    MISSING_RETAILER_SCOPE = "MISSING_RETAILER_SCOPE",
+    /** La sesión no trae tienda: no se puede acotar la consulta. */
+    MISSING_STORE_SCOPE = "MISSING_STORE_SCOPE"
 }

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.js

@@ -24,4 +24,10 @@ var RetailPromotionsErrorCodeEnum;
     RetailPromotionsErrorCodeEnum["DISCOUNT_AFTER_QUOTE"] = "DISCOUNT_AFTER_QUOTE";
     RetailPromotionsErrorCodeEnum["INVALID_SALE_PROMOTION"] = "INVALID_SALE_PROMOTION";
     RetailPromotionsErrorCodeEnum["INVALID_DISCOUNT_CODE"] = "INVALID_DISCOUNT_CODE";
+    RetailPromotionsErrorCodeEnum["SALE_PROMOTION_NOT_FOUND"] = "SALE_PROMOTION_NOT_FOUND";
+    RetailPromotionsErrorCodeEnum["SALE_COUPON_NOT_FOUND"] = "SALE_COUPON_NOT_FOUND";
+    /** La sesión no trae retailer: no se puede acotar la consulta. */
+    RetailPromotionsErrorCodeEnum["MISSING_RETAILER_SCOPE"] = "MISSING_RETAILER_SCOPE";
+    /** La sesión no trae tienda: no se puede acotar la consulta. */
+    RetailPromotionsErrorCodeEnum["MISSING_STORE_SCOPE"] = "MISSING_STORE_SCOPE";
 })(RetailPromotionsErrorCodeEnum || (exports.RetailPromotionsErrorCodeEnum = RetailPromotionsErrorCodeEnum = {}));

package/bin/retailPromotions/index.d.ts

@@ -41,6 +41,7 @@ export * from './dtos/requests/ChangeDiscountCodeStatusRequest';
 export * from './dtos/requests/ListStoreSalePromotionsQuery';
 export * from './dtos/requests/EvaluateSalePromotionsRequest';
 export * from './dtos/requests/HoldSalePromotionRequest';
+export * from './dtos/requests/GetSaleCouponQuery';
 export * from './dtos/responses/SalePromotionCrudResponses';
 export * from './dtos/responses/DiscountCodeResponses';
 export * from './dtos/responses/WizardSalePromotionResponses';

package/bin/retailPromotions/index.js

@@ -61,6 +61,7 @@ __exportStar(require("./dtos/requests/ChangeDiscountCodeStatusRequest"), exports
 __exportStar(require("./dtos/requests/ListStoreSalePromotionsQuery"), exports);
 __exportStar(require("./dtos/requests/EvaluateSalePromotionsRequest"), exports);
 __exportStar(require("./dtos/requests/HoldSalePromotionRequest"), exports);
+__exportStar(require("./dtos/requests/GetSaleCouponQuery"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/SalePromotionCrudResponses"), exports);
 __exportStar(require("./dtos/responses/DiscountCodeResponses"), exports);

package/bin/retailWizard/dtos/WizardGiftLine.d.ts

@@ -1,8 +1,10 @@
 import type { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
 import type { WizardReservedLine } from './WizardReservedLine';
-/** Línea GIFT: siempre ligada a un ancla y con el precio de lista que se regala. */
+/** Línea GIFT: ligada a un ancla, con su promo y el precio de lista que se regala. */
 export type WizardGiftLine = WizardReservedLine & {
     role: WizardLineRoleEnum.GIFT;
     linkedLineId: string;
+    promotionId: string;
+    promotionVersion: number;
     originalPriceCents: number;
 };

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

@@ -1,7 +1,6 @@
 /**
- * PUT /private/wizard/sessions/{id}/lines/{lineId}/promotion (privateApplyLinePromotion, M2M de Promociones).
- * Reemplaza la promo de la línea por valor: un campo ausente queda borrado. `tenantId` va en el query.
- * Nunca toca role ni linkedLineId: los GIFT los gestiona el PUT …/gifts. Responde 204 sin body.
+ * PUT …/lines/{lineId}/promotion (privateApplyLinePromotion): reemplaza la promo de la línea por valor.
+ * Un campo ausente queda borrado; no toca role ni linkedLineId. `tenantId` va en el query.
  */
 export declare class ApplyLinePromotionRequest {
     promotionId?: string;

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

@@ -14,9 +14,8 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const hasPromotion = (o) => o.promotionId !== undefined || o.promotionVersion !== undefined;
 /**
- * PUT /private/wizard/sessions/{id}/lines/{lineId}/promotion (privateApplyLinePromotion, M2M de Promociones).
- * Reemplaza la promo de la línea por valor: un campo ausente queda borrado. `tenantId` va en el query.
- * Nunca toca role ni linkedLineId: los GIFT los gestiona el PUT …/gifts. Responde 204 sin body.
+ * PUT …/lines/{lineId}/promotion (privateApplyLinePromotion): reemplaza la promo de la línea por valor.
+ * Un campo ausente queda borrado; no toca role ni linkedLineId. `tenantId` va en el query.
  */
 class ApplyLinePromotionRequest {
 }

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

@@ -8,6 +8,6 @@
 export declare class QuoteRequest {
     downPaymentCents: number;
     termWeeks: number;
-    /** Se ignora: el servidor financia la ancla. Se acepta un release más por el front viejo. */
+    /** Se ignora: el servidor financia la ancla. */
     financedLineId?: string;
 }

package/bin/retailWizard/events/RetailPromotionInboundMessage.d.ts

@@ -34,7 +34,7 @@ export declare class RetailPromotionInboundMessage {
     occurredAt: string;
     creditId?: string;
     fiadoDirectoryId?: string;
-    salePromotionId?: string;
-    salePromotionVersion?: number;
+    salePromotionId?: string | null;
+    salePromotionVersion?: number | null;
     lines: RetailPromotionInboundLine[];
 }

package/bin/retailWizard/events/RetailPromotionInboundMessage.js

@@ -132,11 +132,13 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], RetailPromotionInboundMessage.prototype, "creditId", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], RetailPromotionInboundMessage.prototype, "fiadoDirectoryId", void 0);
 __decorate([

package/package.json

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

package/src/retailCatalog/dtos/Product.ts

@@ -3,6 +3,7 @@ import { MdmProviderEnum } from '../enums/MdmProviderEnum';
 import { ProductStatusEnum } from '../enums/ProductStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
 import { ProductCategoryEnum } from '../enums/ProductCategoryEnum';
+import { AccessorySubcategoryEnum } from '../enums/AccessorySubcategoryEnum';
 import { TrackingModeEnum } from '../enums/TrackingModeEnum';
 import { ItemTypeEnum } from '../enums/ItemTypeEnum';
 import { ProductComponent } from './ProductComponent';
@@ -40,6 +41,8 @@ export class Product {
 
     // Campos del inventario multi-item; opcionales hasta que todo producto pase por la puerta de entrada.
     category?: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     trackingMode?: TrackingModeEnum;
     /** Se puede vender suelto (fuera de un kit). */
     sellable?: boolean;

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

@@ -2,6 +2,7 @@ import { IsArray, IsBoolean, IsEnum, IsIn, IsInt, IsISO8601, IsObject, IsOptiona
 import { SKU_PATTERN } from '../../constants/SkuPattern';
 import { NON_BUNDLE_CATEGORIES } from '../../constants/NonBundleCategories';
 import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { TrackingModeEnum } from '../../enums/TrackingModeEnum';
 import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
@@ -19,6 +20,11 @@ export class BackofficeCreateProductRequest {
     @IsIn(NON_BUNDLE_CATEGORIES)
     category!: ProductCategoryEnum;
 
+    /** Solo en ACCESSORY. */
+    @IsOptional()
+    @IsEnum(AccessorySubcategoryEnum)
+    accessorySubcategory?: AccessorySubcategoryEnum;
+
     /** Inmutable tras el alta. */
     @IsEnum(TrackingModeEnum)
     trackingMode!: TrackingModeEnum;

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

@@ -2,6 +2,7 @@ import { Type } from 'class-transformer';
 import { ArrayMinSize, IsArray, IsBoolean, IsEnum, IsIn, IsInt, IsISO8601, IsObject, IsOptional, IsString, Matches, Max, Min, Validate, ValidateNested } from 'class-validator';
 import { NON_BUNDLE_CATEGORIES } from '../../constants/NonBundleCategories';
 import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { ProductComponent } from '../ProductComponent';
 import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
@@ -14,6 +15,11 @@ export class BackofficeUpdateProductRequest {
     @IsIn(NON_BUNDLE_CATEGORIES)
     category?: ProductCategoryEnum;
 
+    /** Solo en ACCESSORY. */
+    @IsOptional()
+    @IsEnum(AccessorySubcategoryEnum)
+    accessorySubcategory?: AccessorySubcategoryEnum;
+
     @IsOptional()
     @IsBoolean()
     sellable?: boolean;

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

@@ -1,10 +1,11 @@
 import { Type } from 'class-transformer';
-import { ArrayMinSize, IsArray, IsString, ValidateNested } from 'class-validator';
+import { ArrayMinSize, IsArray, IsNotEmpty, IsString, ValidateNested } from 'class-validator';
 import { ReservationLineRef } from './ReservationLineRef';
 
 /** Componente de la línea con las piezas que quedan HELD de la sesión. */
 export class HoldStockComponent {
     @IsString()
+    @IsNotEmpty()
     sku!: string;
 
     @IsArray()
@@ -15,9 +16,11 @@ export class HoldStockComponent {
 /** Body de PUT /private/stores/{storeId}/holds (privateHoldStock); fija las piezas de una línea. */
 export class HoldStockRequest extends ReservationLineRef {
     @IsString()
+    @IsNotEmpty()
     sessionId!: string;
 
     @IsString()
+    @IsNotEmpty()
     retailerId!: string;
 
     @IsArray()

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

@@ -1,6 +1,7 @@
 import type { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
 import type { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import type { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
 import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { TrackingModeEnum } from '../../enums/TrackingModeEnum';
 import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
@@ -18,6 +19,8 @@ export interface StoreCatalogItem {
     available: number;
     basePriceCents: number;
     category: ProductCategoryEnum;
+    /** Solo en ACCESSORY. */
+    accessorySubcategory?: AccessorySubcategoryEnum;
     trackingMode: TrackingModeEnum;
     brand: string;
     model: string;

package/src/retailCatalog/enums/AccessorySubcategoryEnum.ts

@@ -0,0 +1,9 @@
+/** Subcategoría de un producto ACCESSORY; sirve para regalar «por gama» en Promociones. */
+export enum AccessorySubcategoryEnum {
+    AUDIO = 'AUDIO',
+    CHARGING = 'CHARGING',
+    PROTECTION = 'PROTECTION',
+    CABLES = 'CABLES',
+    WEARABLES = 'WEARABLES',
+    OTHER = 'OTHER',
+}

package/src/retailCatalog/index.ts

@@ -45,6 +45,7 @@ export * from './dtos/validation/ValidateInventoryResponse';
 
 // Inventario multi-item (ciclo 1)
 export * from './enums/ProductCategoryEnum';
+export * from './enums/AccessorySubcategoryEnum';
 export * from './enums/TrackingModeEnum';
 export * from './enums/InventoryMovementTypeEnum';
 export * from './enums/InventorySyncResultStatusEnum';
@@ -93,7 +94,7 @@ export * from './dtos/requests/BackofficeListTransfersQuery';
 export * from './dtos/responses/TransferResponse';
 export * from './dtos/responses/ListTransfersResponse';
 
-// Venta saga (ciclo 3)
+// Saga de venta: hold y avisos de la cola
 export * from './enums/ReservePurposeEnum';
 export * from './enums/InventoryInboundMessageTypeEnum';
 export * from './dtos/requests/HoldStockRequest';

package/src/retailPromotions/constants/retailPromotionsErrorHttpStatus.ts

@@ -1,7 +1,7 @@
 import { RetailPromotionsErrorCodeEnum as C } from '../enums/RetailPromotionsErrorCodeEnum';
 
-/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
-export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 | 422>> = {
+/** Status HTTP de cada code: 403 sesión sin alcance · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 403 | 404 | 409 | 422>> = {
     [C.INVALID_PROMOTION_TRANSITION]: 409,
     [C.CODE_TEXT_TAKEN]: 409,
     [C.PROMOTION_NOT_ACTIVE]: 409,
@@ -18,4 +18,8 @@ export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 |
     [C.DISCOUNT_AFTER_QUOTE]: 409,
     [C.INVALID_SALE_PROMOTION]: 422,
     [C.INVALID_DISCOUNT_CODE]: 422,
+    [C.SALE_PROMOTION_NOT_FOUND]: 404,
+    [C.SALE_COUPON_NOT_FOUND]: 404,
+    [C.MISSING_RETAILER_SCOPE]: 403,
+    [C.MISSING_STORE_SCOPE]: 403,
 };

package/src/retailPromotions/dtos/SalePromotionLevers.ts

@@ -1,3 +1,4 @@
+import { AccessorySubcategoryEnum } from '../../retailCatalog/enums/AccessorySubcategoryEnum';
 import { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
 import { CouponScopeEnum } from '../enums/CouponScopeEnum';
@@ -10,11 +11,11 @@ export interface AccessoryDiscountLever {
     maxAmountCents: number | null;
 }
 
-/** Regalo por lista (`skus`) o por gama (`category` + `maxPriceCents`); el cliente elige `chooseCount`. */
+/** Regalo por lista (`skus`) o por gama (`accessorySubcategory` + `maxPriceCents`); el cliente elige `chooseCount`. */
 export interface GiftLever {
     mode: GiftModeEnum;
     skus: string[] | null;
-    category: string | null;
+    accessorySubcategory: AccessorySubcategoryEnum | null;
     maxPriceCents: number | null;
     chooseCount: number;
 }

package/src/retailPromotions/dtos/requests/GetSaleCouponQuery.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+
+/** Query de publicGetSaleCoupon (`GET /public/sales/{saleId}/coupon`). */
+export class GetSaleCouponQuery {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    sessionId?: string;
+}

package/src/retailPromotions/dtos/requests/SalePromotionLeversInput.ts

@@ -4,12 +4,12 @@ import {
     IsArray,
     IsEnum,
     IsInt,
-    IsNotEmpty,
     IsOptional,
     IsString,
     ValidateIf,
     ValidateNested,
 } from 'class-validator';
+import { AccessorySubcategoryEnum } from '../../../retailCatalog/enums/AccessorySubcategoryEnum';
 import { CouponScopeEnum } from '../../enums/CouponScopeEnum';
 import { GiftModeEnum } from '../../enums/GiftModeEnum';
 import { DiscountValueInput } from './DiscountValueInput';
@@ -25,7 +25,7 @@ export class AccessoryDiscountLeverInput {
     maxAmountCents?: number | null;
 }
 
-/** Regalo por lista exige `skus`; por gama exige `category` y `maxPriceCents`. */
+/** Regalo por lista exige `skus`; por gama exige `accessorySubcategory` y `maxPriceCents`. */
 export class GiftLeverInput {
     @Expose()
     @IsEnum(GiftModeEnum)
@@ -40,9 +40,8 @@ export class GiftLeverInput {
 
     @Expose()
     @ValidateIf((o: GiftLeverInput) => o.mode === GiftModeEnum.RANGE)
-    @IsString()
-    @IsNotEmpty()
-    category?: string | null;
+    @IsEnum(AccessorySubcategoryEnum)
+    accessorySubcategory?: AccessorySubcategoryEnum | null;
 
     @Expose()
     @ValidateIf((o: GiftLeverInput) => o.mode === GiftModeEnum.RANGE)

package/src/retailPromotions/enums/RetailPromotionsErrorCodeEnum.ts

@@ -20,4 +20,10 @@ export enum RetailPromotionsErrorCodeEnum {
     DISCOUNT_AFTER_QUOTE = 'DISCOUNT_AFTER_QUOTE',
     INVALID_SALE_PROMOTION = 'INVALID_SALE_PROMOTION',
     INVALID_DISCOUNT_CODE = 'INVALID_DISCOUNT_CODE',
+    SALE_PROMOTION_NOT_FOUND = 'SALE_PROMOTION_NOT_FOUND',
+    SALE_COUPON_NOT_FOUND = 'SALE_COUPON_NOT_FOUND',
+    /** La sesión no trae retailer: no se puede acotar la consulta. */
+    MISSING_RETAILER_SCOPE = 'MISSING_RETAILER_SCOPE',
+    /** La sesión no trae tienda: no se puede acotar la consulta. */
+    MISSING_STORE_SCOPE = 'MISSING_STORE_SCOPE',
 }

package/src/retailPromotions/index.ts

@@ -48,6 +48,7 @@ export * from './dtos/requests/ChangeDiscountCodeStatusRequest';
 export * from './dtos/requests/ListStoreSalePromotionsQuery';
 export * from './dtos/requests/EvaluateSalePromotionsRequest';
 export * from './dtos/requests/HoldSalePromotionRequest';
+export * from './dtos/requests/GetSaleCouponQuery';
 
 // Response DTOs
 export * from './dtos/responses/SalePromotionCrudResponses';

package/src/retailWizard/dtos/WizardGiftLine.ts

@@ -1,9 +1,11 @@
 import type { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
 import type { WizardReservedLine } from './WizardReservedLine';
 
-/** Línea GIFT: siempre ligada a un ancla y con el precio de lista que se regala. */
+/** Línea GIFT: ligada a un ancla, con su promo y el precio de lista que se regala. */
 export type WizardGiftLine = WizardReservedLine & {
     role: WizardLineRoleEnum.GIFT;
     linkedLineId: string;
+    promotionId: string;
+    promotionVersion: number;
     originalPriceCents: number;
 };

package/src/retailWizard/dtos/requests/ApplyLinePromotionRequest.ts

@@ -5,9 +5,8 @@ const hasPromotion = (o: ApplyLinePromotionRequest): boolean =>
   o.promotionId !== undefined || o.promotionVersion !== undefined;
 
 /**
- * PUT /private/wizard/sessions/{id}/lines/{lineId}/promotion (privateApplyLinePromotion, M2M de Promociones).
- * Reemplaza la promo de la línea por valor: un campo ausente queda borrado. `tenantId` va en el query.
- * Nunca toca role ni linkedLineId: los GIFT los gestiona el PUT …/gifts. Responde 204 sin body.
+ * PUT …/lines/{lineId}/promotion (privateApplyLinePromotion): reemplaza la promo de la línea por valor.
+ * Un campo ausente queda borrado; no toca role ni linkedLineId. `tenantId` va en el query.
  */
 export class ApplyLinePromotionRequest {
   @Expose()

package/src/retailWizard/dtos/requests/QuoteRequest.ts

@@ -19,7 +19,7 @@ export class QuoteRequest {
     @Min(1)
     termWeeks!: number;
 
-    /** Se ignora: el servidor financia la ancla. Se acepta un release más por el front viejo. */
+    /** Se ignora: el servidor financia la ancla. */
     @Expose()
     @IsOptional()
     @IsString()

package/src/retailWizard/events/RetailPromotionInboundMessage.ts

@@ -114,21 +114,23 @@ export class RetailPromotionInboundMessage {
 
     @IsOptional()
     @IsString()
+    @IsNotEmpty()
     creditId?: string;
 
     @IsOptional()
     @IsString()
+    @IsNotEmpty()
     fiadoDirectoryId?: string;
 
     @IsOptional()
     @IsString()
     @IsNotEmpty()
-    salePromotionId?: string;
+    salePromotionId?: string | null;
 
     @IsOptional()
     @IsInt()
     @Min(1)
-    salePromotionVersion?: number;
+    salePromotionVersion?: number | null;
 
     @IsArray()
     @ArrayMinSize(1)