@fiado/type-kit 3.185.0 → 3.187.0

package/bin/loanOfferings/enums/ProductTierEnum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductTierEnum = void 0;
+/**
+ * Gama del equipo (modelo-datos §4.1 `RetailProduct.tier` · §6.1 `eligibleTiers`).
+ *
+ * NOTA (supuesto F1): conceptualmente esta gama pertenece al dominio de catálogo retail
+ * (`retail-catalog-business`), cuyo dominio type-kit aún no existe. Se define aquí para poder
+ * tipar `CreditPlan.eligibleTiers` y `Financier.eligibleTiers` sin bloquear. Al publicarse el
+ * dominio `retailCatalog`, consolidar allí y reexportar (coordinar con la pista Retail).
+ * @enum {string}
+ */
+var ProductTierEnum;
+(function (ProductTierEnum) {
+    ProductTierEnum["LOW"] = "LOW";
+    ProductTierEnum["MID"] = "MID";
+    ProductTierEnum["HIGH"] = "HIGH";
+    ProductTierEnum["PREMIUM"] = "PREMIUM";
+})(ProductTierEnum || (exports.ProductTierEnum = ProductTierEnum = {}));

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

@@ -0,0 +1,13 @@
+/**
+ * Tipo de venta al que aplica un plan de crédito (M6 §4 · modelo-datos §6.1).
+ * Un plan puede configurarse para uno o más tipos (por eso `CreditPlan.saleTypes` es array).
+ * @enum {string}
+ */
+export declare enum SaleTypeEnum {
+    /** Cliente sin historial previo con SureKeep (primera compra). */
+    NEW = "NEW",
+    /** Cliente que ya tuvo un crédito con SureKeep (recompra / renovación). */
+    REPURCHASE = "REPURCHASE",
+    /** Empleado de VentasLuga que compra para uso personal (condiciones preferenciales). */
+    EMPLOYEE = "EMPLOYEE"
+}

