hvp-shared 6.48.0 → 6.49.0

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

@@ -43,3 +43,20 @@ export declare enum CashFlowValidationStatus {
  * NOT_APPLICABLE is only valid for INFORMAL accounts.
  */
 export declare const FORMAL_ALLOWED_INVOICE_STATUSES: readonly [CashFlowInvoiceStatus.INVOICED, CashFlowInvoiceStatus.AUTO_INVOICED, CashFlowInvoiceStatus.PENDING];
+/**
+ * Structured reasons why a cash flow entry is invalid.
+ * Replaces free-text auto-generated observations.
+ * Only applies to SALIDA CAJA; ENTRADA CAJA is always valid.
+ */
+export declare enum CashFlowInvalidReason {
+    /** accountType missing (except DIFERENCIAS → always INFORMAL) */
+    MISSING_ACCOUNT_TYPE = "SIN_TIPO_CUENTA",
+    /** review.supplier missing/empty (SALIDA only) */
+    MISSING_SUPPLIER = "SIN_PROVEEDOR",
+    /** FORMAL account with invoiceStatus NOT_APPLICABLE */
+    FORMAL_WITHOUT_INVOICE = "FORMAL_SIN_FACTURA",
+    /** evidence field missing */
+    MISSING_EVIDENCE = "SIN_EVIDENCIA"
+}
+/** Spanish labels for displaying invalid reasons in UI */
+export declare const INVALID_REASON_LABELS: Record<CashFlowInvalidReason, string>;

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

@@ -10,7 +10,7 @@
  * 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;
+exports.INVALID_REASON_LABELS = exports.CashFlowInvalidReason = 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) {
@@ -54,3 +54,26 @@ exports.FORMAL_ALLOWED_INVOICE_STATUSES = [
     CashFlowInvoiceStatus.AUTO_INVOICED,
     CashFlowInvoiceStatus.PENDING,
 ];
+/**
+ * Structured reasons why a cash flow entry is invalid.
+ * Replaces free-text auto-generated observations.
+ * Only applies to SALIDA CAJA; ENTRADA CAJA is always valid.
+ */
+var CashFlowInvalidReason;
+(function (CashFlowInvalidReason) {
+    /** accountType missing (except DIFERENCIAS → always INFORMAL) */
+    CashFlowInvalidReason["MISSING_ACCOUNT_TYPE"] = "SIN_TIPO_CUENTA";
+    /** review.supplier missing/empty (SALIDA only) */
+    CashFlowInvalidReason["MISSING_SUPPLIER"] = "SIN_PROVEEDOR";
+    /** FORMAL account with invoiceStatus NOT_APPLICABLE */
+    CashFlowInvalidReason["FORMAL_WITHOUT_INVOICE"] = "FORMAL_SIN_FACTURA";
+    /** evidence field missing */
+    CashFlowInvalidReason["MISSING_EVIDENCE"] = "SIN_EVIDENCIA";
+})(CashFlowInvalidReason || (exports.CashFlowInvalidReason = CashFlowInvalidReason = {}));
+/** Spanish labels for displaying invalid reasons in UI */
+exports.INVALID_REASON_LABELS = {
+    [CashFlowInvalidReason.MISSING_ACCOUNT_TYPE]: "Sin tipo de cuenta",
+    [CashFlowInvalidReason.MISSING_SUPPLIER]: "Sin proveedor",
+    [CashFlowInvalidReason.FORMAL_WITHOUT_INVOICE]: "Formal sin factura",
+    [CashFlowInvalidReason.MISSING_EVIDENCE]: "Sin evidencia",
+};

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

@@ -23,7 +23,7 @@
  * }
  * ```
  */
-import { CashFlowAccountType, CashFlowEvidence, CashFlowInvoiceStatus, CashFlowValidationStatus } from '../../constants/qvet-cash-flow.enums';
+import { CashFlowAccountType, CashFlowEvidence, CashFlowInvalidReason, CashFlowInvoiceStatus, CashFlowValidationStatus } from '../../constants/qvet-cash-flow.enums';
 /**
  * @deprecated No longer used. Backend uses standard ApiListSuccessResponse with meta.
  * Kept for backward compatibility during migration.
@@ -635,7 +635,9 @@ export interface CashFlowReview {
     validationStatus?: CashFlowValidationStatus;
     /** Tipo de cuenta overridden by admin (used for accounting export) */
     adminAccountType?: CashFlowAccountType;
-    /** Free-text observations */
+    /** Structured reasons why this entry is invalid (SALIDA only) */
+    invalidReasons?: CashFlowInvalidReason[];
+    /** Free-text observations (human notes only, not auto-generated) */
     observations?: string;
     /** Collaborator ID who last updated */
     lastUpdatedBy?: string;
@@ -656,6 +658,8 @@ export interface UpdateCashFlowReviewRequest {
     validationStatus?: CashFlowValidationStatus;
     /** Only admin can set */
     adminAccountType?: CashFlowAccountType;
+    /** Structured reasons why this entry is invalid */
+    invalidReasons?: CashFlowInvalidReason[];
     observations?: string;
 }
 /**

package/package.json

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