@fiado/type-kit 3.364.0 → 3.366.0

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

@@ -28,4 +28,12 @@ export declare class OriginateLoanCreditRequest {
     clientLevelAtOrigination?: ClientLevelEnum;
     /** IMEI del equipo si ya se conoce (también puede fijarse en el paso 09 vía activate-check). */
     imei?: string;
+    /**
+     * Tienda donde se vende. El motor la persiste y la reenvía al simulador del catálogo en cada
+     * cotización — al RE-cotizar el wizard no la vuelve a mandar, así que sin guardarla la venta
+     * perdería su promoción a mitad del paso 06.
+     */
+    storeId?: string;
+    /** SKU del equipo, por el mismo motivo que `storeId`: resuelve promociones acotadas por producto. */
+    productSku?: string;
 }

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

@@ -89,3 +89,15 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], OriginateLoanCreditRequest.prototype, "imei", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], OriginateLoanCreditRequest.prototype, "productSku", void 0);

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

@@ -4,11 +4,11 @@
  * igual que `CreditPlan`.
  */
 export interface PromotionEffect {
-    /** Puntos de enganche que se restan al mínimo del plan (decimal sobre 1: `0.05` = 5 puntos). */
+    /** Delta NEGATIVO sobre el enganche mínimo del plan (`-0.20` = veinte puntos menos). */
     downPaymentDeltaPct: number | null;
     /** Bono que se abona a la tarjeta PCF al activar el crédito. */
     pcfBonusCents: number | null;
-    /** TNA que reemplaza a la del plan (decimal: `2.10` = 210%). */
+    /** TNA que reemplaza a la del plan, siempre hacia abajo (`1.80` = 180% en vez de 200%). */
     tnaOverride: number | null;
     /** Techo de monto financiable que reemplaza al del plan. */
     maxAmountOverrideCents: number | null;

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

@@ -14,6 +14,8 @@ export declare class CreatePromotionRequest {
     targetLevels: CreditPlanLevelEnum[];
     /** SKUs alcanzados; ausente o `null` = todos los productos. */
     productSkus?: string[] | null;
+    /** Tiendas alcanzadas. `null` o ausente = todas. */
+    storeIds?: string[] | null;
     validFrom?: string | null;
     validUntil?: string | null;
     /**

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

@@ -57,6 +57,13 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], CreatePromotionRequest.prototype, "productSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreatePromotionRequest.prototype, "storeIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -4,11 +4,11 @@
  * clave — las valida el lambda con 422: son reglas del negocio sobre un body bien formado.
  */
 export declare class PromotionEffectInput {
-    /** Puntos de enganche a restar del mínimo del plan (decimal sobre 1). */
+    /** Delta NEGATIVO sobre el enganche mínimo (`-0.20` = veinte puntos menos); rango [-1, 0]. */
     downPaymentDeltaPct?: number | null;
     /** Bono a la tarjeta PCF, en cents. */
     pcfBonusCents?: number | null;
-    /** TNA que reemplaza a la del plan (decimal); rango de negocio [2.00, 2.60]. */
+    /** TNA que reemplaza a la del plan, hacia abajo (`1.80` = 180%); rango [0, 2.60]. */
     tnaOverride?: number | null;
     /** Techo de monto financiable que reemplaza al del plan, en cents. */
     maxAmountOverrideCents?: number | null;

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

@@ -2,10 +2,18 @@
  * Body de POST /private/credit-plans/:planId/simulate y query de GET /credit-plans/:planId/simulator.
  * Entradas del simulador de cuota (flow 06 §6.1.4). `productPriceCents` en cents; `downPaymentPct`
  * decimal sobre 1. `customerSciScore` opcional: si viene, se valida contra el rango SCI del plan.
+ *
+ * `storeId` y `productSku` describen DÓNDE y QUÉ se está vendiendo: con ellos el simulador resuelve
+ * qué promoción aplica. Sin ellos, las promociones acotadas a una tienda o a un SKU quedan fuera —
+ * el simulador no adivina, y dar un beneficio que no corresponde es peor que no darlo.
  */
 export declare class SimulateCreditPlanRequest {
     productPriceCents: number;
     downPaymentPct: number;
     termWeeks: number;
     customerSciScore?: number;
+    /** Tienda donde se vende. Sin él no se resuelven las promociones acotadas por tienda. */
+    storeId?: string;
+    /** SKU del equipo. Sin él no se resuelven las promociones acotadas por producto. */
+    productSku?: string;
 }

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

@@ -16,6 +16,10 @@ const class_validator_1 = require("class-validator");
  * Body de POST /private/credit-plans/:planId/simulate y query de GET /credit-plans/:planId/simulator.
  * Entradas del simulador de cuota (flow 06 §6.1.4). `productPriceCents` en cents; `downPaymentPct`
  * decimal sobre 1. `customerSciScore` opcional: si viene, se valida contra el rango SCI del plan.
+ *
+ * `storeId` y `productSku` describen DÓNDE y QUÉ se está vendiendo: con ellos el simulador resuelve
+ * qué promoción aplica. Sin ellos, las promociones acotadas a una tienda o a un SKU quedan fuera —
+ * el simulador no adivina, y dar un beneficio que no corresponde es peor que no darlo.
  */
 class SimulateCreditPlanRequest {
 }
@@ -47,3 +51,15 @@ __decorate([
     (0, class_validator_1.Max)(100),
     __metadata("design:type", Number)
 ], SimulateCreditPlanRequest.prototype, "customerSciScore", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SimulateCreditPlanRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SimulateCreditPlanRequest.prototype, "productSku", void 0);

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

@@ -12,6 +12,8 @@ export declare class UpdatePromotionRequest {
     segmentId?: string;
     targetLevels?: CreditPlanLevelEnum[];
     productSkus?: string[] | null;
+    /** Tiendas alcanzadas. `null` o ausente = todas. */
+    storeIds?: string[] | null;
     validFrom?: string | null;
     validUntil?: string | null;
     budgetMaxCents?: number | null;

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

@@ -62,6 +62,13 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], UpdatePromotionRequest.prototype, "productSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdatePromotionRequest.prototype, "storeIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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

@@ -21,6 +21,8 @@ export interface PromotionResponse {
     targetLevels: CreditPlanLevelEnum[];
     /** `null` = alcanza a todos los productos. */
     productSkus: string[] | null;
+    /** `null` = alcanza a todas las tiendas. Dimensión «Tienda / canal» del alcance. */
+    storeIds: string[] | null;
     validFrom: string | null;
     validUntil: string | null;
     status: PromotionStatusEnum;

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

@@ -1,3 +1,4 @@
+import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
 /**
  * Un renglón de la tabla de amortización (M2 §3.3). Todos los montos en cents.
  */
@@ -13,6 +14,18 @@ export interface AmortizationRowResponse {
     /** Saldo insoluto de capital tras aplicar la cuota. */
     remainingBalanceCents: number;
 }
+/**
+ * Promoción que el simulador aplicó a esta cotización. Sin este bloque la cuota cambia y nadie
+ * puede explicar por qué: es lo que hace auditable la regla de que gana una sola promoción.
+ */
+export interface AppliedPromotionResponse {
+    promotionId: string;
+    name: string;
+    /** Versión de la promoción al cotizar — el operador la edita y sube. */
+    version: number;
+    /** Palancas del plan que la promoción pisó. */
+    appliedEffects: PromotionEffectKindEnum[];
+}
 /**
  * Resultado del simulador de cuota (POST /private/credit-plans/:planId/simulate,
  * GET /credit-plans/:planId/simulator). Amortización francesa + IVA 16% + comisión de apertura + CAT.
@@ -41,4 +54,9 @@ export interface SimulationResultResponse {
     /** Costo Anual Total (decimal, ej. 2.87 = 287%). Metodología estándar CONDUSEF (supuesto). */
     catAnnual: number;
     schedule: AmortizationRowResponse[];
+    /**
+     * Promoción aplicada, o `null` si ninguna alcanzaba a esta venta. Los montos de arriba YA la
+     * incluyen: es el porqué de la cuota, no un extra a sumar.
+     */
+    appliedPromotion: AppliedPromotionResponse | null;
 }

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

@@ -0,0 +1,27 @@
+import type { WizardSessionLookupStatusEnum } from '../enums/WizardSessionLookupStatusEnum';
+import type { WizardStateEnum } from '../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../enums/WizardStepEnum';
+/**
+ * Una entrada del lote de sesiones del wizard: traduce un `wizardSessionId` a la tienda, el cliente
+ * y el equipo de esa venta. Campo AUSENTE = «no lo se»; presente en `null` = dato afirmado como nulo.
+ */
+export interface WizardSessionLookupEntry {
+    wizardSessionId: string;
+    status: WizardSessionLookupStatusEnum;
+    /** Todos los campos de abajo viajan SOLO con `status: OK`. */
+    retailerId?: string;
+    storeId?: string;
+    /** `null` mientras el KYC no haya dado de alta al cliente. */
+    retailCustomerId?: string | null;
+    state?: WizardStateEnum;
+    currentStep?: WizardStepEnum;
+    /** SKU del equipo reservado; `null` si la venta no llego al paso del producto. */
+    sku?: string | null;
+    /** Ficha comercial CONGELADA al reservar. `null` si no hay equipo reservado. */
+    productBrand?: string | null;
+    productModel?: string | null;
+    productCapacity?: string | null;
+    /** La venta que cerro esta sesion; `null` si todavia no cerro. */
+    saleId?: string | null;
+    folio?: string | null;
+}

package/bin/retailWizard/dtos/WizardSessionLookupEntry.js

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

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

@@ -0,0 +1,9 @@
+import type { WizardSessionLookupEntry } from '../WizardSessionLookupEntry';
+/**
+ * `GET /private/wizard-sessions/batch` — una entrada por cada id pedido, en el MISMO orden.
+ * `unavailableCount` hace ruidoso el resultado parcial: sin el, el caller no sabe que le falto algo.
+ */
+export interface WizardSessionLookupResponse {
+    items: WizardSessionLookupEntry[];
+    unavailableCount: number;
+}

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Como se resolvio cada id pedido a `GET /private/wizard-sessions/batch`. Hay una entrada por id.
+ * `NOT_FOUND` y `UNAVAILABLE` NO son lo mismo: colapsarlos afirma «no tiene» cuando fue «no se leyo».
+ */
+export declare enum WizardSessionLookupStatusEnum {
+    /** La sesion existe y se leyo completa. */
+    OK = "OK",
+    /** No existe esa sesion en el silo. Es un dato POSITIVO, no una ausencia. */
+    NOT_FOUND = "NOT_FOUND",
+    /** No se pudo leer esa sesion. El caller reintenta SOLO ese id. */
+    UNAVAILABLE = "UNAVAILABLE",
+    /** Ese id no tiene forma de id. Reintentarlo nunca va a servir: el caller lo mando mal. */
+    INVALID_ID = "INVALID_ID"
+}

package/bin/retailWizard/enums/WizardSessionLookupStatusEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WizardSessionLookupStatusEnum = void 0;
+/**
+ * Como se resolvio cada id pedido a `GET /private/wizard-sessions/batch`. Hay una entrada por id.
+ * `NOT_FOUND` y `UNAVAILABLE` NO son lo mismo: colapsarlos afirma «no tiene» cuando fue «no se leyo».
+ */
+var WizardSessionLookupStatusEnum;
+(function (WizardSessionLookupStatusEnum) {
+    /** La sesion existe y se leyo completa. */
+    WizardSessionLookupStatusEnum["OK"] = "OK";
+    /** No existe esa sesion en el silo. Es un dato POSITIVO, no una ausencia. */
+    WizardSessionLookupStatusEnum["NOT_FOUND"] = "NOT_FOUND";
+    /** No se pudo leer esa sesion. El caller reintenta SOLO ese id. */
+    WizardSessionLookupStatusEnum["UNAVAILABLE"] = "UNAVAILABLE";
+    /** Ese id no tiene forma de id. Reintentarlo nunca va a servir: el caller lo mando mal. */
+    WizardSessionLookupStatusEnum["INVALID_ID"] = "INVALID_ID";
+})(WizardSessionLookupStatusEnum || (exports.WizardSessionLookupStatusEnum = WizardSessionLookupStatusEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -121,3 +121,6 @@ export * from './events/SaleCancelledV1';
 export * from './events/SaleCompletedV2';
 export * from './events/SaleCancelledV2';
 export * from './events/SessionExpiredV1';
+export * from './enums/WizardSessionLookupStatusEnum';
+export * from './dtos/WizardSessionLookupEntry';
+export * from './dtos/responses/WizardSessionLookupResponse';

package/bin/retailWizard/index.js

@@ -152,3 +152,7 @@ __exportStar(require("./events/SaleCancelledV1"), exports);
 __exportStar(require("./events/SaleCompletedV2"), exports);
 __exportStar(require("./events/SaleCancelledV2"), exports);
 __exportStar(require("./events/SessionExpiredV1"), exports);
+// Lookup privado por lote (GET /private/wizard-sessions/batch)
+__exportStar(require("./enums/WizardSessionLookupStatusEnum"), exports);
+__exportStar(require("./dtos/WizardSessionLookupEntry"), exports);
+__exportStar(require("./dtos/responses/WizardSessionLookupResponse"), exports);

package/package.json

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

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

@@ -81,4 +81,20 @@ export class OriginateLoanCreditRequest {
     @IsOptional()
     @IsString()
     imei?: string;
+
+    /**
+     * Tienda donde se vende. El motor la persiste y la reenvía al simulador del catálogo en cada
+     * cotización — al RE-cotizar el wizard no la vuelve a mandar, así que sin guardarla la venta
+     * perdería su promoción a mitad del paso 06.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    storeId?: string;
+
+    /** SKU del equipo, por el mismo motivo que `storeId`: resuelve promociones acotadas por producto. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    productSku?: string;
 }

package/src/loanOfferings/dtos/PromotionEffect.ts

@@ -4,11 +4,11 @@
  * igual que `CreditPlan`.
  */
 export interface PromotionEffect {
-    /** Puntos de enganche que se restan al mínimo del plan (decimal sobre 1: `0.05` = 5 puntos). */
+    /** Delta NEGATIVO sobre el enganche mínimo del plan (`-0.20` = veinte puntos menos). */
     downPaymentDeltaPct: number | null;
     /** Bono que se abona a la tarjeta PCF al activar el crédito. */
     pcfBonusCents: number | null;
-    /** TNA que reemplaza a la del plan (decimal: `2.10` = 210%). */
+    /** TNA que reemplaza a la del plan, siempre hacia abajo (`1.80` = 180% en vez de 200%). */
     tnaOverride: number | null;
     /** Techo de monto financiable que reemplaza al del plan. */
     maxAmountOverrideCents: number | null;

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

@@ -49,6 +49,13 @@ export class CreatePromotionRequest {
     @IsString({ each: true })
     productSkus?: string[] | null;
 
+    /** Tiendas alcanzadas. `null` o ausente = todas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    storeIds?: string[] | null;
+
     @Expose()
     @IsOptional()
     @IsISO8601()

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

@@ -7,7 +7,7 @@ import { IsInt, IsNumber, IsOptional } from 'class-validator';
  * clave — las valida el lambda con 422: son reglas del negocio sobre un body bien formado.
  */
 export class PromotionEffectInput {
-    /** Puntos de enganche a restar del mínimo del plan (decimal sobre 1). */
+    /** Delta NEGATIVO sobre el enganche mínimo (`-0.20` = veinte puntos menos); rango [-1, 0]. */
     @Expose()
     @IsOptional()
     @IsNumber()
@@ -19,7 +19,7 @@ export class PromotionEffectInput {
     @IsInt()
     pcfBonusCents?: number | null;
 
-    /** TNA que reemplaza a la del plan (decimal); rango de negocio [2.00, 2.60]. */
+    /** TNA que reemplaza a la del plan, hacia abajo (`1.80` = 180%); rango [0, 2.60]. */
     @Expose()
     @IsOptional()
     @IsNumber()

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

@@ -1,10 +1,14 @@
 import { Expose } from 'class-transformer';
-import { IsInt, IsNumber, IsOptional, Max, Min } from 'class-validator';
+import { IsInt, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
 
 /**
  * Body de POST /private/credit-plans/:planId/simulate y query de GET /credit-plans/:planId/simulator.
  * Entradas del simulador de cuota (flow 06 §6.1.4). `productPriceCents` en cents; `downPaymentPct`
  * decimal sobre 1. `customerSciScore` opcional: si viene, se valida contra el rango SCI del plan.
+ *
+ * `storeId` y `productSku` describen DÓNDE y QUÉ se está vendiendo: con ellos el simulador resuelve
+ * qué promoción aplica. Sin ellos, las promociones acotadas a una tienda o a un SKU quedan fuera —
+ * el simulador no adivina, y dar un beneficio que no corresponde es peor que no darlo.
  */
 export class SimulateCreditPlanRequest {
     @Expose()
@@ -29,4 +33,16 @@ export class SimulateCreditPlanRequest {
     @Min(0)
     @Max(100)
     customerSciScore?: number;
+
+    /** Tienda donde se vende. Sin él no se resuelven las promociones acotadas por tienda. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    storeId?: string;
+
+    /** SKU del equipo. Sin él no se resuelven las promociones acotadas por producto. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    productSku?: string;
 }

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

@@ -52,6 +52,13 @@ export class UpdatePromotionRequest {
     @IsString({ each: true })
     productSkus?: string[] | null;
 
+    /** Tiendas alcanzadas. `null` o ausente = todas. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    storeIds?: string[] | null;
+
     @Expose()
     @IsOptional()
     @IsISO8601()

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

@@ -22,6 +22,8 @@ export interface PromotionResponse {
     targetLevels: CreditPlanLevelEnum[];
     /** `null` = alcanza a todos los productos. */
     productSkus: string[] | null;
+    /** `null` = alcanza a todas las tiendas. Dimensión «Tienda / canal» del alcance. */
+    storeIds: string[] | null;
     validFrom: string | null;
     validUntil: string | null;
     status: PromotionStatusEnum;

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

@@ -1,3 +1,5 @@
+import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
+
 /**
  * Un renglón de la tabla de amortización (M2 §3.3). Todos los montos en cents.
  */
@@ -14,6 +16,19 @@ export interface AmortizationRowResponse {
     remainingBalanceCents: number;
 }
 
+/**
+ * Promoción que el simulador aplicó a esta cotización. Sin este bloque la cuota cambia y nadie
+ * puede explicar por qué: es lo que hace auditable la regla de que gana una sola promoción.
+ */
+export interface AppliedPromotionResponse {
+    promotionId: string;
+    name: string;
+    /** Versión de la promoción al cotizar — el operador la edita y sube. */
+    version: number;
+    /** Palancas del plan que la promoción pisó. */
+    appliedEffects: PromotionEffectKindEnum[];
+}
+
 /**
  * Resultado del simulador de cuota (POST /private/credit-plans/:planId/simulate,
  * GET /credit-plans/:planId/simulator). Amortización francesa + IVA 16% + comisión de apertura + CAT.
@@ -42,4 +57,9 @@ export interface SimulationResultResponse {
     /** Costo Anual Total (decimal, ej. 2.87 = 287%). Metodología estándar CONDUSEF (supuesto). */
     catAnnual: number;
     schedule: AmortizationRowResponse[];
+    /**
+     * Promoción aplicada, o `null` si ninguna alcanzaba a esta venta. Los montos de arriba YA la
+     * incluyen: es el porqué de la cuota, no un extra a sumar.
+     */
+    appliedPromotion: AppliedPromotionResponse | null;
 }

package/src/retailWizard/dtos/WizardSessionLookupEntry.ts

@@ -0,0 +1,28 @@
+import type { WizardSessionLookupStatusEnum } from '../enums/WizardSessionLookupStatusEnum';
+import type { WizardStateEnum } from '../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../enums/WizardStepEnum';
+
+/**
+ * Una entrada del lote de sesiones del wizard: traduce un `wizardSessionId` a la tienda, el cliente
+ * y el equipo de esa venta. Campo AUSENTE = «no lo se»; presente en `null` = dato afirmado como nulo.
+ */
+export interface WizardSessionLookupEntry {
+    wizardSessionId: string;
+    status: WizardSessionLookupStatusEnum;
+    /** Todos los campos de abajo viajan SOLO con `status: OK`. */
+    retailerId?: string;
+    storeId?: string;
+    /** `null` mientras el KYC no haya dado de alta al cliente. */
+    retailCustomerId?: string | null;
+    state?: WizardStateEnum;
+    currentStep?: WizardStepEnum;
+    /** SKU del equipo reservado; `null` si la venta no llego al paso del producto. */
+    sku?: string | null;
+    /** Ficha comercial CONGELADA al reservar. `null` si no hay equipo reservado. */
+    productBrand?: string | null;
+    productModel?: string | null;
+    productCapacity?: string | null;
+    /** La venta que cerro esta sesion; `null` si todavia no cerro. */
+    saleId?: string | null;
+    folio?: string | null;
+}

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

@@ -0,0 +1,10 @@
+import type { WizardSessionLookupEntry } from '../WizardSessionLookupEntry';
+
+/**
+ * `GET /private/wizard-sessions/batch` — una entrada por cada id pedido, en el MISMO orden.
+ * `unavailableCount` hace ruidoso el resultado parcial: sin el, el caller no sabe que le falto algo.
+ */
+export interface WizardSessionLookupResponse {
+    items: WizardSessionLookupEntry[];
+    unavailableCount: number;
+}

package/src/retailWizard/enums/WizardSessionLookupStatusEnum.ts

@@ -0,0 +1,14 @@
+/**
+ * Como se resolvio cada id pedido a `GET /private/wizard-sessions/batch`. Hay una entrada por id.
+ * `NOT_FOUND` y `UNAVAILABLE` NO son lo mismo: colapsarlos afirma «no tiene» cuando fue «no se leyo».
+ */
+export enum WizardSessionLookupStatusEnum {
+    /** La sesion existe y se leyo completa. */
+    OK = 'OK',
+    /** No existe esa sesion en el silo. Es un dato POSITIVO, no una ausencia. */
+    NOT_FOUND = 'NOT_FOUND',
+    /** No se pudo leer esa sesion. El caller reintenta SOLO ese id. */
+    UNAVAILABLE = 'UNAVAILABLE',
+    /** Ese id no tiene forma de id. Reintentarlo nunca va a servir: el caller lo mando mal. */
+    INVALID_ID = 'INVALID_ID',
+}

package/src/retailWizard/index.ts

@@ -148,3 +148,8 @@ export * from './events/SaleCancelledV1';
 export * from './events/SaleCompletedV2';
 export * from './events/SaleCancelledV2';
 export * from './events/SessionExpiredV1';
+
+// Lookup privado por lote (GET /private/wizard-sessions/batch)
+export * from './enums/WizardSessionLookupStatusEnum';
+export * from './dtos/WizardSessionLookupEntry';
+export * from './dtos/responses/WizardSessionLookupResponse';