package/bin/loanOfferings/enums/SaleTypeEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleTypeEnum = void 0;
+/**
+ * Tipo de venta al que aplica un plan de crédito (M6 §4 · modelo-datos §6.1).
+ * Un plan puede configurarse para uno o más tipos (por eso `CreditPlan.saleTypes` es array).
+ * @enum {string}
+ */
+var SaleTypeEnum;
+(function (SaleTypeEnum) {
+    /** Cliente sin historial previo con SureKeep (primera compra). */
+    SaleTypeEnum["NEW"] = "NEW";
+    /** Cliente que ya tuvo un crédito con SureKeep (recompra / renovación). */
+    SaleTypeEnum["REPURCHASE"] = "REPURCHASE";
+    /** Empleado de VentasLuga que compra para uso personal (condiciones preferenciales). */
+    SaleTypeEnum["EMPLOYEE"] = "EMPLOYEE";
+})(SaleTypeEnum || (exports.SaleTypeEnum = SaleTypeEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -0,0 +1,21 @@
+export * from './enums/CreditPlanLevelEnum';
+export * from './enums/SaleTypeEnum';
+export * from './enums/ProductTierEnum';
+export * from './enums/CreditPlanStatusEnum';
+export * from './enums/FinancierTypeEnum';
+export * from './enums/FinancierStatusEnum';
+export * from './dtos/CreditPlan';
+export * from './dtos/Financier';
+export * from './dtos/RetailerCreditPlan';
+export * from './dtos/requests/CreateCreditPlanRequest';
+export * from './dtos/requests/UpdateCreditPlanRequest';
+export * from './dtos/requests/ChangeCreditPlanStatusRequest';
+export * from './dtos/requests/SimulateCreditPlanRequest';
+export * from './dtos/requests/CreateFinancierRequest';
+export * from './dtos/requests/UpdateFinancierRequest';
+export * from './dtos/requests/ChangeFinancierStatusRequest';
+export * from './dtos/requests/ReorderFinancierRequest';
+export * from './dtos/responses/CreditPlanResponse';
+export * from './dtos/responses/FinancierResponse';
+export * from './dtos/responses/RetailerCreditPlanResponse';
+export * from './dtos/responses/SimulationResultResponse';

package/bin/loanOfferings/index.js

@@ -0,0 +1,41 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Enums
+__exportStar(require("./enums/CreditPlanLevelEnum"), exports);
+__exportStar(require("./enums/SaleTypeEnum"), exports);
+__exportStar(require("./enums/ProductTierEnum"), exports);
+__exportStar(require("./enums/CreditPlanStatusEnum"), exports);
+__exportStar(require("./enums/FinancierTypeEnum"), exports);
+__exportStar(require("./enums/FinancierStatusEnum"), exports);
+// Entity DTOs
+__exportStar(require("./dtos/CreditPlan"), exports);
+__exportStar(require("./dtos/Financier"), exports);
+__exportStar(require("./dtos/RetailerCreditPlan"), exports);
+// Request DTOs
+__exportStar(require("./dtos/requests/CreateCreditPlanRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateCreditPlanRequest"), exports);
+__exportStar(require("./dtos/requests/ChangeCreditPlanStatusRequest"), exports);
+__exportStar(require("./dtos/requests/SimulateCreditPlanRequest"), exports);
+__exportStar(require("./dtos/requests/CreateFinancierRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateFinancierRequest"), exports);
+__exportStar(require("./dtos/requests/ChangeFinancierStatusRequest"), exports);
+__exportStar(require("./dtos/requests/ReorderFinancierRequest"), exports);
+// Response DTOs
+__exportStar(require("./dtos/responses/CreditPlanResponse"), exports);
+__exportStar(require("./dtos/responses/FinancierResponse"), exports);
+__exportStar(require("./dtos/responses/RetailerCreditPlanResponse"), exports);
+__exportStar(require("./dtos/responses/SimulationResultResponse"), exports);

package/package.json

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

package/src/index.ts

@@ -105,5 +105,11 @@ export * as EmailVerification from './emailVerification';
 export * as RetailOrg from './retailOrg';
 // LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
 export * as LoanConfig from './loanConfig';
+// LoanOfferings: DTOs/enums del lambda loan-offerings-business (comp 07 — planes de crédito,
+// financieras, M:N retailer↔plan y simulador de cuota; SureKeep Fase 1 — pista Loan).
+export * as LoanOfferings from './loanOfferings';
+// LoanCollectorAssignment: DTOs/enums del lambda loan-collector-assignment-business (comp 08 — reglas de
+// asignación de cartera de cobranza + asignaciones crédito↔cobrador; SureKeep Fase 1 — pista Loan).
+export * as LoanCollectorAssignment from './loanCollectorAssignment';
 export * from './messaging';
 export * from './complaint';

package/src/loanCollectorAssignment/dtos/PriorityWeights.ts

@@ -0,0 +1,27 @@
+import { Expose } from 'class-transformer';
+import { IsInt, Max, Min } from 'class-validator';
+
+/**
+ * Pesos del ranking ponderado del algoritmo (modelo-datos §7.1). Cada peso es 0..100; la regla
+ * cross-campo `storeMatch + loadAvailable + seniority === 100` la valida el manager del lambda
+ * (WeightsSumInvalidError) — class-validator no cubre validaciones entre campos.
+ */
+export class PriorityWeights {
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    storeMatch!: number;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    loadAvailable!: number;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    seniority!: number;
+}

package/src/loanCollectorAssignment/dtos/requests/AutoAssignRequest.ts

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/**
+ * Body de POST /private/collector-assignments/auto-assign (hot path). Lo invoca loan-credit-business
+ * al crearse un crédito (F3+); en F1 se prueba con `creditId` dummy. Elige cobrador y persiste ACTIVE.
+ */
+export class AutoAssignRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    creditId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+}

package/src/loanCollectorAssignment/dtos/requests/CreateAssignmentRuleRequest.ts

@@ -0,0 +1,29 @@
+import { Expose, Type } from 'class-transformer';
+import { IsBoolean, IsEnum, IsInt, IsOptional, Min, ValidateNested } from 'class-validator';
+import { AssignmentStrategyEnum } from '../../enums/AssignmentStrategyEnum';
+import { PriorityWeights } from '../PriorityWeights';
+
+/**
+ * Body de POST /retailers/:retailerId/assignment-rules. Crea una regla de asignación.
+ * Los pesos deben sumar 100 (lo valida el manager). `active: true` desactiva la regla activa anterior.
+ */
+export class CreateAssignmentRuleRequest {
+    @Expose()
+    @IsEnum(AssignmentStrategyEnum)
+    strategy!: AssignmentStrategyEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    maxLoadPerCollector?: number | null;
+
+    @Expose()
+    @ValidateNested()
+    @Type(() => PriorityWeights)
+    priorityWeights!: PriorityWeights;
+
+    @Expose()
+    @IsBoolean()
+    active!: boolean;
+}

package/src/loanCollectorAssignment/dtos/requests/ReassignRequest.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/**
+ * Body de POST /retailers/:retailerId/collector-assignments/:assignmentId/reassign (reasignación manual).
+ * `reason` obligatorio (auditoría de acción crítica — modelo-datos §10).
+ */
+export class ReassignRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    reason!: string;
+}

