hvp-shared 6.45.1 → 6.47.0

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

@@ -25,8 +25,6 @@ export declare enum PricePolicy {
     EXT_COST = "EXT_COST",
     /** Internal services (priced by market study / competition) */
     COMP_SVC = "COMP_SVC",
-    /** Diagnostic tests (TBD — no formula yet) */
-    TEST = "TEST",
     /** Individual formula per item */
     SPECIAL = "SPECIAL",
     /** Fixed manual price (no formula) */
@@ -130,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
@@ -37,8 +38,6 @@ var PricePolicy;
     PricePolicy["EXT_COST"] = "EXT_COST";
     /** Internal services (priced by market study / competition) */
     PricePolicy["COMP_SVC"] = "COMP_SVC";
-    /** Diagnostic tests (TBD — no formula yet) */
-    PricePolicy["TEST"] = "TEST";
     /** Individual formula per item */
     PricePolicy["SPECIAL"] = "SPECIAL";
     /** Fixed manual price (no formula) */
@@ -65,7 +64,6 @@ exports.PRICE_POLICY_LABELS = {
     [PricePolicy.COST]: 'Insumos / Artículos (por costo)',
     [PricePolicy.EXT_COST]: 'Servicios externos',
     [PricePolicy.COMP_SVC]: 'Servicios internos (estudio de mercado)',
-    [PricePolicy.TEST]: 'Pruebas diagnósticas',
     [PricePolicy.SPECIAL]: 'Fórmula individual',
     [PricePolicy.MANUAL]: 'Precio manual',
     [PricePolicy.NONE]: 'No se vende',
@@ -105,7 +103,6 @@ exports.AUTO_TIER_POLICIES = [
 /** Policies that have no formula (recommendedPrice = null) */
 exports.NO_FORMULA_POLICIES = [
     PricePolicy.COMP_SVC,
-    PricePolicy.TEST,
     PricePolicy.SPECIAL,
     PricePolicy.MANUAL,
     PricePolicy.NONE,
@@ -139,7 +136,7 @@ exports.ALLOWED_POLICIES_BY_SECTION = {
     [qvet_catalog_1.QVET_SECTIONS.FARMACIA_INTERNA]: [PricePolicy.PHARM, PricePolicy.PHARM_FRAC, PricePolicy.COST_ML, PricePolicy.SPECIAL, PricePolicy.MANUAL],
     [qvet_catalog_1.QVET_SECTIONS.INSUMOS_MEDICOS]: [PricePolicy.COST, PricePolicy.SPECIAL, PricePolicy.MANUAL],
     [qvet_catalog_1.QVET_SECTIONS.OTROS_ARTICULOS]: [PricePolicy.COST, PricePolicy.SPECIAL, PricePolicy.MANUAL],
-    [qvet_catalog_1.QVET_SECTIONS.SERVICIOS_MEDICOS]: [PricePolicy.COMP_SVC, PricePolicy.TEST, PricePolicy.SPECIAL, PricePolicy.MANUAL],
+    [qvet_catalog_1.QVET_SECTIONS.SERVICIOS_MEDICOS]: [PricePolicy.COMP_SVC, PricePolicy.SPECIAL, PricePolicy.MANUAL],
     [qvet_catalog_1.QVET_SECTIONS.OTROS_SERVICIOS]: [PricePolicy.COMP_SVC, PricePolicy.SPECIAL, PricePolicy.MANUAL],
     [qvet_catalog_1.QVET_SECTIONS.SERVICIOS_EXTERNOS]: [PricePolicy.EXT_COST, PricePolicy.SPECIAL, PricePolicy.MANUAL],
 };
@@ -218,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.
  *
@@ -234,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

@@ -100,7 +100,6 @@ describe('getMarkupFactor', () => {
     });
     it('should return null for policies without a formula', () => {
         expect((0, pricing_constants_1.getMarkupFactor)(pricing_constants_1.PricePolicy.COMP_SVC, pricing_constants_1.PricingTier.HIGH_MARGIN)).toBeNull();
-        expect((0, pricing_constants_1.getMarkupFactor)(pricing_constants_1.PricePolicy.TEST, pricing_constants_1.PricingTier.HIGH_MARGIN)).toBeNull();
         expect((0, pricing_constants_1.getMarkupFactor)(pricing_constants_1.PricePolicy.SPECIAL, pricing_constants_1.PricingTier.HIGH_MARGIN)).toBeNull();
         expect((0, pricing_constants_1.getMarkupFactor)(pricing_constants_1.PricePolicy.MANUAL, pricing_constants_1.PricingTier.HIGH_MARGIN)).toBeNull();
         expect((0, pricing_constants_1.getMarkupFactor)(pricing_constants_1.PricePolicy.NONE, pricing_constants_1.PricingTier.HIGH_MARGIN)).toBeNull();
@@ -265,15 +264,6 @@ describe('calculateRecommendedPricePVP', () => {
         });
         expect(result).toBeNull();
     });
-    it('should return null for TEST', () => {
-        const result = (0, pricing_constants_1.calculateRecommendedPricePVP)({
-            pricePolicy: pricing_constants_1.PricePolicy.TEST,
-            pricingTier: pricing_constants_1.PricingTier.HIGH_MARGIN,
-            unitPurchasePriceBI: 100,
-            vatSalePercent: 16,
-        });
-        expect(result).toBeNull();
-    });
     it('should return null for SPECIAL', () => {
         const result = (0, pricing_constants_1.calculateRecommendedPricePVP)({
             pricePolicy: pricing_constants_1.PricePolicy.SPECIAL,
@@ -322,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.45.1",
+  "version": "6.47.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",