@fiado/type-kit 3.213.0 → 3.215.0

package/bin/retailWizard/dtos/responses/SessionFinanciersResponse.d.ts

@@ -0,0 +1,26 @@
+import { FinancierTypeEnum } from '../../../loanOfferings/enums/FinancierTypeEnum';
+/**
+ * Una opción de financiamiento del paso 04 (pantalla forma de pago): la unión de las financieras
+ * ACTIVE del catálogo SOFOM (`loan-offerings GET /private/financiers/active` — display + orden)
+ * con la elegibilidad del producto reservado (`eligibleFinanciers` del catálogo retail).
+ */
+export interface SessionFinancierOption {
+    code: string;
+    name: string;
+    /** Texto de display de la card (viene del catálogo SOFOM). */
+    label: string;
+    /** INTERNAL = SureKeep (pista crédito propia); EXTERNAL = derivación (PayJoy, CrediYa…). */
+    type: FinancierTypeEnum;
+    displayOrder: number;
+    /** Solo EXTERNAL: URL de derivación. */
+    externalRedirectUrl: string | null;
+    /** El producto reservado admite esta financiera (INTERNAL siempre elegible). */
+    eligible: boolean;
+}
+/**
+ * GET /wizard/sessions/:id/financiers — las opciones de financiamiento del paso 04 para la sesión
+ * (según su producto reservado). Ordenadas por `displayOrder`. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SessionFinanciersResponse {
+    financiers: SessionFinancierOption[];
+}

package/bin/retailWizard/dtos/responses/SessionFinanciersResponse.js

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

package/bin/retailWizard/dtos/responses/SignatureSendOtpResponse.d.ts

@@ -0,0 +1,10 @@
+/**
+ * POST /wizard/sessions/:id/signature/send-otp — firma FES tiempo 1 (paso 08): loan-credit
+ * congela términos, genera los PDFs y despacha el OTP dedicado de firma (4 dígitos, 5 min) al
+ * teléfono del cliente vía messages-business. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SignatureSendOtpResponse {
+    otpSent: boolean;
+    /** Teléfono destino enmascarado para la pantalla (`****1234`) — nunca el número completo. */
+    otpDestinationMasked: string;
+}

package/bin/retailWizard/dtos/responses/SignatureSendOtpResponse.js

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

package/bin/retailWizard/dtos/responses/SignatureSignResponse.d.ts

