@fiado/type-kit 3.460.0 → 3.461.0

package/bin/retailCatalog/dtos/responses/ReleaseStockResponse.d.ts

@@ -0,0 +1,10 @@
+/** Resultado de liberar una línea; `released=false` si onlyExpired y aún no vence. */
+export interface ReleasedReservationLine {
+    lineId: string;
+    reservationId: string;
+    released: boolean;
+}
+/** Response de privateReleaseStock. */
+export interface ReleaseStockResponse {
+    lines: ReleasedReservationLine[];
+}

package/bin/retailCatalog/dtos/responses/ReleaseStockResponse.js

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

package/bin/retailCatalog/dtos/responses/RenewReservationsResponse.d.ts

@@ -0,0 +1,10 @@
+/** Vencimiento nuevo de una línea renovada. */
+export interface RenewedReservationLine {
+    lineId: string;
+    reservationId: string;
+    expiresAt: string;
+}
+/** Response de privateRenewReservations. */
+export interface RenewReservationsResponse {
+    lines: RenewedReservationLine[];
+}

package/bin/retailCatalog/dtos/responses/RenewReservationsResponse.js

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

package/bin/retailCatalog/dtos/responses/ReserveStockResponse.d.ts

@@ -0,0 +1,25 @@
+import type { MdmProviderEnum } from '../../enums/MdmProviderEnum';
+import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import type { TrackingModeEnum } from '../../enums/TrackingModeEnum';
+/** Componente reservado de un kit. */
+export interface ReservedComponent {
+    sku: string;
+    qty: number;
+    category: ProductCategoryEnum;
+    trackingMode: TrackingModeEnum;
+}
+/** Response de privateReserveStock; el precio de la línea es `basePriceCents`. */
+export interface ReserveStockResponse {
+    expiresAt: string;
+    basePriceCents: number;
+    listPriceCents: number | null;
+    /** Llave del registro PRICE# del que salió el precio fijado. */
+    priceSk: string;
+    eligibleFinanciers: string[];
+    /** Ítems que la línea suma al tope de la venta. */
+    sellItemCost: number;
+    mdmEnabled: boolean;
+    mdmProvider: MdmProviderEnum | null;
+    /** Solo si la línea es un kit. */
+    components?: ReservedComponent[];
+}

package/bin/retailCatalog/dtos/responses/ReserveStockResponse.js

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

package/bin/retailCatalog/dtos/responses/ReturnStockResponse.d.ts

@@ -0,0 +1,4 @@
+/** Response de privateReturnStock; una repetición también responde 200. */
+export interface ReturnStockResponse {
+    saleId: string;
+}

package/bin/retailCatalog/dtos/responses/ReturnStockResponse.js

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

package/bin/retailCatalog/dtos/responses/SellStockResponse.d.ts

@@ -0,0 +1,18 @@
+/** Componente vendido con las piezas que salieron. */
+export interface SoldLineComponent {
+    sku: string;
+    qty: number;
+    identifiers: string[];
+}
+/** Línea vendida. */
+export interface SoldLine {
+    lineId: string;
+    sku: string;
+    qty: number;
+    components: SoldLineComponent[];
+}
+/** Response de privateSellStock; una repetición devuelve el mismo resultado. */
+export interface SellStockResponse {
+    soldAt: string;
+    lines: SoldLine[];
+}

package/bin/retailCatalog/dtos/responses/SellStockResponse.js

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

package/bin/retailCatalog/dtos/responses/SkuPriceEntry.d.ts

@@ -0,0 +1,9 @@
+import type { PriceSourceEnum } from '../../enums/PriceSourceEnum';
+/** Un registro del historial de precios PRICE# de un SKU. */
+export interface SkuPriceEntry {
+    effectiveFrom: string;
+    listPriceCents: number | null;
+    basePriceCents: number;
+    source: PriceSourceEnum;
+    createdBy: string;
+}

package/bin/retailCatalog/dtos/responses/SkuPriceEntry.js

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

package/bin/retailCatalog/dtos/responses/StoreCatalogItem.d.ts

