@fiado/type-kit 3.564.0 → 3.566.0

package/src/retailCustomer/dtos/responses/CustomerReferralResponses.ts

@@ -0,0 +1,46 @@
+import { CustomerReferral } from '../CustomerReferral';
+import { AccountStatusEnum } from '../../enums/AccountStatusEnum';
+import { ReferralSourceEnum } from '../../enums/ReferralSourceEnum';
+
+/** Respuesta de `privateCreateCustomerReferrals`. */
+export interface CreateCustomerReferralsResponse {
+    referrals: CustomerReferral[];
+}
+
+/** Respuesta de `privateUpdateCustomerReferral`. */
+export interface UpdateCustomerReferralResponse {
+    referral: CustomerReferral;
+}
+
+/** Respuesta de `privateListCustomerReferrals`. */
+export interface ListCustomerReferralsResponse {
+    referrals: CustomerReferral[];
+}
+
+/** Quién recomendó un teléfono. */
+export interface ReferralByPhone {
+    referralId: string;
+    referrerCustomerId: string;
+    referrerName: string;
+    source: ReferralSourceEnum;
+    capturedAt: string;
+}
+
+/** Respuesta de `privateGetReferralsByPhone`, del más antiguo al más reciente. */
+export interface ReferralsByPhoneResponse {
+    referrals: ReferralByPhone[];
+}
+
+/** Teléfono que ya es cliente. */
+export interface CustomerByPhone {
+    phone: string;
+    retailCustomerId: string;
+    retailerId: string;
+    /** `null` si la cuenta PCF aún no se pide. */
+    accountStatus: AccountStatusEnum | null;
+}
+
+/** Respuesta de `privateGetCustomersByPhones`; los teléfonos que no son clientes no aparecen. */
+export interface CustomersByPhonesResponse {
+    customers: CustomerByPhone[];
+}

package/src/retailCustomer/enums/ReferralRoleEnum.ts

@@ -0,0 +1,5 @@
+/** A quién premia una promo de referido: a quien recomienda o al recomendado. */
+export enum ReferralRoleEnum {
+    REFERRER = 'REFERRER',
+    REFERRED = 'REFERRED',
+}

package/src/retailCustomer/enums/ReferralSourceEnum.ts

@@ -0,0 +1,6 @@
+/** Dónde se capturó un referido: en la venta, en la apertura sin venta o en el cajón del cliente. */
+export enum ReferralSourceEnum {
+    SALE = 'SALE',
+    OPENING = 'OPENING',
+    BACKOFFICE = 'BACKOFFICE',
+}

package/src/retailCustomer/enums/ReferralStatusEnum.ts

@@ -0,0 +1,7 @@
+/** Estado del referido en el cajón: aún no compra, abrió su cuenta, ya compró o tiene crédito SureKeep. */
+export enum ReferralStatusEnum {
+    NOT_PURCHASED = 'NOT_PURCHASED',
+    ACCOUNT_OPENED = 'ACCOUNT_OPENED',
+    PURCHASED = 'PURCHASED',
+    SUREKEEP_CREDIT = 'SUREKEEP_CREDIT',
+}

package/src/retailCustomer/index.ts

@@ -9,11 +9,15 @@ export * from './enums/WelcomeBonusStatusEnum';
 export * from './enums/WelcomeBonusAmountSourceEnum';
 export * from './enums/WelcomeBonusSettlementStatusEnum';
 export * from './enums/BonusTypeEnum';
+export * from './enums/ReferralSourceEnum';
+export * from './enums/ReferralStatusEnum';
+export * from './enums/ReferralRoleEnum';
 
 // Entidades (planas, con class-validator + @Expose)
 export * from './dtos/KycReview';
 export * from './dtos/RetailAddress';
 export * from './dtos/RetailCustomer';
+export * from './dtos/CustomerReferral';
 
 // Request DTOs (input validado por endpoint)
 export * from './dtos/requests/CreateCustomerRequest';
@@ -24,6 +28,10 @@ export * from './dtos/requests/KycReviewRequest';
 export * from './dtos/requests/WelcomeAccreditationRequest';
 export * from './dtos/requests/WelcomeAccreditationResultRequest';
 export * from './dtos/requests/UpsertPromotionBonusRequest';
+export * from './dtos/requests/CreateCustomerReferralsRequest';
+export * from './dtos/requests/UpdateCustomerReferralRequest';
+export * from './dtos/requests/GetCustomersByPhonesRequest';
+export * from './dtos/requests/GetReferralsByPhoneQuery';
 
 // Response DTOs
 export * from './dtos/responses/CustomerResponse';