@@ -0,0 +1,10 @@
+import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
+/**
+ * POST /wizard/sessions/:id/signature/sign — resultado de la firma FES tiempo 2 (paso 08).
+ * `signed: true` implica `checklist.contractSigned: true` (condición 2 de activación).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SignatureSignResponse {
+    signed: boolean;
+    checklist: ActivationChecklist;
+}

package/bin/retailWizard/dtos/responses/SignatureSignResponse.js

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

package/bin/retailWizard/index.d.ts

@@ -18,6 +18,8 @@ export * from './dtos/WizardWelcome';
 export * from './dtos/SalePaymentDetail';
 export * from './dtos/ProspectNewCustomer';
 export * from './dtos/WizardBeneficiary';
+export * from './dtos/WizardLoan';
+export * from './dtos/WizardCreditSummary';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';
@@ -49,7 +51,20 @@ export * from './dtos/requests/CreateProspectRequest';
 export * from './dtos/requests/UpdateProspectRequest';
 export * from './dtos/requests/MarkProspectLostRequest';
 export * from './dtos/requests/CancelSaleRequest';
+export * from './dtos/requests/QuoteRequest';
+export * from './dtos/requests/DownPaymentRequest';
+export * from './dtos/requests/SignatureSignRequest';
+export * from './dtos/requests/RegisterDeviceRequest';
 export * from './dtos/responses/KycPrepareResponse';
+export * from './dtos/responses/SessionFinanciersResponse';
+export * from './dtos/responses/ScoreConsultResponse';
+export * from './dtos/responses/ScoreResultResponse';
+export * from './dtos/responses/QuoteResponse';
+export * from './dtos/responses/DownPaymentResponse';
+export * from './dtos/responses/ContractPreviewResponse';
+export * from './dtos/responses/SignatureSendOtpResponse';
+export * from './dtos/responses/SignatureSignResponse';
+export * from './dtos/responses/RegisterDeviceResponse';
 export * from './events/SaleCompletedV1';
 export * from './events/SaleCancelledV1';
 export * from './events/SessionExpiredV1';

package/bin/retailWizard/index.js

@@ -36,6 +36,8 @@ __exportStar(require("./dtos/WizardWelcome"), exports);
 __exportStar(require("./dtos/SalePaymentDetail"), exports);
 __exportStar(require("./dtos/ProspectNewCustomer"), exports);
 __exportStar(require("./dtos/WizardBeneficiary"), exports);
+__exportStar(require("./dtos/WizardLoan"), exports);
+__exportStar(require("./dtos/WizardCreditSummary"), exports);
 // Entidades principales (shapes de estado/persistencia — planas)
 __exportStar(require("./dtos/WizardSession"), exports);
 __exportStar(require("./dtos/OtpVerification"), exports);
@@ -70,8 +72,21 @@ __exportStar(require("./dtos/requests/CreateProspectRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateProspectRequest"), exports);
 __exportStar(require("./dtos/requests/MarkProspectLostRequest"), exports);
 __exportStar(require("./dtos/requests/CancelSaleRequest"), exports);
+__exportStar(require("./dtos/requests/QuoteRequest"), exports);
+__exportStar(require("./dtos/requests/DownPaymentRequest"), exports);
+__exportStar(require("./dtos/requests/SignatureSignRequest"), exports);
+__exportStar(require("./dtos/requests/RegisterDeviceRequest"), exports);
 // Response DTOs (output tipado por endpoint)
 __exportStar(require("./dtos/responses/KycPrepareResponse"), exports);
+__exportStar(require("./dtos/responses/SessionFinanciersResponse"), exports);
+__exportStar(require("./dtos/responses/ScoreConsultResponse"), exports);
+__exportStar(require("./dtos/responses/ScoreResultResponse"), exports);
+__exportStar(require("./dtos/responses/QuoteResponse"), exports);
+__exportStar(require("./dtos/responses/DownPaymentResponse"), exports);
+__exportStar(require("./dtos/responses/ContractPreviewResponse"), exports);
+__exportStar(require("./dtos/responses/SignatureSendOtpResponse"), exports);
+__exportStar(require("./dtos/responses/SignatureSignResponse"), exports);
+__exportStar(require("./dtos/responses/RegisterDeviceResponse"), exports);
 // Contratos de eventos (PascalCase + sufijo V1)
 __exportStar(require("./events/SaleCompletedV1"), exports);
 __exportStar(require("./events/SaleCancelledV1"), exports);

package/package.json

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

package/src/kyc/dtos/KycAddress.ts

@@ -0,0 +1,46 @@
+import { Expose } from 'class-transformer';
+import { IsNumber, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Domicilio del INE ya normalizado por `places-business` (AWS Location), listo para que el consumidor
+ * arme su `AddressBase` local. Mapea el `AddressCandidate` de places a un shape con `@Expose`, porque
+ * el consumer parsea el evento con `excludeExtraneousValues` y descartaría todo campo sin exponer.
+ *
+ * Todos los campos son opcionales: el domicilio es best-effort (la OCR del INE + el geocoding pueden
+ * no resolver todo). ⚠️ PII: nunca loguear esta estructura.
+ */
+export class KycAddress {
+    /** Etiqueta completa legible (equivalente a Place.Label). */
+    @Expose() @IsOptional() @IsString()
+    label?: string;
+
+    @Expose() @IsOptional() @IsString()
+    street?: string;
+
+    /** Número exterior (Place.AddressNumber). */
+    @Expose() @IsOptional() @IsString()
+    addressNumber?: string;
+
+    @Expose() @IsOptional() @IsString()
+    neighborhood?: string;
+
+    @Expose() @IsOptional() @IsString()
+    municipality?: string;
+
+    /** Estado/provincia (Place.Region). */
+    @Expose() @IsOptional() @IsString()
+    region?: string;
+
+    @Expose() @IsOptional() @IsString()
+    postalCode?: string;
+
+    /** ISO3 del país (Place.Country). */
+    @Expose() @IsOptional() @IsString()
+    country?: string;
+
+    @Expose() @IsOptional() @IsNumber()
+    latitude?: number;
+
+    @Expose() @IsOptional() @IsNumber()
+    longitude?: number;
+}