@@ -0,0 +1,29 @@
+import type { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
+import type { MdmProviderEnum } from '../../enums/MdmProviderEnum';
+import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import type { ProductTierEnum } from '../../enums/ProductTierEnum';
+import type { TrackingModeEnum } from '../../enums/TrackingModeEnum';
+import type { ProductComponent } from '../ProductComponent';
+/** Fila por SKU del catálogo de venta de una tienda (privateGetStoreStockCatalog). */
+export interface StoreCatalogItem {
+    sku: string;
+    /** Piezas disponibles; en un kit, el mínimo que alcanzan sus componentes. */
+    available: number;
+    basePriceCents: number;
+    category: ProductCategoryEnum;
+    trackingMode: TrackingModeEnum;
+    brand: string;
+    model: string;
+    capacity: string;
+    color: string;
+    imageUrl: string | null;
+    tier: ProductTierEnum | null;
+    eligibleFinanciers: string[];
+    mdmEnabled: boolean;
+    mdmProvider: MdmProviderEnum | null;
+    mdmLockMode: MdmLockModeEnum | null;
+    /** Solo si es kit. */
+    components?: ProductComponent[];
+}
+/** Response de privateGetStoreStockCatalog. */
+export type GetStoreStockCatalogResponse = StoreCatalogItem[];

package/bin/retailCatalog/dtos/responses/StoreCatalogItem.js

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

package/bin/retailCatalog/dtos/responses/SuggestPiecesResponse.d.ts

@@ -0,0 +1,6 @@
+/** Pieza AVAILABLE sugerida por prefijo. */
+export interface SuggestedPiece {
+    identifier: string;
+}
+/** Response de privateSuggestPieces, con tope de resultados. */
+export type SuggestPiecesResponse = SuggestedPiece[];

package/bin/retailCatalog/dtos/responses/SuggestPiecesResponse.js

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

package/bin/retailCatalog/dtos/responses/SyncInventoryResponse.d.ts

@@ -0,0 +1,13 @@
+import type { InventorySyncRejectionCodeEnum } from '../../enums/InventorySyncRejectionCodeEnum';
+import type { InventorySyncResultStatusEnum } from '../../enums/InventorySyncResultStatusEnum';
+/** Resultado de un ítem del lote; `code` solo viene con REJECTED. */
+export interface InventorySyncResult {
+    /** Identifica el ítem del lote (SKU, o tienda + SKU + identificador). */
+    key: string;
+    status: InventorySyncResultStatusEnum;
+    code?: InventorySyncRejectionCodeEnum;
+}
+/** Response de privateSyncInventory: siempre 200, con resultado por ítem. */
+export interface SyncInventoryResponse {
+    results: InventorySyncResult[];
+}

package/bin/retailCatalog/dtos/responses/SyncInventoryResponse.js

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

package/bin/retailCatalog/dtos/validation/ValidateProductResponse.d.ts

@@ -2,6 +2,8 @@ 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';
 /**
  * Response de GET /private/products/:retailerId/:sku — validar que el producto existe + status.
  * Incluye los campos que los downstream consumen: `eligibleFinanciers` (wizard F2 paso 4)
@@ -12,9 +14,12 @@ export declare class ValidateProductResponse {
     retailerId: string;
     sku: string;
     status: ProductStatusEnum;
-    tier: ProductTierEnum;
+    /** `null` = Sin gama. */
+    tier: ProductTierEnum | null;
     eligibleFinanciers: string[];
     mdmEnabled: boolean;
     mdmProvider: MdmProviderEnum | null;
     mdmLockMode: MdmLockModeEnum | null;
+    category?: ProductCategoryEnum;
+    trackingMode?: TrackingModeEnum;
 }

package/bin/retailCatalog/enums/InventoryLensFilterEnum.d.ts

@@ -17,5 +17,7 @@ export declare enum InventoryLensFilterEnum {
     /** Top vendidos en LUGA que SureKeep no financia. **No disponible** (INT6). */
     GAP = "gap",
     /** Desbalance de stock del mismo SKU entre tiendas. */
-    TRANSFERS = "transfers"
+    TRANSFERS = "transfers",
+    /** Lista por SKU del Inventario v3, con stock, ventas del periodo, cobertura y alertas. */
+    LIST = "list"
 }