@@ -31,6 +39,7 @@ export * from './dtos/responses/Customer360Response';
 export * from './dtos/responses/WelcomeBonusResponse';
 export * from './dtos/responses/WelcomeAccreditationResponse';
 export * from './dtos/responses/PromotionBonusEntryResponse';
+export * from './dtos/responses/CustomerReferralResponses';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/CustomerCreatedV1';

package/src/retailPromotions/constants/retailPromotionsErrorHttpStatus.ts

@@ -36,4 +36,6 @@ export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 403 |
     [C.PROMOTION_PAYMENT_NOT_ELIGIBLE]: 422,
     [C.SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED]: 422,
     [C.SYSTEM_PROMOTION_FIELD_LOCKED]: 422,
+    [C.REFERRAL_REWARD_NEEDS_PURCHASE]: 422,
+    [C.INVALID_REFERRAL_TRIGGER]: 400,
 };

package/src/retailPromotions/dtos/ReferralPromotion.ts

@@ -0,0 +1,35 @@
+import { ReferralPromotionChannelEnum } from '../enums/ReferralPromotionChannelEnum';
+import { ReferralRewardTypeEnum } from '../enums/ReferralRewardTypeEnum';
+import { ReferralTriggerEnum } from '../enums/ReferralTriggerEnum';
+import { CouponLever } from './SalePromotionLevers';
+
+/** Premio de un rol; solo trae valor el campo que corresponde a su `type`. */
+export interface ReferralReward {
+    type: ReferralRewardTypeEnum;
+    /** `FIXED_BONUS`. */
+    amountCents: number | null;
+    /** `PERCENT_BONUS` y `SALE_DISCOUNT`; 1000 = 10%. */
+    percentBps: number | null;
+    /** Tope del %; `null` = sin tope. */
+    maxAmountCents: number | null;
+    /** `COUPON`. */
+    coupon: CouponLever | null;
+}
+
+/** Evento, condiciones y premios de una promo `REFERRAL`; forma de pago, gama, vigencia y presupuesto son los de la promo. */
+export interface ReferralPromotionConfig {
+    channel: ReferralPromotionChannelEnum;
+    trigger: ReferralTriggerEnum;
+    /** Solo en `NTH_PURCHASE`. */
+    purchaseNumber: number | null;
+    /** Solo en `INSTALLMENT_STREAK`. */
+    installmentStreak: number | null;
+    /** Monto mínimo de la compra o del crédito. */
+    minAmountCents: number | null;
+    /** Días desde la captura del referido. */
+    windowDays: number | null;
+    maxRewardsPerReferrer: number | null;
+    referrerReward: ReferralReward;
+    /** `null` = el recomendado no gana nada. */
+    referredReward: ReferralReward | null;
+}

package/src/retailPromotions/dtos/SalePromotion.ts

@@ -3,6 +3,7 @@ import { PromotionPaymentOptionEnum } from '../enums/PromotionPaymentOptionEnum'
 import { SalePromotionPhaseEnum } from '../enums/SalePromotionPhaseEnum';
 import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
 import { SalePromotionSystemKeyEnum } from '../enums/SalePromotionSystemKeyEnum';
+import { ReferralPromotionConfig } from './ReferralPromotion';
 import { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from './SalePromotionLevers';
 
 /** Promo de venta tal como la devuelve el CRUD. Dinero en centavos, fechas ISO. */
@@ -31,6 +32,8 @@ export interface SalePromotion {
     oncePerCustomer: boolean;
     /** Si se puede sumar con otras promos en la misma línea. */
     stackable: boolean;
+    /** Solo en promos `REFERRAL`. */
+    referral?: ReferralPromotionConfig | null;
     status: SalePromotionStatusEnum;
     /** Derivada; `null` cuando el estado no es `ACTIVE`. */
     phase: SalePromotionPhaseEnum | null;

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

@@ -0,0 +1,12 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional } from 'class-validator';
+import { SalePaymentMethodEnum } from '../../../retailWizard/enums/SalePaymentMethodEnum';
+
+/** Body de `POST /private/sessions/{sessionId}/sale-promotion/payment-check` (M2M). */
+export class CheckSalePromotionPaymentRequest {
+    /** Medio del cobro de contado; ausente = se valida contra la forma de pago de la sesión (enganche o cierre a crédito). */
+    @Expose()
+    @IsOptional()
+    @IsEnum(SalePaymentMethodEnum)
+    method?: SalePaymentMethodEnum;
+}

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

@@ -13,6 +13,7 @@ import {
 } from 'class-validator';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
+import { ReferralPromotionInput } from './ReferralPromotionInput';
 import { SalePromotionLeversInput } from './SalePromotionLeversInput';
 import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
 
@@ -85,4 +86,11 @@ export class CreateSalePromotionRequest {
     @IsOptional()
     @IsBoolean()
     stackable?: boolean;
+
+    /** Evento, condiciones y premios de la promo de referido; ausente en las demás promos. */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => ReferralPromotionInput)
+    referral?: ReferralPromotionInput | null;
 }

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

