hvp-shared 6.16.0 → 6.17.0

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.17.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",