package/bin/retailCatalog/enums/InventoryLensFilterEnum.js

@@ -22,4 +22,6 @@ var InventoryLensFilterEnum;
     InventoryLensFilterEnum["GAP"] = "gap";
     /** Desbalance de stock del mismo SKU entre tiendas. */
     InventoryLensFilterEnum["TRANSFERS"] = "transfers";
+    /** Lista por SKU del Inventario v3, con stock, ventas del periodo, cobertura y alertas. */
+    InventoryLensFilterEnum["LIST"] = "list";
 })(InventoryLensFilterEnum || (exports.InventoryLensFilterEnum = InventoryLensFilterEnum = {}));

package/bin/retailCatalog/enums/InventoryLensPeriodEnum.d.ts

@@ -0,0 +1,7 @@
+/** Periodo de ventas y cobertura del Inventario v3; viaja en query string. `all` cuenta como 90 días. */
+export declare enum InventoryLensPeriodEnum {
+    DAYS_7 = "7d",
+    DAYS_30 = "30d",
+    DAYS_90 = "90d",
+    ALL = "all"
+}

package/bin/retailCatalog/enums/InventoryLensPeriodEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InventoryLensPeriodEnum = void 0;
+/** Periodo de ventas y cobertura del Inventario v3; viaja en query string. `all` cuenta como 90 días. */
+var InventoryLensPeriodEnum;
+(function (InventoryLensPeriodEnum) {
+    InventoryLensPeriodEnum["DAYS_7"] = "7d";
+    InventoryLensPeriodEnum["DAYS_30"] = "30d";
+    InventoryLensPeriodEnum["DAYS_90"] = "90d";
+    InventoryLensPeriodEnum["ALL"] = "all";
+})(InventoryLensPeriodEnum || (exports.InventoryLensPeriodEnum = InventoryLensPeriodEnum = {}));

package/bin/retailCatalog/enums/InventoryMovementTypeEnum.d.ts

@@ -0,0 +1,9 @@
+/** Tipo de movimiento del libro de inventario (MOV#) de una tienda. */
+export declare enum InventoryMovementTypeEnum {
+    ENTRY = "ENTRY",
+    RESERVATION = "RESERVATION",
+    RELEASE = "RELEASE",
+    SALE = "SALE",
+    RETURN = "RETURN",
+    ADJUSTMENT = "ADJUSTMENT"
+}

package/bin/retailCatalog/enums/InventoryMovementTypeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InventoryMovementTypeEnum = void 0;
+/** Tipo de movimiento del libro de inventario (MOV#) de una tienda. */
+var InventoryMovementTypeEnum;
+(function (InventoryMovementTypeEnum) {
+    InventoryMovementTypeEnum["ENTRY"] = "ENTRY";
+    InventoryMovementTypeEnum["RESERVATION"] = "RESERVATION";
+    InventoryMovementTypeEnum["RELEASE"] = "RELEASE";
+    InventoryMovementTypeEnum["SALE"] = "SALE";
+    InventoryMovementTypeEnum["RETURN"] = "RETURN";
+    InventoryMovementTypeEnum["ADJUSTMENT"] = "ADJUSTMENT";
+})(InventoryMovementTypeEnum || (exports.InventoryMovementTypeEnum = InventoryMovementTypeEnum = {}));

package/bin/retailCatalog/enums/InventorySyncRejectionCodeEnum.d.ts

@@ -0,0 +1,9 @@
+/** Motivo por el que la puerta de entrada rechaza un ítem; el resto del lote sí se aplica. */
+export declare enum InventorySyncRejectionCodeEnum {
+    /** El identificador ya existe en otra tienda o SKU del tenant. */
+    DUPLICATE_IDENTIFIER = "DUPLICATE_IDENTIFIER",
+    /** El ajuste de un SKU por cantidad deja el saldo por debajo de lo reservado. */
+    ADJUSTMENT_EXCEEDS_AVAILABLE = "ADJUSTMENT_EXCEEDS_AVAILABLE",
+    /** El precio trae una vigencia futura, que este ciclo no se admite. */
+    FUTURE_PRICE_NOT_SUPPORTED = "FUTURE_PRICE_NOT_SUPPORTED"
+}

