@fiado/type-kit 3.460.0 → 3.462.0

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

@@ -0,0 +1,5 @@
+/** Identificadores (IMEI o serie) capturados para un SKU de la línea; un producto suelto es un solo SKU. */
+export interface WizardLineIdentifiers {
+    sku: string;
+    identifiers: string[];
+}

package/bin/retailWizard/dtos/WizardLineIdentifiers.js

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

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

@@ -0,0 +1,15 @@
+import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
+import type { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
+import type { TrackingModeEnum } from '../../retailCatalog/enums/TrackingModeEnum';
+/** Ficha comercial de una línea, congelada al reservar para pintarla sin volver al catálogo. */
+export interface WizardLineProduct {
+    brand: string;
+    model: string;
+    capacity: string | null;
+    color: string | null;
+    imageUrl: string | null;
+    /** `null` = Sin gama. */
+    tier: ProductTierEnum | null;
+    category: ProductCategoryEnum;
+    trackingMode: TrackingModeEnum;
+}

package/bin/retailWizard/dtos/WizardLineProduct.js

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

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

@@ -1,3 +1,5 @@
+import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
+import type { TrackingModeEnum } from '../../retailCatalog/enums/TrackingModeEnum';
 /**
  * Ficha COMERCIAL del equipo reservado, congelada en la sesión al momento de reservarlo (S03).
  *
@@ -38,4 +40,8 @@ export interface WizardProduct {
      * Mismo nombre que en `retail-catalog`: es su dato, no se renombra al cruzar la frontera.
      */
     eligibleFinanciers: string[];
+    /** Línea de `reservedLines` que espeja esta ficha. */
+    lineId?: string;
+    category?: ProductCategoryEnum;
+    trackingMode?: TrackingModeEnum;
 }

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

@@ -0,0 +1,35 @@
+import type { MdmProviderEnum } from '../../retailCatalog/enums/MdmProviderEnum';
+import type { ReservedComponent } from '../../retailCatalog/dtos/responses/ReserveStockResponse';
+import type { LinePaymentTypeEnum } from '../enums/LinePaymentTypeEnum';
+import type { WizardLineStatusEnum } from '../enums/WizardLineStatusEnum';
+import type { WizardLineIdentifiers } from './WizardLineIdentifiers';
+import type { WizardLineProduct } from './WizardLineProduct';
+/** Línea de la venta en curso; los campos de precio son `null` mientras la línea está PENDING. */
+export interface WizardReservedLine {
+    lineId: string;
+    sku: string;
+    qty: number;
+    status: WizardLineStatusEnum;
+    /** Llave de idempotencia de la reserva; una nueva por cada intento. */
+    reservationId: string;
+    /** Vencimiento de la reserva; una línea PENDING nace con ahora + 30 min. */
+    expiresAt: string;
+    /** Precio fijado de la línea (el del kit si es kit). */
+    basePriceCents: number | null;
+    listPriceCents: number | null;
+    /** Llave del registro PRICE# del que salió el precio. */
+    priceSk: string | null;
+    eligibleFinanciers: string[];
+    /** SureKeep está en `eligibleFinanciers`. */
+    financeable: boolean;
+    /** `null` mientras no se decide qué línea se financia. */
+    paymentType: LinePaymentTypeEnum | null;
+    /** Ítems que la línea suma al tope de 100 de la venta. */
+    sellItemCost: number | null;
+    mdmEnabled?: boolean;
+    mdmProvider?: MdmProviderEnum | null;
+    /** Solo si la línea es un kit. */
+    components?: ReservedComponent[];
+    identifiers?: WizardLineIdentifiers[];
+    product?: WizardLineProduct | null;
+}

package/bin/retailWizard/dtos/WizardReservedLine.js

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

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

@@ -9,6 +9,7 @@ import type { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardProduct } from './WizardProduct';
+import type { WizardReservedLine } from './WizardReservedLine';
 import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 /** Modalidad de captura del KYC (M1 §213-329). */
