hvp-shared 6.16.0 → 6.18.0

package/dist/constants/background-job.constants.d.ts

@@ -14,6 +14,8 @@ export declare enum JobType {
     SYNC_TRANSFERS = "SYNC_TRANSFERS",
     SYNC_MOVEMENTS = "SYNC_MOVEMENTS",
     SYNC_COLLECTIONS = "SYNC_COLLECTIONS",
+    SYNC_CASH_CLOSINGS = "SYNC_CASH_CLOSINGS",
+    SYNC_CASH_FLOWS = "SYNC_CASH_FLOWS",
     SYNC_STOCK_CONFIG = "SYNC_STOCK_CONFIG",
     SYNC_CATALOG = "SYNC_CATALOG",
     SYNC_CLIENTS = "SYNC_CLIENTS",
@@ -36,6 +38,10 @@ export declare enum ReportType {
     TRANSFERS = "TRANSFERS",
     /** Collections (Cobros) report - uses date range params */
     COLLECTIONS = "COLLECTIONS",
+    /** Cash closings (Cierres de Caja) report - uses date range params */
+    CASH_CLOSINGS = "CASH_CLOSINGS",
+    /** Cash flows (Entradas/Salidas de Caja) report - uses date range params */
+    CASH_FLOWS = "CASH_FLOWS",
     /** Inventory snapshot - uses snapshot date param */
     INVENTORY_SNAPSHOT = "INVENTORY_SNAPSHOT",
     /** Clients list - no date params required */

package/dist/constants/background-job.constants.js

@@ -18,6 +18,8 @@ var JobType;
     JobType["SYNC_TRANSFERS"] = "SYNC_TRANSFERS";
     JobType["SYNC_MOVEMENTS"] = "SYNC_MOVEMENTS";
     JobType["SYNC_COLLECTIONS"] = "SYNC_COLLECTIONS";
+    JobType["SYNC_CASH_CLOSINGS"] = "SYNC_CASH_CLOSINGS";
+    JobType["SYNC_CASH_FLOWS"] = "SYNC_CASH_FLOWS";
     JobType["SYNC_STOCK_CONFIG"] = "SYNC_STOCK_CONFIG";
     JobType["SYNC_CATALOG"] = "SYNC_CATALOG";
     JobType["SYNC_CLIENTS"] = "SYNC_CLIENTS";
@@ -41,6 +43,10 @@ var ReportType;
     ReportType["TRANSFERS"] = "TRANSFERS";
     /** Collections (Cobros) report - uses date range params */
     ReportType["COLLECTIONS"] = "COLLECTIONS";
+    /** Cash closings (Cierres de Caja) report - uses date range params */
+    ReportType["CASH_CLOSINGS"] = "CASH_CLOSINGS";
+    /** Cash flows (Entradas/Salidas de Caja) report - uses date range params */
+    ReportType["CASH_FLOWS"] = "CASH_FLOWS";
     /** Inventory snapshot - uses snapshot date param */
     ReportType["INVENTORY_SNAPSHOT"] = "INVENTORY_SNAPSHOT";
     /** Clients list - no date params required */
@@ -70,6 +76,8 @@ exports.REPORT_PARAM_TYPES = {
     [ReportType.MOVEMENTS]: 'date_range',
     [ReportType.TRANSFERS]: 'date_range',
     [ReportType.COLLECTIONS]: 'date_range',
+    [ReportType.CASH_CLOSINGS]: 'date_range',
+    [ReportType.CASH_FLOWS]: 'date_range',
     [ReportType.INVENTORY_SNAPSHOT]: 'snapshot',
     [ReportType.CLIENTS]: 'no_params',
     [ReportType.CATALOG]: 'no_params',
@@ -106,6 +114,8 @@ exports.JOB_TYPE_LABELS = {
     [JobType.SYNC_TRANSFERS]: 'Sincronizar Traspasos',
     [JobType.SYNC_MOVEMENTS]: 'Sincronizar Movimientos',
     [JobType.SYNC_COLLECTIONS]: 'Sincronizar Cobros',
+    [JobType.SYNC_CASH_CLOSINGS]: 'Sincronizar Cierres de Caja',
+    [JobType.SYNC_CASH_FLOWS]: 'Sincronizar Entradas/Salidas',
     [JobType.SYNC_STOCK_CONFIG]: 'Sincronizar Config. Stock',
     [JobType.SYNC_CATALOG]: 'Sincronizar Catálogo',
     [JobType.SYNC_CLIENTS]: 'Sincronizar Clientes',
@@ -122,6 +132,8 @@ exports.REPORT_TYPE_LABELS = {
     [ReportType.MOVEMENTS]: 'Movimientos',
     [ReportType.TRANSFERS]: 'Traspasos',
     [ReportType.COLLECTIONS]: 'Cobros',
+    [ReportType.CASH_CLOSINGS]: 'Cierres de Caja',
+    [ReportType.CASH_FLOWS]: 'Entradas/Salidas',
     [ReportType.INVENTORY_SNAPSHOT]: 'Cortes de Inventario',
     [ReportType.CLIENTS]: 'Clientes',
     [ReportType.CATALOG]: 'Catálogo',

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

@@ -569,6 +569,30 @@ export interface QvetCashClosingsByStaffItem {
     totalSales: number;
     branches: string[];
 }
+/**
+ * Cash closing grouped response - one entry per closing with payment methods nested.
+ * Used for displaying closings as single cards/rows in the UI.
+ * Backend returns: ApiListSuccessResponse<QvetCashClosingGroupedResponse>
+ *
+ * @example GET /api/qvet/cash-closings/grouped?year=2026&month=1
+ */
+export interface QvetCashClosingGroupedResponse {
+    closingNumber: number;
+    closingDate: string;
+    previousClosingDate: string;
+    cashRegister: string;
+    branch: string;
+    staffName: string;
+    closingTotal: number;
+    collectedAmount: number;
+    dayCollections: number;
+    cashOut: number;
+    syncedAt: string;
+    paymentMethods: {
+        method: string;
+        amount: number;
+    }[];
+}
 /**
  * Query parameters for cash closings endpoint
  */
@@ -587,3 +611,86 @@ export interface QvetCashClosingsQueryParams {
     skip?: number;
     sort?: string;
 }
+/**
+ * Single cash flow record from QVET (Entradas/Salidas de Caja)
+ * Represents cash in/out transactions outside of regular sales
+ * Examples: petty cash, reimbursements, supplier payments
+ *
+ * Transaction types:
+ * - ENTRADA CAJA: Cash in (positive amount)
+ * - SALIDA CAJA: Cash out (negative amount)
+ */
+export interface QvetCashFlowResponse {
+    id: string;
+    branch: string;
+    cashRegister: string;
+    transactionDate: string;
+    transactionType: string;
+    paymentMethod: string;
+    amount: number;
+    comments: string;
+    supplier: string;
+    staffName: string;
+    closingDate: string;
+    syncedAt: string;
+}
+/**
+ * Cash flows summary statistics data.
+ * Backend wraps with: ApiSingleSuccessResponse<QvetCashFlowsSummaryData>
+ */
+export interface QvetCashFlowsSummaryData {
+    totalRecords: number;
+    totalCashIn: number;
+    totalCashOut: number;
+    netFlow: number;
+    byTransactionType: {
+        type: string;
+        totalAmount: number;
+        count: number;
+    }[];
+    byPaymentMethod: {
+        method: string;
+        totalAmount: number;
+        count: number;
+    }[];
+}
+/**
+ * Cash flows grouped by staff member.
+ * Backend returns: ApiSingleSuccessResponse<QvetCashFlowsByStaffItem[]>
+ */
+export interface QvetCashFlowsByStaffItem {
+    staffName: string;
+    totalCashIn: number;
+    totalCashOut: number;
+    netFlow: number;
+    recordCount: number;
+}
+/**
+ * Cash flows grouped by supplier/recipient.
+ * Backend returns: ApiSingleSuccessResponse<QvetCashFlowsBySupplierItem[]>
+ */
+export interface QvetCashFlowsBySupplierItem {
+    supplier: string;
+    totalAmount: number;
+    recordCount: number;
+}
+/**
+ * Query parameters for cash flows endpoint
+ */
+export interface QvetCashFlowsQueryParams {
+    startDate?: string;
+    endDate?: string;
+    year?: number;
+    month?: number;
+    halfMonth?: 1 | 2;
+    branch?: string;
+    cashRegister?: string;
+    transactionType?: string;
+    paymentMethod?: string;
+    staffName?: string;
+    supplier?: string;
+    limit?: number;
+    page?: number;
+    skip?: number;
+    sort?: string;
+}

package/package.json

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