package/bin/retailCatalog/enums/InventorySyncRejectionCodeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InventorySyncRejectionCodeEnum = void 0;
+/** Motivo por el que la puerta de entrada rechaza un ítem; el resto del lote sí se aplica. */
+var InventorySyncRejectionCodeEnum;
+(function (InventorySyncRejectionCodeEnum) {
+    /** El identificador ya existe en otra tienda o SKU del tenant. */
+    InventorySyncRejectionCodeEnum["DUPLICATE_IDENTIFIER"] = "DUPLICATE_IDENTIFIER";
+    /** El ajuste de un SKU por cantidad deja el saldo por debajo de lo reservado. */
+    InventorySyncRejectionCodeEnum["ADJUSTMENT_EXCEEDS_AVAILABLE"] = "ADJUSTMENT_EXCEEDS_AVAILABLE";
+    /** El precio trae una vigencia futura, que este ciclo no se admite. */
+    InventorySyncRejectionCodeEnum["FUTURE_PRICE_NOT_SUPPORTED"] = "FUTURE_PRICE_NOT_SUPPORTED";
+})(InventorySyncRejectionCodeEnum || (exports.InventorySyncRejectionCodeEnum = InventorySyncRejectionCodeEnum = {}));

package/bin/retailCatalog/enums/InventorySyncResultStatusEnum.d.ts

@@ -0,0 +1,6 @@
+/** Resultado por ítem de la puerta de entrada (sync): aplicado, sin cambios o rechazado. */
+export declare enum InventorySyncResultStatusEnum {
+    APPLIED = "APPLIED",
+    NOOP = "NOOP",
+    REJECTED = "REJECTED"
+}

package/bin/retailCatalog/enums/InventorySyncResultStatusEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InventorySyncResultStatusEnum = void 0;
+/** Resultado por ítem de la puerta de entrada (sync): aplicado, sin cambios o rechazado. */
+var InventorySyncResultStatusEnum;
+(function (InventorySyncResultStatusEnum) {
+    InventorySyncResultStatusEnum["APPLIED"] = "APPLIED";
+    InventorySyncResultStatusEnum["NOOP"] = "NOOP";
+    InventorySyncResultStatusEnum["REJECTED"] = "REJECTED";
+})(InventorySyncResultStatusEnum || (exports.InventorySyncResultStatusEnum = InventorySyncResultStatusEnum = {}));

package/bin/retailCatalog/enums/PriceSourceEnum.d.ts

@@ -0,0 +1,4 @@
+/** Origen de un registro del historial de precios (PRICE#). */
+export declare enum PriceSourceEnum {
+    ZENTRAL_SYNC = "ZENTRAL_SYNC"
+}

package/bin/retailCatalog/enums/PriceSourceEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PriceSourceEnum = void 0;
+/** Origen de un registro del historial de precios (PRICE#). */
+var PriceSourceEnum;
+(function (PriceSourceEnum) {
+    PriceSourceEnum["ZENTRAL_SYNC"] = "ZENTRAL_SYNC";
+})(PriceSourceEnum || (exports.PriceSourceEnum = PriceSourceEnum = {}));

package/bin/retailCatalog/enums/ProductCategoryEnum.d.ts

@@ -0,0 +1,9 @@
+/** Categoría del producto tal como llega de Zentral; solo PHONE lleva configuración MDM. */
+export declare enum ProductCategoryEnum {
+    PHONE = "PHONE",
+    SIM = "SIM",
+    MODEM = "MODEM",
+    ACCESSORY = "ACCESSORY",
+    /** Kit: se vende como una línea y consume el stock de sus componentes. */
+    BUNDLE = "BUNDLE"
+}