package/src/kyc/events/KycVerificationChangedV1.ts

@@ -4,7 +4,7 @@ import { IdentificationDocumentStatus } from '../../identity/enums/Identificatio
 import { KycVerificationStatusEnum } from '../enums/KycVerificationStatusEnum';
 import { KycSubChecks } from '../dtos/KycSubChecks';
 import { KycPersonData } from '../dtos/responses/KycPersonData';
-import { AddressBase } from '../../address/dtos/AddressBase';
+import { KycAddress } from '../dtos/KycAddress';
 
 /**
  * Cambio terminal de una verificación KYC, tal como lo publica `kyc-metamap-webhook` directo en
@@ -74,10 +74,12 @@ export class KycVerificationChangedV1 {
     person?: KycPersonData;
 
     /**
-     * Domicilio del INE ya ESTRUCTURADO por `places-business` (paso 02e), listo para copiarse a
-     * `RetailCustomer.address` en el upsert. OPCIONAL y aditivo: el webhook lo puebla cuando la OCR trae
-     * domicilio y `places` resuelve; si no, el upsert corre sin dirección y se completa después. ⚠️ PII.
+     * Domicilio del INE ya normalizado por `places-business` (paso 02e). El webhook manda el resultado
+     * del geocoding (`KycAddress`); el CONSUMIDOR (wizard) arma con esto su `AddressBase` local, porque
+     * ese objeto lleva contexto de SureKeep (tenant, tipo) que el webhook no tiene. OPCIONAL y aditivo:
+     * si la OCR no trae domicilio o `places` no resuelve, viaja ausente y el upsert corre sin dirección.
+     * ⚠️ PII: nunca loguear.
      */
-    @Expose() @IsOptional() @ValidateNested() @Type(() => AddressBase)
-    address?: AddressBase;
+    @Expose() @IsOptional() @ValidateNested() @Type(() => KycAddress)
+    address?: KycAddress;
 }

package/src/kyc/index.ts

@@ -7,6 +7,9 @@ export * from './enums/KycWatchlistStatusEnum';
 // Sub-pasos descompuestos (SureKeep F2)
 export * from './dtos/KycSubChecks';
 
+// Domicilio del INE normalizado por places (SureKeep F2)
+export * from './dtos/KycAddress';
+
 // Response DTOs
 export * from './dtos/responses/KycPersonData';
 export * from './dtos/responses/KycByDirectoryResponse';

package/src/retailWizard/dtos/WizardCreditSummary.ts

@@ -0,0 +1,27 @@
+import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
+import { LoanCreditStatusEnum } from '../../loanCredit/enums/LoanCreditStatusEnum';
+
+/**
+ * Resumen financiero TRANSITORIO del crédito para las pantallas del wizard (06 cotización /
+ * 08 firma). Se arma en cada response desde `loan-credit GET|originate|quote` — NO se persiste
+ * en la sesión (regla punteros-no-datos del sub-objeto `loan`). Montos en cents; TNA decimal.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface WizardCreditSummary {
+    creditId: string;
+    status: LoanCreditStatusEnum;
+    planId: string;
+    termWeeks: number;
+    equipmentPriceCents: number;
+    downPaymentCents: number;
+    financedCapitalCents: number;
+    tnaAnnual: number;
+    /** Cuota semanal sin IVA (amortización francesa, constante). */
+    weeklyPaymentCents: number;
+    /** Cuota semanal con IVA — el número que ve el cliente. */
+    weeklyPaymentWithIvaCents: number;
+    totalInterestCents: number;
+    totalIvaCents: number;
+    totalToPayCents: number;
+    clientLevelAtOrigination?: ClientLevelEnum;
+}

