hvp-shared 6.6.0 → 6.7.0

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

@@ -99,3 +99,96 @@ export interface QvetSalesQueryParams {
     skip?: number;
     sort?: string;
 }
+/**
+ * Single purchase record from QVET
+ * Represents one line item in a purchase transaction
+ */
+export interface QvetPurchaseResponse {
+    _id: string;
+    qvetCode: number;
+    productName: string;
+    barcode: string;
+    section: string;
+    family: string;
+    subfamily: string;
+    purchaseDate: string;
+    invoiceSeries: string;
+    invoiceNumber: number;
+    supplierInvoice: string;
+    quantity: number;
+    unitPrice: number;
+    subtotal: number;
+    taxAmount: number;
+    discount: number;
+    total: number;
+    conversionFactor: number;
+    branch: string;
+    warehouse: string;
+    supplier: string;
+    orderDate: string | null;
+    orderNumber: number | null;
+    invoiceDate: string | null;
+    reference: string;
+    syncedAt: string;
+}
+/**
+ * Paginated list of purchases
+ */
+export interface QvetPurchasesListResponse {
+    ok: boolean;
+    data: QvetPurchaseResponse[];
+    pagination: {
+        total: number;
+        limit: number;
+        skip: number;
+        hasMore: boolean;
+    };
+}
+/**
+ * Purchases summary statistics for a period
+ */
+export interface QvetPurchasesSummaryResponse {
+    ok: boolean;
+    data: {
+        totalRecords: number;
+        totalPurchases: number;
+        totalSubtotal: number;
+        totalTax: number;
+        totalDiscount: number;
+        totalQuantity: number;
+        avgPurchase: number;
+        uniqueSuppliers: number;
+        uniqueProducts: number;
+    };
+}
+/**
+ * Purchases by supplier aggregation
+ */
+export interface QvetPurchasesBySupplierItem {
+    supplier: string;
+    totalPurchases: number;
+    totalQuantity: number;
+    recordCount: number;
+}
+export interface QvetPurchasesBySupplierResponse {
+    ok: boolean;
+    data: QvetPurchasesBySupplierItem[];
+}
+/**
+ * Query parameters for purchases endpoint
+ */
+export interface QvetPurchasesQueryParams {
+    startDate?: string;
+    endDate?: string;
+    year?: number;
+    month?: number;
+    halfMonth?: 1 | 2;
+    warehouse?: string;
+    section?: string;
+    family?: string;
+    supplier?: string;
+    qvetCode?: number;
+    limit?: number;
+    skip?: number;
+    sort?: string;
+}

package/package.json

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