@@ -13,4 +13,11 @@ export class EvaluateSalePromotionsRequest {
     @IsString()
     @IsNotEmpty()
     discountCode?: string | null;
+
+    /** Teléfono del cliente de la venta; con él se sabe si llegó recomendado. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    phone?: string;
 }

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

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsNotEmpty, IsString } from 'class-validator';
+
+const REWARD_PHONES_MAX_BATCH = 100;
+
+/** Body de la ruta privada de premios de referido por cadena y lote de teléfonos (normalizados a 10 dígitos). */
+export class GetReferralRewardsByPhonesRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(REWARD_PHONES_MAX_BATCH)
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    phones!: string[];
+}

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

@@ -0,0 +1,24 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { ReferralPromotionChannelEnum } from '../../enums/ReferralPromotionChannelEnum';
+import { ReferralTriggerEnum } from '../../enums/ReferralTriggerEnum';
+
+/** Query de las promos de referido vigentes del paso Referidos; la tienda sale de la sesión. */
+export class ListLiveReferralPromotionsQuery {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    sessionId!: string;
+
+    /** Sin canal: venta y crédito. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ReferralPromotionChannelEnum)
+    channel?: ReferralPromotionChannelEnum;
+
+    /** `ACCOUNT_OPENED` en una apertura sin venta: solo las que se ganan al abrir cuenta. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ReferralTriggerEnum)
+    trigger?: ReferralTriggerEnum;
+}

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

@@ -1,14 +1,27 @@
 import { Expose, Type } from 'class-transformer';
 import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { ReferralPromotionChannelEnum } from '../../enums/ReferralPromotionChannelEnum';
+import { SalePromotionKindEnum } from '../../enums/SalePromotionKindEnum';
 import { SalePromotionStatusEnum } from '../../enums/SalePromotionStatusEnum';
 
-/** Query de publicListSalePromotions; sin `status` excluye las archivadas. */
+/** Query de publicListSalePromotions; sin `status` excluye las archivadas y sin `kind` las de referido. */
 export class ListSalePromotionsQuery {
     @Expose()
     @IsOptional()
     @IsEnum(SalePromotionStatusEnum)
     status?: SalePromotionStatusEnum;
 
+    @Expose()
+    @IsOptional()
+    @IsEnum(SalePromotionKindEnum)
+    kind?: SalePromotionKindEnum;
+
+    /** Canal de las promos de referido. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ReferralPromotionChannelEnum)
+    channel?: ReferralPromotionChannelEnum;
+
     @Expose()
     @IsOptional()
     @Type(() => Number)

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

@@ -0,0 +1,93 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, IsEnum, IsInt, IsOptional, Max, Min, ValidateIf, ValidateNested } from 'class-validator';
+import { ReferralPromotionChannelEnum } from '../../enums/ReferralPromotionChannelEnum';
+import { ReferralRewardTypeEnum } from '../../enums/ReferralRewardTypeEnum';
+import { ReferralTriggerEnum } from '../../enums/ReferralTriggerEnum';
+import { CouponLeverInput } from './SalePromotionLeversInput';
+
+const isPercentReward = (o: ReferralRewardInput): boolean =>
+    o.type === ReferralRewardTypeEnum.PERCENT_BONUS || o.type === ReferralRewardTypeEnum.SALE_DISCOUNT;
+
+/** Premio de un rol en el body: exige el campo de su `type`. Qué premio vale con qué evento lo valida el lambda (422). */
+export class ReferralRewardInput {
+    @Expose()
+    @IsEnum(ReferralRewardTypeEnum)
+    type!: ReferralRewardTypeEnum;
+
+    @Expose()
+    @ValidateIf((o: ReferralRewardInput) => o.type === ReferralRewardTypeEnum.FIXED_BONUS)
+    @IsInt()
+    @Min(1)
+    amountCents?: number | null;
+
+    @Expose()
+    @ValidateIf(isPercentReward)
+    @IsInt()
+    @Min(1)
+    @Max(10000)
+    percentBps?: number | null;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    maxAmountCents?: number | null;
+
+    @Expose()
+    @ValidateIf((o: ReferralRewardInput) => o.type === ReferralRewardTypeEnum.COUPON)
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => CouponLeverInput)
+    coupon?: CouponLeverInput | null;
+}
+
+/** Bloque `referral` del body de la promo; su presencia la vuelve `REFERRAL`. Compra N y racha ≥ 2 los valida el lambda. */
+export class ReferralPromotionInput {
+    @Expose()
+    @IsEnum(ReferralPromotionChannelEnum)
+    channel!: ReferralPromotionChannelEnum;
+
+    @Expose()
+    @IsEnum(ReferralTriggerEnum)
+    trigger!: ReferralTriggerEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    purchaseNumber?: number | null;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    installmentStreak?: number | null;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    minAmountCents?: number | null;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    windowDays?: number | null;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    maxRewardsPerReferrer?: number | null;
+
+    @Expose()
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => ReferralRewardInput)
+    referrerReward!: ReferralRewardInput;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => ReferralRewardInput)
+    referredReward?: ReferralRewardInput | null;
+}

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