package/src/retailWizard/dtos/WizardLoan.ts

@@ -0,0 +1,45 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString } from 'class-validator';
+import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
+
+/**
+ * Contexto de crédito de la sesión (`WizardSession.loan`) — pista SOFOM, pasos 04-09 del wizard.
+ *
+ * Guarda SOLO PUNTEROS al dominio loan-*: el detalle financiero (montos, cuota, checklist,
+ * estado) se lee de `loan-credit GET /private/credits/{creditId}`; la oferta/decisión del score
+ * de `loan-scoring GET /private/scoring/evaluations/{sciEvaluationId}`. Nunca denormalizar datos
+ * financieros acá (única excepción: `level`, para el chip de nivel sin refetch).
+ *
+ * `null` en ventas de contado/externa; se hidrata paso a paso solo en la venta a crédito.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export class WizardLoan {
+    /** Paso 04 — acreditado creado on-demand al elegir SureKeep (`POST /private/borrowers`). */
+    @Expose()
+    @IsString()
+    borrowerId!: string;
+
+    /** Paso 05 — snapshot inmutable de la evaluación SCI (`POST /private/scoring/evaluate`). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    sciEvaluationId?: string;
+
+    /** Paso 05 — nivel denormalizado (display del chip de nivel; el snapshot es la fuente). */
+    @Expose()
+    @IsOptional()
+    @IsEnum(ClientLevelEnum)
+    level?: ClientLevelEnum;
+
+    /** Paso 06 — plan del catálogo SOFOM resuelto por nivel (loan-offerings). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    planId?: string;
+
+    /** Paso 06 — crédito originado en `PENDING_ACTIVATION` (`POST /private/credits/originate`). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    creditId?: string;
+}

package/src/retailWizard/dtos/WizardSession.ts

@@ -5,6 +5,7 @@ import type { PaymentMethodEnum } from '../enums/PaymentMethodEnum';
 import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { OccupationEnum } from '../enums/OccupationEnum';
 import type { WizardConsents } from './WizardConsents';
+import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardWelcome } from './WizardWelcome';
 
@@ -55,6 +56,8 @@ export interface WizardSession {
   folio: string | null;
   payment: WizardPayment | null;
   welcome: WizardWelcome | null;
+  /** Contexto de crédito (pista SOFOM, pasos 04-09): PUNTEROS al dominio loan-*. Null en contado/externa. */
+  loan: WizardLoan | null;
   saleId: string | null;
   /** Prospecto vinculado (si la sesión se reanudó desde un prospecto): se cierra al cerrar la venta (D-prospecto). */
   prospectId: string | null;

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

