@fiado/type-kit 3.472.0 → 3.474.0

package/src/retailPromotions/index.ts

@@ -0,0 +1,56 @@
+// Enums
+export * from './enums/SalePromotionStatusEnum';
+export * from './enums/SalePromotionTransitionEnum';
+export * from './enums/SalePromotionPhaseEnum';
+export * from './enums/SalePromotionLeverEnum';
+export * from './enums/SalePromotionLogEventEnum';
+export * from './enums/SalePromotionLogFormatEnum';
+export * from './enums/DiscountTypeEnum';
+export * from './enums/GiftModeEnum';
+export * from './enums/PromotionAppliesToEnum';
+export * from './enums/CouponScopeEnum';
+export * from './enums/CouponStatusEnum';
+export * from './enums/DiscountCodeStatusEnum';
+export * from './enums/DiscountCodeOriginEnum';
+export * from './enums/DiscountCodeTransitionEnum';
+export * from './enums/EntitlementStateEnum';
+export * from './enums/EntitlementKindEnum';
+export * from './enums/SaleCouponAvailabilityEnum';
+export * from './enums/RetailPromotionsErrorCodeEnum';
+
+// Constantes y helpers puros
+export * from './constants/retailPromotionsErrorHttpStatus';
+export * from './constants/salePromotionTransitions';
+export * from './constants/bonusPreMoney';
+export * from './helpers/resolveSalePromotionTransition';
+export * from './helpers/computeBudgetUsedBps';
+
+// Entidades del dominio
+export * from './dtos/DiscountValue';
+export * from './dtos/SalePromotionLevers';
+export * from './dtos/SalePromotion';
+export * from './dtos/SalePromotionLogEntry';
+export * from './dtos/DiscountCode';
+export * from './dtos/LinePromotionDiscount';
+
+// Request DTOs
+export * from './dtos/requests/DiscountValueInput';
+export * from './dtos/requests/SalePromotionLeversInput';
+export * from './dtos/requests/SalePromotionScopeInput';
+export * from './dtos/requests/CreateSalePromotionRequest';
+export * from './dtos/requests/UpdateSalePromotionRequest';
+export * from './dtos/requests/ChangeSalePromotionStatusRequest';
+export * from './dtos/requests/ListSalePromotionsQuery';
+export * from './dtos/requests/ListSalePromotionLogQuery';
+export * from './dtos/requests/CreateDiscountCodeRequest';
+export * from './dtos/requests/ListDiscountCodesQuery';
+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';
+export * from './dtos/responses/DiscountCodeResponses';
+export * from './dtos/responses/WizardSalePromotionResponses';

package/src/retailWizard/dtos/Sale.ts

