@fiado/type-kit 3.500.0 → 3.502.0

package/bin/retailPromotions/index.d.ts

@@ -29,6 +29,9 @@ export * from './dtos/SalePromotion';
 export * from './dtos/SalePromotionLogEntry';
 export * from './dtos/DiscountCode';
 export * from './dtos/LinePromotionDiscount';
+export * from './dtos/LinePromotionAmount';
+export * from './dtos/SalePromotionRef';
+export * from './validators/IsHoldModeExclusiveConstraint';
 export * from './dtos/requests/DiscountValueInput';
 export * from './dtos/requests/SalePromotionLeversInput';
 export * from './dtos/requests/SalePromotionScopeInput';
@@ -43,6 +46,7 @@ export * from './dtos/requests/ChangeDiscountCodeStatusRequest';
 export * from './dtos/requests/ListStoreSalePromotionsQuery';
 export * from './dtos/requests/EvaluateSalePromotionsRequest';
 export * from './dtos/requests/HoldGiftPromotionInput';
+export * from './dtos/requests/HoldPromotionInput';
 export * from './dtos/requests/HoldSalePromotionRequest';
 export * from './dtos/requests/GetSaleCouponQuery';
 export * from './dtos/requests/SkuSalePromotionsQuery';

package/bin/retailPromotions/index.js

@@ -48,6 +48,10 @@ __exportStar(require("./dtos/SalePromotion"), exports);
 __exportStar(require("./dtos/SalePromotionLogEntry"), exports);
 __exportStar(require("./dtos/DiscountCode"), exports);
 __exportStar(require("./dtos/LinePromotionDiscount"), exports);
+__exportStar(require("./dtos/LinePromotionAmount"), exports);
+__exportStar(require("./dtos/SalePromotionRef"), exports);
+// Validadores
+__exportStar(require("./validators/IsHoldModeExclusiveConstraint"), exports);
 // Request DTOs
 __exportStar(require("./dtos/requests/DiscountValueInput"), exports);
 __exportStar(require("./dtos/requests/SalePromotionLeversInput"), exports);