@@ -108,6 +109,10 @@ export interface WizardSession {
      */
     product: WizardProduct | null;
     reservationExpiresAt: string | null;
+    /** Líneas de la venta; `reservedSku`, `reservedImei` y `product` espejan la financiada o la principal. */
+    reservedLines?: WizardReservedLine[];
+    /** Línea elegida para financiar; `null` si la venta es de contado o aún no se elige. */
+    financedLineId?: string | null;
     paymentMethod: PaymentMethodEnum | null;
     externalProvider: ExternalProviderEnum | null;
     /** Folio de cobro server-side (D11), idempotente, sobrevive al volver atrás. */

package/bin/retailWizard/dtos/requests/AddProductRequest.d.ts

@@ -1,15 +1,11 @@
 /**
- * POST /wizard/sessions/:id/product — reserva un equipo del catálogo (paso 03). Reserva 30 min en
- * RetailInventory F1 (condición atómica H2).
- *
- * `imei` y `cashPriceCents` son OPCIONALES a propósito: la unidad física y el precio son AUTORIDAD DEL
- * SERVIDOR. Con solo el `sku`, el wizard elige una unidad disponible del catálogo y toma su precio (el
- * cliente NUNCA dicta el monto a cobrar — `cashPriceCents` ancla el cobro con `amountCents == cashPrice`).
- * Si el caller manda `imei`, el server puede honrar esa unidad, pero el precio SIEMPRE sale del catálogo.
- * SureKeep Fase 2 — pista Retail.
+ * POST /wizard/sessions/:id/product — agrega una línea a la venta y reserva sus piezas en el catálogo.
+ * `imei` y `cashPriceCents` son opcionales: la pieza y el precio los decide el servidor.
  */
 export declare class AddProductRequest {
     sku: string;
     imei?: string;
     cashPriceCents?: number;
+    /** Piezas de la línea; ausente = 1. */
+    qty?: number;
 }

package/bin/retailWizard/dtos/requests/AddProductRequest.js

@@ -13,14 +13,8 @@ exports.AddProductRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
- * POST /wizard/sessions/:id/product — reserva un equipo del catálogo (paso 03). Reserva 30 min en
- * RetailInventory F1 (condición atómica H2).
- *
- * `imei` y `cashPriceCents` son OPCIONALES a propósito: la unidad física y el precio son AUTORIDAD DEL
- * SERVIDOR. Con solo el `sku`, el wizard elige una unidad disponible del catálogo y toma su precio (el
- * cliente NUNCA dicta el monto a cobrar — `cashPriceCents` ancla el cobro con `amountCents == cashPrice`).
- * Si el caller manda `imei`, el server puede honrar esa unidad, pero el precio SIEMPRE sale del catálogo.
- * SureKeep Fase 2 — pista Retail.
+ * POST /wizard/sessions/:id/product — agrega una línea a la venta y reserva sus piezas en el catálogo.
+ * `imei` y `cashPriceCents` son opcionales: la pieza y el precio los decide el servidor.
  */
 class AddProductRequest {
 }
@@ -43,3 +37,10 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], AddProductRequest.prototype, "cashPriceCents", 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)
+], AddProductRequest.prototype, "qty", void 0);

package/bin/retailWizard/dtos/requests/CompleteSaleRequest.d.ts

@@ -0,0 +1,16 @@
+/** Identificadores capturados en la entrega para un SKU de la línea (componente si es kit). */
+export declare class CompleteSaleLineComponent {
+    sku: string;
+    /** Vacío si el SKU se rastrea por cantidad. */
+    identifiers: string[];
+}
+/** Línea de la sesión con los identificadores de sus piezas. */
+export declare class CompleteSaleLine {
+    lineId: string;
+    components: CompleteSaleLineComponent[];
+}
+/** POST /wizard/sessions/:id/complete-sale — cierra la venta con los identificadores de cada línea. */
+export declare class CompleteSaleRequest {
+    /** Opcional: el front previo cierra sin body; el wizard exige los identificadores que falten. */
+    lines?: CompleteSaleLine[];
+}

package/bin/retailWizard/dtos/requests/CompleteSaleRequest.js

@@ -0,0 +1,59 @@
+"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.CompleteSaleRequest = exports.CompleteSaleLine = exports.CompleteSaleLineComponent = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Identificadores capturados en la entrega para un SKU de la línea (componente si es kit). */
+class CompleteSaleLineComponent {
+}
+exports.CompleteSaleLineComponent = CompleteSaleLineComponent;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], CompleteSaleLineComponent.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CompleteSaleLineComponent.prototype, "identifiers", void 0);
+/** Línea de la sesión con los identificadores de sus piezas. */
+class CompleteSaleLine {
+}
+exports.CompleteSaleLine = CompleteSaleLine;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], CompleteSaleLine.prototype, "lineId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => CompleteSaleLineComponent),
+    __metadata("design:type", Array)
+], CompleteSaleLine.prototype, "components", void 0);
+/** POST /wizard/sessions/:id/complete-sale — cierra la venta con los identificadores de cada línea. */
+class CompleteSaleRequest {
+}
+exports.CompleteSaleRequest = CompleteSaleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => CompleteSaleLine),
+    __metadata("design:type", Array)
+], CompleteSaleRequest.prototype, "lines", void 0);