@@ -12,6 +12,7 @@ import {
 } from 'class-validator';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
+import { ReferralPromotionInput } from './ReferralPromotionInput';
 import { SalePromotionLeversInput } from './SalePromotionLeversInput';
 import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
 
@@ -86,4 +87,11 @@ export class UpdateSalePromotionRequest {
     @IsOptional()
     @IsBoolean()
     stackable?: boolean;
+
+    /** Evento, condiciones y premios de la promo de referido; ausente en las demás promos. */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => ReferralPromotionInput)
+    referral?: ReferralPromotionInput | null;
 }

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

@@ -0,0 +1,26 @@
+import { ReferralPromotionChannelEnum } from '../../enums/ReferralPromotionChannelEnum';
+import { ReferralTriggerEnum } from '../../enums/ReferralTriggerEnum';
+import { ReferralReward } from '../ReferralPromotion';
+
+/** Promo de referido vigente para el paso Referidos: «tú ganas» y «tu amigo gana». */
+export interface LiveReferralPromotionItem {
+    promotionId: string;
+    version: number;
+    name: string;
+    customerText: string;
+    channel: ReferralPromotionChannelEnum;
+    trigger: ReferralTriggerEnum;
+    /** Solo en `NTH_PURCHASE`. */
+    purchaseNumber: number | null;
+    /** Solo en `INSTALLMENT_STREAK`. */
+    installmentStreak: number | null;
+    /** Fin de vigencia; `null` = sin fecha de fin. */
+    validUntil: string | null;
+    referrerReward: ReferralReward;
+    /** `null` = el recomendado no gana nada. */
+    referredReward: ReferralReward | null;
+}
+
+export interface ListLiveReferralPromotionsResponse {
+    items: LiveReferralPromotionItem[];
+}

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

@@ -0,0 +1,28 @@
+import { ReferralRoleEnum } from '../../../retailCustomer/enums/ReferralRoleEnum';
+import { ReferralRewardStatusEnum } from '../../enums/ReferralRewardStatusEnum';
+import { ReferralRewardTypeEnum } from '../../enums/ReferralRewardTypeEnum';
+
+/** Premio de referido de un teléfono en una promo (candado REWARD#). Sin PII. */
+export interface ReferralRewardByPhone {
+    promotionId: string;
+    promotionName: string;
+    referralId: string;
+    role: ReferralRoleEnum;
+    rewardType: ReferralRewardTypeEnum;
+    /** `null` si el premio no tiene monto en centavos. */
+    amountCents: number | null;
+    status: ReferralRewardStatusEnum;
+    /** Fecha del estado: pago, reserva o anulación. */
+    statusAt: string;
+}
+
+/** Premios de un teléfono; vacío si no tiene. */
+export interface ReferralRewardsOfPhone {
+    phone: string;
+    rewards: ReferralRewardByPhone[];
+}
+
+/** Respuesta de la ruta privada de premios por cadena y lote de teléfonos. */
+export interface ReferralRewardsByPhonesResponse {
+    phones: ReferralRewardsOfPhone[];
+}

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

