hvp-shared 6.46.0 → 6.47.0

package/dist/constants/pricing.constants.d.ts

@@ -128,4 +128,29 @@ export declare function calculateRecommendedPricePVP(params: {
     unitPurchasePriceBI: number;
     vatSalePercent: number;
 }): number | null;
+/** Cost-based multiplier for floor price (PHARM, PHARM_FRAC, COST_ML, COST) */
+export declare const MIN_PRICE_COST_FACTOR = 0.25;
+/** Cost-based multiplier for floor price (EXT_COST) */
+export declare const MIN_PRICE_EXT_COST_FACTOR = 1;
+/** Fraction of salePricePVP for recommended minimum price (COMP_SVC) */
+export declare const MIN_PRICE_COMP_SVC_SALE_FRACTION = 0.5;
+export interface FloorPriceResult {
+    recommendedMinimumPrice: number | null;
+    floorPrice: number | null;
+}
+/**
+ * Calculate floor prices (recommended minimum price and absolute floor) for a catalog item.
+ *
+ * Business rules by PricePolicy:
+ * - PHARM, PHARM_FRAC, COST_ML, COST: both = unitCostBI × 0.25 × (1 + VAT/100), round5
+ * - EXT_COST: both = unitCostBI × 1.0 × (1 + VAT/100), round5
+ * - COMP_SVC: recommendedMinimumPrice = salePricePVP × 0.50 (round5), floorPrice = 0
+ * - NONE, SPECIAL, MANUAL: both null
+ */
+export declare function calculateFloorPrices(params: {
+    pricePolicy: PricePolicy;
+    unitPurchasePriceBI: number;
+    vatSalePercent: number;
+    salePricePVP: number;
+}): FloorPriceResult;
 export {};

package/dist/constants/pricing.constants.js

@@ -9,11 +9,12 @@
  *   recommendedPrice = unitCostBI * markupFactor * (1 + vatSale/100)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ALLOWED_POLICIES_BY_SECTION = exports.COMP_SVC_SECTIONS = exports.NON_SELLABLE_SECTIONS = exports.NO_FORMULA_POLICIES = exports.AUTO_TIER_POLICIES = exports.AUTO_TIER_RANGES = exports.MARKUP_FACTORS = exports.PRICING_TIER_VALUES = exports.PRICE_POLICY_VALUES = exports.PRICING_TIER_LABELS = exports.PRICE_POLICY_LABELS = exports.PricingTier = exports.PricePolicy = void 0;
+exports.MIN_PRICE_COMP_SVC_SALE_FRACTION = exports.MIN_PRICE_EXT_COST_FACTOR = exports.MIN_PRICE_COST_FACTOR = exports.ALLOWED_POLICIES_BY_SECTION = exports.COMP_SVC_SECTIONS = exports.NON_SELLABLE_SECTIONS = exports.NO_FORMULA_POLICIES = exports.AUTO_TIER_POLICIES = exports.AUTO_TIER_RANGES = exports.MARKUP_FACTORS = exports.PRICING_TIER_VALUES = exports.PRICE_POLICY_VALUES = exports.PRICING_TIER_LABELS = exports.PRICE_POLICY_LABELS = exports.PricingTier = exports.PricePolicy = void 0;
 exports.getAutoTier = getAutoTier;
 exports.getMarkupFactor = getMarkupFactor;
 exports.getDefaultPricePolicy = getDefaultPricePolicy;
 exports.calculateRecommendedPricePVP = calculateRecommendedPricePVP;
+exports.calculateFloorPrices = calculateFloorPrices;
 const qvet_catalog_1 = require("./qvet-catalog");
 // =============================================================================
 // ENUMS
@@ -214,6 +215,13 @@ function getDefaultPricePolicy(section, saleUnit, conversionFactor) {
     // Fallback: manual pricing
     return { policy: PricePolicy.MANUAL, tier: null };
 }