package/bin/retailWizard/dtos/requests/DeleteProductRequest.d.ts

@@ -1,5 +1,7 @@
-/** DELETE /wizard/sessions/:id/product — libera la reserva del equipo (vuelve al catálogo). SureKeep Fase 2 — pista Retail. */
+/** DELETE /wizard/sessions/:id/product — quita una línea de la venta y libera su reserva en el catálogo. */
 export declare class DeleteProductRequest {
     /** Opcional a propósito: exigirlo rompe a los callers que liberan la reserva sin mandar el imei. */
     imei?: string;
+    /** Línea a quitar de la venta. */
+    lineId?: string;
 }

package/bin/retailWizard/dtos/requests/DeleteProductRequest.js

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeleteProductRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-/** DELETE /wizard/sessions/:id/product — libera la reserva del equipo (vuelve al catálogo). SureKeep Fase 2 — pista Retail. */
+/** DELETE /wizard/sessions/:id/product — quita una línea de la venta y libera su reserva en el catálogo. */
 class DeleteProductRequest {
 }
 exports.DeleteProductRequest = DeleteProductRequest;
@@ -22,3 +22,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], DeleteProductRequest.prototype, "imei", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], DeleteProductRequest.prototype, "lineId", void 0);

package/bin/retailWizard/dtos/requests/QuoteRequest.d.ts

@@ -8,4 +8,6 @@
 export declare class QuoteRequest {
     downPaymentCents: number;
     termWeeks: number;
+    /** Línea que se financia; su precio fijado es el del crédito. */
+    financedLineId?: string;
 }

package/bin/retailWizard/dtos/requests/QuoteRequest.js

@@ -34,3 +34,10 @@ __decorate([
     (0, class_validator_1.Min)(1),
     __metadata("design:type", Number)
 ], QuoteRequest.prototype, "termWeeks", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], QuoteRequest.prototype, "financedLineId", void 0);

package/bin/retailWizard/dtos/requests/SuggestIdentifiersQuery.d.ts

@@ -0,0 +1,5 @@
+/** Query de GET /wizard/sessions/:id/lines/:lineId/identifiers; sku es el componente si la línea es kit. */
+export declare class SuggestIdentifiersQuery {
+    sku: string;
+    prefix: string;
+}

package/bin/retailWizard/dtos/requests/SuggestIdentifiersQuery.js

@@ -0,0 +1,30 @@
+"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.SuggestIdentifiersQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Query de GET /wizard/sessions/:id/lines/:lineId/identifiers; sku es el componente si la línea es kit. */
+class SuggestIdentifiersQuery {
+}
+exports.SuggestIdentifiersQuery = SuggestIdentifiersQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], SuggestIdentifiersQuery.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(4),
+    __metadata("design:type", String)
+], SuggestIdentifiersQuery.prototype, "prefix", void 0);

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

@@ -0,0 +1,7 @@
+/** Forma de pago de una línea de la venta. */
+export declare enum LinePaymentTypeEnum {
+    /** Financiada con crédito SureKeep. */
+    CREDIT = "CREDIT",
+    /** De contado (o con tarjeta), junto con el enganche. */
+    CASH = "CASH"
+}

package/bin/retailWizard/enums/LinePaymentTypeEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinePaymentTypeEnum = void 0;
+/** Forma de pago de una línea de la venta. */
+var LinePaymentTypeEnum;
+(function (LinePaymentTypeEnum) {
+    /** Financiada con crédito SureKeep. */
+    LinePaymentTypeEnum["CREDIT"] = "CREDIT";
+    /** De contado (o con tarjeta), junto con el enganche. */
+    LinePaymentTypeEnum["CASH"] = "CASH";
+})(LinePaymentTypeEnum || (exports.LinePaymentTypeEnum = LinePaymentTypeEnum = {}));

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

