@fiado/type-kit 3.459.0 → 3.461.0

package/src/retailCatalog/dtos/requests/SyncInventoryRequest.ts

@@ -0,0 +1,145 @@
+import { Type } from 'class-transformer';
+import {
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsInt,
+    IsISO8601,
+    IsOptional,
+    IsString,
+    Length,
+    Matches,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
+import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
+import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../enums/ProductTierEnum';
+import { TrackingModeEnum } from '../../enums/TrackingModeEnum';
+import { ProductComponent } from '../ProductComponent';
+
+/** Precio de un producto en la puerta de entrada; crea PRICE# solo si cambió el monto. */
+export class SyncPrice {
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    listPriceCents?: number | null;
+
+    @IsInt()
+    @Min(0)
+    basePriceCents!: number;
+
+    @IsISO8601()
+    effectiveFrom!: string;
+}
+
+/** Producto tal como llega de Zentral. */
+export class SyncProduct {
+    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Length(1, 64)
+    @IsString()
+    sku!: string;
+
+    @IsEnum(ProductCategoryEnum)
+    category!: ProductCategoryEnum;
+
+    @IsEnum(TrackingModeEnum)
+    trackingMode!: TrackingModeEnum;
+
+    @IsBoolean()
+    sellable!: boolean;
+
+    @IsBoolean()
+    showInSalesFlow!: boolean;
+
+    @IsArray()
+    @IsString({ each: true })
+    eligibleFinanciers!: string[];
+
+    /** Solo en BUNDLE. */
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => ProductComponent)
+    components?: ProductComponent[];
+
+    /** `null` o ausente = Sin gama. */
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    tier?: ProductTierEnum | null;
+
+    @ValidateNested()
+    @Type(() => SyncPrice)
+    price!: SyncPrice;
+
+    // Datos descriptivos y MDM: un producto nuevo de Zentral solo entra por esta puerta.
+    @IsOptional()
+    @IsString()
+    brand?: string;
+
+    @IsOptional()
+    @IsString()
+    model?: string;
+
+    @IsOptional()
+    @IsString()
+    capacity?: string;
+
+    @IsOptional()
+    @IsString()
+    color?: string;
+
+    @IsOptional()
+    @IsString()
+    description?: string;
+
+    @IsOptional()
+    @IsString()
+    imageUrl?: string | null;
+
+    @IsOptional()
+    @IsBoolean()
+    mdmEnabled?: boolean;
+
+    @IsOptional()
+    @IsEnum(MdmProviderEnum)
+    mdmProvider?: MdmProviderEnum | null;
+
+    @IsOptional()
+    @IsEnum(MdmLockModeEnum)
+    mdmLockMode?: MdmLockModeEnum | null;
+}
+
+/** Stock de un SKU en una tienda: `qty` para SKUs por cantidad, `identifiers` para IMEI o serie. */
+export class SyncStock {
+    @IsString()
+    storeId!: string;
+
+    @IsString()
+    sku!: string;
+
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    qty?: number;
+
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    identifiers?: string[];
+}
+
+/** Body de POST /private/retailers/{retailerId}/inventory/sync (privateSyncInventory), la puerta de entrada. */
+export class SyncInventoryRequest {
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SyncProduct)
+    products!: SyncProduct[];
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SyncStock)
+    stock!: SyncStock[];
+}

package/src/retailCatalog/dtos/responses/GetInventorySkuResponse.ts