+// =============================================================================
+// ROUNDING HELPER
+// =============================================================================
+/** Round to nearest multiple of 5 */
+function roundToNearest5(value) {
+    return Math.round(value / 5) * 5;
+}
 /**
  * Calculate the recommended price PVP (con IVA) for a catalog item.
  *
@@ -230,6 +238,56 @@ function calculateRecommendedPricePVP(params) {
         return null;
     const priceBI = unitPurchasePriceBI * factor;
     const pricePVP = priceBI * (1 + vatSalePercent / 100);
-    // Round to nearest multiple of 5
-    return Math.round(pricePVP / 5) * 5;
+    return roundToNearest5(pricePVP);
+}
+// =============================================================================
+// FLOOR PRICE CALCULATION
+// =============================================================================
+/** Cost-based multiplier for floor price (PHARM, PHARM_FRAC, COST_ML, COST) */
+exports.MIN_PRICE_COST_FACTOR = 0.25;
+/** Cost-based multiplier for floor price (EXT_COST) */
+exports.MIN_PRICE_EXT_COST_FACTOR = 1.0;
+/** Fraction of salePricePVP for recommended minimum price (COMP_SVC) */
+exports.MIN_PRICE_COMP_SVC_SALE_FRACTION = 0.50;
+/** Policies that use cost-based floor price (cost × factor × (1+VAT)) */
+const COST_BASED_FLOOR_POLICIES = [
+    PricePolicy.PHARM,
+    PricePolicy.PHARM_FRAC,
+    PricePolicy.COST_ML,
+    PricePolicy.COST,
+];
+/**
+ * Calculate floor prices (recommended minimum price and absolute floor) for a catalog item.
+ *
+ * Business rules by PricePolicy:
+ * - PHARM, PHARM_FRAC, COST_ML, COST: both = unitCostBI × 0.25 × (1 + VAT/100), round5
+ * - EXT_COST: both = unitCostBI × 1.0 × (1 + VAT/100), round5
+ * - COMP_SVC: recommendedMinimumPrice = salePricePVP × 0.50 (round5), floorPrice = 0
+ * - NONE, SPECIAL, MANUAL: both null
+ */
+function calculateFloorPrices(params) {
+    const { pricePolicy, unitPurchasePriceBI, vatSalePercent, salePricePVP } = params;
+    // Cost-based policies (PHARM, PHARM_FRAC, COST_ML, COST)
+    if (COST_BASED_FLOOR_POLICIES.includes(pricePolicy)) {
+        if (unitPurchasePriceBI <= 0)
+            return { recommendedMinimumPrice: null, floorPrice: null };
+        const price = roundToNearest5(unitPurchasePriceBI * exports.MIN_PRICE_COST_FACTOR * (1 + vatSalePercent / 100));
+        return { recommendedMinimumPrice: price, floorPrice: price };
+    }
+    // External cost services
+    if (pricePolicy === PricePolicy.EXT_COST) {
+        if (unitPurchasePriceBI <= 0)
+            return { recommendedMinimumPrice: null, floorPrice: null };
+        const price = roundToNearest5(unitPurchasePriceBI * exports.MIN_PRICE_EXT_COST_FACTOR * (1 + vatSalePercent / 100));
+        return { recommendedMinimumPrice: price, floorPrice: price };
+    }
+    // Internal services (market-study pricing)
+    if (pricePolicy === PricePolicy.COMP_SVC) {
+        const minPrice = salePricePVP > 0
+            ? roundToNearest5(salePricePVP * exports.MIN_PRICE_COMP_SVC_SALE_FRACTION)
+            : null;
+        return { recommendedMinimumPrice: minPrice, floorPrice: 0 };
+    }
+    // NONE, SPECIAL, MANUAL — no floor prices
+    return { recommendedMinimumPrice: null, floorPrice: null };
 }

package/dist/constants/pricing.constants.test.js

@@ -312,3 +312,85 @@ describe('calculateRecommendedPricePVP', () => {
         expect(result).toBe(60);
     });
 });