package/bin/retailCatalog/enums/ProductCategoryEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductCategoryEnum = void 0;
+/** Categoría del producto tal como llega de Zentral; solo PHONE lleva configuración MDM. */
+var ProductCategoryEnum;
+(function (ProductCategoryEnum) {
+    ProductCategoryEnum["PHONE"] = "PHONE";
+    ProductCategoryEnum["SIM"] = "SIM";
+    ProductCategoryEnum["MODEM"] = "MODEM";
+    ProductCategoryEnum["ACCESSORY"] = "ACCESSORY";
+    /** Kit: se vende como una línea y consume el stock de sus componentes. */
+    ProductCategoryEnum["BUNDLE"] = "BUNDLE";
+})(ProductCategoryEnum || (exports.ProductCategoryEnum = ProductCategoryEnum = {}));

package/bin/retailCatalog/enums/TrackingModeEnum.d.ts

@@ -0,0 +1,6 @@
+/** Cómo se rastrea el stock de un producto: por pieza (IMEI o serie) o solo por cantidad. */
+export declare enum TrackingModeEnum {
+    IMEI = "IMEI",
+    SERIAL = "SERIAL",
+    QUANTITY = "QUANTITY"
+}

package/bin/retailCatalog/enums/TrackingModeEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrackingModeEnum = void 0;
+/** Cómo se rastrea el stock de un producto: por pieza (IMEI o serie) o solo por cantidad. */
+var TrackingModeEnum;
+(function (TrackingModeEnum) {
+    TrackingModeEnum["IMEI"] = "IMEI";
+    TrackingModeEnum["SERIAL"] = "SERIAL";
+    TrackingModeEnum["QUANTITY"] = "QUANTITY";
+})(TrackingModeEnum || (exports.TrackingModeEnum = TrackingModeEnum = {}));

package/bin/retailCatalog/index.d.ts

@@ -25,3 +25,32 @@ export * from './dtos/responses/ImportCsvResult';
 export * from './dtos/responses/InventoryLensResponse';
 export * from './dtos/validation/ValidateProductResponse';
 export * from './dtos/validation/ValidateInventoryResponse';
+export * from './enums/ProductCategoryEnum';
+export * from './enums/TrackingModeEnum';
+export * from './enums/InventoryMovementTypeEnum';
+export * from './enums/InventorySyncResultStatusEnum';
+export * from './enums/InventorySyncRejectionCodeEnum';
+export * from './enums/PriceSourceEnum';
+export * from './enums/InventoryLensPeriodEnum';
+export * from './dtos/ProductComponent';
+export * from './dtos/requests/ReservationLineRef';
+export * from './dtos/requests/StockLine';
+export * from './dtos/requests/ReserveStockRequest';
+export * from './dtos/requests/RenewReservationsRequest';
+export * from './dtos/requests/SuggestPiecesQuery';
+export * from './dtos/requests/SellStockRequest';
+export * from './dtos/requests/ReleaseStockRequest';
+export * from './dtos/requests/ReturnStockRequest';
+export * from './dtos/requests/SyncInventoryRequest';
+export * from './dtos/requests/GetInventorySkuQuery';
+export * from './dtos/responses/ReserveStockResponse';
+export * from './dtos/responses/RenewReservationsResponse';
+export * from './dtos/responses/SuggestPiecesResponse';
+export * from './dtos/responses/SellStockResponse';
+export * from './dtos/responses/ReleaseStockResponse';
+export * from './dtos/responses/ReturnStockResponse';
+export * from './dtos/responses/SyncInventoryResponse';
+export * from './dtos/responses/StoreCatalogItem';
+export * from './dtos/responses/SkuPriceEntry';
+export * from './dtos/responses/GetInventorySkuResponse';
+export * from './dtos/responses/ListSkuPricesResponse';

package/bin/retailCatalog/index.js

@@ -48,3 +48,33 @@ __exportStar(require("./dtos/responses/InventoryLensResponse"), exports);
 // Validation DTOs (shapes de endpoints privados)
 __exportStar(require("./dtos/validation/ValidateProductResponse"), exports);
 __exportStar(require("./dtos/validation/ValidateInventoryResponse"), exports);
