hvp-shared 6.2.0 → 6.4.0

package/dist/constants/catalog-item.constants.d.ts

@@ -30,6 +30,37 @@ export declare const USAGE_TYPE_VALUES: UsageType[];
  * UsageType labels in Spanish (for UI)
  */
 export declare const USAGE_TYPE_LABELS: Record<UsageType, string>;
+/**
+ * StockPolicy - How stock levels are managed for an item
+ *
+ * This is an HVP-only field (not in QVET).
+ * Determined by QVET's tipoControlStock field on sync.
+ */
+export declare enum StockPolicy {
+    /** Stock min/max calculated based on consumption history */
+    DEMAND_BASED = "demandBased",
+    /** Only ordered when customer requests, min/max = 0 but system proposes values */
+    ON_DEMAND = "onDemand",
+    /** No longer sold, min/max = 0, no proposals */
+    DISCONTINUED = "discontinued",
+    /** User defines stock levels manually, system does not calculate */
+    MANUAL = "manual",
+    /** No stock control (services, etc.), field not editable */
+    NOT_APPLICABLE = "notApplicable"
+}
+/**
+ * All StockPolicy values as array (for dropdowns)
+ */
+export declare const STOCK_POLICY_VALUES: StockPolicy[];
+/**
+ * StockPolicy labels in Spanish (for UI)
+ */
+export declare const STOCK_POLICY_LABELS: Record<StockPolicy, string>;
+/**
+ * Editable stock policies (for UI validation)
+ * notApplicable is not editable - it's set automatically based on tipoControlStock
+ */
+export declare const EDITABLE_STOCK_POLICIES: StockPolicy[];
 /**
  * ArticleType - Type of article in QVET
  */

package/dist/constants/catalog-item.constants.js

@@ -5,7 +5,7 @@
  * Enums and constants for catalog items (products/services from QVET).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SYNC_STATUS_LABELS = exports.SYNC_STATUS_VALUES = exports.SyncStatus = exports.BRAND_VALUES = exports.Brand = exports.TARIFF_TYPE_LABELS = exports.TARIFF_TYPE_VALUES = exports.TariffType = exports.ARTICLE_TYPE_VALUES = exports.ArticleType = exports.USAGE_TYPE_LABELS = exports.USAGE_TYPE_VALUES = exports.UsageType = void 0;
+exports.SYNC_STATUS_LABELS = exports.SYNC_STATUS_VALUES = exports.SyncStatus = exports.BRAND_VALUES = exports.Brand = exports.TARIFF_TYPE_LABELS = exports.TARIFF_TYPE_VALUES = exports.TariffType = exports.ARTICLE_TYPE_VALUES = exports.ArticleType = exports.EDITABLE_STOCK_POLICIES = exports.STOCK_POLICY_LABELS = exports.STOCK_POLICY_VALUES = exports.StockPolicy = exports.USAGE_TYPE_LABELS = exports.USAGE_TYPE_VALUES = exports.UsageType = void 0;
 /**
  * UsageType - How the item is used in HVP
  *
@@ -41,6 +41,49 @@ exports.USAGE_TYPE_LABELS = {
     [UsageType.FIXED_ASSET]: 'Activo Fijo',
     [UsageType.NOT_APPLICABLE]: 'No Aplica',
 };
+/**
+ * StockPolicy - How stock levels are managed for an item
+ *
+ * This is an HVP-only field (not in QVET).
+ * Determined by QVET's tipoControlStock field on sync.
+ */
+var StockPolicy;
+(function (StockPolicy) {
+    /** Stock min/max calculated based on consumption history */
+    StockPolicy["DEMAND_BASED"] = "demandBased";
+    /** Only ordered when customer requests, min/max = 0 but system proposes values */
+    StockPolicy["ON_DEMAND"] = "onDemand";
+    /** No longer sold, min/max = 0, no proposals */
+    StockPolicy["DISCONTINUED"] = "discontinued";
+    /** User defines stock levels manually, system does not calculate */
+    StockPolicy["MANUAL"] = "manual";
+    /** No stock control (services, etc.), field not editable */
+    StockPolicy["NOT_APPLICABLE"] = "notApplicable";
+})(StockPolicy || (exports.StockPolicy = StockPolicy = {}));
+/**
+ * All StockPolicy values as array (for dropdowns)
+ */
+exports.STOCK_POLICY_VALUES = Object.values(StockPolicy);
+/**
+ * StockPolicy labels in Spanish (for UI)
+ */
+exports.STOCK_POLICY_LABELS = {
+    [StockPolicy.DEMAND_BASED]: 'Basado en Demanda',
+    [StockPolicy.ON_DEMAND]: 'Bajo Pedido',
+    [StockPolicy.DISCONTINUED]: 'Descontinuado',
+    [StockPolicy.MANUAL]: 'Manual',
+    [StockPolicy.NOT_APPLICABLE]: 'No Aplica',
+};
+/**
+ * Editable stock policies (for UI validation)
+ * notApplicable is not editable - it's set automatically based on tipoControlStock
+ */
+exports.EDITABLE_STOCK_POLICIES = [
+    StockPolicy.DEMAND_BASED,
+    StockPolicy.ON_DEMAND,
+    StockPolicy.DISCONTINUED,
+    StockPolicy.MANUAL,
+];
 /**
  * ArticleType - Type of article in QVET
  */

package/dist/contracts/catalog-item/requests.d.ts

@@ -3,7 +3,7 @@
  *
  * Request DTOs for catalog item endpoints.
  */
-import { UsageType, SyncStatus } from '../../constants/catalog-item.constants';
+import { UsageType, SyncStatus, StockPolicy } from '../../constants/catalog-item.constants';
 import { MarketCompetition } from '../../constants/market-competition.constants';
 import { PricingRuleCode } from '../../constants/pricing-rule.constants';
 /**
@@ -104,7 +104,11 @@ export interface UpdateCatalogItemHvpDataRequest {
     pricingRuleCode?: PricingRuleCode;
     /** Recommended price (calculated from pricing rule) */
     recommendedPrice?: number;
-    /** Flag: item requires manual stock review (algorithm doesn't apply) */
+    /** How stock levels are managed */
+    stockPolicy?: StockPolicy;
+    /** Observations generated by analysis script */
+    stockObservations?: string;
+    /** @deprecated Use stockPolicy: 'manual' instead */
     requiresManualReview?: boolean;
 }
 /**

package/dist/contracts/catalog-item/responses.d.ts

@@ -4,7 +4,7 @@
  * Response DTOs for catalog item endpoints.
  */
 import { SyncField } from '../../types/sync-field.types';
-import { UsageType, SyncStatus } from '../../constants/catalog-item.constants';
+import { UsageType, SyncStatus, StockPolicy } from '../../constants/catalog-item.constants';
 import { MarketCompetition } from '../../constants/market-competition.constants';
 import { PricingRuleCode } from '../../constants/pricing-rule.constants';
 import { Warehouse } from '../../types/qvet.types';
@@ -136,7 +136,11 @@ export interface CatalogItemDetailResponse {
          * Calculated from: cost * (1 + targetMargin/100) * (1 + VAT/100)
          */
         recommendedPrice?: number;
-        /** Flag: item requires manual stock review (algorithm doesn't apply) */
+        /** How stock levels are managed */
+        stockPolicy?: StockPolicy;
+        /** Observations generated by analysis script */
+        stockObservations?: string;
+        /** @deprecated Use stockPolicy: 'manual' instead */
         requiresManualReview?: boolean;
     };
     hasPendingChanges: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "6.2.0",
+  "version": "6.4.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",