@@ -27,18 +27,18 @@ export interface Sale {
   skus?: string[];
   /** La cancelación aún no confirma la devolución al inventario. */
   inventoryReturnPending?: boolean;
+  /** Venta de la saga: el inventario se aplica y se devuelve por la cola, no por HTTP. */
+  inventoryViaQueue?: boolean;
+  /** Promo de venta congelada al cerrar; `null` = ninguna. */
+  salePromotionId?: string | null;
+  salePromotionVersion?: number | 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. En contado == precio del equipo (lo garantiza `registerPayment`);
-   * en crédito es SOLO el enganche. ⚠️ Su significado es contrato de `SaleCompletedV1` (La Central,
-   * comisión F4): no redefinir — el precio del equipo viaja aparte en `equipmentPriceCents`. 0 en
-   * EXTERNAL_REFERRAL.
-   */
+  /** Lo cobrado en caja al cerrar: enganche + lo no financiado; 0 en EXTERNAL_REFERRAL. Contrato de `SaleCompletedV1`. */
   amountCents: number;
   /**
-   * Precio de lista del equipo al cerrar (de la reserva de la sesión). En contado coincide con
-   * `amountCents`; en crédito es el precio full financiado. `null` en ventas anteriores al campo.
+   * Ancla neta al cerrar (precio − discountCents de la ancla); base de comisión.
+   * `null` en ventas anteriores al campo.
    */
   equipmentPriceCents: number | null;
   /** Enganche cobrado (solo ventas CREDIT; `null` en contado/externa). */

package/src/retailWizard/dtos/SaleLine.ts

@@ -1,9 +1,10 @@
 import type { SoldLineComponent } from '../../retailCatalog/dtos/responses/SellStockResponse';
 import type { LinePaymentTypeEnum } from '../enums/LinePaymentTypeEnum';
 import type { WizardLineProduct } from './WizardLineProduct';
+import type { WizardLinePromotionFields } from './WizardLinePromotionFields';
 
 /** Línea de una venta cerrada; un producto suelto es un solo componente. */
-export interface SaleLine {
+export interface SaleLine extends WizardLinePromotionFields {
     lineId: string;
     sku: string;
     qty: number;
@@ -12,6 +13,8 @@ export interface SaleLine {
     /** Llave del registro PRICE# del que salió el precio. */
     priceSk: string;
     paymentType: LinePaymentTypeEnum;
+    /** Parte financiada de la línea, congelada en la venta. */
+    financedCents?: number;
     components: SoldLineComponent[];
     product?: WizardLineProduct | null;
 }

package/src/retailWizard/dtos/WizardFinancingPreview.ts

@@ -0,0 +1,12 @@
+/** Parte financiada de una línea en el reparto provisional. */
+export interface WizardFinancingPreviewLine {
+    lineId: string;
+    financedCents: number;
+}
+
+/** Reparto provisional de la sesión; se calcula al leer y no se persiste. */
+export interface WizardFinancingPreview {
+    /** Tope de extras financiables: floor(30% × ancla neta). */
+    capCents: number;
+    lines: WizardFinancingPreviewLine[];
+}

package/src/retailWizard/dtos/WizardGiftLine.ts

@@ -0,0 +1,11 @@
+import type { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
+import type { WizardReservedLine } from './WizardReservedLine';
+
+/** 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/WizardLinePromotionFields.ts

@@ -0,0 +1,16 @@
+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 {
+    role?: WizardLineRoleEnum;
+    promotionId?: string;
+    promotionVersion?: number;
+    /** Línea ancla a la que va ligado el regalo. */
+    linkedLineId?: string;
+    /** Solo en la línea ancla. */
+    discountCode?: string;
+    /** Descuento total de la línea; neto = basePriceCents × qty − discountCents. */
+    discountCents?: number;
+    /** Precio antes del descuento; en un regalo, el valor de lista con la línea a $0. */
+    originalPriceCents?: number;
+}

package/src/retailWizard/dtos/WizardReservedLine.ts

@@ -4,9 +4,10 @@ import type { LinePaymentTypeEnum } from '../enums/LinePaymentTypeEnum';
 import type { WizardLineStatusEnum } from '../enums/WizardLineStatusEnum';
 import type { WizardLineIdentifiers } from './WizardLineIdentifiers';
 import type { WizardLineProduct } from './WizardLineProduct';
+import type { WizardLinePromotionFields } from './WizardLinePromotionFields';
 
 /** Línea de la venta en curso; los campos de precio son `null` mientras la línea está PENDING. */
-export interface WizardReservedLine {
+export interface WizardReservedLine extends WizardLinePromotionFields {
     lineId: string;
     sku: string;
     qty: number;
@@ -27,6 +28,8 @@ export interface WizardReservedLine {
     paymentType: LinePaymentTypeEnum | null;
     /** Ítems que la línea suma al tope de 100 de la venta. */
     sellItemCost: number | null;
+    /** Parte financiada de la línea; se escribe al cotizar y se congela con el crédito. */
+    financedCents?: number;
     mdmEnabled?: boolean;
     mdmProvider?: MdmProviderEnum | null;
     /** Solo si la línea es un kit. */

package/src/retailWizard/dtos/WizardSession.ts

@@ -6,6 +6,7 @@ import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { OccupationEnum } from '../enums/OccupationEnum';
 import type { WizardBlockedSummary } from './WizardBlocked';
 import type { WizardConsents } from './WizardConsents';
+import type { WizardFinancingPreview } from './WizardFinancingPreview';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardProduct } from './WizardProduct';
@@ -117,6 +118,15 @@ export interface WizardSession {
   reservedLines?: WizardReservedLine[];
   /** Línea elegida para financiar; `null` si la venta es de contado o aún no se elige. */
   financedLineId?: string | null;
+  /** Reparto provisional mientras haya líneas; se calcula al leer, no se persiste. */
+  financingPreview?: WizardFinancingPreview | null;
+  /** Marca de la saga: todas las piezas rastreadas de las líneas vivas quedaron HELD. */
+  piecesHeldAt?: string | null;
+  /** Promo de venta que fijó Promociones; `null` = ninguna. */
+  salePromotionId?: string | null;
+  salePromotionVersion?: number | null;
+  /** Enganche cobrado que queda por reembolsar tras cancelar. */
+  refundPendingCents?: number;
   paymentMethod: PaymentMethodEnum | null;
   externalProvider: ExternalProviderEnum | null;
   /** Folio de cobro server-side (D11), idempotente, sobrevive al volver atrás. */

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

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsInt, IsOptional, IsString, Min } from 'class-validator';
+import { IsInt, IsOptional, IsString, Min, MinLength } from 'class-validator';
 
 /**
  * POST /wizard/sessions/:id/product — agrega una línea a la venta y reserva sus piezas en el catálogo.
@@ -27,4 +27,11 @@ export class AddProductRequest {
   @IsInt()
   @Min(1)
   qty?: number;
+
+  /** Línea viva que este kit reemplaza («Cambiar por el kit»). */
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @MinLength(1)
+  replacesLineId?: string;
 }

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

@@ -0,0 +1,44 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsOptional, IsString, Min, ValidateIf } from 'class-validator';
+
+const hasPromotion = (o: ApplyLinePromotionRequest): boolean =>
+  o.promotionId !== undefined || o.promotionVersion !== undefined;
+
+/**
+ * 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()
+  @ValidateIf(hasPromotion)
+  @IsString()
+  @IsNotEmpty()
+  promotionId?: string;
+
+  /** Va junto con promotionId; las versiones de Promociones empiezan en 1. */
+  @Expose()
+  @ValidateIf(hasPromotion)
+  @IsInt()
+  @Min(1)
+  promotionVersion?: number;
+
+  /** Solo en la línea ancla. */
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  discountCode?: string;
+
+  /** Descuento total de la línea; 0 mientras el código espera revalidarse. */
+  @Expose()
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  discountCents?: number;
+
+  @Expose()
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  originalPriceCents?: number;
+}

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

@@ -0,0 +1,24 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsString, Min, ValidateIf } from 'class-validator';
+
+/**
+ * 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.
+ * Responde 204 sin body.
+ */
+export class ApplySalePromotionRequest {
+  @Expose()
+  @ValidateIf(
+    (o: ApplySalePromotionRequest) =>
+      o.salePromotionId !== null || (o.salePromotionVersion !== null && o.salePromotionVersion !== undefined),
+  )
+  @IsString()
+  @IsNotEmpty()
+  salePromotionId!: string | null;
+
+  @Expose()
+  @ValidateIf((o: ApplySalePromotionRequest) => o.salePromotionId !== null && o.salePromotionId !== undefined)
+  @IsInt()
+  @Min(1)
+  salePromotionVersion!: number | null;
+}

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

@@ -0,0 +1,40 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsNotEmpty, IsString, ValidateNested } from 'class-validator';
+
+/** Componente de la línea con los identificadores de sus piezas. */
+export class PinSessionPiecesComponent {
+  @Expose()
+  @IsString()
+  @IsNotEmpty()
+  sku!: string;
+
+  @Expose()
+  @IsArray()
+  @IsString({ each: true })
+  identifiers!: string[];
+}
+
+/** Línea de la sesión cuyas piezas se fijan. */
+export class PinSessionPiecesLine {
+  @Expose()
+  @IsString()
+  @IsNotEmpty()
+  lineId!: string;
+
+  @Expose()
+  @IsArray()
+  @ArrayMinSize(1)
+  @ValidateNested({ each: true })
+  @Type(() => PinSessionPiecesComponent)
+  components!: PinSessionPiecesComponent[];
+}
+
+/** POST /wizard/sessions/:id/pieces (publicPinSessionPieces) — deja HELD las piezas de las líneas. */
+export class PinSessionPiecesRequest {
+  @Expose()
+  @IsArray()
+  @ArrayMinSize(1)
+  @ValidateNested({ each: true })
+  @Type(() => PinSessionPiecesLine)
+  lines!: PinSessionPiecesLine[];
+}

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

