@fiado/type-kit 3.546.0 → 3.547.0

package/_test_/unit/loanOfferings/prepaymentMinimum.test.ts

@@ -0,0 +1,40 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+  PrepaymentMinimum,
+  PrepaymentMinimumModeEnum,
+  UpdateCreditPlanRequest,
+} from '../../../src/loanOfferings/index';
+
+const errorsOf = async (prepaymentMinimum: Record<string, unknown>): Promise<string[]> => {
+  const dto = plainToInstance(UpdateCreditPlanRequest, { prepaymentMinimum }, { excludeExtraneousValues: true });
+  const errors = await validate(dto as object);
+  return errors.flatMap((error) => (error.children ?? []).map((child) => child.property).concat(error.children?.length ? [] : [error.property]));
+};
+
+describe('UpdateCreditPlanRequest.prepaymentMinimum', () => {
+  it('tipa el mínimo del abono y conserva sus campos', async () => {
+    const dto = plainToInstance(
+      UpdateCreditPlanRequest,
+      { prepaymentMinimum: { mode: 'PERCENT_OF_PERIOD_PAYMENT', periodPaymentPct: 0.5 } },
+      { excludeExtraneousValues: true },
+    );
+    expect(await validate(dto as object)).toHaveLength(0);
+    expect(dto.prepaymentMinimum).toBeInstanceOf(PrepaymentMinimum);
+    expect(dto.prepaymentMinimum?.periodPaymentPct).toBe(0.5);
+  });
+
+  it('acepta cualquier monto, porcentaje del pago del periodo y monto fijo', async () => {
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.ANY })).toEqual([]);
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.PERCENT_OF_PERIOD_PAYMENT, periodPaymentPct: 1 })).toEqual([]);
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.FIXED, amountCents: 10_000 })).toEqual([]);
+  });
+
+  it('rechaza un modo desconocido, un porcentaje fuera de (0, 1] y un monto menor a un centavo', async () => {
+    expect(await errorsOf({ mode: 'HALF' })).toContain('mode');
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.PERCENT_OF_PERIOD_PAYMENT, periodPaymentPct: 1.5 })).toContain('periodPaymentPct');
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.PERCENT_OF_PERIOD_PAYMENT, periodPaymentPct: 0 })).toContain('periodPaymentPct');
+    expect(await errorsOf({ mode: PrepaymentMinimumModeEnum.FIXED, amountCents: 0 })).toContain('amountCents');
+  });
+});

package/bin/loanCredit/dtos/responses/CreditCustomerListItem.d.ts