@@ -0,0 +1,17 @@
+/** 200 de privateCheckSalePromotionPayment: todas las promos apartadas admiten el medio. */
+export interface PrivateSalePromotionPaymentCheckResponse {
+    sessionId: string;
+    /** Promos apartadas que se revisaron; vacía si la sesión no tiene promo. */
+    checkedPromotionIds: string[];
+}
+
+/** `data` del 422 PROMOTION_PAYMENT_NOT_ELIGIBLE; las listas van separadas por coma. */
+export interface PromotionPaymentNotEligibleDetails {
+    /** Todas las promos que no admiten el medio. */
+    promotionIds: string;
+    /** La primera de ellas, para el copy. */
+    promotionId: string;
+    promotionName: string;
+    /** `PromotionPaymentOptionEnum` que acepta esa promo. */
+    acceptedOptions: string;
+}

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

@@ -9,6 +9,7 @@ import { SaleCouponAvailabilityEnum } from '../../enums/SaleCouponAvailabilityEn
 import { SalePromotionKindEnum } from '../../enums/SalePromotionKindEnum';
 import { SalePromotionLeverEnum } from '../../enums/SalePromotionLeverEnum';
 import { DiscountValue } from '../DiscountValue';
+import { ReferralReward } from '../ReferralPromotion';
 import { LinePromotionDiscount } from '../LinePromotionDiscount';
 import { SalePromotionLevers, SalePromotionScope } from '../SalePromotionLevers';
 
@@ -99,9 +100,23 @@ export interface EvaluatedDiscountCode {
     totalDiscountCents: number;
 }
 
+/** Lo que gana el recomendado en una promo de referido vigente. */
+export interface EvaluatedReferredReward {
+    promotionId: string;
+    promotionName: string;
+    reward: ReferralReward;
+}
+
+/** Quién recomendó al cliente; solo viene si alguna promo vigente le da algo al recomendado. */
+export interface EvaluatedReferredBy {
+    name: string;
+    rewards?: EvaluatedReferredReward[];
+}
+
 export interface EvaluateSalePromotionsResponse {
     promotions: EvaluatedSalePromotion[];
     discountCode: EvaluatedDiscountCode | null;
+    referredBy?: EvaluatedReferredBy | null;
 }
 
 /** Promo de regalo del teléfono que quedó apartada. */

package/src/retailPromotions/enums/ReferralPromotionChannelEnum.ts

@@ -0,0 +1,5 @@
+/** Dónde vive la promo de referido: en promos de venta o en promos de crédito. */
+export enum ReferralPromotionChannelEnum {
+    SALE = 'SALE',
+    CREDIT = 'CREDIT',
+}

package/src/retailPromotions/enums/ReferralRewardStatusEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Estado del premio de referido en el cajón. Del libro: ACCREDITED → PAID; PENDING y UNVERIFIED → PENDING;
+ * FAILED o entrega anulada → NOT_APPLICABLE.
+ */
+export enum ReferralRewardStatusEnum {
+    PAID = 'PAID',
+    PENDING = 'PENDING',
+    NOT_APPLICABLE = 'NOT_APPLICABLE',
+}

package/src/retailPromotions/enums/ReferralRewardTypeEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Premio de referido: bono fijo o % de lo que paga el referido (con tope) a cuenta PCF, cupón (solo venta)
+ * o descuento en esta venta (solo el recomendado, solo venta).
+ */
+export enum ReferralRewardTypeEnum {
+    FIXED_BONUS = 'FIXED_BONUS',
+    PERCENT_BONUS = 'PERCENT_BONUS',
+    COUPON = 'COUPON',
+    SALE_DISCOUNT = 'SALE_DISCOUNT',
+}

package/src/retailPromotions/enums/ReferralTriggerEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Evento del referido que paga la promo. Venta: FIRST_PURCHASE, ACCOUNT_OPENED, ANY_PURCHASE, NTH_PURCHASE.
+ * Crédito: CREDIT_ACTIVATED, FIRST_INSTALLMENT, INSTALLMENT_STREAK.
+ */
+export enum ReferralTriggerEnum {
+    FIRST_PURCHASE = 'FIRST_PURCHASE',
+    ACCOUNT_OPENED = 'ACCOUNT_OPENED',
+    ANY_PURCHASE = 'ANY_PURCHASE',
+    NTH_PURCHASE = 'NTH_PURCHASE',
+    CREDIT_ACTIVATED = 'CREDIT_ACTIVATED',
+    FIRST_INSTALLMENT = 'FIRST_INSTALLMENT',
+    INSTALLMENT_STREAK = 'INSTALLMENT_STREAK',
+}