@@ -19,7 +19,7 @@ export class QuoteRequest {
     @Min(1)
     termWeeks!: number;
 
-    /** Línea que se financia; su precio fijado es el del crédito. */
+    /** Se ignora: el servidor financia la ancla. */
     @Expose()
     @IsOptional()
     @IsString()

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

@@ -0,0 +1,40 @@
+import { Expose, Type } from 'class-transformer';
+import { IsArray, IsInt, IsNotEmpty, IsString, Min, ValidateIf, ValidateNested } from 'class-validator';
+
+/** Un regalo del conjunto que queda ligado al ancla. */
+export class AnchorGiftItem {
+  @Expose()
+  @IsString()
+  @IsNotEmpty()
+  sku!: string;
+}
+
+/** Hay que validar el campo si hay regalos o si vino con valor. */
+function mustValidate(o: SetAnchorGiftsRequest, value: unknown): boolean {
+  return (Array.isArray(o.items) && o.items.length > 0) || (value !== null && value !== undefined);
+}
+
+/**
+ * PUT /private/wizard/sessions/{id}/lines/{anchorLineId}/gifts (M2M de Promociones).
+ * Deja exactamente esos GIFT en el ancla; `items: []` suelta todos. `tenantId` va en el query.
+ */
+export class SetAnchorGiftsRequest {
+  /** Obligatorio si hay regalos; puede ir `null` con `items: []`. */
+  @Expose()
+  @ValidateIf((o: SetAnchorGiftsRequest) => mustValidate(o, o.promotionId))
+  @IsString()
+  @IsNotEmpty()
+  promotionId!: string | null;
+
+  @Expose()
+  @ValidateIf((o: SetAnchorGiftsRequest) => mustValidate(o, o.promotionVersion))
+  @IsInt()
+  @Min(1)
+  promotionVersion!: number | null;
+
+  @Expose()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => AnchorGiftItem)
+  items!: AnchorGiftItem[];
+}