@@ -63,6 +67,7 @@ __exportStar(require("./dtos/requests/ChangeDiscountCodeStatusRequest"), exports
 __exportStar(require("./dtos/requests/ListStoreSalePromotionsQuery"), exports);
 __exportStar(require("./dtos/requests/EvaluateSalePromotionsRequest"), exports);
 __exportStar(require("./dtos/requests/HoldGiftPromotionInput"), exports);
+__exportStar(require("./dtos/requests/HoldPromotionInput"), exports);
 __exportStar(require("./dtos/requests/HoldSalePromotionRequest"), exports);
 __exportStar(require("./dtos/requests/GetSaleCouponQuery"), exports);
 __exportStar(require("./dtos/requests/SkuSalePromotionsQuery"), exports);

package/bin/retailPromotions/validators/IsHoldModeExclusiveConstraint.d.ts

@@ -0,0 +1,6 @@
+import { type ValidationArguments, type ValidatorConstraintInterface } from 'class-validator';
+/** Rechaza mandar `promotions` junto con `gift`, `promotionId` o `saleGiftSkus` (forma vieja). */
+export declare class IsHoldModeExclusiveConstraint implements ValidatorConstraintInterface {
+    validate(_value: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/retailPromotions/validators/IsHoldModeExclusiveConstraint.js

@@ -0,0 +1,24 @@
+"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.IsHoldModeExclusiveConstraint = void 0;
+const class_validator_1 = require("class-validator");
+/** Rechaza mandar `promotions` junto con `gift`, `promotionId` o `saleGiftSkus` (forma vieja). */
+let IsHoldModeExclusiveConstraint = class IsHoldModeExclusiveConstraint {
+    validate(_value, args) {
+        const o = args.object;
+        return o.gift == null && o.promotionId == null && o.saleGiftSkus == null;
+    }
+    defaultMessage() {
+        return 'promotions no se combina con gift, promotionId ni saleGiftSkus';
+    }
+};
+exports.IsHoldModeExclusiveConstraint = IsHoldModeExclusiveConstraint;
+exports.IsHoldModeExclusiveConstraint = IsHoldModeExclusiveConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isHoldModeExclusive', async: false })
+], IsHoldModeExclusiveConstraint);

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

@@ -5,6 +5,7 @@ import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
 import type { SalePaymentDetail } from './SalePaymentDetail';
 import type { SaleLine } from './SaleLine';
+import type { SalePromotionRef } from '../../retailPromotions/dtos/SalePromotionRef';
 /**
  * Venta (modelo-datos §3). pk `SALE#<saleId>` · sk `META` · 4 GSIs (`retailerId-soldAt-index`,
  * `storeId-soldAt-index`, `seller-soldAt-index`, `customerId-soldAt-index`). Unicidad de folio vía
@@ -31,6 +32,8 @@ export interface Sale {
     /** Promo de venta congelada al cerrar; `null` = ninguna. */
     salePromotionId?: string | null;
     salePromotionVersion?: number | null;
+    /** Todas las promos de venta congeladas al cerrar. */
+    salePromotions?: SalePromotionRef[] | null;
     /** IMEI consumido del silo también en contado (local-first); null en EXTERNAL_REFERRAL (D15). */
     imei: string | null;
     /** Lo cobrado en caja al cerrar: enganche + lo no financiado; 0 en EXTERNAL_REFERRAL. Contrato de `SaleCompletedV1`. */

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

@@ -1,3 +1,4 @@
+import type { LinePromotionAmount } from '../../retailPromotions/dtos/LinePromotionAmount';
 import type { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
 /** Campos de Promociones en la línea de sesión y de venta; solo los escribe su endpoint M2M. */
 export interface WizardLinePromotionFields {
@@ -12,4 +13,7 @@ export interface WizardLinePromotionFields {
     discountCents?: number;
     /** Precio antes del descuento; en un regalo, el valor de lista con la línea a $0. */
     originalPriceCents?: number;
+    /** Descuento de cada promo en la línea; sin el campo, la de `promotionId` lleva todo menos el código. */
+    promotionDiscounts?: LinePromotionAmount[];
+    codeDiscountCents?: number;
 }

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

@@ -1,3 +1,4 @@
+import type { SalePromotionRef } from '../../retailPromotions/dtos/SalePromotionRef';
 import type { WizardStateEnum } from '../enums/WizardStateEnum';
 import type { WizardStepEnum } from '../enums/WizardStepEnum';
 import type { FiadoPhoneStatusEnum } from '../enums/FiadoPhoneStatusEnum';
@@ -122,6 +123,8 @@ export interface WizardSession {
     /** Promo de venta que fijó Promociones; `null` = ninguna. */
     salePromotionId?: string | null;
     salePromotionVersion?: number | null;
+    /** Todas las promos de venta fijadas; `salePromotionId` queda como la principal. */
+    salePromotions?: SalePromotionRef[] | null;
     /** Enganche cobrado que queda por reembolsar tras cancelar. */
     refundPendingCents?: number;
     paymentMethod: PaymentMethodEnum | null;

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

@@ -1,3 +1,4 @@
+import { LinePromotionAmount } from '../../../retailPromotions/dtos/LinePromotionAmount';
 /**
  * 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.
@@ -11,4 +12,8 @@ export declare class ApplyLinePromotionRequest {
     /** Descuento total de la línea; 0 mientras el código espera revalidarse. */
     discountCents?: number;
     originalPriceCents?: number;
+    /** Descuento de cada promo en la línea; `promotionId` queda como la principal. */
+    promotionDiscounts?: LinePromotionAmount[];
+    /** Parte de `discountCents` que viene del código. */
+    codeDiscountCents?: number;
 }

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApplyLinePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const LinePromotionAmount_1 = require("../../../retailPromotions/dtos/LinePromotionAmount");
 const hasPromotion = (o) => o.promotionId !== undefined || o.promotionVersion !== undefined;
 /**
  * PUT …/lines/{lineId}/promotion (privateApplyLinePromotion): reemplaza la promo de la línea por valor.
@@ -55,3 +56,18 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], ApplyLinePromotionRequest.prototype, "originalPriceCents", 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)(() => LinePromotionAmount_1.LinePromotionAmount),
+    __metadata("design:type", Array)
+], ApplyLinePromotionRequest.prototype, "promotionDiscounts", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ApplyLinePromotionRequest.prototype, "codeDiscountCents", void 0);

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

@@ -1,3 +1,4 @@
+import { SalePromotionRef } from '../../../retailPromotions/dtos/SalePromotionRef';
 /**
  * PUT /private/wizard/sessions/{id}/sale-promotion (privateApplySalePromotion, M2M de Promociones).
  * Ambos en `null` = «Ninguna»; la versión va solo con la promo. `tenantId` va en el query.
@@ -6,4 +7,6 @@
 export declare class ApplySalePromotionRequest {
     salePromotionId: string | null;
     salePromotionVersion: number | null;
+    /** Todas las promos de venta fijadas; `salePromotionId` queda como la principal. */
+    salePromotions?: SalePromotionRef[] | null;
 }

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApplySalePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const SalePromotionRef_1 = require("../../../retailPromotions/dtos/SalePromotionRef");
 /**
  * PUT /private/wizard/sessions/{id}/sale-promotion (privateApplySalePromotion, M2M de Promociones).
  * Ambos en `null` = «Ninguna»; la versión va solo con la promo. `tenantId` va en el query.
@@ -34,3 +35,11 @@ __decorate([
     (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], ApplySalePromotionRequest.prototype, "salePromotionVersion", 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)(() => SalePromotionRef_1.SalePromotionRef),
+    __metadata("design:type", Array)
+], ApplySalePromotionRequest.prototype, "salePromotions", void 0);

package/bin/retailWizard/dtos/responses/PrivateWizardSessionResponse.d.ts

@@ -3,6 +3,7 @@ import type { WizardStateEnum } from '../../enums/WizardStateEnum';
 import type { WizardStepEnum } from '../../enums/WizardStepEnum';
 import type { WizardPayment } from '../WizardPayment';
 import type { WizardReservedLine } from '../WizardReservedLine';
+import type { SalePromotionRef } from '../../../retailPromotions/dtos/SalePromotionRef';
 /** GET /private/wizard/sessions/{id} (privateGetWizardSession): lo que Promociones lee de la sesión. */
 export interface PrivateWizardSessionResponse {
     sessionId: string;
@@ -18,6 +19,8 @@ export interface PrivateWizardSessionResponse {
     anchorLineId: string | null;
     salePromotionId: string | null;
     salePromotionVersion: number | null;
+    /** Todas las promos de venta fijadas; `salePromotionId` queda como la principal. */
+    salePromotions?: SalePromotionRef[] | null;
     /** Líneas vivas con los campos de Promociones y financedCents. */
     lines: WizardReservedLine[];
     fiadoDirectoryId?: string | null;

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

@@ -1,3 +1,5 @@
+import { LinePromotionAmount } from '../../retailPromotions/dtos/LinePromotionAmount';
+import { SalePromotionRef } from '../../retailPromotions/dtos/SalePromotionRef';
 import { RetailPromotionInboundMessageTypeEnum } from '../enums/RetailPromotionInboundMessageTypeEnum';
 import { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
 /** Línea de la venta en el mensaje de Promociones. */
@@ -12,6 +14,10 @@ export declare class RetailPromotionInboundLine {
     /** Solo en la línea ancla. */
     discountCode?: string;
     discountCents?: number;
+    /** Descuento de cada promo en la línea; `promotionId` queda como la principal. */
+    promotionDiscounts?: LinePromotionAmount[];
+    /** Parte de `discountCents` que viene del código. */
+    codeDiscountCents?: number;
     /** Si la línea no lo trae, basePriceCents × qty. */
     originalPriceCents: number;
     /** Identificadores de todos los componentes de la línea, aplanados. */
@@ -36,5 +42,7 @@ export declare class RetailPromotionInboundMessage {
     fiadoDirectoryId?: string;
     salePromotionId?: string | null;
     salePromotionVersion?: number | null;
+    /** Todas las promos de venta de la venta; `salePromotionId` queda como la principal. */
+    salePromotions?: SalePromotionRef[] | null;
     lines: RetailPromotionInboundLine[];
 }

package/bin/retailWizard/events/RetailPromotionInboundMessage.js

@@ -12,6 +12,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetailPromotionInboundMessage = exports.RetailPromotionInboundLine = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const LinePromotionAmount_1 = require("../../retailPromotions/dtos/LinePromotionAmount");
+const SalePromotionRef_1 = require("../../retailPromotions/dtos/SalePromotionRef");
 const RetailPromotionInboundMessageTypeEnum_1 = require("../enums/RetailPromotionInboundMessageTypeEnum");
 const WizardLineRoleEnum_1 = require("../enums/WizardLineRoleEnum");
 /** Línea de la venta en el mensaje de Promociones. */
@@ -68,6 +70,19 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], RetailPromotionInboundLine.prototype, "discountCents", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => LinePromotionAmount_1.LinePromotionAmount),
+    __metadata("design:type", Array)
+], RetailPromotionInboundLine.prototype, "promotionDiscounts", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], RetailPromotionInboundLine.prototype, "codeDiscountCents", void 0);
 __decorate([
     (0, class_validator_1.IsInt)(),
     (0, class_validator_1.Min)(0),
@@ -153,6 +168,13 @@ __decorate([
     (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], RetailPromotionInboundMessage.prototype, "salePromotionVersion", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SalePromotionRef_1.SalePromotionRef),
+    __metadata("design:type", Array)
+], RetailPromotionInboundMessage.prototype, "salePromotions", void 0);
 __decorate([
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(1),

package/bin/retailWizard/index.d.ts

@@ -41,6 +41,8 @@ export * from './dtos/WizardBlocked';
 export * from './dtos/WizardLineProduct';
 export * from './dtos/WizardLineIdentifiers';
 export * from './dtos/WizardLinePromotionFields';
+export { LinePromotionAmount } from '../retailPromotions/dtos/LinePromotionAmount';
+export { SalePromotionRef } from '../retailPromotions/dtos/SalePromotionRef';
 export * from './dtos/WizardFinancingPreview';
 export * from './dtos/WizardReservedLine';
 export * from './dtos/WizardGiftLine';

package/bin/retailWizard/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalePromotionRef = exports.LinePromotionAmount = void 0;
 // Catálogos de valores compartidos entre endpoints
 __exportStar(require("./catalog/monthlyIncome"), exports);
 // Enums
@@ -60,6 +61,10 @@ __exportStar(require("./dtos/WizardBlocked"), exports);
 __exportStar(require("./dtos/WizardLineProduct"), exports);
 __exportStar(require("./dtos/WizardLineIdentifiers"), exports);
 __exportStar(require("./dtos/WizardLinePromotionFields"), exports);
+var LinePromotionAmount_1 = require("../retailPromotions/dtos/LinePromotionAmount");
+Object.defineProperty(exports, "LinePromotionAmount", { enumerable: true, get: function () { return LinePromotionAmount_1.LinePromotionAmount; } });
+var SalePromotionRef_1 = require("../retailPromotions/dtos/SalePromotionRef");
+Object.defineProperty(exports, "SalePromotionRef", { enumerable: true, get: function () { return SalePromotionRef_1.SalePromotionRef; } });
 __exportStar(require("./dtos/WizardFinancingPreview"), exports);
 __exportStar(require("./dtos/WizardReservedLine"), exports);
 __exportStar(require("./dtos/WizardGiftLine"), exports);

package/package.json

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

package/src/loanCredit/dtos/responses/LoanPaymentListItem.ts

@@ -12,6 +12,8 @@ export interface LoanPaymentListItem {
     /** Folio del pago — la referencia de conciliación. */
     receipt: string;
     installmentNumber: number;
+    /** Todas las cuotas que cubrió el pago, ascendente; ausente en abono, liquidación y filas viejas (usar `installmentNumber`). */
+    installmentNumbers?: number[];
     attemptId: string;
     /** Ausente en los pagos en tienda: ahí no hubo motor. */
     mechanism?: MechanismType;

package/src/retailPromotions/constants/retailPromotionsErrorHttpStatus.ts

@@ -32,4 +32,5 @@ export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 403 |
     [C.INVALID_NEXT_TOKEN]: 400,
     [C.CATALOG_SKU_NOT_FOUND]: 404,
     [C.SPLIT_FINANCING_DISABLED]: 409,
+    [C.PROMOTION_NOT_STACKABLE]: 422,
 };

package/src/retailPromotions/dtos/LinePromotionAmount.ts

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsString, Min } from 'class-validator';
+
+/** Descuento que una promo le aplica a una línea; la suma de la lista + el código da el total. */
+export class LinePromotionAmount {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    promotionId!: string;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
+    promotionVersion!: number;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    discountCents!: number;
+}

package/src/retailPromotions/dtos/LinePromotionDiscount.ts

@@ -1,3 +1,5 @@
+import type { LinePromotionAmount } from './LinePromotionAmount';
+
 /** Desglose por línea de la sesión: qué promo o código la tocó y cuánto bajó. */
 export interface LinePromotionDiscount {
     lineId: string;
@@ -7,4 +9,7 @@ export interface LinePromotionDiscount {
     originalPriceCents: number;
     discountCents: number;
     finalPriceCents: number;
+    /** Descuento de cada promo en la línea; sin el campo, la de `promotionId` lleva todo menos el código. */
+    promotionDiscounts?: LinePromotionAmount[];
+    codeDiscountCents?: number;
 }

package/src/retailPromotions/dtos/SalePromotion.ts

@@ -22,6 +22,8 @@ export interface SalePromotion {
     /** `null` = permanente. */
     validUntil: string | null;
     oncePerCustomer: boolean;
+    /** Si se puede sumar con otras promos en la misma línea. */
+    stackable: boolean;
     status: SalePromotionStatusEnum;
     /** Derivada; `null` cuando el estado no es `ACTIVE`. */
     phase: SalePromotionPhaseEnum | null;

package/src/retailPromotions/dtos/SalePromotionRef.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsString, Min } from 'class-validator';
+
+/** Promo de venta fijada en la sesión o en la venta, con su versión. */
+export class SalePromotionRef {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    promotionId!: string;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
+    promotionVersion!: number;
+}

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

@@ -70,4 +70,10 @@ export class CreateSalePromotionRequest {
     @IsOptional()
     @IsBoolean()
     oncePerCustomer?: boolean;
+
+    /** Si se puede sumar con otras promos en la misma línea. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    stackable?: boolean;
 }

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

@@ -0,0 +1,30 @@
+import { Expose } from 'class-transformer';
+import { IsArray, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
+
+/** Promo apartada en la lista nueva: a qué líneas aplica y qué regalos eligió el cliente. */
+export class HoldPromotionInput {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    promotionId!: string;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
+    promotionVersion!: number;
+
+    /** Líneas que toca la promo; ausente = las que resuelva el lambda. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    lineIds?: string[];
+
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    giftSkus?: string[];
+}

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

@@ -1,6 +1,18 @@
 import { Expose, Type } from 'class-transformer';
-import { IsArray, IsInt, IsNotEmpty, IsObject, IsOptional, IsString, ValidateIf, ValidateNested } from 'class-validator';
+import {
+    IsArray,
+    IsInt,
+    IsNotEmpty,
+    IsObject,
+    IsOptional,
+    IsString,
+    Validate,
+    ValidateIf,
+    ValidateNested,
+} from 'class-validator';
+import { IsHoldModeExclusiveConstraint } from '../../validators/IsHoldModeExclusiveConstraint';
 import { HoldGiftPromotionInput } from './HoldGiftPromotionInput';
+import { HoldPromotionInput } from './HoldPromotionInput';
 
 /**
  * Body de publicHoldSalePromotion (PUT, `sessionId` en el path): hasta una promo de regalo, una de venta
@@ -9,7 +21,7 @@ import { HoldGiftPromotionInput } from './HoldGiftPromotionInput';
 export class HoldSalePromotionRequest {
     /**
      * Promo de regalo del teléfono (su única palanca es el regalo).
-     * El lambda rechaza con PROMOTION_KIND_MISMATCH una promo de venta mandada aquí.
+     * @deprecated Usa `promotions`; no se combina con él.
      */
     @Expose()
     @IsOptional()
@@ -20,7 +32,7 @@ export class HoldSalePromotionRequest {
 
     /**
      * Promo de venta; `null` = «Ninguna».
-     * El lambda rechaza con PROMOTION_KIND_MISMATCH una promo de solo regalo mandada aquí.
+     * @deprecated Usa `promotions`; no se combina con él.
      */
     @Expose()
     @IsOptional()
@@ -33,7 +45,10 @@ export class HoldSalePromotionRequest {
     @IsInt()
     promotionVersion?: number | null;
 
-    /** Regalo incluido en la promo de venta, solo si esa promo además trae otras palancas. */
+    /**
+     * Regalo incluido en la promo de venta, solo si esa promo además trae otras palancas.
+     * @deprecated Usa `giftSkus` en `promotions`.
+     */
     @Expose()
     @IsOptional()
     @IsArray()
@@ -45,4 +60,13 @@ export class HoldSalePromotionRequest {
     @IsString()
     @IsNotEmpty()
     discountCode?: string | null;
+
+    /** Promos apartadas, cada una con sus líneas y regalos; excluyente con la forma vieja. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => HoldPromotionInput)
+    @Validate(IsHoldModeExclusiveConstraint)
+    promotions?: HoldPromotionInput[] | null;
 }

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

@@ -71,4 +71,10 @@ export class UpdateSalePromotionRequest {
     @IsOptional()
     @IsBoolean()
     oncePerCustomer?: boolean;
+
+    /** Si se puede sumar con otras promos en la misma línea. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    stackable?: boolean;
 }

package/src/retailPromotions/dtos/responses/WizardSalePromotionResponses.ts

@@ -29,6 +29,10 @@ export interface StoreSalePromotionItem {
     scope: SalePromotionScope;
     /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
     appliesTo: PromotionAppliesToEnum;
+    /** Si se puede sumar con otras promos en la misma línea. */
+    stackable: boolean;
+    /** Ocupa el lugar de la línea ancla (teléfono o kit), aunque no la toque directo. */
+    anchorBound: boolean;
     conditions?: SalePromotionConditions;
     /** Si viene, todavía no se puede decidir para este cliente (ej. CUSTOMER_NOT_IDENTIFIED). */
     blockedBy?: RetailPromotionsErrorCodeEnum | null;
@@ -69,6 +73,10 @@ export interface EvaluatedSalePromotion {
     afterSale: AfterSaleBenefit[];
     /** SUREKEEP_ONLY = solo con crédito SureKeep; ANY_FINANCIER = también contado o derivada. */
     appliesTo: PromotionAppliesToEnum;
+    /** Si se puede sumar con otras promos en la misma línea. */
+    stackable: boolean;
+    /** Ocupa el lugar de la línea ancla (teléfono o kit), aunque no la toque directo. */
+    anchorBound: boolean;
     conditions?: SalePromotionConditions;
     /** Si viene, la promo se muestra pero no se puede elegir; dice por qué (ej. CUSTOMER_NOT_IDENTIFIED). */
     blockedBy?: RetailPromotionsErrorCodeEnum | null;
@@ -95,6 +103,16 @@ export interface HeldGiftPromotion {
     skus: string[];
 }
 
+/** Promo apartada en la lista nueva, con las líneas que toca y los regalos elegidos. */
+export interface HeldPromotion {
+    promotionId: string;
+    promotionVersion: number;
+    kind: SalePromotionKindEnum;
+    stackable: boolean;
+    lineIds: string[];
+    giftSkus: string[];
+}
+
 /** Lo que quedó apartado y escrito en la sesión: la promo de regalo, la de venta y el código. */
 export interface HoldSalePromotionResponse {
     sessionId: string;
@@ -106,6 +124,8 @@ export interface HoldSalePromotionResponse {
     saleGiftSkus: string[];
     lines: LinePromotionDiscount[];
     totalDiscountCents: number;
+    /** Todas las promos apartadas; los campos de arriba se conservan por compatibilidad. */
+    promotions: HeldPromotion[];
 }
 
 /** `released: false` = no había apartado; soltar es idempotente. */
@@ -142,6 +162,7 @@ export interface SaleAppliedPromotion {
     version: number;
     name: string;
     kind: SalePromotionKindEnum;
+    stackable?: boolean;
 }
 
 /** Cupón y «lo que se lleva» de una venta cerrada (publicGetSaleCoupon). */

package/src/retailPromotions/enums/RetailPromotionsErrorCodeEnum.ts

@@ -45,4 +45,6 @@ export enum RetailPromotionsErrorCodeEnum {
     CATALOG_SKU_NOT_FOUND = 'CATALOG_SKU_NOT_FOUND',
     /** Con el reparto apagado no se aplican palancas de precio ni código; los regalos sí. */
     SPLIT_FINANCING_DISABLED = 'SPLIT_FINANCING_DISABLED',
+    /** La promo no acumulable choca con otra en la misma línea. */
+    PROMOTION_NOT_STACKABLE = 'PROMOTION_NOT_STACKABLE',
 }

package/src/retailPromotions/index.ts

@@ -34,6 +34,11 @@ export * from './dtos/SalePromotion';
 export * from './dtos/SalePromotionLogEntry';
 export * from './dtos/DiscountCode';
 export * from './dtos/LinePromotionDiscount';
+export * from './dtos/LinePromotionAmount';
+export * from './dtos/SalePromotionRef';
+
+// Validadores
+export * from './validators/IsHoldModeExclusiveConstraint';
 
 // Request DTOs
 export * from './dtos/requests/DiscountValueInput';
@@ -50,6 +55,7 @@ export * from './dtos/requests/ChangeDiscountCodeStatusRequest';
 export * from './dtos/requests/ListStoreSalePromotionsQuery';
 export * from './dtos/requests/EvaluateSalePromotionsRequest';
 export * from './dtos/requests/HoldGiftPromotionInput';
+export * from './dtos/requests/HoldPromotionInput';
 export * from './dtos/requests/HoldSalePromotionRequest';
 export * from './dtos/requests/GetSaleCouponQuery';
 export * from './dtos/requests/SkuSalePromotionsQuery';

package/src/retailPromotions/validators/IsHoldModeExclusiveConstraint.ts

@@ -0,0 +1,18 @@
+import {
+    ValidatorConstraint,
+    type ValidationArguments,
+    type ValidatorConstraintInterface,
+} from 'class-validator';
+
+/** Rechaza mandar `promotions` junto con `gift`, `promotionId` o `saleGiftSkus` (forma vieja). */
+@ValidatorConstraint({ name: 'isHoldModeExclusive', async: false })
+export class IsHoldModeExclusiveConstraint implements ValidatorConstraintInterface {
+    validate(_value: unknown, args: ValidationArguments): boolean {
+        const o = args.object as { gift?: unknown; promotionId?: unknown; saleGiftSkus?: unknown };
+        return o.gift == null && o.promotionId == null && o.saleGiftSkus == null;
+    }
+
+    defaultMessage(): string {
+        return 'promotions no se combina con gift, promotionId ni saleGiftSkus';
+    }
+}

package/src/retailWizard/dtos/Sale.ts

@@ -5,6 +5,7 @@ import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
 import type { SalePaymentDetail } from './SalePaymentDetail';
 import type { SaleLine } from './SaleLine';
+import type { SalePromotionRef } from '../../retailPromotions/dtos/SalePromotionRef';
 
 /**
  * Venta (modelo-datos §3). pk `SALE#<saleId>` · sk `META` · 4 GSIs (`retailerId-soldAt-index`,
@@ -32,6 +33,8 @@ export interface Sale {
   /** Promo de venta congelada al cerrar; `null` = ninguna. */
   salePromotionId?: string | null;
   salePromotionVersion?: number | null;
+  /** Todas las promos de venta congeladas al cerrar. */
+  salePromotions?: SalePromotionRef[] | null;
   /** IMEI consumido del silo también en contado (local-first); null en EXTERNAL_REFERRAL (D15). */
   imei: string | null;
   /** Lo cobrado en caja al cerrar: enganche + lo no financiado; 0 en EXTERNAL_REFERRAL. Contrato de `SaleCompletedV1`. */