@@ -25,6 +25,8 @@ export interface CreditCustomerCredit {
     settledCreditsCount: number | null;
     writtenOffCreditsCount: number | null;
     outstandingBalanceCents: number | null;
+    /** Deuda total de sus créditos vivos: capital, interés e IVA que faltan de las cuotas abiertas. `null` = no aplica. */
+    totalDebtCents?: number | null;
     arrearsDays: number | null;
     lastPaymentAt: string | null;
     /** Ausente en créditos sin pago desde que existe el campo: el front cae a `lastPaymentAt`. */

package/bin/loanCredit/dtos/responses/LoanBorrowerCreditItem.d.ts

@@ -9,6 +9,8 @@ export interface LoanBorrowerCreditItem extends LoanCreditResponse {
     paidInstallments: number;
     /** `null` = no aplica (el crédito se canceló o caducó); `0` = ya no debe nada. */
     outstandingBalanceCents: number | null;
+    /** Deuda total: capital, interés e IVA que faltan de las cuotas abiertas (PENDING u OVERDUE). `null` = no aplica. */
+    totalDebtCents?: number | null;
     /** Días desde el vencimiento impago más viejo; `0` al día; `null` si no hay atraso que medir. */
     overdueDays: number | null;
     /** Suma del TOTAL de las cuotas vencidas impagas. Sigue a `overdueDays` en `null`/`0`. */

package/bin/loanCredit/dtos/responses/LoanCreditDetail.d.ts

@@ -13,6 +13,8 @@ export interface LoanCreditDetail extends LoanCreditResponse {
     financier: SaleFinancierEnum;
     paidInstallments: number;
     outstandingBalanceCents: number | null;
+    /** Deuda total: capital, interés e IVA que faltan de las cuotas abiertas (PENDING u OVERDUE). `null` = no aplica. */
+    totalDebtCents?: number | null;
     overdueDays: number | null;
     overdueAmountCents: number | null;
     /** Cuotas vencidas impagas. `0` = nada vencido; `null` acompaña a `overdueDays` en null. */

package/bin/loanCredit/dtos/responses/LoanPrepaymentQuote.d.ts

@@ -3,8 +3,10 @@ export interface LoanPrepaymentQuote {
     creditId: string;
     /** Saldo insoluto que se le informa al cliente. */
     outstandingCapitalCents: number;
-    /** Pago del periodo: el mínimo del abono. */
+    /** Pago del periodo. */
     periodPaymentCents: number;
+    /** Mínimo del abono según el plan del crédito; con mínimo `ANY`, 1 centavo. */
+    minAmountCents?: number;
     /** Monto de liquidación anticipada: el techo del abono. */
     settlementAmountCents: number;
 }

package/bin/loanCredit/dtos/responses/SellerCreditRow.d.ts

@@ -17,6 +17,8 @@ export interface SellerCreditRow {
     summaryUnavailable: boolean;
     paidInstallments: number | null;
     outstandingBalanceCents: number | null;
+    /** Deuda total: capital, interés e IVA que faltan de las cuotas abiertas (PENDING u OVERDUE). `null` = no aplica. */
+    totalDebtCents?: number | null;
     overdueDays: number | null;
     overdueAmountCents: number | null;
     /** Primera cuota que todavía se debe; `null` si ya no debe nada o si el plan no se leyó. */

package/bin/loanOfferings/dtos/CreditPlan.d.ts

@@ -2,6 +2,7 @@ import { CreditPlanLevelEnum } from '../enums/CreditPlanLevelEnum';
 import { CreditPlanStatusEnum } from '../enums/CreditPlanStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from './PrepaymentMinimum';
 /**
  * CreditPlan — plan de crédito del catálogo SOFOM SureKeep (modelo-datos §6.1 · M6 §4).
  * Entidad completa del dominio `loan-offerings-business` (SureKeep Fase 1 — pista Loan).
@@ -49,4 +50,6 @@ export declare class CreditPlan {
     updatedBy: string;
     createdAt: string;
     updatedAt: string;
+    /** Mínimo del abono a capital; ausente = `ANY` (cualquier monto). */
+    prepaymentMinimum?: PrepaymentMinimum;
 }

package/bin/loanOfferings/dtos/CreditPlan.js

@@ -17,6 +17,7 @@ const CreditPlanLevelEnum_1 = require("../enums/CreditPlanLevelEnum");
 const CreditPlanStatusEnum_1 = require("../enums/CreditPlanStatusEnum");
 const ProductTierEnum_1 = require("../enums/ProductTierEnum");
 const SaleTypeEnum_1 = require("../enums/SaleTypeEnum");
+const PrepaymentMinimum_1 = require("./PrepaymentMinimum");
 /**
  * CreditPlan — plan de crédito del catálogo SOFOM SureKeep (modelo-datos §6.1 · M6 §4).
  * Entidad completa del dominio `loan-offerings-business` (SureKeep Fase 1 — pista Loan).
@@ -182,3 +183,10 @@ __decorate([
     (0, class_validator_1.Matches)(regex_1.regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' }),
     __metadata("design:type", String)
 ], CreditPlan.prototype, "updatedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PrepaymentMinimum_1.PrepaymentMinimum),
+    __metadata("design:type", PrepaymentMinimum_1.PrepaymentMinimum)
+], CreditPlan.prototype, "prepaymentMinimum", void 0);

package/bin/loanOfferings/dtos/PrepaymentMinimum.d.ts

@@ -0,0 +1,12 @@
+import { PrepaymentMinimumModeEnum } from '../enums/PrepaymentMinimumModeEnum';
+/**
+ * Mínimo del abono a capital de un plan. El máximo no depende del plan: es lo que falta para liquidar.
+ * Sin este campo en el plan, el mínimo es `ANY`.
+ */
+export declare class PrepaymentMinimum {
+    mode: PrepaymentMinimumModeEnum;
+    /** Sólo `PERCENT_OF_PERIOD_PAYMENT`: decimal sobre 1 del pago del periodo (`0.5` = 50 %). */
+    periodPaymentPct?: number | null;
+    /** Sólo `FIXED`: monto mínimo en cents. */
+    amountCents?: number | null;
+}

package/bin/loanOfferings/dtos/PrepaymentMinimum.js

@@ -0,0 +1,42 @@
+"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.PrepaymentMinimum = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const PrepaymentMinimumModeEnum_1 = require("../enums/PrepaymentMinimumModeEnum");
+/**
+ * Mínimo del abono a capital de un plan. El máximo no depende del plan: es lo que falta para liquidar.
+ * Sin este campo en el plan, el mínimo es `ANY`.
+ */
+class PrepaymentMinimum {
+}
+exports.PrepaymentMinimum = PrepaymentMinimum;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(PrepaymentMinimumModeEnum_1.PrepaymentMinimumModeEnum),
+    __metadata("design:type", String)
+], PrepaymentMinimum.prototype, "mode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0.0001),
+    (0, class_validator_1.Max)(1),
+    __metadata("design:type", Number)
+], PrepaymentMinimum.prototype, "periodPaymentPct", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], PrepaymentMinimum.prototype, "amountCents", void 0);

