indas-ui 0.0.1 → 0.1.0

package/dist/lib/api/estimation/quotepanel.d.ts

@@ -0,0 +1,304 @@
+import type { APIResponse } from '../core/types.js';
+/**
+ * Quotation API class
+ * Manages quotation operations for the Quote Panel
+ */
+export declare class QuotationAPI {
+    /**
+     * Get booking data (Quote Panel data)
+     * @param filters - Filter parameters
+     * @param sessionData - Session data (REQUIRED for authentication)
+     */
+    static getBookingData(filters?: {
+        ApprovalType?: string;
+        FilterSTR?: string;
+        FromDate?: string;
+        ToDate?: string;
+    }, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get booking data expanded to one row per content × quantity slab.
+     * Same filters as getBookingData; each quote fans out into its per-content,
+     * per-quantity rows (ContentName / ContentQuantity / ContentUnitPrice / ...).
+     */
+    static getBookingDataWithContent(filters?: {
+        ApprovalType?: string;
+        FilterSTR?: string;
+        FromDate?: string;
+        ToDate?: string;
+    }, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get all quotations with optional filters
+     * @param filters - Optional filter parameters
+     * @param sessionData - Session data (REQUIRED for authentication)
+     */
+    static getAllQuotations(filters?: {
+        dateFrom?: string;
+        dateTo?: string;
+        status?: string;
+        searchQuery?: string;
+    }, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get a single quotation by ID
+     * @param quotationId - The quotation ID
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static getQuotation(quotationId: number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Update internal approval status for a quotation
+     * @param params - Status update parameters
+     * @param params.type - Type of approval update ('internalapproved')
+     * @param params.status - New status ('Approve', 'Reject', 'Rework', 'Pending')
+     * @param params.remarks - Remarks for the status change
+     * @param params.BKID - Booking ID (quotation ID)
+     * @param params.BKNo - Booking number (quote number)
+     * @param params.InternalApprovedUserID - User ID who is approving
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static updateInternalApprovalStatus(params: {
+        type?: string;
+        status: 'Approve' | 'Reject' | 'Rework' | 'Pending' | 'PendingHOD' | 'PendingVH' | 'ReworkHOD' | 'ReworkVH' | 'RejectHOD' | 'RejectVH';
+        remarks: string;
+        BKID: string | number;
+        BKNo: string;
+        InternalApprovedUserID: string | number;
+    }, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Update quotation status (legacy method - kept for backward compatibility)
+     * @deprecated Use updateInternalApprovalStatus instead
+     * @param quotationId - The quotation ID
+     * @param newStatus - New status value
+     * @param remarks - Optional remarks for the status change
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static updateQuotationStatus(quotationId: number, newStatus: string, remarks?: string, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Delete a quotation
+     * @param quotationId - The quotation ID
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static deleteQuotation(quotationId: number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get the rich quotation list (header + paper details from primary plan row).
+     * Endpoint: GET /api/planwindow/quotationList
+     * Returns up to `top` rows; capped at 5000 server-side.
+     */
+    static getQuotationList(sessionData?: any, options?: {
+        fromDate?: string;
+        toDate?: string;
+        bookingId?: number;
+        ledgerId?: number;
+        top?: number;
+    }): Promise<APIResponse>;
+    /**
+     * Get detail costing for a quotation
+     * Returns 6 datasets: PlanType, DetailCostingName, QuoteCorrugationDetail,
+     * QuoteCorrugationDetail1, DetailCostingQuantity, ViweQuantity, MaterialDetails1
+     * @param bookingId - The booking ID
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static getDetailCosting(bookingId: number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Fetch the FastReport Detail Costing PDF as a blob and open in new tab.
+     * Calls the local .NET 10 backend (DetailsCostingController).
+     * Uses fetch with full auth headers (Basic Auth + session headers).
+     * @param bookingId - The booking ID
+     * @param sessionData - Session data (REQUIRED)
+     * @returns blob URL string on success, null on failure
+     */
+    static fetchDetailCostingPdf(bookingId: number, sessionData?: any, template?: string | null): Promise<{
+        success: boolean;
+        blobUrl?: string;
+        error?: string;
+    }>;
+    /**
+     * Fetch the FastReport Costing Summary Details PDF as a blob.
+     * Calls the local .NET 10 backend (DetailsSummeryCostingController).
+     * @param bookingId - The booking ID
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static fetchCostingSummaryDetailsPdf(bookingId: number, sessionData?: any): Promise<{
+        success: boolean;
+        blobUrl?: string;
+        error?: string;
+    }>;
+    /**
+     * Fetch Quote Mail PDF via FastReport (POST)
+     * Accepts user-overridable fields (postal name, header/footer text, etc.)
+     * Returns a blob URL for display in iframe or conversion to base64 for email.
+     */
+    static fetchQuoteMailPdf(bookingId: number, params: {
+        mailingName?: string;
+        attention?: string;
+        mailingAddress?: string;
+        quoteBy?: string;
+        designation?: string;
+        currencySymbol?: string;
+        conversionValue?: string;
+        isExportQuotation?: boolean;
+        headerText?: string;
+        footerText?: string;
+        processes?: string;
+        hideContentDetails?: boolean;
+        hideMaterialDetails?: boolean;
+        showSignature?: boolean;
+    }, sessionData?: any): Promise<{
+        success: boolean;
+        blobUrl?: string;
+        blob?: Blob;
+        error?: string;
+    }>;
+    /**
+     * Shared helper: fetch a PDF blob from the standard API base URL.
+     * Uses raw fetch (APIClient doesn't support blob responses).
+     */
+    private static _fetchPdfBlob;
+    /**
+     * Get Quote Mail data — dedicated API with salesperson fallback
+     * Returns TblQuotes (booking+mail details) and TblQuoteQties (qty+cost)
+     */
+    static getMailQuoteData(bookingId: number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get costing summary for a quotation
+     * @param quotationId - The quotation ID
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static getCostingSummary(quotationId: number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get detail costing for multiple quotations
+     * Used for bulk printing or export
+     * @param quotationIds - Array of quotation IDs
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static getBulkDetailCosting(quotationIds: number[], sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get costing summary for multiple quotations
+     * Used for bulk printing or export
+     * @param quotationIds - Array of quotation IDs
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static getBulkCostingSummary(quotationIds: number[], sessionData?: any): Promise<APIResponse>;
+    /**
+     * Export quotations to Excel/PDF
+     * @param quotationIds - Array of quotation IDs to export
+     * @param format - Export format ('excel' | 'pdf')
+     * @param sessionData - Session data (REQUIRED)
+     */
+    static exportQuotations(quotationIds: number[], format?: 'excel' | 'pdf', sessionData?: any): Promise<APIResponse>;
+    private static get priceApprovalBase();
+    /**
+     * Get the next approval number for a new price approval
+     * Returns format: "A/{FYear}/{sequence:D4}" (e.g., "A/2025-2026/0001")
+     */
+    static getPriceApprovalEnquiryNo(sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get company configurations for price approval
+     * Returns permissions, currency settings, cost estimation method, etc.
+     */
+    static getCompanyConfigurations(sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get user permissions for Price Approval (CanView, CanSave, CanEdit, CanDelete)
+     */
+    static getPriceApprovalUserPermissions(sessionData?: any): Promise<APIResponse>;
+    /**
+     * Load quotes pending for price approval (not yet approved/booked)
+     * Returns JobBooking records with IsSendForPriceApproval=1
+     */
+    static getPriceApprovalQuoteLoad(sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get ALL active quotes for price approval (no IsSendForPriceApproval filter)
+     * Used for the Pending tab on the standalone Price Approval page
+     */
+    static getPriceApprovalAllActiveQuoteLoad(sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get all approved price records (showlist)
+     * Returns existing price approvals from JobApprovedCost
+     */
+    static getPriceApprovalShowlist(sessionData?: any): Promise<APIResponse>;
+    /**
+     * Load all data needed for the approval window.
+     * Calls CheckPriceApprovalWithSameBookingID to determine Flag,
+     * then GridDataForApprovalWindow + PriceApprovalEnquiryNo in parallel.
+     * Returns: { isUpdate, approvalNo, existingApproval, costingRows }
+     */
+    static loadApprovalWindow(bookingId: number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get costing grid data for the approval window
+     * @param bookingId - The booking ID
+     * @param flag - "false" for new/pending, "true" for existing approval
+     */
+    static getGridDataForApprovalWindow(bookingId: number, flag: string, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Check if a parent booking already has a non-blocked price approval
+     * Returns approval data or "0" if none
+     */
+    static checkPriceApprovalWithSameBookingID(bookingId: number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Block old price approval and transfer ProductMaster to new booking
+     */
+    static blockPriceApprovalWithSameBookingID(bookingId: number, bookingIdNew: number, bookingNo: string, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Save or update price approval data
+     * @param paData - The approval data object
+     * @param bookingId - The booking ID
+     * @param flag - "false" for insert (new), "true" for update
+     */
+    static savePriceApprovalData(paData: Record<string, any>, bookingId: number, flag: string, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Soft-delete a price approval and reset IsApproved=0 on JobBooking
+     * Returns "Success", "false" (linked records exist), or error
+     */
+    static deletePriceApproval(bookingId: number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Get comment data for price approval
+     */
+    static getCommentData(params: {
+        bookingIDs?: string;
+        productMasterIDs?: string;
+        salesOrderNo?: string;
+        priceApprovalNo?: string;
+        moduleName: string;
+    }, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Save comment data for price approval
+     */
+    static saveCommentData(params: {
+        commentDetail: Record<string, any>;
+        salesOrderNo?: string;
+        priceApprovalNo?: string;
+        moduleName: string;
+    }, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Send quotation for client/price approval
+     * Sets IsSendForPriceApproval=1 on JobBooking
+     * @param bookingId - The booking ID (can be comma-separated for bulk)
+     */
+    static updateSendForApproval(bookingId: string | number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Unsend quotation from client/price approval
+     * Sets IsSendForPriceApproval=0 on JobBooking
+     * @param bookingId - The booking ID (can be comma-separated for bulk)
+     */
+    static updateUnSendForApproval(bookingId: string | number, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Update quotation status directly (simple Status field update)
+     * Used for client-side approve/reject workflow
+     * @param bookingId - The booking ID
+     * @param status - New status string
+     */
+    static updateQuoteStatus(bookingId: string | number, status: string, sessionData?: any): Promise<APIResponse>;
+    /**
+     * Generate Quote Revision with a target price
+     * Creates a new revision of the quotation, adjusting profit % so the final
+     * quoted cost matches the target. Used by the "User" role for quick revisions
+     * without opening the full estimation page.
+     * Endpoint: POST /api/planwindow/generatequoterevision
+     * @param bookingId - The booking ID of the quote to revise
+     * @param targetedCost - The target price the user wants the new quote to match
+     * @param typeOfCost - The TypeOfCost from the quotation (Unit Cost / Cost/100 / Cost/1000)
+     * @param status - The current quotation Status (from backend)
+     */
+    static generateQuoteRevision(bookingId: string | number, targetedCosts: {
+        PlanContQty: number;
+        TargetedCost: number;
+    }[], typeOfCost: string, status: string, sessionData?: any): Promise<APIResponse>;
+}