package/src/retailWizard/dtos/responses/PrivateWizardSessionResponse.ts

@@ -0,0 +1,30 @@
+import type { PaymentMethodEnum } from '../../enums/PaymentMethodEnum';
+import type { WizardStateEnum } from '../../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../../enums/WizardStepEnum';
+import type { WizardPayment } from '../WizardPayment';
+import type { WizardReservedLine } from '../WizardReservedLine';
+
+/** GET /private/wizard/sessions/{id} (privateGetWizardSession): lo que Promociones lee de la sesión. */
+export interface PrivateWizardSessionResponse {
+  sessionId: string;
+  retailerId: string;
+  storeId: string;
+  /** `null` mientras el KYC no dé de alta al cliente. */
+  retailCustomerId: string | null;
+  state: WizardStateEnum;
+  currentStep: WizardStepEnum;
+  /** `loan.creditId`; `null` en contado o antes de originar. */
+  creditId: string | null;
+  /** Línea ancla (teléfono o kit) que deriva el servidor; `null` si aún no hay. */
+  anchorLineId: string | null;
+  salePromotionId: string | null;
+  salePromotionVersion: number | null;
+  /** Líneas vivas con los campos de Promociones y financedCents. */
+  lines: WizardReservedLine[];
+  fiadoDirectoryId?: string | null;
+  folio?: string | null;
+  /** Forma de pago que eligió el vendedor; existe antes que `creditId`. */
+  paymentMethod?: PaymentMethodEnum | null;
+  /** Cobro de contado; `null` mientras no se cobra. */
+  payment?: WizardPayment | null;
+}

package/src/retailWizard/dtos/responses/SetAnchorGiftsResponse.ts

@@ -0,0 +1,6 @@
+import type { WizardGiftLine } from '../WizardGiftLine';
+
+/** Respuesta del PUT de regalos: las líneas GIFT que quedaron ligadas al ancla. */
+export interface SetAnchorGiftsResponse {
+  lines: WizardGiftLine[];
+}

package/src/retailWizard/enums/RetailPromotionInboundMessageTypeEnum.ts

@@ -0,0 +1,5 @@
+/** Tipo de mensaje que el wizard publica en la cola de Promociones. */
+export enum RetailPromotionInboundMessageTypeEnum {
+    SALE_CONFIRMED = 'SALE_CONFIRMED',
+    SALE_CANCELLED = 'SALE_CANCELLED',
+}

package/src/retailWizard/enums/WizardLineRoleEnum.ts

