hvp-shared 6.47.1 → 6.49.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/qvet-cash-flow.enums.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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];
+/**
+ * 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

@@ -0,0 +1,79 @@
+"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.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) {
+    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,
+];
+/**
+ * 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,6 +23,7 @@
  * }
  * ```
  */
+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.
@@ -613,6 +614,54 @@ 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;
+    /** 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;
+    /** 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;
+    /** Structured reasons why this entry is invalid */
+    invalidReasons?: CashFlowInvalidReason[];
+    observations?: string;
+}
 /**
  * Single cash flow record from QVET (Entradas/Salidas de Caja)
  * Represents cash in/out transactions outside of regular sales
@@ -634,6 +683,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.1",
+  "version": "6.49.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",