@fiado/type-kit 3.546.0 → 3.548.0

package/_test_/unit/loanCredit/cancelLoanCreditRequest.test.ts

@@ -0,0 +1,40 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { CancelLoanCreditRequest } from '../../../src/loanCredit/index';
+import type { LoanCreditResponse } from '../../../src/loanCredit/index';
+
+const errorsOf = async (body: Record<string, unknown>): Promise<string[]> => {
+    const errors = await validate(plainToInstance(CancelLoanCreditRequest, body));
+    return errors.map((error) => error.property);
+};
+
+const VALID = { saleId: '01M5B1V5R2KZ90G8CNEA8TTC46', reason: 'El cliente se arrepintió' };
+
+describe('CancelLoanCreditRequest', () => {
+    it('acepta la venta y el motivo', async () => {
+        expect(await errorsOf(VALID)).toEqual([]);
+    });
+
+    it('exige saleId y reason', async () => {
+        expect((await errorsOf({})).sort()).toEqual(['reason', 'saleId']);
+    });
+
+    it('rechaza saleId o reason vacíos', async () => {
+        expect(await errorsOf({ ...VALID, saleId: '' })).toEqual(['saleId']);
+        expect(await errorsOf({ ...VALID, reason: '' })).toEqual(['reason']);
+    });
+
+    it('rechaza un saleId con caracteres fuera de la referencia del hecho', async () => {
+        expect(await errorsOf({ ...VALID, saleId: 'SALE#123' })).toEqual(['saleId']);
+    });
+});
+
+describe('LoanCreditResponse.hasPayments', () => {
+    it('es opcional y booleano', () => {
+        const partial: Pick<LoanCreditResponse, 'hasPayments'> = {};
+        const withFlag: Pick<LoanCreditResponse, 'hasPayments'> = { hasPayments: true };
+        expect(partial.hasPayments).toBeUndefined();
+        expect(withFlag.hasPayments).toBe(true);
+    });
+});

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/_test_/unit/loanRetailAudit/loanRetailAuditContracts.test.ts