+// Inventario multi-item (ciclo 1)
+__exportStar(require("./enums/ProductCategoryEnum"), exports);
+__exportStar(require("./enums/TrackingModeEnum"), exports);
+__exportStar(require("./enums/InventoryMovementTypeEnum"), exports);
+__exportStar(require("./enums/InventorySyncResultStatusEnum"), exports);
+__exportStar(require("./enums/InventorySyncRejectionCodeEnum"), exports);
+__exportStar(require("./enums/PriceSourceEnum"), exports);
+__exportStar(require("./enums/InventoryLensPeriodEnum"), exports);
+__exportStar(require("./dtos/ProductComponent"), exports);
+__exportStar(require("./dtos/requests/ReservationLineRef"), exports);
+__exportStar(require("./dtos/requests/StockLine"), exports);
+__exportStar(require("./dtos/requests/ReserveStockRequest"), exports);
+__exportStar(require("./dtos/requests/RenewReservationsRequest"), exports);
+__exportStar(require("./dtos/requests/SuggestPiecesQuery"), exports);
+__exportStar(require("./dtos/requests/SellStockRequest"), exports);
+__exportStar(require("./dtos/requests/ReleaseStockRequest"), exports);
+__exportStar(require("./dtos/requests/ReturnStockRequest"), exports);
+__exportStar(require("./dtos/requests/SyncInventoryRequest"), exports);
+__exportStar(require("./dtos/requests/GetInventorySkuQuery"), exports);
+__exportStar(require("./dtos/responses/ReserveStockResponse"), exports);
+__exportStar(require("./dtos/responses/RenewReservationsResponse"), exports);
+__exportStar(require("./dtos/responses/SuggestPiecesResponse"), exports);
+__exportStar(require("./dtos/responses/SellStockResponse"), exports);
+__exportStar(require("./dtos/responses/ReleaseStockResponse"), exports);
+__exportStar(require("./dtos/responses/ReturnStockResponse"), exports);
+__exportStar(require("./dtos/responses/SyncInventoryResponse"), exports);
+__exportStar(require("./dtos/responses/StoreCatalogItem"), exports);
+__exportStar(require("./dtos/responses/SkuPriceEntry"), exports);
+__exportStar(require("./dtos/responses/GetInventorySkuResponse"), exports);
+__exportStar(require("./dtos/responses/ListSkuPricesResponse"), exports);

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

@@ -4,6 +4,7 @@ import type { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
 import type { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
 import type { CentralSyncStatusEnum } from '../enums/CentralSyncStatusEnum';
 import type { SalePaymentDetail } from './SalePaymentDetail';
+import type { SaleLine } from './SaleLine';
 /**
  * Venta (modelo-datos §3). pk `SALE#<saleId>` · sk `META` · 4 GSIs (`retailerId-soldAt-index`,
  * `storeId-soldAt-index`, `seller-soldAt-index`, `customerId-soldAt-index`). Unicidad de folio vía
@@ -19,6 +20,12 @@ export interface Sale {
     type: SaleTypeEnum;
     externalProvider: ExternalProviderEnum | null;
     sku: string;
+    /** Líneas vendidas; `sku` e `imei` siguen siendo los del teléfono financiado o de la línea principal. */
+    lines?: SaleLine[];
+    /** SKUs de líneas y componentes, para filtrar ventas por SKU. */
+    skus?: string[];
+    /** La cancelación aún no confirma la devolución al inventario. */
+    inventoryReturnPending?: boolean;
     /** IMEI consumido del silo también en contado (local-first); null en EXTERNAL_REFERRAL (D15). */
     imei: string | null;
     /**

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

@@ -0,0 +1,16 @@
+import type { SoldLineComponent } from '../../retailCatalog/dtos/responses/SellStockResponse';
+import type { LinePaymentTypeEnum } from '../enums/LinePaymentTypeEnum';
+import type { WizardLineProduct } from './WizardLineProduct';
+/** Línea de una venta cerrada; un producto suelto es un solo componente. */
+export interface SaleLine {
+    lineId: string;
+    sku: string;
+    qty: number;
+    basePriceCents: number;
+    listPriceCents: number | null;
+    /** Llave del registro PRICE# del que salió el precio. */
+    priceSk: string;
+    paymentType: LinePaymentTypeEnum;
+    components: SoldLineComponent[];
+    product?: WizardLineProduct | null;
+}

package/bin/retailWizard/dtos/SaleLine.js

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

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