hvp-shared 6.47.0 → 6.48.0

package/dist/constants/index.d.ts

@@ -14,3 +14,4 @@ export * from './job-category.constants';
 export * from './special-collaborators.constants';
 export * from './commissions.constants';
 export * from './hr.enums';
+export * from './qvet-cash-flow.enums';

package/dist/constants/index.js

@@ -30,3 +30,4 @@ __exportStar(require("./job-category.constants"), exports);
 __exportStar(require("./special-collaborators.constants"), exports);
 __exportStar(require("./commissions.constants"), exports);
 __exportStar(require("./hr.enums"), exports);
+__exportStar(require("./qvet-cash-flow.enums"), exports);

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

@@ -128,8 +128,8 @@ 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 (PHARM, PHARM_FRAC, COST_ML, COST) — cost + 25% margin */
+export declare const MIN_PRICE_COST_FACTOR = 1.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) */

package/dist/constants/pricing.constants.js

@@ -218,9 +218,11 @@ function getDefaultPricePolicy(section, saleUnit, conversionFactor) {
 // =============================================================================
 // ROUNDING HELPER
 // =============================================================================
-/** Round to nearest multiple of 5 */
+/** Round to nearest multiple of 5 (minimum 5 for positive values) */
 function roundToNearest5(value) {
-    return Math.round(value / 5) * 5;
+    if (value <= 0)
+        return 0;
+    return Math.max(5, Math.round(value / 5) * 5);
 }
 /**
  * Calculate the recommended price PVP (con IVA) for a catalog item.
@@ -243,8 +245,8 @@ function calculateRecommendedPricePVP(params) {
 // =============================================================================
 // 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 (PHARM, PHARM_FRAC, COST_ML, COST) — cost + 25% margin */
+exports.MIN_PRICE_COST_FACTOR = 1.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) */

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

@@ -319,17 +319,17 @@ 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
+        it.each(costPolicies)('%s: both = cost × 1.25 × (1+VAT/100), round5', (policy) => {
+            // $100 * 1.25 * 1.16 = $145 → round5 = $145
             const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: policy });