@@ -0,0 +1,38 @@
+import type { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnum';
+import type { InventoryMovementTypeEnum } from '../../enums/InventoryMovementTypeEnum';
+import type { SkuPriceEntry } from './SkuPriceEntry';
+
+/** Un movimiento del libro de inventario. */
+export interface InventoryMovementEntry {
+    storeId: string;
+    sku: string;
+    type: InventoryMovementTypeEnum;
+    qty: number;
+    /** IMEI o serie; `null` en SKUs por cantidad. */
+    identifier: string | null;
+    occurredAt: string;
+    createdBy: string;
+}
+
+/** Pieza de una tienda; status AVAILABLE, SOLD o DAMAGED. */
+export interface InventoryPieceEntry {
+    identifier: string;
+    status: InventoryItemStatusEnum;
+}
+
+/** Piezas de un SKU con IMEI o serie en una tienda. */
+export interface InventoryStorePieces {
+    storeId: string;
+    pieces: InventoryPieceEntry[];
+}
+
+/** Response de backofficeGetInventorySku: solo lo que la fila de filter=list no trae. */
+export interface GetInventorySkuResponse {
+    sku: string;
+    movements: InventoryMovementEntry[];
+    /** Página siguiente del libro; `null` si no hay más. */
+    nextToken: string | null;
+    /** Vacío si el SKU se rastrea por cantidad. */
+    piecesByStore: InventoryStorePieces[];
+    currentPrice: SkuPriceEntry | null;
+}

package/src/retailCatalog/dtos/responses/InventoryLensResponse.ts

@@ -1,4 +1,7 @@
 import type { InventoryLensFilterEnum } from '../../enums/InventoryLensFilterEnum';
+import type { InventoryLensPeriodEnum } from '../../enums/InventoryLensPeriodEnum';
+import type { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
+import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { InventoryLensUnavailableReasonEnum } from '../../enums/InventoryLensUnavailableReasonEnum';
 import type { InventoryTransferReasonEnum } from '../../enums/InventoryTransferReasonEnum';
 
@@ -87,8 +90,47 @@ export interface InventoryLensTransferSuggestion {
     reason: InventoryTransferReasonEnum;
 }
 
+/** Stock y ventas del periodo de un SKU en una tienda. */
+export interface InventoryLensStoreStock {
+    storeId: string;
+    stock: number;
+    sold: number;
+}
+
+/** Alertas de una fila del modo lista. */
+export interface InventoryLensAlerts {
+    /** Cobertura menor a 7 días con stock. */
+    lowStock: boolean;
+    /** Más de 5 piezas sin ventas en el periodo. */
+    slowMover: boolean;
+    outOfStock: boolean;
+    /** Ventas de 30 días en el percentil 90 del tenant. */
+    topRotation: boolean;
+}
+
+/** Días de cobertura: número, `INFINITE` con stock sin ventas, `null` sin stock. */
+export type InventoryLensCoverage = number | 'INFINITE' | null;
+
+/** Una fila del modo `list` (Inventario v3): un SKU consolidado o de la tienda pedida. */
+export interface InventoryLensListItem {
+    sku: string;
+    brand: string;
+    model: string;
+    category: ProductCategoryEnum;
+    tier: ProductTierEnum | null;
+    basePriceCents: number;
+    stockTotal: number;
+    storesWithStock: number;
+    storesTotal: number;
+    byStore: InventoryLensStoreStock[];
+    soldPeriod: number;
+    coverage: InventoryLensCoverage;
+    alerts: InventoryLensAlerts;
+    sold30d: number;
+}
+
 /** Fila del lente — el tipo depende del tab pedido. */
-export type InventoryLensItem = InventoryLensSkuItem | InventoryLensTransferSuggestion;
+export type InventoryLensItem = InventoryLensSkuItem | InventoryLensTransferSuggestion | InventoryLensListItem;
 
 /**
  * `GET /backoffice/inventory/lens?filter=…` — la pantalla «Inventario» del Portal Admin VentasLuga.
@@ -104,7 +146,11 @@ export interface InventoryLensResponse {
     /** El tab que se resolvió — eco del query, para que el front no se confunda de pestaña. */
     filter: InventoryLensFilterEnum;
 
-    counters: InventoryLensCounters;
+    /** No viaja en el modo `list`. */
+    counters?: InventoryLensCounters;
+
+    /** Eco del periodo resuelto en el modo `list`. */
+    period?: InventoryLensPeriodEnum;
 
     /** Filas del tab. Vacío cuando `unavailable` es `true`. */
     items: InventoryLensItem[];

package/src/retailCatalog/dtos/responses/ListSkuPricesResponse.ts

@@ -0,0 +1,7 @@
+import type { SkuPriceEntry } from './SkuPriceEntry';
+
+/** Response de GET /backoffice/inventory/skus/{sku}/prices; más reciente primero. */
+export interface ListSkuPricesResponse {
+    sku: string;
+    items: SkuPriceEntry[];
+}

package/src/retailCatalog/dtos/responses/ReleaseStockResponse.ts

@@ -0,0 +1,11 @@
+/** 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/src/retailCatalog/dtos/responses/RenewReservationsResponse.ts

@@ -0,0 +1,11 @@
+/** 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/src/retailCatalog/dtos/responses/ReserveStockResponse.ts

@@ -0,0 +1,27 @@
+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/src/retailCatalog/dtos/responses/ReturnStockResponse.ts

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

package/src/retailCatalog/dtos/responses/SellStockResponse.ts

@@ -0,0 +1,20 @@
+/** 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/src/retailCatalog/dtos/responses/SkuPriceEntry.ts

@@ -0,0 +1,10 @@
+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/src/retailCatalog/dtos/responses/StoreCatalogItem.ts

@@ -0,0 +1,31 @@
+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/src/retailCatalog/dtos/responses/SuggestPiecesResponse.ts

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

package/src/retailCatalog/dtos/responses/SyncInventoryResponse.ts

@@ -0,0 +1,15 @@
+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/src/retailCatalog/dtos/validation/ValidateProductResponse.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.
@@ -13,9 +15,12 @@ export 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/src/retailCatalog/enums/InventoryLensFilterEnum.ts

@@ -18,4 +18,6 @@ export enum InventoryLensFilterEnum {
     GAP = 'gap',
     /** Desbalance de stock del mismo SKU entre tiendas. */
     TRANSFERS = 'transfers',
+    /** Lista por SKU del Inventario v3, con stock, ventas del periodo, cobertura y alertas. */
+    LIST = 'list',
 }

package/src/retailCatalog/enums/InventoryLensPeriodEnum.ts

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

package/src/retailCatalog/enums/InventoryMovementTypeEnum.ts

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

package/src/retailCatalog/enums/InventorySyncRejectionCodeEnum.ts

@@ -0,0 +1,9 @@
+/** Motivo por el que la puerta de entrada rechaza un ítem; el resto del lote sí se aplica. */
+export 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/src/retailCatalog/enums/InventorySyncResultStatusEnum.ts

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

package/src/retailCatalog/enums/PriceSourceEnum.ts

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

package/src/retailCatalog/enums/ProductCategoryEnum.ts

@@ -0,0 +1,9 @@
+/** Categoría del producto tal como llega de Zentral; solo PHONE lleva configuración MDM. */
+export 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/src/retailCatalog/enums/TrackingModeEnum.ts

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

package/src/retailCatalog/index.ts

@@ -39,3 +39,34 @@ export * from './dtos/responses/InventoryLensResponse';
 // Validation DTOs (shapes de endpoints privados)
 export * from './dtos/validation/ValidateProductResponse';
 export * from './dtos/validation/ValidateInventoryResponse';
+
+// Inventario multi-item (ciclo 1)
+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/src/retailWizard/dtos/Sale.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`,
@@ -20,6 +21,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/src/retailWizard/dtos/SaleLine.ts

@@ -0,0 +1,17 @@
+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/src/retailWizard/dtos/WizardLineIdentifiers.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/src/retailWizard/dtos/WizardLineProduct.ts

@@ -0,0 +1,16 @@
+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/src/retailWizard/dtos/WizardProduct.ts

@@ -1,3 +1,6 @@
+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 +41,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/src/retailWizard/dtos/WizardReservedLine.ts

@@ -0,0 +1,36 @@
+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;
+}