@@ -0,0 +1,30 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, Min, ValidateNested } from 'class-validator';
+import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
+import { SalePaymentDetail } from '../SalePaymentDetail';
+
+/**
+ * POST /wizard/sessions/:id/down-payment — cobro del ENGANCHE de la venta a crédito (paso 07,
+ * pista SOFOM). Endpoint propio, separado del cobro de contado (`/payment`): acá la regla dura es
+ * `amountCents == downPaymentCents` del crédito (`loan-credit GET /credits/{id}`), NO el precio
+ * full. Idempotente por sesión. El folio `SK-…-ENG-…` lo genera el server (no viaja en el body).
+ * Al confirmar, el wizard marca la condición 1 del checklist (`activate-check { downPayment }`).
+ * SPEI: el vendedor captura el comprobante (`speiTrackingKey`+`senderClabe`) y avanza.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export class DownPaymentRequest {
+    @Expose()
+    @IsEnum(SalePaymentMethodEnum)
+    method!: SalePaymentMethodEnum;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    amountCents!: number;
+
+    @Expose()
+    @IsOptional()
+    @Type(() => SalePaymentDetail)
+    @ValidateNested()
+    detail?: SalePaymentDetail;
+}

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

@@ -0,0 +1,21 @@
+import { Expose } from 'class-transformer';
+import { IsInt, Min } from 'class-validator';
+
+/**
+ * POST /wizard/sessions/:id/quote — términos elegidos en el cotizador del paso 06 (slider de
+ * enganche + botones de plazo). El wizard valida contra los bounds del PLAN resuelto por nivel
+ * (`minDownPaymentPct`/`maxDownPaymentPct`/`termWeeksOptions`) y origina (o re-cotiza) el crédito
+ * en loan-credit. El precio del equipo NO viaja: es el ancla `reservedCashPriceCents` de la sesión.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export class QuoteRequest {
+    @Expose()
+    @IsInt()
+    @Min(0)
+    downPaymentCents!: number;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
+    termWeeks!: number;
+}

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

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches } from 'class-validator';
+
+/**
+ * POST /wizard/sessions/:id/device — registro del IMEI del equipo entregado (paso 09, variante
+ * crédito). El wizard valida el formato (15 dígitos); el Luhn y la unicidad (`IMEI_IN_USE`) los
+ * valida loan-credit en el `activate-check`, que además dispara el enrolamiento MDM (condiciones
+ * 3-4 del checklist). SureKeep Fase 2 — pista SOFOM.
+ */
+export class RegisterDeviceRequest {
+    @Expose()
+    @IsString()
+    @Matches(/^\d{15}$/, { message: 'imei debe ser de 15 dígitos' })
+    imei!: string;
+}

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

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches } from 'class-validator';
+
+/**
+ * POST /wizard/sessions/:id/signature/sign — firma FES tiempo 2 (paso 08): verifica el OTP de
+ * firma (4 dígitos — M2 §4.4) y firma los contratos en loan-credit (sha256 + `signedAt` +
+ * condición 2 del checklist). Errores: `OTP_INVALID` · `OTP_EXPIRED` · `OTP_MAX_ATTEMPTS`.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export class SignatureSignRequest {
+    @Expose()
+    @IsString()
+    @Matches(/^\d{4}$/, { message: 'otpCode debe ser de 4 dígitos' })
+    otpCode!: string;
+}

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

@@ -0,0 +1,13 @@
+import { WizardCreditSummary } from '../WizardCreditSummary';
+
+/**
+ * GET /wizard/sessions/:id/contract/preview — resumen previo a la firma FES (paso 08): el estado
+ * financiero del crédito (fuente: loan-credit) + las variables del template del contrato que el
+ * wizard armará para el sign tiempo-1 (`contractData`: nombre, CURP, domicilio… — PII TRANSITORIA,
+ * viaja solo en esta response, NO se persiste ni loggea). El PDF real lo genera el sign tiempo-1
+ * en loan-credit; este preview no llama a document-generator. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface ContractPreviewResponse {
+    credit: WizardCreditSummary;
+    contractData: Record<string, string>;
+}

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

@@ -0,0 +1,15 @@
+import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
+
+/**
+ * POST /wizard/sessions/:id/down-payment — confirmación del cobro del enganche (paso 07).
+ * `paymentId` = el folio de enganche `SK-…-ENG-…` (identificador natural del cobro en caja;
+ * concilia contra el depósito semanal del retailer). `checklist` refleja el estado post
+ * `activate-check { downPayment: true }` en loan-credit. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface DownPaymentResponse {
+    paymentId: string;
+    folio: string;
+    /** ISO 8601 del registro del cobro en la sesión. */
+    registeredAt: string;
+    checklist: ActivationChecklist;
+}

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