-            expect(result.recommendedMinimumPrice).toBe(30);
-            expect(result.floorPrice).toBe(30);
+            expect(result.recommendedMinimumPrice).toBe(145);
+            expect(result.floorPrice).toBe(145);
         });
         it('should round to nearest 5', () => {
-            // $80 * 0.25 * 1.16 = $23.20 → round5 = $25
+            // $80 * 1.25 * 1.16 = $116 → round5 = $115
             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);
+            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.PHARM, unitPurchasePriceBI: 0 });
@@ -342,14 +342,20 @@ describe('calculateFloorPrices', () => {
             expect(result.floorPrice).toBeNull();
         });
         it('should handle 0% VAT', () => {
-            // $100 * 0.25 * 1.0 = $25 → $25
+            // $100 * 1.25 * 1.0 = $125 → $125
             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);
+            expect(result.recommendedMinimumPrice).toBe(125);
+            expect(result.floorPrice).toBe(125);
+        });
+        it('should never return less than 5 for positive cost', () => {
+            // $1 * 1.25 * 1.0 = $1.25 → round5 = 0, but min is 5
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.PHARM, unitPurchasePriceBI: 1, vatSalePercent: 0 });
+            expect(result.recommendedMinimumPrice).toBe(5);
+            expect(result.floorPrice).toBe(5);
         });
     });
     describe('EXT_COST', () => {
-        it('both = cost × 1.0 × (1+VAT/100), round5', () => {
+        it('both = cost × 1.0 × (1+VAT/100), round5 (at-cost recovery)', () => {
             // $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);
@@ -366,6 +372,12 @@ describe('calculateFloorPrices', () => {
             expect(result.recommendedMinimumPrice).toBe(230);
             expect(result.floorPrice).toBe(230);
         });
+        it('should never return less than 5 for positive cost', () => {
+            // $2 * 1.0 * 1.0 = $2 → round5 = 0, but min is 5
+            const result = (0, pricing_constants_1.calculateFloorPrices)({ ...defaults, pricePolicy: pricing_constants_1.PricePolicy.EXT_COST, unitPurchasePriceBI: 2, vatSalePercent: 0 });
+            expect(result.recommendedMinimumPrice).toBe(5);
+            expect(result.floorPrice).toBe(5);
+        });
     });
     describe('COMP_SVC', () => {
         it('recommendedMinimumPrice = salePricePVP × 0.50, floorPrice = 0', () => {

package/dist/constants/qvet-cash-flow.enums.d.ts

@@ -0,0 +1,45 @@
+/**
+ * QVET Cash Flow Review Enums
+ *
+ * Used in the cash flow review workflow where collaborators and admins
+ * annotate QVET cash transactions (entradas/salidas de caja) with
+ * supplier, account type, evidence, and invoice status.
+ *
+ * DB values use QVET abbreviations (CE, SE, FA, etc.) for historical
+ * compatibility. Enum keys use descriptive English names.
+ */
+/** Whether the transaction goes through formal or informal accounting */
+export declare enum CashFlowAccountType {
+    FORMAL = "FORMAL",
+    INFORMAL = "INFORMAL"
+}
+/** Evidence status for the transaction receipt/voucher */
+export declare enum CashFlowEvidence {
+    /** Comprobante guardado (receipt saved in Dropbox) */
+    SAVED = "CE",
+    /** Se extravió (receipt existed but was lost/not captured) */
+    MISSING = "SE",
+    /** Sin comprobantes (no receipt for this type of payment) */
+    NO_RECEIPT = "SC"
+}
+/** Invoice status for formal transactions */
+export declare enum CashFlowInvoiceStatus {
+    /** Factura recibida */
+    INVOICED = "FA",
+    /** Proveedor factura automáticamente */
+    AUTO_INVOICED = "FA_AUTO",
+    /** Pendiente de factura */
+    PENDING = "PE",
+    /** No facturable (informales, etc.) */
+    NOT_APPLICABLE = "SF"
+}
+/** Validation result for a cash flow entry */
+export declare enum CashFlowValidationStatus {
+    VALID = "valid",
+    INVALID = "invalid"
+}
+/**
+ * Invoice statuses allowed when accountType is FORMAL.
+ * NOT_APPLICABLE is only valid for INFORMAL accounts.
+ */
+export declare const FORMAL_ALLOWED_INVOICE_STATUSES: readonly [CashFlowInvoiceStatus.INVOICED, CashFlowInvoiceStatus.AUTO_INVOICED, CashFlowInvoiceStatus.PENDING];

package/dist/constants/qvet-cash-flow.enums.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * QVET Cash Flow Review Enums
+ *
+ * Used in the cash flow review workflow where collaborators and admins
+ * annotate QVET cash transactions (entradas/salidas de caja) with
+ * supplier, account type, evidence, and invoice status.
+ *
+ * DB values use QVET abbreviations (CE, SE, FA, etc.) for historical
+ * compatibility. Enum keys use descriptive English names.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORMAL_ALLOWED_INVOICE_STATUSES = exports.CashFlowValidationStatus = exports.CashFlowInvoiceStatus = exports.CashFlowEvidence = exports.CashFlowAccountType = void 0;
+/** Whether the transaction goes through formal or informal accounting */
+var CashFlowAccountType;
+(function (CashFlowAccountType) {
+    CashFlowAccountType["FORMAL"] = "FORMAL";
+    CashFlowAccountType["INFORMAL"] = "INFORMAL";
+})(CashFlowAccountType || (exports.CashFlowAccountType = CashFlowAccountType = {}));
+/** Evidence status for the transaction receipt/voucher */
+var CashFlowEvidence;
+(function (CashFlowEvidence) {
+    /** Comprobante guardado (receipt saved in Dropbox) */
+    CashFlowEvidence["SAVED"] = "CE";
+    /** Se extravió (receipt existed but was lost/not captured) */
+    CashFlowEvidence["MISSING"] = "SE";
+    /** Sin comprobantes (no receipt for this type of payment) */
+    CashFlowEvidence["NO_RECEIPT"] = "SC";
+})(CashFlowEvidence || (exports.CashFlowEvidence = CashFlowEvidence = {}));
+/** Invoice status for formal transactions */
+var CashFlowInvoiceStatus;
+(function (CashFlowInvoiceStatus) {
+    /** Factura recibida */
+    CashFlowInvoiceStatus["INVOICED"] = "FA";
+    /** Proveedor factura automáticamente */
+    CashFlowInvoiceStatus["AUTO_INVOICED"] = "FA_AUTO";
+    /** Pendiente de factura */
+    CashFlowInvoiceStatus["PENDING"] = "PE";
+    /** No facturable (informales, etc.) */
+    CashFlowInvoiceStatus["NOT_APPLICABLE"] = "SF";
+})(CashFlowInvoiceStatus || (exports.CashFlowInvoiceStatus = CashFlowInvoiceStatus = {}));
+/** Validation result for a cash flow entry */
+var CashFlowValidationStatus;
+(function (CashFlowValidationStatus) {
+    CashFlowValidationStatus["VALID"] = "valid";
+    CashFlowValidationStatus["INVALID"] = "invalid";
+})(CashFlowValidationStatus || (exports.CashFlowValidationStatus = CashFlowValidationStatus = {}));
+/**
+ * Invoice statuses allowed when accountType is FORMAL.
+ * NOT_APPLICABLE is only valid for INFORMAL accounts.
+ */
+exports.FORMAL_ALLOWED_INVOICE_STATUSES = [
+    CashFlowInvoiceStatus.INVOICED,
+    CashFlowInvoiceStatus.AUTO_INVOICED,
+    CashFlowInvoiceStatus.PENDING,
+];

package/dist/contracts/qvet/responses.d.ts

@@ -23,6 +23,7 @@
  * }
  * ```
  */
+import { CashFlowAccountType, CashFlowEvidence, CashFlowInvoiceStatus, CashFlowValidationStatus } from '../../constants/qvet-cash-flow.enums';
 /**
  * @deprecated No longer used. Backend uses standard ApiListSuccessResponse with meta.
  * Kept for backward compatibility during migration.
@@ -613,6 +614,50 @@ export interface QvetCashClosingsQueryParams {
     skip?: number;
     sort?: string;
 }
+/**
+ * Review data added by collaborators/admins to a QVET cash flow entry.
+ *
+ * QVET-sourced fields (branch, amount, etc.) remain immutable.
+ * All editable data lives in this subdocument.
+ *
+ * @example PATCH /api/qvet/cash-flows/:id/review
+ */
+export interface CashFlowReview {
+    /** Proveedor (may differ from QVET's supplier field) */
+    supplier?: string;
+    /** Tipo de cuenta assigned by collaborator */
+    accountType?: CashFlowAccountType;
+    /** Receipt/voucher evidence status */
+    evidence?: CashFlowEvidence;
+    /** Invoice status (FORMAL accounts cannot be NOT_APPLICABLE) */
+    invoiceStatus?: CashFlowInvoiceStatus;
+    /** Auto-calculated or admin-overridden validation result */
+    validationStatus?: CashFlowValidationStatus;
+    /** Tipo de cuenta overridden by admin (used for accounting export) */
+    adminAccountType?: CashFlowAccountType;
+    /** Free-text observations */
+    observations?: string;
+    /** Collaborator ID who last updated */
+    lastUpdatedBy?: string;
+    /** ISO 8601 timestamp of last update */
+    lastUpdatedAt?: string;
+}
+/**
+ * Request body for updating a cash flow review.
+ *
+ * @example PATCH /api/qvet/cash-flows/:id/review
+ */
+export interface UpdateCashFlowReviewRequest {
+    supplier?: string;
+    accountType?: CashFlowAccountType;
+    evidence?: CashFlowEvidence;
+    invoiceStatus?: CashFlowInvoiceStatus;
+    /** Only admin can override */
+    validationStatus?: CashFlowValidationStatus;
+    /** Only admin can set */
+    adminAccountType?: CashFlowAccountType;
+    observations?: string;
+}
 /**
  * Single cash flow record from QVET (Entradas/Salidas de Caja)
  * Represents cash in/out transactions outside of regular sales
@@ -634,6 +679,7 @@ export interface QvetCashFlowResponse {
     supplier: string;
     staffName: string;
     closingDate: string;
+    review?: CashFlowReview;
     syncedAt: string;
 }
 /**

package/package.json

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