+// =============================================================================
+// calculateFloorPrices
+// =============================================================================
+describe('calculateFloorPrices', () => {
+    const defaults = { unitPurchasePriceBI: 100, vatSalePercent: 16, salePricePVP: 500 };
+    describe('cost-based policies (PHARM, PHARM_FRAC, COST_ML, COST)', () => {
+        const costPolicies = [pricing_constants_1.PricePolicy.PHARM, pricing_constants_1.PricePolicy.PHARM_FRAC, pricing_constants_1.PricePolicy.COST_ML, pricing_constants_1.PricePolicy.COST];
+        it.each(costPolicies)('%s: both = cost × 0.25 × (1+VAT/100), round5', (policy) => {
+            // $100 * 0.25 * 1.16 = $29 → round5 = $30
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: policy });
+            expect(result.recommendedMinimumPrice).toBe(30);
+            expect(result.floorPrice).toBe(30);
+        });
+        it('should round to nearest 5', () => {
+            // $80 * 0.25 * 1.16 = $23.20 → round5 = $25
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.PHARM, unitPurchasePriceBI: 80 });
+            expect(result.recommendedMinimumPrice).toBe(25);
+            expect(result.floorPrice).toBe(25);
+        });
+        it('should return null when cost is 0', () => {
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.PHARM, unitPurchasePriceBI: 0 });
+            expect(result.recommendedMinimumPrice).toBeNull();
+            expect(result.floorPrice).toBeNull();
+        });
+        it('should return null when cost is negative', () => {
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.COST, unitPurchasePriceBI: -10 });
+            expect(result.recommendedMinimumPrice).toBeNull();
+            expect(result.floorPrice).toBeNull();
+        });
+        it('should handle 0% VAT', () => {
+            // $100 * 0.25 * 1.0 = $25 → $25
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.COST, vatSalePercent: 0 });
+            expect(result.recommendedMinimumPrice).toBe(25);
+            expect(result.floorPrice).toBe(25);
+        });
+    });
+    describe('EXT_COST', () => {
+        it('both = cost × 1.0 × (1+VAT/100), round5', () => {
+            // $100 * 1.0 * 1.16 = $116 → round5 = $115
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.EXT_COST });
+            expect(result.recommendedMinimumPrice).toBe(115);
+            expect(result.floorPrice).toBe(115);
+        });
+        it('should return null when cost is 0', () => {
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.EXT_COST, unitPurchasePriceBI: 0 });
+            expect(result.recommendedMinimumPrice).toBeNull();
+            expect(result.floorPrice).toBeNull();
+        });
+        it('should round to nearest 5', () => {
+            // $200 * 1.0 * 1.16 = $232 → round5 = $230
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.EXT_COST, unitPurchasePriceBI: 200 });
+            expect(result.recommendedMinimumPrice).toBe(230);
+            expect(result.floorPrice).toBe(230);
+        });
+    });
+    describe('COMP_SVC', () => {
+        it('recommendedMinimumPrice = salePricePVP × 0.50, floorPrice = 0', () => {
+            // $500 * 0.50 = $250 → round5 = $250
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.COMP_SVC });
+            expect(result.recommendedMinimumPrice).toBe(250);
+            expect(result.floorPrice).toBe(0);
+        });
+        it('should round salePricePVP fraction to nearest 5', () => {
+            // $330 * 0.50 = $165 → round5 = $165
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.COMP_SVC, salePricePVP: 330 });
+            expect(result.recommendedMinimumPrice).toBe(165);
+            expect(result.floorPrice).toBe(0);
+        });
+        it('should return null recommendedMinimumPrice when salePricePVP is 0', () => {
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.COMP_SVC, salePricePVP: 0 });
+            expect(result.recommendedMinimumPrice).toBeNull();
+            expect(result.floorPrice).toBe(0);
+        });
+    });
+    describe('no-formula policies (NONE, SPECIAL, MANUAL)', () => {
+        it.each([pricing_constants_1.PricePolicy.NONE, pricing_constants_1.PricePolicy.SPECIAL, pricing_constants_1.PricePolicy.MANUAL])('%s: both null', (policy) => {
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: policy });
+            expect(result.recommendedMinimumPrice).toBeNull();
+            expect(result.floorPrice).toBeNull();
+        });
+    });
+});

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

@@ -103,6 +103,10 @@ export interface UpdateCatalogItemHvpDataRequest {
     pricingTier?: PricingTier;
     /** Recommended price PVP (calculated from policy + tier + cost) */
     recommendedPrice?: number;
+    /** Recommended minimum price PVP (calculated from policy + cost) */
+    recommendedMinimumPrice?: number;
+    /** Floor price PVP (calculated from policy + cost) */
+    floorPrice?: number;
     /** How stock levels are managed */
     stockPolicy?: StockPolicy;
     /** Observations generated by analysis script */

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

@@ -135,6 +135,10 @@ export interface CatalogItemDetailResponse {
          * Calculated from: unitCostBI * markupFactor * (1 + VAT/100)
          */
         recommendedPrice?: number;
+        /** Precio mínimo recomendado PVP (con IVA) — suggested QVET "tarifa mínima" */
+        recommendedMinimumPrice?: number;
+        /** Precio piso PVP (con IVA) — absolute minimum, never sell below this */
+        floorPrice?: number;
         /** How stock levels are managed */
         stockPolicy?: StockPolicy;
         /** Observations generated by analysis script */

package/package.json

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