@@ -0,0 +1,25 @@
+import { WizardCreditSummary } from '../WizardCreditSummary';
+
+/** Bounds y parámetros del plan que gobiernan el cotizador (slider + plazos) del paso 06. */
+export interface QuotePlanBounds {
+    planId: string;
+    code: string;
+    /** Enganche mínimo como decimal sobre 1 (`0.40` = 40%). */
+    minDownPaymentPct: number;
+    /** Techo de enganche (decimal sobre 1); `null` = sin techo definido. */
+    maxDownPaymentPct: number | null;
+    termWeeksOptions: number[];
+    /** TNA decimal (`2.60` = 260%) — la tasa que manda es la del PLAN. */
+    tnaAnnual: number;
+    openingCommissionPct: number;
+}
+
+/**
+ * POST /wizard/sessions/:id/quote — respuesta del cotizador del paso 06: el plan resuelto por
+ * nivel + el snapshot financiero del crédito originado/re-cotizado (transitorio, NO se persiste
+ * en la sesión — la fuente es loan-credit). SureKeep Fase 2 — pista SOFOM.
+ */
+export interface QuoteResponse {
+    plan: QuotePlanBounds;
+    credit: WizardCreditSummary;
+}

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

@@ -0,0 +1,15 @@
+import { LoanCreditStatusEnum } from '../../../loanCredit/enums/LoanCreditStatusEnum';
+import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
+
+/**
+ * POST /wizard/sessions/:id/device — resultado del registro de IMEI + candado (paso 09).
+ * `active: true` cuando el checklist quedó 4/4 y el crédito pasó a `ACTIVE` (el front bloquea
+ * "Continuar a Bienvenida" hasta entonces; `missingItems` lista lo que falta).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface RegisterDeviceResponse {
+    creditStatus: LoanCreditStatusEnum;
+    checklist: ActivationChecklist;
+    missingItems: string[];
+    active: boolean;
+}

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

@@ -0,0 +1,21 @@
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../../loanScoring/enums/ScoringDecisionEnum';
+import { ScoringOffer } from '../../../loanScoring/dtos/ScoringOffer';
+
+/**
+ * POST /wizard/sessions/:id/score/consult — resultado de la evaluación SCI del paso 05.
+ *
+ * El wizard es idempotente por sesión: si la sesión ya tiene `loan.sciEvaluationId`, devuelve el
+ * snapshot existente (no re-evalúa — cada evaluate del motor genera un snapshot NUEVO).
+ * `REJECTED`/`NO_ELIGIBLE` no matan la venta: el front ofrece financiera externa o contado.
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface ScoreConsultResponse {
+    /** Decisión normalizada del motor de scoring. */
+    status: ScoringDecisionEnum;
+    level: ClientLevelEnum;
+    /** Puntero al snapshot inmutable en loan-scoring (se persiste en `WizardSession.loan`). */
+    sciEvaluationId: string;
+    /** Oferta del proveedor (display del paso 05; la cotización del 06 usa el PLAN, no esto). */
+    offer: ScoringOffer | null;
+}

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