package/src/retailPromotions/enums/RetailPromotionsErrorCodeEnum.ts

@@ -53,4 +53,8 @@ export enum RetailPromotionsErrorCodeEnum {
     SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED = 'SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED',
     /** De la promo de sistema solo se edita el monto del bono. */
     SYSTEM_PROMOTION_FIELD_LOCKED = 'SYSTEM_PROMOTION_FIELD_LOCKED',
+    /** La promo de apertura de cuenta eligió un premio que depende de la compra. */
+    REFERRAL_REWARD_NEEDS_PURCHASE = 'REFERRAL_REWARD_NEEDS_PURCHASE',
+    /** Evento de referido inválido: compra N o racha menor a 2, o evento de otro canal. */
+    INVALID_REFERRAL_TRIGGER = 'INVALID_REFERRAL_TRIGGER',
 }

package/src/retailPromotions/enums/SalePromotionKindEnum.ts

@@ -1,8 +1,9 @@
 /**
- * Tipo de promo en el apartado: GIFT solo trae regalo y va ligada al teléfono; SALE es cualquier otra.
+ * Tipo de promo: GIFT solo trae regalo y va ligada al teléfono; REFERRAL premia por un referido; SALE es cualquier otra.
  * @enum {string}
  */
 export enum SalePromotionKindEnum {
     GIFT = 'GIFT',
     SALE = 'SALE',
+    REFERRAL = 'REFERRAL',
 }

package/src/retailPromotions/index.ts

@@ -21,6 +21,10 @@ export * from './enums/RetailPromotionsErrorCodeEnum';
 export * from './enums/SalePromotionKindEnum';
 export * from './enums/SkuSalePromotionLookupStatusEnum';
 export * from './enums/SalePromotionSystemKeyEnum';
+export * from './enums/ReferralPromotionChannelEnum';
+export * from './enums/ReferralTriggerEnum';
+export * from './enums/ReferralRewardTypeEnum';
+export * from './enums/ReferralRewardStatusEnum';
 
 // Constantes y helpers puros
 export * from './constants/retailPromotionsErrorHttpStatus';
@@ -40,6 +44,7 @@ export * from './dtos/DiscountCode';
 export * from './dtos/LinePromotionDiscount';
 export * from './dtos/LinePromotionAmount';
 export * from './dtos/SalePromotionRef';
+export * from './dtos/ReferralPromotion';
 
 // Validadores
 export * from './validators/IsHoldModeExclusiveConstraint';
@@ -48,6 +53,7 @@ export * from './validators/IsHoldModeExclusiveConstraint';
 export * from './dtos/requests/DiscountValueInput';
 export * from './dtos/requests/SalePromotionLeversInput';
 export * from './dtos/requests/SalePromotionScopeInput';
+export * from './dtos/requests/ReferralPromotionInput';
 export * from './dtos/requests/CreateSalePromotionRequest';
 export * from './dtos/requests/UpdateSalePromotionRequest';
 export * from './dtos/requests/ChangeSalePromotionStatusRequest';
@@ -64,6 +70,9 @@ export * from './dtos/requests/HoldSalePromotionRequest';
 export * from './dtos/requests/GetSaleCouponQuery';
 export * from './dtos/requests/SkuSalePromotionsQuery';
 export * from './dtos/requests/ActiveSalePromotionsBySkusRequest';
+export * from './dtos/requests/CheckSalePromotionPaymentRequest';
+export * from './dtos/requests/GetReferralRewardsByPhonesRequest';
+export * from './dtos/requests/ListLiveReferralPromotionsQuery';
 
 // Response DTOs
 export * from './dtos/responses/SalePromotionCrudResponses';
@@ -73,3 +82,6 @@ export * from './dtos/responses/SkuSalePromotionsResponse';
 export * from './dtos/responses/SalePromotionSegmentsResponse';
 export * from './dtos/responses/ActiveSalePromotionsBySkusResponse';
 export * from './dtos/responses/WelcomeBonusPromotionResponse';
+export * from './dtos/responses/SalePromotionPaymentCheckResponses';
+export * from './dtos/responses/ReferralRewardsByPhonesResponses';
+export * from './dtos/responses/LiveReferralPromotionsResponse';