hvp-shared 6.15.0 → 6.16.0

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

@@ -510,3 +510,80 @@ export interface QvetCollectionsQueryParams {
     page?: number;
     skip?: number;
 }
+/**
+ * Single cash closing record from QVET
+ * Represents a cash register closing entry - one row per payment method per closing
+ *
+ * A single closing (closingNumber) has multiple rows, one for each payment method.
+ * To get the total for a closing, sum all rows with the same closingNumber.
+ */
+export interface QvetCashClosingResponse {
+    id: string;
+    cashRegister: string;
+    closingNumber: number;
+    paymentMethod: string;
+    saleAmount: number;
+    closingTotal: number;
+    collectedAmount: number;
+    dayCollections: number;
+    cashOut: number;
+    closingDate: string;
+    previousClosingDate: string;
+    branch: string;
+    staffName: string;
+    syncedAt: string;
+}
+/**
+ * Cash closings summary statistics data.
+ * Backend wraps with: ApiSingleSuccessResponse<QvetCashClosingsSummaryData>
+ */
+export interface QvetCashClosingsSummaryData {
+    totalRecords: number;
+    totalClosings: number;
+    totalSales: number;
+    totalCollected: number;
+    totalCashOut: number;
+    byPaymentMethod: {
+        method: string;
+        totalAmount: number;
+        count: number;
+    }[];
+}
+/**
+ * Cash closings grouped by cash register.
+ * Backend returns: ApiSingleSuccessResponse<QvetCashClosingsByCashRegisterItem[]>
+ */
+export interface QvetCashClosingsByCashRegisterItem {
+    cashRegister: string;
+    totalSales: number;
+    totalClosings: number;
+    totalCashOut: number;
+}
+/**
+ * Cash closings grouped by staff member.
+ * Backend returns: ApiSingleSuccessResponse<QvetCashClosingsByStaffItem[]>
+ */
+export interface QvetCashClosingsByStaffItem {
+    staffName: string;
+    totalClosings: number;
+    totalSales: number;
+    branches: string[];
+}
+/**
+ * Query parameters for cash closings endpoint
+ */
+export interface QvetCashClosingsQueryParams {
+    startDate?: string;
+    endDate?: string;
+    year?: number;
+    month?: number;
+    halfMonth?: 1 | 2;
+    branch?: string;
+    cashRegister?: string;
+    paymentMethod?: string;
+    staffName?: string;
+    limit?: number;
+    page?: number;
+    skip?: number;
+    sort?: string;
+}

package/package.json

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