@@ -123,6 +123,15 @@ describe('ListAuditTrailQuery', () => {
 });
 
 describe('catálogos', () => {
+    it('incluye PROSPECT y RETAIL_CUSTOMER del wizard y los acepta en el evento', () => {
+        for (const entityType of ['PROSPECT', 'RETAIL_CUSTOMER']) {
+            expect(AUDIT_TRAIL_ENTITY_TYPES).toContain(entityType);
+            expect(errorsOf(AuditTrailRecordedV1, { ...validEvent, entityType })).toEqual([]);
+        }
+        expect(RetailAuditEntityTypeEnum.PROSPECT).toBe('PROSPECT');
+        expect(RetailAuditEntityTypeEnum.RETAIL_CUSTOMER).toBe('RETAIL_CUSTOMER');
+    });
+
     it('AUDIT_TRAIL_ENTITY_TYPES une Loan y Retail sin repetidos', () => {
         const all = [...Object.values(LoanAuditEntityTypeEnum), ...Object.values(RetailAuditEntityTypeEnum)];
         expect([...AUDIT_TRAIL_ENTITY_TYPES].sort()).toEqual([...all].sort());

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

@@ -0,0 +1,25 @@
+import 'reflect-metadata';
+import { SaleCancellationReasonEnum } from '../../../src/retailWizard/index';
+import type { Sale, SaleCancellation } from '../../../src/retailWizard/index';
+
+describe('SaleCancellation', () => {
+    it('cataloga los cinco motivos por los que no se puede cancelar', () => {
+        expect(Object.values(SaleCancellationReasonEnum).sort()).toEqual([
+            'CANCEL_WINDOW_EXPIRED',
+            'CREDIT_HAS_PAYMENTS',
+            'CREDIT_NOT_CANCELLABLE',
+            'IMEI_NOT_RETURNABLE',
+            'SALE_ALREADY_CANCELLED',
+        ]);
+    });
+
+    it('viaja opcional en la venta', () => {
+        const cancellation: SaleCancellation = {
+            allowed: false,
+            reason: SaleCancellationReasonEnum.CREDIT_HAS_PAYMENTS,
+            windowEndsAt: '2026-10-26T00:00:00.000Z',
+        };
+        const sale: Pick<Sale, 'cancellation'> = { cancellation };
+        expect(sale.cancellation?.allowed).toBe(false);
+    });
+});

package/bin/loanCredit/dtos/requests/CancelLoanCreditRequest.d.ts

@@ -0,0 +1,7 @@
+/** Body de `POST /private/credits/:creditId/cancel` (loan-credit-business): la venta que se cancela. */
+export declare class CancelLoanCreditRequest {
+    /** Venta que origina la cancelación; es la referencia del aviso al cliente. */
+    saleId: string;
+    /** Motivo de la cancelación; va a la auditoría del crédito y no se loguea. */
+    reason: string;
+}

package/bin/loanCredit/dtos/requests/CancelLoanCreditRequest.js

@@ -0,0 +1,33 @@
+"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.CancelLoanCreditRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Body de `POST /private/credits/:creditId/cancel` (loan-credit-business): la venta que se cancela. */
+class CancelLoanCreditRequest {
+}
+exports.CancelLoanCreditRequest = CancelLoanCreditRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(120),
+    (0, class_validator_1.Matches)(/^[A-Za-z0-9._:-]+$/),
+    __metadata("design:type", String)
+], CancelLoanCreditRequest.prototype, "saleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CancelLoanCreditRequest.prototype, "reason", void 0);

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/LoanCreditResponse.d.ts

@@ -51,6 +51,8 @@ export interface LoanCreditResponse {
     effectiveTerms?: EffectiveTermsSnapshot | null;
     activatedAt?: string;
     voluntaryCancelDeadline?: string;
+    /** Si ya se abonó alguna cuota (el enganche no cuenta); solo lo traen la lectura y la cancelación privadas. */
+    hasPayments?: boolean;
     firstDueDate?: string;
     lastDueDate?: string;
     createdBy: string;

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/loanCredit/index.d.ts

@@ -117,6 +117,7 @@ export * from './dtos/WriteOffConfirmations';
 export * from './dtos/requests/BackofficeSettleCreditRequest';
 export * from './dtos/requests/BackofficeListWriteOffCandidatesRequest';
 export * from './dtos/requests/BackofficeWriteOffCreditRequest';
+export * from './dtos/requests/CancelLoanCreditRequest';
 export * from './dtos/requests/BackofficeCollectWrittenOffCreditRequest';
 export * from './dtos/requests/BackofficeProposeRestructureRequest';
 export * from './dtos/requests/BackofficeApproveRestructureRequest';

package/bin/loanCredit/index.js

@@ -159,6 +159,7 @@ __exportStar(require("./dtos/WriteOffConfirmations"), exports);
 __exportStar(require("./dtos/requests/BackofficeSettleCreditRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeListWriteOffCandidatesRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeWriteOffCreditRequest"), exports);
+__exportStar(require("./dtos/requests/CancelLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeCollectWrittenOffCreditRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeProposeRestructureRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeApproveRestructureRequest"), exports);

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/loanRetailAudit/enums/RetailAuditEntityTypeEnum.d.ts

@@ -13,5 +13,7 @@ export declare enum RetailAuditEntityTypeEnum {
     COMMISSION_PAYOUT = "COMMISSION_PAYOUT",
     COMMISSION_ADJUSTMENT = "COMMISSION_ADJUSTMENT",
     COMMISSION_RULE = "COMMISSION_RULE",
-    COMMISSION_POLICY = "COMMISSION_POLICY"
+    COMMISSION_POLICY = "COMMISSION_POLICY",
+    PROSPECT = "PROSPECT",
+    RETAIL_CUSTOMER = "RETAIL_CUSTOMER"
 }

package/bin/loanRetailAudit/enums/RetailAuditEntityTypeEnum.js

@@ -18,4 +18,6 @@ var RetailAuditEntityTypeEnum;
     RetailAuditEntityTypeEnum["COMMISSION_ADJUSTMENT"] = "COMMISSION_ADJUSTMENT";
     RetailAuditEntityTypeEnum["COMMISSION_RULE"] = "COMMISSION_RULE";
     RetailAuditEntityTypeEnum["COMMISSION_POLICY"] = "COMMISSION_POLICY";
+    RetailAuditEntityTypeEnum["PROSPECT"] = "PROSPECT";
+    RetailAuditEntityTypeEnum["RETAIL_CUSTOMER"] = "RETAIL_CUSTOMER";
 })(RetailAuditEntityTypeEnum || (exports.RetailAuditEntityTypeEnum = RetailAuditEntityTypeEnum = {}));

package/bin/loanRetailAudit/events/AuditTrailRecordedV1.d.ts

@@ -10,7 +10,7 @@ export declare class AuditTrailRecordedV1 {
     action: AuditTrailActionEnum;
     changes: AuditTrailChange[];
     context: AuditTrailContextEntry[];
-    /** userId del actor, o `system` si lo disparó un proceso interno. */
+    /** userId del actor; nunca `system`: sin usuario va el nombre del lambda que lo disparó. */
     performedBy: string;
     sourceLambda: string;
     occurredAt: string;

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/bin/retailWizard/dtos/Sale.d.ts

@@ -7,6 +7,7 @@ import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
 import type { SalePaymentDetail } from './SalePaymentDetail';
 import type { SaleLine } from './SaleLine';
 import type { SalePromotionRef } from '../../retailPromotions/dtos/SalePromotionRef';
+import type { SaleCancellation } from './SaleCancellation';
 /**
  * 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
@@ -65,6 +66,8 @@ export interface Sale {
     cancelledAt: string | null;
     /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
     cancelReason: string | null;
+    /** Si la venta se puede cancelar hoy y, si no, por qué; solo lo trae el detalle del backoffice. */
+    cancellation?: SaleCancellation;
     /**
      * SNAPSHOT de identidad y contexto, congelado al cerrar la venta. NO se refresca: una venta es la
      * fotografía de un hecho, no la caché de un perfil. Si el cliente corrige su nombre, la venta

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

@@ -0,0 +1,9 @@
+import type { SaleCancellationReasonEnum } from '../enums/SaleCancellationReasonEnum';
+/** Si la venta se puede cancelar hoy; el backend valida igual al cancelar. */
+export interface SaleCancellation {
+    allowed: boolean;
+    /** Ausente cuando `allowed` es true. */
+    reason?: SaleCancellationReasonEnum;
+    /** Fin de la ventana de cancelación voluntaria, ISO-8601. */
+    windowEndsAt?: string;
+}

package/bin/retailWizard/dtos/SaleCancellation.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailWizard/enums/SaleCancellationReasonEnum.d.ts

@@ -0,0 +1,8 @@
+/** Por qué una venta no se puede cancelar; coincide con el `code` que respondería la cancelación. */
+export declare enum SaleCancellationReasonEnum {
+    SALE_ALREADY_CANCELLED = "SALE_ALREADY_CANCELLED",
+    IMEI_NOT_RETURNABLE = "IMEI_NOT_RETURNABLE",
+    CANCEL_WINDOW_EXPIRED = "CANCEL_WINDOW_EXPIRED",
+    CREDIT_HAS_PAYMENTS = "CREDIT_HAS_PAYMENTS",
+    CREDIT_NOT_CANCELLABLE = "CREDIT_NOT_CANCELLABLE"
+}

package/bin/retailWizard/enums/SaleCancellationReasonEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleCancellationReasonEnum = void 0;
+/** Por qué una venta no se puede cancelar; coincide con el `code` que respondería la cancelación. */
+var SaleCancellationReasonEnum;
+(function (SaleCancellationReasonEnum) {
+    SaleCancellationReasonEnum["SALE_ALREADY_CANCELLED"] = "SALE_ALREADY_CANCELLED";
+    SaleCancellationReasonEnum["IMEI_NOT_RETURNABLE"] = "IMEI_NOT_RETURNABLE";
+    SaleCancellationReasonEnum["CANCEL_WINDOW_EXPIRED"] = "CANCEL_WINDOW_EXPIRED";
+    SaleCancellationReasonEnum["CREDIT_HAS_PAYMENTS"] = "CREDIT_HAS_PAYMENTS";
+    SaleCancellationReasonEnum["CREDIT_NOT_CANCELLABLE"] = "CREDIT_NOT_CANCELLABLE";
+})(SaleCancellationReasonEnum || (exports.SaleCancellationReasonEnum = SaleCancellationReasonEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -57,6 +57,8 @@ export * from './dtos/AccessorySaleLine';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';
+export * from './dtos/SaleCancellation';
+export * from './enums/SaleCancellationReasonEnum';
 export * from './dtos/Prospect';
 export * from './dtos/PaginatedResult';
 export * from './dtos/requests/StartSessionRequest';

package/bin/retailWizard/index.js

@@ -80,6 +80,8 @@ __exportStar(require("./dtos/AccessorySaleLine"), exports);
 __exportStar(require("./dtos/WizardSession"), exports);
 __exportStar(require("./dtos/OtpVerification"), exports);
 __exportStar(require("./dtos/Sale"), exports);
+__exportStar(require("./dtos/SaleCancellation"), exports);
+__exportStar(require("./enums/SaleCancellationReasonEnum"), exports);
 __exportStar(require("./dtos/Prospect"), exports);
 // Paginación genérica
 __exportStar(require("./dtos/PaginatedResult"), exports);

package/package.json

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

package/src/loanCredit/dtos/requests/CancelLoanCreditRequest.ts

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString, Matches, MaxLength } from 'class-validator';
+
+/** Body de `POST /private/credits/:creditId/cancel` (loan-credit-business): la venta que se cancela. */
+export class CancelLoanCreditRequest {
+    /** Venta que origina la cancelación; es la referencia del aviso al cliente. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(120)
+    @Matches(/^[A-Za-z0-9._:-]+$/)
+    saleId!: string;
+
+    /** Motivo de la cancelación; va a la auditoría del crédito y no se loguea. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(500)
+    reason!: string;
+}

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/LoanCreditResponse.ts

@@ -52,6 +52,8 @@ export interface LoanCreditResponse {
     effectiveTerms?: EffectiveTermsSnapshot | null;
     activatedAt?: string;
     voluntaryCancelDeadline?: string;
+    /** Si ya se abonó alguna cuota (el enganche no cuenta); solo lo traen la lectura y la cancelación privadas. */
+    hasPayments?: boolean;
     firstDueDate?: string;
     lastDueDate?: string;
     createdBy: string;

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/loanCredit/index.ts

@@ -141,6 +141,7 @@ export * from './dtos/WriteOffConfirmations';
 export * from './dtos/requests/BackofficeSettleCreditRequest';
 export * from './dtos/requests/BackofficeListWriteOffCandidatesRequest';
 export * from './dtos/requests/BackofficeWriteOffCreditRequest';
+export * from './dtos/requests/CancelLoanCreditRequest';
 export * from './dtos/requests/BackofficeCollectWrittenOffCreditRequest';
 export * from './dtos/requests/BackofficeProposeRestructureRequest';
 export * from './dtos/requests/BackofficeApproveRestructureRequest';

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/loanRetailAudit/enums/RetailAuditEntityTypeEnum.ts

@@ -14,4 +14,6 @@ export enum RetailAuditEntityTypeEnum {
     COMMISSION_ADJUSTMENT = 'COMMISSION_ADJUSTMENT',
     COMMISSION_RULE = 'COMMISSION_RULE',
     COMMISSION_POLICY = 'COMMISSION_POLICY',
+    PROSPECT = 'PROSPECT',
+    RETAIL_CUSTOMER = 'RETAIL_CUSTOMER',
 }

package/src/loanRetailAudit/events/AuditTrailRecordedV1.ts

@@ -37,7 +37,7 @@ export class AuditTrailRecordedV1 {
     @Type(() => AuditTrailContextEntry)
     context!: AuditTrailContextEntry[];
 
-    /** userId del actor, o `system` si lo disparó un proceso interno. */
+    /** userId del actor; nunca `system`: sin usuario va el nombre del lambda que lo disparó. */
     @Expose()
     @IsString()
     @IsNotEmpty()

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;
 }

package/src/retailWizard/dtos/Sale.ts

@@ -7,6 +7,7 @@ import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
 import type { SalePaymentDetail } from './SalePaymentDetail';
 import type { SaleLine } from './SaleLine';
 import type { SalePromotionRef } from '../../retailPromotions/dtos/SalePromotionRef';
+import type { SaleCancellation } from './SaleCancellation';
 
 /**
  * Venta (modelo-datos §3). pk `SALE#<saleId>` · sk `META` · 4 GSIs (`retailerId-soldAt-index`,
@@ -66,6 +67,8 @@ export interface Sale {
   cancelledAt: string | null;
   /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
   cancelReason: string | null;
+  /** Si la venta se puede cancelar hoy y, si no, por qué; solo lo trae el detalle del backoffice. */
+  cancellation?: SaleCancellation;
   /**
    * SNAPSHOT de identidad y contexto, congelado al cerrar la venta. NO se refresca: una venta es la
    * fotografía de un hecho, no la caché de un perfil. Si el cliente corrige su nombre, la venta

package/src/retailWizard/dtos/SaleCancellation.ts

@@ -0,0 +1,10 @@
+import type { SaleCancellationReasonEnum } from '../enums/SaleCancellationReasonEnum';
+
+/** Si la venta se puede cancelar hoy; el backend valida igual al cancelar. */
+export interface SaleCancellation {
+  allowed: boolean;
+  /** Ausente cuando `allowed` es true. */
+  reason?: SaleCancellationReasonEnum;
+  /** Fin de la ventana de cancelación voluntaria, ISO-8601. */
+  windowEndsAt?: string;
+}

package/src/retailWizard/enums/SaleCancellationReasonEnum.ts

@@ -0,0 +1,8 @@
+/** Por qué una venta no se puede cancelar; coincide con el `code` que respondería la cancelación. */
+export enum SaleCancellationReasonEnum {
+  SALE_ALREADY_CANCELLED = 'SALE_ALREADY_CANCELLED',
+  IMEI_NOT_RETURNABLE = 'IMEI_NOT_RETURNABLE',
+  CANCEL_WINDOW_EXPIRED = 'CANCEL_WINDOW_EXPIRED',
+  CREDIT_HAS_PAYMENTS = 'CREDIT_HAS_PAYMENTS',
+  CREDIT_NOT_CANCELLABLE = 'CREDIT_NOT_CANCELLABLE',
+}

package/src/retailWizard/index.ts

@@ -64,6 +64,8 @@ export * from './dtos/AccessorySaleLine';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';
+export * from './dtos/SaleCancellation';
+export * from './enums/SaleCancellationReasonEnum';
 export * from './dtos/Prospect';
 
 // Paginación genérica