package/bin/loanOfferings/dtos/requests/CreateCreditPlanRequest.d.ts

@@ -1,6 +1,7 @@
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from '../PrepaymentMinimum';
 /**
  * Body de POST /credit-plans — alta de un plan (SureKeep Fase 1 — pista Loan).
  * Campos server-assigned (`planId`, `version`, `ivaOnInterest`=0.16, `status`, auditoría) NO viajan
@@ -24,4 +25,6 @@ export declare class CreateCreditPlanRequest {
     maxSciScore?: number | null;
     validFrom?: string | null;
     validUntil?: string | null;
+    /** Mínimo del abono a capital; ausente = sin cambios (en el alta: `ANY`). */
+    prepaymentMinimum?: PrepaymentMinimum;
 }

package/bin/loanOfferings/dtos/requests/CreateCreditPlanRequest.js

@@ -15,6 +15,7 @@ const class_validator_1 = require("class-validator");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
 const SaleTypeEnum_1 = require("../../enums/SaleTypeEnum");
+const PrepaymentMinimum_1 = require("../PrepaymentMinimum");
 /**
  * Body de POST /credit-plans — alta de un plan (SureKeep Fase 1 — pista Loan).
  * Campos server-assigned (`planId`, `version`, `ivaOnInterest`=0.16, `status`, auditoría) NO viajan
@@ -135,3 +136,10 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], CreateCreditPlanRequest.prototype, "validUntil", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PrepaymentMinimum_1.PrepaymentMinimum),
+    __metadata("design:type", PrepaymentMinimum_1.PrepaymentMinimum)
+], CreateCreditPlanRequest.prototype, "prepaymentMinimum", void 0);

package/bin/loanOfferings/dtos/requests/UpdateCreditPlanRequest.d.ts

@@ -1,5 +1,6 @@
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from '../PrepaymentMinimum';
 /**
  * Body de PUT /credit-plans/:planId — edición parcial de parámetros del plan (todos opcionales).
  * En F1 el PUT puede editar `min/maxSciScore` por-plan (DEC-004); el guard atómico anti-huecos
@@ -22,4 +23,6 @@ export declare class UpdateCreditPlanRequest {
     maxSciScore?: number | null;
     validFrom?: string | null;
     validUntil?: string | null;
+    /** Mínimo del abono a capital; ausente = sin cambios (en el alta: `ANY`). */
+    prepaymentMinimum?: PrepaymentMinimum;
 }

package/bin/loanOfferings/dtos/requests/UpdateCreditPlanRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
 const SaleTypeEnum_1 = require("../../enums/SaleTypeEnum");
+const PrepaymentMinimum_1 = require("../PrepaymentMinimum");
 /**
  * Body de PUT /credit-plans/:planId — edición parcial de parámetros del plan (todos opcionales).
  * En F1 el PUT puede editar `min/maxSciScore` por-plan (DEC-004); el guard atómico anti-huecos
@@ -132,3 +133,10 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], UpdateCreditPlanRequest.prototype, "validUntil", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PrepaymentMinimum_1.PrepaymentMinimum),
+    __metadata("design:type", PrepaymentMinimum_1.PrepaymentMinimum)
+], UpdateCreditPlanRequest.prototype, "prepaymentMinimum", void 0);

package/bin/loanOfferings/dtos/responses/CreditPlanResponse.d.ts

@@ -2,6 +2,7 @@ import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { CreditPlanStatusEnum } from '../../enums/CreditPlanStatusEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from '../PrepaymentMinimum';
 /**
  * Shape de salida de un plan de crédito (GET / POST / PUT de /credit-plans).
  * Montos en cents; porcentajes y TNA en decimal.
@@ -32,4 +33,6 @@ export interface CreditPlanResponse {
     updatedBy: string;
     createdAt: string;
     updatedAt: string;
+    /** Mínimo del abono a capital; ausente = `ANY` (cualquier monto). */
+    prepaymentMinimum?: PrepaymentMinimum;
 }