@@ -0,0 +1,4 @@
+/** Papel especial de una línea; sin `role` es una línea normal. */
+export enum WizardLineRoleEnum {
+    GIFT = 'GIFT',
+}

package/src/retailWizard/events/RetailCommissionInboundMessage.ts

@@ -0,0 +1,54 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsArray, IsEnum, IsISO8601, IsInt, IsNotEmpty, IsString, Min, ValidateNested } from 'class-validator';
+import { ItemTypeEnum } from '../../retailCatalog/enums/ItemTypeEnum';
+
+/** Línea vendida en el mensaje de comisiones. */
+export class RetailCommissionInboundLine {
+    @IsString()
+    @IsNotEmpty()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+
+    /** Precio neto de la línea (precio − descuento). */
+    @IsInt()
+    @Min(0)
+    netCents!: number;
+
+    @IsEnum(ItemTypeEnum)
+    itemType!: ItemTypeEnum;
+}
+
+/** Venta de la saga que el wizard publica en la cola de comisiones, con sus líneas. */
+export class RetailCommissionInboundMessage {
+    @IsString()
+    @IsNotEmpty()
+    tenantId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    saleId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    sessionId!: string;
+
+    @IsISO8601()
+    soldAt!: string;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => RetailCommissionInboundLine)
+    lines!: RetailCommissionInboundLine[];
+}

package/src/retailWizard/events/RetailPromotionInboundMessage.ts

@@ -0,0 +1,140 @@
+import { Type } from 'class-transformer';
+import {
+    ArrayMinSize,
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsISO8601,
+    IsInt,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+import { RetailPromotionInboundMessageTypeEnum } from '../enums/RetailPromotionInboundMessageTypeEnum';
+import { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
+
+/** Línea de la venta en el mensaje de Promociones. */
+export class RetailPromotionInboundLine {
+    @IsString()
+    @IsNotEmpty()
+    lineId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+
+    @IsOptional()
+    @IsEnum(WizardLineRoleEnum)
+    role?: WizardLineRoleEnum;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    linkedLineId?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    promotionId?: string;
+
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    promotionVersion?: number;
+
+    /** Solo en la línea ancla. */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    discountCode?: string;
+
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    discountCents?: number;
+
+    /** Si la línea no lo trae, basePriceCents × qty. */
+    @IsInt()
+    @Min(0)
+    originalPriceCents!: number;
+
+    /** Identificadores de todos los componentes de la línea, aplanados. */
+    @IsArray()
+    @IsString({ each: true })
+    identifiers!: string[];
+
+    /** Solo en SALE_CANCELLED: la pieza regresó al inventario. */
+    @IsOptional()
+    @IsBoolean()
+    returned?: boolean;
+}
+
+/** Venta confirmada o cancelada que el wizard publica en RetailPromotionInboundQueue; crédito = trae creditId. */
+export class RetailPromotionInboundMessage {
+    @IsEnum(RetailPromotionInboundMessageTypeEnum)
+    type!: RetailPromotionInboundMessageTypeEnum;
+
+    @IsString()
+    @IsNotEmpty()
+    tenantId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    saleId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    sessionId!: string;
+
+    /** El retailCustomerId de la venta. */
+    @IsString()
+    @IsNotEmpty()
+    customerId!: string;
+
+    @IsISO8601()
+    soldAt!: string;
+
+    /** soldAt en la confirmación; cancelledAt en la cancelación. */
+    @IsISO8601()
+    occurredAt!: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    creditId?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    fiadoDirectoryId?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    salePromotionId?: string | null;
+
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    salePromotionVersion?: number | null;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => RetailPromotionInboundLine)
+    lines!: RetailPromotionInboundLine[];
+}

package/src/retailWizard/events/SaleCompletedV1.ts

@@ -14,9 +14,8 @@ export interface SaleCompletedV1 {
   sku: string;
   imei: string | null;
   /**
-   * Lo COBRADO en caja al cerrar (contrato histórico — La Central y comisión F4 lo asumen así).
-   * En contado == precio del equipo; en CREDIT es SOLO el enganche: desambiguar con `type` +
-   * `equipmentPriceCents`, NUNCA redefinir este campo.
+   * Lo cobrado en caja al cerrar: enganche + lo no financiado (en contado, el total).
+   * Desambiguar con `type` + `equipmentPriceCents`.
    */
   amountCents: number;
   /**