package/src/loanCollectorAssignment/dtos/requests/RedistributeRequest.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/**
+ * Body de POST /retailers/:retailerId/collectors/:userId/redistribute. Redistribuye la cartera activa de
+ * un cobrador (ej. al desactivarlo). `reason` obligatorio (ej. `USER_INACTIVATED`) — auditoría §10.
+ */
+export class RedistributeRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    reason!: string;
+}

package/src/loanCollectorAssignment/dtos/requests/UpdateAssignmentRuleRequest.ts

@@ -0,0 +1,32 @@
+import { Expose, Type } from 'class-transformer';
+import { IsBoolean, IsEnum, IsInt, IsOptional, Min, ValidateNested } from 'class-validator';
+import { AssignmentStrategyEnum } from '../../enums/AssignmentStrategyEnum';
+import { PriorityWeights } from '../PriorityWeights';
+
+/**
+ * Body de PUT /retailers/:retailerId/assignment-rules/:ruleId. Update parcial: todos los campos opcionales.
+ * Si se envían `priorityWeights`, deben sumar 100 (lo valida el manager).
+ */
+export class UpdateAssignmentRuleRequest {
+    @Expose()
+    @IsOptional()
+    @IsEnum(AssignmentStrategyEnum)
+    strategy?: AssignmentStrategyEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    maxLoadPerCollector?: number | null;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => PriorityWeights)
+    priorityWeights?: PriorityWeights;
+
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    active?: boolean;
+}

package/src/loanCollectorAssignment/dtos/responses/AssignmentRuleResponse.ts