package/bin/loanOfferings/enums/PrepaymentMinimumModeEnum.d.ts

@@ -0,0 +1,9 @@
+/** Cómo se fija el mínimo del abono a capital de un plan. */
+export declare enum PrepaymentMinimumModeEnum {
+    /** Sin mínimo: el cliente abona el monto que quiera. */
+    ANY = "ANY",
+    /** Un porcentaje del pago del periodo (`periodPaymentPct`). */
+    PERCENT_OF_PERIOD_PAYMENT = "PERCENT_OF_PERIOD_PAYMENT",
+    /** Un monto fijo (`amountCents`). */
+    FIXED = "FIXED"
+}

package/bin/loanOfferings/enums/PrepaymentMinimumModeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrepaymentMinimumModeEnum = void 0;
+/** Cómo se fija el mínimo del abono a capital de un plan. */
+var PrepaymentMinimumModeEnum;
+(function (PrepaymentMinimumModeEnum) {
+    /** Sin mínimo: el cliente abona el monto que quiera. */
+    PrepaymentMinimumModeEnum["ANY"] = "ANY";
+    /** Un porcentaje del pago del periodo (`periodPaymentPct`). */
+    PrepaymentMinimumModeEnum["PERCENT_OF_PERIOD_PAYMENT"] = "PERCENT_OF_PERIOD_PAYMENT";
+    /** Un monto fijo (`amountCents`). */
+    PrepaymentMinimumModeEnum["FIXED"] = "FIXED";
+})(PrepaymentMinimumModeEnum || (exports.PrepaymentMinimumModeEnum = PrepaymentMinimumModeEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -15,7 +15,9 @@ export * from './enums/StorePolicyPhaseEnum';
 export * from './enums/SegmentStatusEnum';
 export * from './enums/SegmentColorSlotEnum';
 export * from './enums/SegmentFilterIdEnum';
+export * from './enums/PrepaymentMinimumModeEnum';
 export * from './dtos/CreditPlan';
+export * from './dtos/PrepaymentMinimum';
 export * from './dtos/Financier';
 export * from './dtos/RetailerCreditPlan';
 export * from './dtos/PromotionEffect';

package/bin/loanOfferings/index.js

@@ -32,8 +32,10 @@ __exportStar(require("./enums/StorePolicyPhaseEnum"), exports);
 __exportStar(require("./enums/SegmentStatusEnum"), exports);
 __exportStar(require("./enums/SegmentColorSlotEnum"), exports);
 __exportStar(require("./enums/SegmentFilterIdEnum"), exports);
+__exportStar(require("./enums/PrepaymentMinimumModeEnum"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/CreditPlan"), exports);
+__exportStar(require("./dtos/PrepaymentMinimum"), exports);
 __exportStar(require("./dtos/Financier"), exports);
 __exportStar(require("./dtos/RetailerCreditPlan"), exports);
 __exportStar(require("./dtos/PromotionEffect"), exports);

package/bin/retailLoan/dtos/MyCreditSummary.d.ts

@@ -25,5 +25,7 @@ export interface MyCreditSummary {
     totalInstallments: number;
     paidInstallments: number;
     remainingBalance: number | null;
+    /** Deuda total en pesos: capital, interés e IVA que faltan de las cuotas abiertas. `null` = no aplica. */
+    totalDebt?: number | null;
     overdue?: MyOverdue;
 }

package/package.json

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

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

@@ -28,6 +28,8 @@ export interface CreditCustomerCredit {
     settledCreditsCount: number | null;
     writtenOffCreditsCount: number | null;
     outstandingBalanceCents: number | null;
+    /** Deuda total de sus créditos vivos: capital, interés e IVA que faltan de las cuotas abiertas. `null` = no aplica. */
+    totalDebtCents?: number | null;
     arrearsDays: number | null;
     lastPaymentAt: string | null;
     /** Ausente en créditos sin pago desde que existe el campo: el front cae a `lastPaymentAt`. */

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

@@ -10,6 +10,8 @@ export interface LoanBorrowerCreditItem extends LoanCreditResponse {
     paidInstallments: number;
     /** `null` = no aplica (el crédito se canceló o caducó); `0` = ya no debe nada. */
     outstandingBalanceCents: number | null;
+    /** Deuda total: capital, interés e IVA que faltan de las cuotas abiertas (PENDING u OVERDUE). `null` = no aplica. */
+    totalDebtCents?: number | null;
     /** Días desde el vencimiento impago más viejo; `0` al día; `null` si no hay atraso que medir. */
     overdueDays: number | null;
     /** Suma del TOTAL de las cuotas vencidas impagas. Sigue a `overdueDays` en `null`/`0`. */

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

@@ -14,6 +14,8 @@ export interface LoanCreditDetail extends LoanCreditResponse {
     financier: SaleFinancierEnum;
     paidInstallments: number;
     outstandingBalanceCents: number | null;
+    /** Deuda total: capital, interés e IVA que faltan de las cuotas abiertas (PENDING u OVERDUE). `null` = no aplica. */
+    totalDebtCents?: number | null;
     overdueDays: number | null;
     overdueAmountCents: number | null;
     /** Cuotas vencidas impagas. `0` = nada vencido; `null` acompaña a `overdueDays` en null. */

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

@@ -3,8 +3,10 @@ export interface LoanPrepaymentQuote {
     creditId: string;
     /** Saldo insoluto que se le informa al cliente. */
     outstandingCapitalCents: number;
-    /** Pago del periodo: el mínimo del abono. */
+    /** Pago del periodo. */
     periodPaymentCents: number;
+    /** Mínimo del abono según el plan del crédito; con mínimo `ANY`, 1 centavo. */
+    minAmountCents?: number;
     /** Monto de liquidación anticipada: el techo del abono. */
     settlementAmountCents: number;
 }

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

@@ -18,6 +18,8 @@ export interface SellerCreditRow {
     summaryUnavailable: boolean;
     paidInstallments: number | null;
     outstandingBalanceCents: number | null;
+    /** Deuda total: capital, interés e IVA que faltan de las cuotas abiertas (PENDING u OVERDUE). `null` = no aplica. */
+    totalDebtCents?: number | null;
     overdueDays: number | null;
     overdueAmountCents: number | null;
     /** Primera cuota que todavía se debe; `null` si ya no debe nada o si el plan no se leyó. */

package/src/loanOfferings/dtos/CreditPlan.ts

@@ -1,4 +1,4 @@
-import { Expose } from 'class-transformer';
+import { Expose, Type } from 'class-transformer';
 import {
     ArrayNotEmpty,
     IsArray,
@@ -11,12 +11,14 @@ import {
     Matches,
     Max,
     Min,
+    ValidateNested,
 } from 'class-validator';
 import { regexIso8601 } from '../../helpers/constans/regex';
 import { CreditPlanLevelEnum } from '../enums/CreditPlanLevelEnum';
 import { CreditPlanStatusEnum } from '../enums/CreditPlanStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from './PrepaymentMinimum';
 
 /**
  * CreditPlan — plan de crédito del catálogo SOFOM SureKeep (modelo-datos §6.1 · M6 §4).
@@ -168,4 +170,11 @@ export class CreditPlan {
     @IsString()
     @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
     updatedAt!: string;
+
+    /** Mínimo del abono a capital; ausente = `ANY` (cualquier monto). */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => PrepaymentMinimum)
+    prepaymentMinimum?: PrepaymentMinimum;
 }

package/src/loanOfferings/dtos/PrepaymentMinimum.ts

@@ -0,0 +1,28 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsNumber, IsOptional, Max, Min } from 'class-validator';
+import { PrepaymentMinimumModeEnum } from '../enums/PrepaymentMinimumModeEnum';
+
+/**
+ * Mínimo del abono a capital de un plan. El máximo no depende del plan: es lo que falta para liquidar.
+ * Sin este campo en el plan, el mínimo es `ANY`.
+ */
+export class PrepaymentMinimum {
+    @Expose()
+    @IsEnum(PrepaymentMinimumModeEnum)
+    mode!: PrepaymentMinimumModeEnum;
+
+    /** Sólo `PERCENT_OF_PERIOD_PAYMENT`: decimal sobre 1 del pago del periodo (`0.5` = 50 %). */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    @Min(0.0001)
+    @Max(1)
+    periodPaymentPct?: number | null;
+
+    /** Sólo `FIXED`: monto mínimo en cents. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    amountCents?: number | null;
+}

package/src/loanOfferings/dtos/requests/CreateCreditPlanRequest.ts

@@ -1,4 +1,4 @@
-import { Expose } from 'class-transformer';
+import { Expose, Type } from 'class-transformer';
 import {
     ArrayNotEmpty,
     IsArray,
@@ -10,10 +10,12 @@ import {
     IsString,
     Max,
     Min,
+    ValidateNested,
 } from 'class-validator';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from '../PrepaymentMinimum';
 
 /**
  * Body de POST /credit-plans — alta de un plan (SureKeep Fase 1 — pista Loan).
@@ -115,4 +117,11 @@ export class CreateCreditPlanRequest {
     @IsOptional()
     @IsString()
     validUntil?: string | null;
+
+    /** Mínimo del abono a capital; ausente = sin cambios (en el alta: `ANY`). */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => PrepaymentMinimum)
+    prepaymentMinimum?: PrepaymentMinimum;
 }

package/src/loanOfferings/dtos/requests/UpdateCreditPlanRequest.ts

@@ -1,4 +1,4 @@
-import { Expose } from 'class-transformer';
+import { Expose, Type } from 'class-transformer';
 import {
     ArrayNotEmpty,
     IsArray,
@@ -10,9 +10,11 @@ import {
     IsString,
     Max,
     Min,
+    ValidateNested,
 } from 'class-validator';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from '../PrepaymentMinimum';
 
 /**
  * Body de PUT /credit-plans/:planId — edición parcial de parámetros del plan (todos opcionales).
@@ -114,4 +116,11 @@ export class UpdateCreditPlanRequest {
     @IsOptional()
     @IsString()
     validUntil?: string | null;
+
+    /** Mínimo del abono a capital; ausente = sin cambios (en el alta: `ANY`). */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => PrepaymentMinimum)
+    prepaymentMinimum?: PrepaymentMinimum;
 }

package/src/loanOfferings/dtos/responses/CreditPlanResponse.ts

@@ -2,6 +2,7 @@ import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { CreditPlanStatusEnum } from '../../enums/CreditPlanStatusEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
 import { SaleTypeEnum } from '../../enums/SaleTypeEnum';
+import { PrepaymentMinimum } from '../PrepaymentMinimum';
 
 /**
  * Shape de salida de un plan de crédito (GET / POST / PUT de /credit-plans).
@@ -33,4 +34,6 @@ export interface CreditPlanResponse {
     updatedBy: string;
     createdAt: string;
     updatedAt: string;
+    /** Mínimo del abono a capital; ausente = `ANY` (cualquier monto). */
+    prepaymentMinimum?: PrepaymentMinimum;
 }

package/src/loanOfferings/enums/PrepaymentMinimumModeEnum.ts

@@ -0,0 +1,9 @@
+/** Cómo se fija el mínimo del abono a capital de un plan. */
+export enum PrepaymentMinimumModeEnum {
+    /** Sin mínimo: el cliente abona el monto que quiera. */
+    ANY = 'ANY',
+    /** Un porcentaje del pago del periodo (`periodPaymentPct`). */
+    PERCENT_OF_PERIOD_PAYMENT = 'PERCENT_OF_PERIOD_PAYMENT',
+    /** Un monto fijo (`amountCents`). */
+    FIXED = 'FIXED',
+}

package/src/loanOfferings/index.ts

@@ -16,9 +16,11 @@ export * from './enums/StorePolicyPhaseEnum';
 export * from './enums/SegmentStatusEnum';
 export * from './enums/SegmentColorSlotEnum';
 export * from './enums/SegmentFilterIdEnum';
+export * from './enums/PrepaymentMinimumModeEnum';
 
 // Entity DTOs
 export * from './dtos/CreditPlan';
+export * from './dtos/PrepaymentMinimum';
 export * from './dtos/Financier';
 export * from './dtos/RetailerCreditPlan';
 export * from './dtos/PromotionEffect';

package/src/retailLoan/dtos/MyCreditSummary.ts

@@ -28,5 +28,7 @@ export interface MyCreditSummary {
     totalInstallments: number;
     paidInstallments: number;
     remainingBalance: number | null;
+    /** Deuda total en pesos: capital, interés e IVA que faltan de las cuotas abiertas. `null` = no aplica. */
+    totalDebt?: number | null;
     overdue?: MyOverdue;
 }