@@ -0,0 +1,15 @@
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../../loanScoring/enums/ScoringDecisionEnum';
+import { ScoringOffer } from '../../../loanScoring/dtos/ScoringOffer';
+
+/**
+ * GET /wizard/sessions/:id/score/result — lectura del resultado del score del paso 05 (la tablet
+ * lee el snapshot ya persistido vía `loan.sciEvaluationId`; no dispara evaluación).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface ScoreResultResponse {
+    status: ScoringDecisionEnum;
+    level: ClientLevelEnum;
+    sciEvaluationId: string;
+    offer: ScoringOffer | null;
+}

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

@@ -0,0 +1,28 @@
+import { FinancierTypeEnum } from '../../../loanOfferings/enums/FinancierTypeEnum';
+
+/**
+ * Una opción de financiamiento del paso 04 (pantalla forma de pago): la unión de las financieras
+ * ACTIVE del catálogo SOFOM (`loan-offerings GET /private/financiers/active` — display + orden)
+ * con la elegibilidad del producto reservado (`eligibleFinanciers` del catálogo retail).
+ */
+export interface SessionFinancierOption {
+    code: string;
+    name: string;
+    /** Texto de display de la card (viene del catálogo SOFOM). */
+    label: string;
+    /** INTERNAL = SureKeep (pista crédito propia); EXTERNAL = derivación (PayJoy, CrediYa…). */
+    type: FinancierTypeEnum;
+    displayOrder: number;
+    /** Solo EXTERNAL: URL de derivación. */
+    externalRedirectUrl: string | null;
+    /** El producto reservado admite esta financiera (INTERNAL siempre elegible). */
+    eligible: boolean;
+}
+
+/**
+ * GET /wizard/sessions/:id/financiers — las opciones de financiamiento del paso 04 para la sesión
+ * (según su producto reservado). Ordenadas por `displayOrder`. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SessionFinanciersResponse {
+    financiers: SessionFinancierOption[];
+}

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

@@ -0,0 +1,10 @@
+/**
+ * POST /wizard/sessions/:id/signature/send-otp — firma FES tiempo 1 (paso 08): loan-credit
+ * congela términos, genera los PDFs y despacha el OTP dedicado de firma (4 dígitos, 5 min) al
+ * teléfono del cliente vía messages-business. SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SignatureSendOtpResponse {
+    otpSent: boolean;
+    /** Teléfono destino enmascarado para la pantalla (`****1234`) — nunca el número completo. */
+    otpDestinationMasked: string;
+}

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

@@ -0,0 +1,11 @@
+import { ActivationChecklist } from '../../../loanCredit/dtos/ActivationChecklist';
+
+/**
+ * POST /wizard/sessions/:id/signature/sign — resultado de la firma FES tiempo 2 (paso 08).
+ * `signed: true` implica `checklist.contractSigned: true` (condición 2 de activación).
+ * SureKeep Fase 2 — pista SOFOM.
+ */
+export interface SignatureSignResponse {
+    signed: boolean;
+    checklist: ActivationChecklist;
+}

package/src/retailWizard/index.ts

@@ -21,6 +21,8 @@ export * from './dtos/WizardWelcome';
 export * from './dtos/SalePaymentDetail';
 export * from './dtos/ProspectNewCustomer';
 export * from './dtos/WizardBeneficiary';
+export * from './dtos/WizardLoan';
+export * from './dtos/WizardCreditSummary';
 
 // Entidades principales (shapes de estado/persistencia — planas)
 export * from './dtos/WizardSession';
@@ -58,9 +60,22 @@ export * from './dtos/requests/CreateProspectRequest';
 export * from './dtos/requests/UpdateProspectRequest';
 export * from './dtos/requests/MarkProspectLostRequest';
 export * from './dtos/requests/CancelSaleRequest';
+export * from './dtos/requests/QuoteRequest';
+export * from './dtos/requests/DownPaymentRequest';
+export * from './dtos/requests/SignatureSignRequest';
+export * from './dtos/requests/RegisterDeviceRequest';
 
 // Response DTOs (output tipado por endpoint)
 export * from './dtos/responses/KycPrepareResponse';
+export * from './dtos/responses/SessionFinanciersResponse';
+export * from './dtos/responses/ScoreConsultResponse';
+export * from './dtos/responses/ScoreResultResponse';
+export * from './dtos/responses/QuoteResponse';
+export * from './dtos/responses/DownPaymentResponse';
+export * from './dtos/responses/ContractPreviewResponse';
+export * from './dtos/responses/SignatureSendOtpResponse';
+export * from './dtos/responses/SignatureSignResponse';
+export * from './dtos/responses/RegisterDeviceResponse';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/SaleCompletedV1';