@@ -0,0 +1,9 @@
+/** Estado de una línea reservada de la sesión. */
+export declare enum WizardLineStatusEnum {
+    /** Escrita con su reservationId, antes de que el catálogo confirme la reserva. */
+    PENDING = "PENDING",
+    /** El catálogo confirmó la reserva y fijó precio. */
+    RESERVED = "RESERVED",
+    /** Marcada para liberar; pago y enganche la rechazan. */
+    RELEASING = "RELEASING"
+}

package/bin/retailWizard/enums/WizardLineStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WizardLineStatusEnum = void 0;
+/** Estado de una línea reservada de la sesión. */
+var WizardLineStatusEnum;
+(function (WizardLineStatusEnum) {
+    /** Escrita con su reservationId, antes de que el catálogo confirme la reserva. */
+    WizardLineStatusEnum["PENDING"] = "PENDING";
+    /** El catálogo confirmó la reserva y fijó precio. */
+    WizardLineStatusEnum["RESERVED"] = "RESERVED";
+    /** Marcada para liberar; pago y enganche la rechazan. */
+    WizardLineStatusEnum["RELEASING"] = "RELEASING";
+})(WizardLineStatusEnum || (exports.WizardLineStatusEnum = WizardLineStatusEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -21,6 +21,8 @@ export * from './enums/AppOnboardingStepEnum';
 export * from './enums/AppOnboardingStepStatusEnum';
 export * from './enums/BlockedReasonEnum';
 export * from './enums/BlockedCategoryEnum';
+export * from './enums/WizardLineStatusEnum';
+export * from './enums/LinePaymentTypeEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -34,6 +36,10 @@ export * from './dtos/AccountStep';
 export * from './dtos/AppOnboardingStep';
 export * from './dtos/WizardResumeTarget';
 export * from './dtos/WizardBlocked';
+export * from './dtos/WizardLineProduct';
+export * from './dtos/WizardLineIdentifiers';
+export * from './dtos/WizardReservedLine';
+export * from './dtos/SaleLine';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';
@@ -69,6 +75,8 @@ export * from './dtos/requests/QuoteRequest';
 export * from './dtos/requests/DownPaymentRequest';
 export * from './dtos/requests/SignatureSignRequest';
 export * from './dtos/requests/RegisterDeviceRequest';
+export * from './dtos/requests/CompleteSaleRequest';
+export * from './dtos/requests/SuggestIdentifiersQuery';
 export * from './dtos/responses/KycPrepareResponse';
 export * from './dtos/responses/ProofOfAddressPrepareResponse';
 export * from './dtos/responses/SessionFinanciersResponse';

package/bin/retailWizard/index.js

@@ -39,6 +39,8 @@ __exportStar(require("./enums/AppOnboardingStepEnum"), exports);
 __exportStar(require("./enums/AppOnboardingStepStatusEnum"), exports);
 __exportStar(require("./enums/BlockedReasonEnum"), exports);
 __exportStar(require("./enums/BlockedCategoryEnum"), exports);
+__exportStar(require("./enums/WizardLineStatusEnum"), exports);
+__exportStar(require("./enums/LinePaymentTypeEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -53,6 +55,10 @@ __exportStar(require("./dtos/AccountStep"), exports);
 __exportStar(require("./dtos/AppOnboardingStep"), exports);
 __exportStar(require("./dtos/WizardResumeTarget"), exports);
 __exportStar(require("./dtos/WizardBlocked"), exports);
+__exportStar(require("./dtos/WizardLineProduct"), exports);
+__exportStar(require("./dtos/WizardLineIdentifiers"), exports);
+__exportStar(require("./dtos/WizardReservedLine"), exports);
+__exportStar(require("./dtos/SaleLine"), exports);
 // Entidades principales (shapes de estado/persistencia — planas)
 __exportStar(require("./dtos/WizardSession"), exports);
 __exportStar(require("./dtos/OtpVerification"), exports);
@@ -91,6 +97,8 @@ __exportStar(require("./dtos/requests/QuoteRequest"), exports);
 __exportStar(require("./dtos/requests/DownPaymentRequest"), exports);
 __exportStar(require("./dtos/requests/SignatureSignRequest"), exports);
 __exportStar(require("./dtos/requests/RegisterDeviceRequest"), exports);
+__exportStar(require("./dtos/requests/CompleteSaleRequest"), exports);
+__exportStar(require("./dtos/requests/SuggestIdentifiersQuery"), exports);
 // Response DTOs (output tipado por endpoint)
 __exportStar(require("./dtos/responses/KycPrepareResponse"), exports);
 __exportStar(require("./dtos/responses/ProofOfAddressPrepareResponse"), exports);

package/package.json

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

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

@@ -0,0 +1,21 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsUUID, Min } from 'class-validator';
+import { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+
+/** Body de `POST /private/customers/:directoryId/credits/:creditId/payments` (loan-credit-business). */
+export class CreateCustomerPaymentRequest {
+    @Expose()
+    @IsEnum(LoanCustomerPaymentTypeEnum)
+    type!: LoanCustomerPaymentTypeEnum;
+
+    /** Monto que vio el cliente; si ya no coincide, responde 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    expectedAmountCents!: number;
+
+    /** Llave del reintento: la misma llave con el mismo cuerpo devuelve la misma respuesta. */
+    @Expose()
+    @IsUUID()
+    idempotencyKey!: string;
+}

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

@@ -1,3 +1,4 @@
+import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
 import { LoanAdHocChargeKindEnum } from '../../enums/LoanAdHocChargeKindEnum';
 
 /** Response 202 de recovery-collection, prepayments y advances. El 202 no mueve el libro; lo mueve el apply-result. */
@@ -7,4 +8,6 @@ export interface LoanAdHocChargeRequested {
     /** `<creditId>#<chargeKind>#<n>`. */
     chargeId: string;
     amountCents: number;
+    /** Respuesta síncrona del motor; ausente si no contestó a tiempo. */
+    collection?: { status: CollectionResultStatus; amountCollectedCents: number };
 }

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

@@ -0,0 +1,32 @@
+import { LoanAdHocChargeKindEnum } from '../../enums/LoanAdHocChargeKindEnum';
+import { LoanNextInstallmentModeEnum } from '../../enums/LoanNextInstallmentModeEnum';
+import { LoanPaymentOptionUnavailableReasonEnum } from '../../enums/LoanPaymentOptionUnavailableReasonEnum';
+import { LoanSettlementQuote } from './LoanSettlementQuote';
+
+/** Una opción de pago. `amountCents` solo viene si está disponible. */
+export interface LoanCustomerPaymentOption {
+    available: boolean;
+    unavailableReason?: LoanPaymentOptionUnavailableReasonEnum;
+    amountCents?: number;
+}
+
+/** Response de `GET /private/customers/:directoryId/credits/:creditId/payment-options`. Montos en cents. */
+export interface LoanCustomerPaymentOptions {
+    creditId: string;
+    /** Cargo ad hoc en curso; mientras exista, ninguna opción está disponible. */
+    pendingCharge?: { kind: LoanAdHocChargeKindEnum; amountCents: number };
+    nextInstallment: LoanCustomerPaymentOption & {
+        mode?: LoanNextInstallmentModeEnum;
+        installmentNumber?: number;
+        /** `YYYY-MM-DD`. */
+        dueDate?: string;
+    };
+    /** Varias cuotas: hoy siempre `available: false` con `NOT_AVAILABLE_YET`. */
+    advance: LoanCustomerPaymentOption;
+    settlement: LoanCustomerPaymentOption & {
+        /** La cotización de hoy; su `settlementAmountCents` es el `amountCents`. */
+        quote?: LoanSettlementQuote;
+        /** Lo que deben las cuotas abiertas menos `settlementAmountCents`. */
+        savingsCents?: number;
+    };
+}

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

@@ -0,0 +1,12 @@
+import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
+import { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+
+/** Response 202 de `POST /private/customers/:directoryId/credits/:creditId/payments`. */
+export interface LoanCustomerPaymentResult {
+    creditId: string;
+    type: LoanCustomerPaymentTypeEnum;
+    chargeId: string;
+    amountCents: number;
+    /** Respuesta síncrona del motor; ausente si no contestó a tiempo. */
+    collection?: { status: CollectionResultStatus; amountCollectedCents: number };
+}

package/src/loanCredit/enums/LoanCustomerPaymentTypeEnum.ts

@@ -0,0 +1,5 @@
+/** Pago que el cliente puede pedir desde la app. */
+export enum LoanCustomerPaymentTypeEnum {
+    NEXT_INSTALLMENT = 'NEXT_INSTALLMENT',
+    SETTLEMENT = 'SETTLEMENT',
+}

package/src/loanCredit/enums/LoanNextInstallmentModeEnum.ts

@@ -0,0 +1,7 @@
+/** Cómo se cobra la siguiente cuota. */
+export enum LoanNextInstallmentModeEnum {
+    /** La cuota aún no está registrada en el motor: se adelanta. */
+    ADVANCE = 'ADVANCE',
+    /** Vence hoy o hay vencidas: se cobra lo exigible. */
+    COLLECT_DUE = 'COLLECT_DUE',
+}

package/src/loanCredit/enums/LoanPaymentOptionUnavailableReasonEnum.ts

@@ -0,0 +1,13 @@
+/** Por qué una opción de pago no está disponible. */
+export enum LoanPaymentOptionUnavailableReasonEnum {
+    /** Hay un cargo ad hoc en curso. */
+    PAYMENT_IN_PROGRESS = 'PAYMENT_IN_PROGRESS',
+    /** El crédito todavía no está activo. */
+    CREDIT_NOT_CURRENT = 'CREDIT_NOT_CURRENT',
+    /** Adelantar cubriría todo lo abierto: se liquida. */
+    USE_SETTLEMENT = 'USE_SETTLEMENT',
+    /** La opción aún no está habilitada. */
+    NOT_AVAILABLE_YET = 'NOT_AVAILABLE_YET',
+    /** SETTLED, WRITTEN_OFF, CANCELLED o DISCARDED. */
+    CREDIT_CLOSED = 'CREDIT_CLOSED',
+}

package/src/loanCredit/index.ts

@@ -154,3 +154,11 @@ export * from './dtos/responses/LoanPrepaymentQuote';
 export * from './dtos/responses/LoanPaymentReviewItem';
 export * from './dtos/responses/LoanPaymentReviewListResponse';
 export * from './dtos/responses/LoanPaymentReviewResolution';
+
+// Pagos del cliente: contrato privado con retail-loan-business
+export * from './enums/LoanCustomerPaymentTypeEnum';
+export * from './enums/LoanNextInstallmentModeEnum';
+export * from './enums/LoanPaymentOptionUnavailableReasonEnum';
+export * from './dtos/requests/CreateCustomerPaymentRequest';
+export * from './dtos/responses/LoanCustomerPaymentOptions';
+export * from './dtos/responses/LoanCustomerPaymentResult';

package/src/retailCatalog/dtos/Product.ts

@@ -2,6 +2,9 @@ import { MdmLockModeEnum } from '../enums/MdmLockModeEnum';
 import { MdmProviderEnum } from '../enums/MdmProviderEnum';
 import { ProductStatusEnum } from '../enums/ProductStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
+import { ProductCategoryEnum } from '../enums/ProductCategoryEnum';
+import { TrackingModeEnum } from '../enums/TrackingModeEnum';
+import { ProductComponent } from './ProductComponent';
 
 /**
  * Product — aggregate root del catálogo del dominio `retailCatalog`
@@ -20,7 +23,8 @@ export class Product {
     description!: string;
     specs!: Record<string, unknown> | null;
     imageUrl!: string | null;
-    tier!: ProductTierEnum;
+    /** `null` = Sin gama. */
+    tier!: ProductTierEnum | null;
     basePriceCents!: number;
     listPriceCents!: number | null;
     eligibleFinanciers!: string[];
@@ -32,4 +36,16 @@ export class Product {
     updatedBy!: string;
     createdAt!: string;
     updatedAt!: string;
+
+    // Campos del inventario multi-item; opcionales hasta que todo producto pase por la puerta de entrada.
+    category?: ProductCategoryEnum;
+    trackingMode?: TrackingModeEnum;
+    /** Se puede vender suelto (fuera de un kit). */
+    sellable?: boolean;
+    /** Aparece en el catálogo del flujo de venta. */
+    showInSalesFlow?: boolean;
+    /** Solo en BUNDLE. */
+    components?: ProductComponent[] | null;
+    /** Llave del registro PRICE# del que salen basePriceCents y listPriceCents. */
+    currentPriceSk?: string | null;
 }

package/src/retailCatalog/dtos/ProductComponent.ts

@@ -0,0 +1,14 @@
+import { IsInt, IsString, Length, Matches, Min } from 'class-validator';
+import { SKU_PATTERN } from '../constants/SkuPattern';
+
+/** Componente de un kit (BUNDLE): qué SKU consume y cuántas piezas por kit. */
+export class ProductComponent {
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    @IsInt()
+    @Min(1)
+    qty!: number;
+}