nazar-salary 2.0.1 → 2.1.1

package/index.d.ts

@@ -165,6 +165,86 @@ declare module 'nazar-salary' {
     period_to?: string;
   }
 
+  export interface ManualPaymentData {
+    operation_number: string;
+    bank_id: string;
+    payment_method: string;
+    amount: number;
+    transaction_date?: string;
+    transaction_time?: string;
+    comment?: string;
+  }
+
+  export interface ManualPaymentStudent {
+    id: number;
+    first_name: string;
+    last_name: string;
+    phone?: string;
+    manager_name?: string;
+    purchase_amount?: number;
+    is_verified: boolean;
+    verified_at?: string;
+  }
+
+  export interface ManualPaymentDetails {
+    operation_number: string;
+    amount: number;
+    bank_commission?: number;
+    net_amount?: number;
+    manager_commission?: number;
+    discrepancy_amount?: number;
+    payment_method?: string;
+    manual_verification?: boolean;
+    verified_by?: number;
+  }
+
+  export interface ManualPaymentResponse {
+    status: 'success' | 'error';
+    result: 'verified' | 'discrepancy' | 'orphan';
+    message: string;
+    student?: ManualPaymentStudent;
+    payment: ManualPaymentDetails;
+    code?: string;
+    details?: any;
+  }
+
+  export interface OrphanPaymentItem {
+    id: number;
+    operation_number: string;
+    amount: number;
+    bank_name: string;
+    payment_method: string;
+    commission_rate: number;
+    bank_commission: number;
+    net_amount: number;
+    transaction_date?: string;
+    transaction_time?: string;
+    comment?: string;
+    created_by: string;
+    created_at: string;
+  }
+
+  export interface OrphanPaymentsResponse {
+    orphan_payments: OrphanPaymentItem[];
+    pagination: Pagination;
+  }
+
+  export interface PaymentMethod {
+    payment_method_id: string;
+    payment_method_name: string;
+    commission_rate: number;
+  }
+
+  export interface BankConfig {
+    bank_id: string;
+    bank_name: string;
+    payment_methods: PaymentMethod[];
+  }
+
+  export interface BanksConfigResponse {
+    banks: BankConfig[];
+  }
+
   export interface UpdateUserData {
     first_name?: string;
     last_name?: string;
@@ -626,6 +706,9 @@ declare module 'nazar-salary' {
     uploadKaspiReceipt(file: File | Buffer, options?: UploadBankReceiptOptions): Promise<BankReceiptUploadResponse>;
     getReceiptsList(params?: BankReceiptsListParams): Promise<BankReceiptsListResponse>;
     getReceiptStatus(logId: number): Promise<BankReceiptStatusResponse>;
+    addManualPayment(data: ManualPaymentData): Promise<ManualPaymentResponse>;
+    getOrphanPayments(params?: { page?: number; limit?: number }): Promise<OrphanPaymentsResponse>;
+    getBanksConfig(): Promise<BanksConfigResponse>;
 
     // Teacher endpoints
     getTeacherLanguages(): Promise<TeacherLanguagesResponse>;

package/index.js

@@ -179,7 +179,7 @@ class SalaryAPI {
 
   /**
    * Upload bank receipt Excel file for verification (Admin only)
-   * Supports Kaspi, Halyk, Jusan and other bank statements
+   * Supports Kaspi only
    * Processing happens asynchronously, use getReceiptStatus to check progress
    * @param {File|Buffer} file - Excel file (.xlsx) with bank statement
    * @param {object} [options] - Upload options
@@ -218,7 +218,42 @@ class SalaryAPI {
    * @returns {Promise<{status: string, log_id: number, file_name: string, summary?: object, details?: object, error_message?: string}>}
    */
   async getReceiptStatus(logId) {
-    return await this.client.get(`/api/v1/admin/receipts/${logId}`);
+    return await this.client.get(`/api/v1/admin/receipts/logs/${logId}`);
+  }
+
+  /**
+   * Manually add payment from non-Kaspi banks (Admin only)
+   * @param {object} data - Payment data
+   * @param {string} data.operation_number - 11-digit operation number
+   * @param {string} data.bank_id - Bank ID (halyk, forte, jusan, freedom, centercredit)
+   * @param {string} data.payment_method - Payment method ID
+   * @param {number} data.amount - Payment amount (2000-10000000 KZT)
+   * @param {string} [data.transaction_date] - Transaction date
+   * @param {string} [data.transaction_time] - Transaction time
+   * @param {string} [data.comment] - Comment (max 500 chars)
+   * @returns {Promise<{status: string, result: string, message: string, student?: object, payment: object}>}
+   */
+  async addManualPayment(data) {
+    return await this.client.post("/api/v1/admin/receipts/manual-add", data);
+  }
+
+  /**
+   * Get list of orphan (unused) payments (Admin only)
+   * @param {object} [params] - Query parameters
+   * @param {number} [params.page=1] - Page number
+   * @param {number} [params.limit=30] - Items per page
+   * @returns {Promise<{orphan_payments: array, pagination: object}>}
+   */
+  async getOrphanPayments(params = {}) {
+    return await this.client.get("/api/v1/admin/receipts/orphan", { params });
+  }
+
+  /**
+   * Get available banks and payment methods configuration (Admin only)
+   * @returns {Promise<{banks: array}>}
+   */
+  async getBanksConfig() {
+    return await this.client.get("/api/v1/admin/receipts/banks");
   }
 
   // ===== TEACHER ENDPOINTS =====

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nazar-salary",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "description": "Frontend library for Nazar Salary API",
   "main": "index.js",
   "types": "index.d.ts",