@@ -0,0 +1,16 @@
+import { AssignmentStrategyEnum } from '../../enums/AssignmentStrategyEnum';
+import { PriorityWeights } from '../PriorityWeights';
+
+/** Shape de salida de una regla de asignación (modelo-datos §7.1). */
+export interface AssignmentRuleResponse {
+    ruleId: string;
+    retailerId: string;
+    strategy: AssignmentStrategyEnum;
+    maxLoadPerCollector: number | null;
+    priorityWeights: PriorityWeights;
+    active: boolean;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/src/loanCollectorAssignment/dtos/responses/CollectorAssignmentResponse.ts

@@ -0,0 +1,17 @@
+import { AssignmentStatusEnum } from '../../enums/AssignmentStatusEnum';
+
+/** Shape de salida de una asignación crédito↔cobrador (modelo-datos §7.2). */
+export interface CollectorAssignmentResponse {
+    assignmentId: string;
+    retailerId: string;
+    creditId: string;
+    storeId: string;
+    collectorUserId: string;
+    assignedAt: string;
+    status: AssignmentStatusEnum;
+    reassignedFromUserId: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/src/loanCollectorAssignment/dtos/responses/CollectorLoadResponse.ts

@@ -0,0 +1,11 @@
+/**
+ * Carga actual de un cobrador (flow 07.2 / GET /retailers/:retailerId/collector-loads).
+ * `activeAssignments` = COUNT de asignaciones ACTIVE (GSI collectorUserId-assignedAt-index).
+ * `threshold` = maxLoadPerCollector de la regla activa (null si no hay tope).
+ */
+export interface CollectorLoadResponse {
+    collectorUserId: string;
+    activeAssignments: number;
+    threshold: number | null;
+    storeIds: string[];
+}

package/src/loanCollectorAssignment/dtos/responses/RedistributeSummaryResponse.ts

@@ -0,0 +1,10 @@
+/** Resultado de redistribuir la cartera activa de un cobrador (flow 07.4). */
+export interface RedistributeSummaryResponse {
+    reassignedCount: number;
+    errors: RedistributeError[];
+}
+
+export interface RedistributeError {
+    creditId: string;
+    reason: string;
+}

package/src/loanCollectorAssignment/enums/AssignmentStatusEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Estado de una asignación crédito↔cobrador (modelo-datos §7.2). Historial append-only:
+ * 1 crédito = 1 `ACTIVE`; reasignación → row vieja `REASSIGNED`; release/liquidado → `INACTIVE`.
+ * @enum {string}
+ */
+export enum AssignmentStatusEnum {
+    ACTIVE = 'ACTIVE',
+    INACTIVE = 'INACTIVE',
+    REASSIGNED = 'REASSIGNED',
+}

package/src/loanCollectorAssignment/enums/AssignmentStrategyEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Estrategia de asignación de cartera de cobranza (modelo-datos §7.1 / M6 §7.5).
+ * DEC-008 (loan-collector-assignment): se soportan las 4 + ranking híbrido (strategy + priorityWeights).
+ * A RATIFICAR con Jaime/senior: M6 §7.5 solo respalda 3 — `ROUND_ROBIN` es adición del spec 08.
+ * @enum {string}
+ */
+export enum AssignmentStrategyEnum {
+    BY_STORE = 'BY_STORE',
+    BY_LOAD = 'BY_LOAD',
+    BY_SENIORITY = 'BY_SENIORITY',
+    ROUND_ROBIN = 'ROUND_ROBIN',
+}

package/src/loanCollectorAssignment/index.ts

@@ -0,0 +1,19 @@
+// Enums
+export * from './enums/AssignmentStrategyEnum';
+export * from './enums/AssignmentStatusEnum';
+
+// Shared DTOs
+export * from './dtos/PriorityWeights';
+
+// Request DTOs
+export * from './dtos/requests/CreateAssignmentRuleRequest';
+export * from './dtos/requests/UpdateAssignmentRuleRequest';
+export * from './dtos/requests/AutoAssignRequest';
+export * from './dtos/requests/ReassignRequest';
+export * from './dtos/requests/RedistributeRequest';
+
+// Response DTOs
+export * from './dtos/responses/AssignmentRuleResponse';
+export * from './dtos/responses/CollectorAssignmentResponse';
+export * from './dtos/responses/CollectorLoadResponse';
+export * from './dtos/responses/RedistributeSummaryResponse';

package/src/loanOfferings/dtos/CreditPlan.ts

@@ -0,0 +1,171 @@
+import { Expose } from 'class-transformer';
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsInt,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Matches,
+    Max,
+    Min,
+} 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';
+
+/**
+ * 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).
+ *
+ * Convenciones: montos en **cents** (entero); porcentajes **decimal sobre 1** (`0.40` = 40%);
+ * TNA decimal (`2.60` = 260%). El PLAN es dueño de los umbrales SCI por nivel
+ * (`minSciScore`/`maxSciScore`, resolución 2026-07-15) y del techo de enganche `maxDownPaymentPct`.
+ */
+export class CreditPlan {
+    @Expose()
+    @IsString()
+    planId!: string;
+
+    /** Código único por tenant: `BRONZE_NEW` | `SILVER_NEW` | `GOLD_NEW` | `EMPLOYEE`. */
+    @Expose()
+    @IsString()
+    code!: string;
+
+    @Expose()
+    @IsString()
+    name!: string;
+
+    @Expose()
+    @IsString()
+    description!: string;
+
+    @Expose()
+    @IsEnum(CreditPlanLevelEnum)
+    level!: CreditPlanLevelEnum;
+
+    /** Array: un plan puede aplicar a varios tipos de venta (M6 §4). */
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsEnum(SaleTypeEnum, { each: true })
+    saleTypes!: SaleTypeEnum[];
+
+    /** Gamas elegibles del plan; `null` = todas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductTierEnum, { each: true })
+    eligibleTiers!: ProductTierEnum[] | null;
+
+    /** Enganche MÍNIMO como decimal sobre 1 (`0.40` = 40%). */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    minDownPaymentPct!: number;
+
+    /** Techo de enganche (decimal sobre 1); `null` = sin techo definido (F1: TBD). */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    maxDownPaymentPct!: number | null;
+
+    /** Plazos válidos en semanas (subconjunto del catálogo maestro). */
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsInt({ each: true })
+    @Min(1, { each: true })
+    termWeeksOptions!: number[];
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    maxFinancedAmountCents!: number;
+
+    /** Tasa Nominal Anual como decimal (`2.60` = 260%); rango de negocio [2.00, 2.60]. */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    tnaAnnual!: number;
+
+    /** IVA sobre intereses (decimal); fijo `0.16` en México. */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    ivaOnInterest!: number;
+
+    /** Comisión de apertura (decimal sobre 1); default `0`. */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    openingCommissionPct!: number;
+
+    /** Corrimiento de cuotas al pagar fuera de fecha (M6 §4 "Corrimiento"). */
+    @Expose()
+    @IsBoolean()
+    paymentShift!: boolean;
+
+    /** Cota inferior del rango SCI del nivel (0-100); `null` mientras TBD. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    minSciScore!: number | null;
+
+    /** Cota superior del rango SCI del nivel (0-100); `null` mientras TBD. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    maxSciScore!: number | null;
+
+    /** Versión del plan; incrementa en cada publicación de cambios. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    version!: number;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    validFrom!: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    validUntil!: string | null;
+
+    @Expose()
+    @IsEnum(CreditPlanStatusEnum)
+    status!: CreditPlanStatusEnum;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })
+    createdAt!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
+    updatedAt!: string;
+}

package/src/loanOfferings/dtos/Financier.ts

@@ -0,0 +1,91 @@
+import { Expose } from 'class-transformer';
+import {
+    IsArray,
+    IsEnum,
+    IsInt,
+    IsObject,
+    IsOptional,
+    IsString,
+    Matches,
+    Min,
+} from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { FinancierStatusEnum } from '../enums/FinancierStatusEnum';
+import { FinancierTypeEnum } from '../enums/FinancierTypeEnum';
+import { ProductTierEnum } from '../enums/ProductTierEnum';
+
+/**
+ * Financier — financiera del catálogo mostrado al cliente (modelo-datos §6.3 · M6 §6).
+ * Entidad completa del dominio `loan-offerings-business` (SureKeep Fase 1 — pista Loan).
+ * SureKeep (INTERNAL) va primero (`displayOrder=1`); las externas después.
+ */
+export class Financier {
+    @Expose()
+    @IsString()
+    financierId!: string;
+
+    /** Grafía canónica: `SUREKEEP` | `PAYJOY` | `KREDIYA` | `LESPAGO`. */
+    @Expose()
+    @IsString()
+    code!: string;
+
+    @Expose()
+    @IsString()
+    name!: string;
+
+    @Expose()
+    @IsEnum(FinancierTypeEnum)
+    type!: FinancierTypeEnum;
+
+    /** Orden de presentación en el wizard (M1 paso 4). Reorder renumera. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    displayOrder!: number;
+
+    /** Texto mostrado en el wizard (ej. "RECOMENDADO"). */
+    @Expose()
+    @IsString()
+    label!: string;
+
+    /** Solo EXTERNAL: URL de derivación; `null` para INTERNAL. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    externalRedirectUrl!: string | null;
+
+    /** Gamas que la financiera acepta por defecto; `null` = todas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsEnum(ProductTierEnum, { each: true })
+    eligibleTiers!: ProductTierEnum[] | null;
+
+    /** Configuración específica por financiera; `null` si no aplica. */
+    @Expose()
+    @IsOptional()
+    @IsObject()
+    config!: Record<string, unknown> | null;
+
+    @Expose()
+    @IsEnum(FinancierStatusEnum)
+    status!: FinancierStatusEnum;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })
+    createdAt!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
+    updatedAt!: string;
+}