shareneus 1.4.96 → 1.4.98

package/dist/index.d.ts

@@ -130,3 +130,4 @@ export { GetItemPriceForPriceList } from "./inventory/items/item-price-for-price
 export { CalcItemFinalSalePrice } from "./inventory/items/item-price-for-pricelist";
 export { IsNotNull, IsNull } from "./shared/util";
 export { GetAgeString } from "./shared/util";
+export { SalesTotalCalculationsWithDecimals } from "./sales-receive/sales-total-calculation";

package/dist/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DebitNotePdfService = exports.DCWithoutPricePdfService = exports.DCLandscapeWithoutPricePdfService = exports.DCLandscapePdfService = exports.CustomerBalancesService = exports.SalesByCustomerPDFService = exports.CustWiseSalesDetailsService = exports.CreditNoteTotalsService = exports.CreditNotePdfService = exports.ConsultationPDFService = exports.ConsultationFullPrintService = exports.ConsultationFeeReceiptPrintService = exports.CNPrintService = exports.ChecklistsPDFService = exports.CheckListPrintService = exports.CategoryWiseItemPDFService = exports.SalesReceiptprintService = exports.AppointmentTotalsService = exports.AnalysisPDFService = exports.VenBalanceXlsxFileService = exports.TallySalesImportXlsxFileService = exports.StockXlsxFileService = exports.IssueSparesXlsxFileService = exports.ScheduledDrugXlsxFileService = exports.ScheduledDrugSummaryXlsxFileService = exports.SalesByServiceSummaryXlsxFileService = exports.SummaryXlsxFileService = exports.ServiceAdvisorWisePartXlsxFileService = exports.ServiceAdvisorWiseLaborXlsxFileService = exports.RepairOrdersXlsxFileService = exports.PaymentsMadeXlsxFileService = exports.PaymentReceiveXlsxFileService = exports.OperatorWiseSummaryXlsxFileService = exports.OperatorWiseDetailsXlsxFileService = exports.ManfWiseSalesXlsxFileService = exports.ItemsWiseSalesXlsxFileService = exports.ItemWiseMOSummaryXlsxFileService = exports.ItemWiseMODetailsXlsxFileService = exports.ItemWiseDoctorSaleXlsxFileService = exports.InvoicesWiseXlsxFileService = exports.InsuranceExpireXlsxFileService = exports.GSTR2ExcelService = exports.GSTR1ExcelService = exports.GSTROXlsxFileService = exports.ExpiringDrugsXlsxFileService = exports.SalesByCustomerXlsxFileService = exports.CustWiseSalesXlsxFileService = exports.CustBalanceXlsxFileService = exports.CategoryWiseItemXlsxFileService = exports.AnalysisXlsxFileService = void 0;
 exports.SharedPDFService = exports.SharedInvoiceprintService = exports.WOPrintService = exports.ScheduledDrugSummaryPDFService = exports.ScheduledDrugPDFService = exports.SalesTotalsService = exports.SaleReceiptPrintService = exports.SalesReceiptpdfService = exports.SalesPrintService = exports.SalesPdfService = exports.SalesByServiceSummaryPDF = exports.ROTotalsService = exports.ROPrintService = exports.RoprintService = exports.RepairOrdersReportsPDFService = exports.ReorderPointPDFService = exports.ReceiptPrintService = exports.PurchaseOrderPDFService = exports.PurchaseOrderTotalsService = exports.PurchaseOrderPrintService = exports.PosReceiptPrintService = exports.POTotalsService = exports.PaymentsReportPDFService = exports.ReceiptPDFService = exports.PackShipPrintService = exports.PackShipPDFService = exports.OperatorWiseSalesSummaryPDF = exports.OperatorWiseSalesDetailsPDF = exports.MaterialOutprintService = exports.MeetingPdfService = exports.ManfWiseSalesService = exports.ItemWiseSalesPDFService = exports.ItemWiseMOSummaryPDF = exports.ItemWiseMODetailsPDF = exports.ItemWiseDoctorSalePDFService = exports.ItemDetaisPdf = exports.IssuePartsprintService = exports.InvoiceTotalsService = exports.InvoiceLandscapePdfService = exports.InvPrintService = exports.InvoiceprintService = exports.InsuranceExpirePDF = exports.ExpiringDrugPDFService = exports.EstPrintService = exports.EquipmentDesignPdf = exports.DeliveryChallanTotalsService = exports.DeliveryChallanPrintService = exports.DeliveryChallanPdfService = exports.DebitNoteTotalsService = exports.DebitNotePrintService = void 0;
-exports.GetAgeString = exports.IsNull = exports.IsNotNull = exports.CalcItemFinalSalePrice = exports.GetItemPriceForPriceList = exports.SalesReceiveTotalsService = exports.SalesReceivePrintService = exports.SalesReceivePdfService = exports.AdjustmentDrugPDFService = exports.HSNSummaryPDFService = exports.HSNSummaryExcelService = exports.ItemBarCodeLabelPdf = exports.NextServiceDatePDFService = exports.NextServiceDateXlsxFileService = exports.ConsultationLetterHeadPDFService = exports.InvoiceLetterheadPdfService = exports.HCInvoiceprintService = exports.InvoicePortraitPrintService = exports.MyDate = exports.TrUtils = exports.VendorDebitNoteTotalsService = exports.VendorDebitNotePrintService = exports.VendorDebitNotePdfService = exports.VendorCreditNoteTotalsService = exports.VendorCreditNotePrintService = exports.VendorCreditNotePDFService = exports.VendorBalancesService = exports.TransferOrderPrintService = exports.TechnicianPrintService = exports.TechnicianpdfService = exports.TaskReportsPDfService = exports.TaskPDfService = exports.PrintSharedService = void 0;
+exports.SalesTotalCalculationsWithDecimals = exports.GetAgeString = exports.IsNull = exports.IsNotNull = exports.CalcItemFinalSalePrice = exports.GetItemPriceForPriceList = exports.SalesReceiveTotalsService = exports.SalesReceivePrintService = exports.SalesReceivePdfService = exports.AdjustmentDrugPDFService = exports.HSNSummaryPDFService = exports.HSNSummaryExcelService = exports.ItemBarCodeLabelPdf = exports.NextServiceDatePDFService = exports.NextServiceDateXlsxFileService = exports.ConsultationLetterHeadPDFService = exports.InvoiceLetterheadPdfService = exports.HCInvoiceprintService = exports.InvoicePortraitPrintService = exports.MyDate = exports.TrUtils = exports.VendorDebitNoteTotalsService = exports.VendorDebitNotePrintService = exports.VendorDebitNotePdfService = exports.VendorCreditNoteTotalsService = exports.VendorCreditNotePrintService = exports.VendorCreditNotePDFService = exports.VendorBalancesService = exports.TransferOrderPrintService = exports.TechnicianPrintService = exports.TechnicianpdfService = exports.TaskReportsPDfService = exports.TaskPDfService = exports.PrintSharedService = void 0;
 var analysis_excel_service_1 = require("./accounting/invoice/reports/excel/analysis-excel.service");
 Object.defineProperty(exports, "AnalysisXlsxFileService", { enumerable: true, get: function () { return analysis_excel_service_1.AnalysisXlsxFileService; } });
 var category_wise_item_excel_service_1 = require("./accounting/invoice/reports/excel/category-wise-item-excel.service");
@@ -268,3 +268,5 @@ Object.defineProperty(exports, "IsNotNull", { enumerable: true, get: function ()
 Object.defineProperty(exports, "IsNull", { enumerable: true, get: function () { return util_1.IsNull; } });
 var util_2 = require("./shared/util");
 Object.defineProperty(exports, "GetAgeString", { enumerable: true, get: function () { return util_2.GetAgeString; } });
+var sales_total_calculation_1 = require("./sales-receive/sales-total-calculation");
+Object.defineProperty(exports, "SalesTotalCalculationsWithDecimals", { enumerable: true, get: function () { return sales_total_calculation_1.SalesTotalCalculationsWithDecimals; } });

package/dist/sales-receive/sales-receive-print.service.js

@@ -4,10 +4,11 @@ exports.SalesReceivePrintService = void 0;
 const aggregation_1 = require("../aggregation/aggregation");
 const code_enums_1 = require("../enums/code-enums");
 const enums_1 = require("../enums/enums");
+const math_operations_1 = require("../shared/math-operations");
 const shared_print_service_1 = require("../shared/shared-print.service");
 const my_date_1 = require("../utils/my-date");
 const tr_utils_1 = require("../utils/tr-utils");
-const sales_receive_totals_service_1 = require("./sales-receive-totals.service");
+const sales_total_calculation_1 = require("./sales-total-calculation");
 class SalesReceivePrintService {
     static GetSalesReceivePrintInfo(OriginalSalesReceiveData, OriginalEntityData, image, IncludeGST, ConsolidateGST, TaxCodes, IsProforma) {
         var _a, _b;
@@ -26,10 +27,14 @@ class SalesReceivePrintService {
         SalesReceivePrintData = shared_print_service_1.PrintSharedService.GetEntityHeaderStyles(SalesReceivePrintData, OriginalEntityData, image);
         SalesReceivePrintData = this.GetSalesReceiveOtherDetailsForPrint(SalesReceivePrintData, argSalesReceiveData);
         let IsTaxable = (IncludeGST && tr_utils_1.TrUtils.isTaxable(argSalesReceiveData.Settings.Tax)) ? true : false;
-        let finalTotalsData = sales_receive_totals_service_1.SalesReceiveTotalsService.GetTotalsValue([], argSalesReceiveData.Items, IsTaxable, true, argSalesReceiveData.Disc, argSalesReceiveData.Perc, TaxCodes, true, argSalesReceiveData.Settings, SalesReceivePrintData.Entity);
+        // let finalTotalsData: any = SalesReceiveTotalsService.GetTotalsValue([], argSalesReceiveData.Items, IsTaxable,
+        //     true,
+        //     argSalesReceiveData.Disc, argSalesReceiveData.Perc, TaxCodes, true, argSalesReceiveData.Settings, SalesReceivePrintData.Entity);
+        let finalTotalsData = (0, sales_total_calculation_1.SalesTotalCalculationsWithDecimals)(argSalesReceiveData.Items, [], IsTaxable, argSalesReceiveData.DecimalsNumber);
         if (ConsolidateGST) {
-            finalTotalsData.CustLaborTotalBeforeDisc = finalTotalsData.CustLaborAfterTax;
-            finalTotalsData.CustPartsTotalBeforeDisc = finalTotalsData.CustPartAfterTax;
+            // finalTotalsData.CustLaborTotalBeforeDisc = finalTotalsData.CustLaborAfterTax;
+            // finalTotalsData.CustPartsTotalBeforeDisc = finalTotalsData.CustPartAfterTax;
+            finalTotalsData.CustPartsTotalBeforeDisc = (0, math_operations_1.Add)(finalTotalsData.totalTaxOnItems, (0, math_operations_1.Subtract)(finalTotalsData.subtotalOnItems, finalTotalsData.totalDiscountOnItems));
         }
         SalesReceivePrintData = tr_utils_1.TrUtils.ConcatObjects(SalesReceivePrintData, finalTotalsData);
         SalesReceivePrintData.Items = this.GetItemsPrintInfo(SalesReceivePrintData.Items, ConsolidateGST, TaxCodes, (_b = (_a = OriginalEntityData.Entity.Settings) === null || _a === void 0 ? void 0 : _a.Acc) === null || _b === void 0 ? void 0 : _b.LTot, SalesReceivePrintData.Entity.DecimalsNumber);

package/dist/sales-receive/sales-receive-totals.service.d.ts

@@ -1,27 +1,212 @@
+/**
+ * Service class for calculating sales receive totals including taxes, discounts and final amounts
+ */
 export declare class SalesReceiveTotalsService {
+    /**
+     * Main method to calculate totals for sales receive operations
+     * @param opCodesList - Array of operation codes/labor items
+     * @param PartsList - Array of parts/items to be processed
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @param DetailedInfo - Whether to include detailed breakdown information
+     * @param Disc - Discount amount
+     * @param Perc - Discount percentage
+     * @param TaxCodes - Available tax codes for GST calculations
+     * @param WithItems - Whether to include items in the response
+     * @param Settings - General settings object
+     * @param EntitySettings - Entity-specific settings including decimal places
+     * @returns Object containing calculated totals and breakdown information
+     */
     static GetTotalsValue(opCodesList: any, PartsList: any, IsIndependentTax: boolean, DetailedInfo: boolean, Disc: any, Perc: string, TaxCodes: any, WithItems: boolean, Settings: any, EntitySettings?: any): any;
+    /**
+     * Calculates labor part values including discounts and taxes
+     * @param PartsList - Array of parts to be processed
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Processed parts list with calculated values
+     */
     static CalculateLaborPartValues(PartsList: any, IsIndependentTax: boolean): any;
+    /**
+     * Resets and recalculates labor part values including discounts and taxes
+     * @param PartsList - Array of parts to be processed
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Parts list with reset and recalculated values
+     */
     static ResetLaborPartValues(PartsList: any, IsIndependentTax: boolean): any;
+    /**
+     * Resets part values to zero if they are null or invalid
+     * @param Part - Individual part item to reset
+     * @returns Part with reset values
+     */
     static ResetLaborPartValueIfInvalid(Part: any): any;
+    /**
+     * Prepares final repair order data for saving with calculated totals
+     * @param LaborList - Array of labor items
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @param Disc - Discount amount
+     * @param Perc - Discount percentage
+     * @param DetailedInfo - Whether to include detailed information
+     * @param Settings - General settings
+     * @param DecimalsNumber - Number of decimal places for calculations
+     * @returns Final totals data object ready for saving
+     */
     static GetFinalRODataForSave(LaborList: any, PartsList: any, IsIndependentTax: boolean, Disc: any, Perc: string, DetailedInfo: boolean, Settings: any, DecimalsNumber: any): any;
+    /**
+     * Sets main discount values in the totals data object
+     * @param Disc - Discount amount
+     * @param Perc - Discount percentage
+     * @param finalTotalsData - Totals data object to update
+     * @param DetailedInfo - Whether to include detailed information
+     * @returns Updated totals data with discount values
+     */
     static SetMainDiscountValues(Disc: string, Perc: string, finalTotalsData: any, DetailedInfo: boolean): any;
+    /**
+     * Calculates final customer totals including subtotals, taxes, and rounded amounts
+     * @param finalTotalsData - Existing totals data object
+     * @param LaborList - Array of labor items
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @param DetailedInfo - Whether to include detailed information
+     * @param DecimalsNumber - Number of decimal places for calculations
+     * @returns Updated totals data with customer calculations
+     */
     static GetFinalCustomerTotalsData(finalTotalsData: any, LaborList: any, PartsList: any, IsIndependentTax: boolean, DetailedInfo: boolean, DecimalsNumber?: number): any;
+    /**
+     * Calculates subtotal for labor and parts combined
+     * @param LaborList - Array of labor items
+     * @param PartsList - Array of parts
+     * @returns Calculated subtotal amount
+     */
     static GetSubTotalFor(LaborList: any, PartsList: any): any;
+    /**
+     * Calculates total amount for parts after applying discounts
+     * @param PartsList - Array of parts
+     * @returns Total parts amount after discounts
+     */
     static GetPartsTotalAfterDiscount(PartsList: any): any;
+    /**
+     * Generates detailed totals data including tax breakdowns and groupings
+     * @param finalTotalsData - Existing totals data
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @param opCodesList - Array of operation codes
+     * @param PartsList - Array of parts
+     * @param TaxCodes - Available tax codes
+     * @param DecimalsNumber - Number of decimal places
+     * @returns Enhanced totals data with detailed breakdowns
+     */
     static GetDetailedTotalsData(finalTotalsData: any, IsIndependentTax: boolean, opCodesList: any, PartsList: any, TaxCodes: any, DecimalsNumber?: number): any;
+    /**
+     * Groups parts by tax percentage for consolidated tax reporting
+     * @param Parts - Array of parts to group
+     * @param TaxCodes - Available tax codes
+     * @param DecimalsNumber - Number of decimal places
+     * @returns Array of parts grouped by tax percentage
+     */
     static GetTaxGroupingForPartsByPerc(Parts: any, TaxCodes: any, DecimalsNumber: any): any[];
+    /**
+     * Compares and groups parts by tax percentage rates
+     * @param Parts - Array of parts to compare
+     * @param TaxCodes - Available tax codes
+     * @returns Array of grouped parts with same tax percentages
+     */
     static ComparePartsByPerc(Parts: any, TaxCodes: any): any[];
+    /**
+     * Calculates total discounted amount for all parts
+     * @param PartsList - Array of parts
+     * @param isTaxable - Whether parts are taxable
+     * @param finalTotalsData - Existing totals data
+     * @returns Total discounted amount including overall part discount
+     */
     static GetPartDiscountedTotal(PartsList: any, isTaxable: boolean, finalTotalsData: any): any;
+    /**
+     * Calculates total tax amount for all parts
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Total tax amount for all parts
+     */
     static GetPartsTaxTotalFor(PartsList: any, IsIndependentTax: boolean): any;
+    /**
+     * Calculates customer total based on tax calculation type
+     * @param finalTotalsData - Existing totals data
+     * @param LaborTaxAmount - Total labor tax amount
+     * @param PartsTaxAmount - Total parts tax amount
+     * @param LaborList - Array of labor items
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Final customer total based on tax type
+     */
     static GetCustomerTotalBasedOnTaxType(finalTotalsData: any, LaborTaxAmount: number, PartsTaxAmount: number, LaborList: any, PartsList: any, IsIndependentTax: boolean): any;
+    /**
+     * Calculates items total after applying discounts (percentage or fixed)
+     * @param PartsTotalAfterDisc - Parts total after discount
+     * @param PartsTaxAmount - Parts tax amount
+     * @param MainPDisc - Main parts discount amount
+     * @param PDiscInPerc - Parts discount percentage
+     * @returns Final items total after all discounts
+     */
     static ItemsTotalAfterDiscount(PartsTotalAfterDisc: number, PartsTaxAmount: number, MainPDisc: number, PDiscInPerc: string): number;
+    /**
+     * Calculates total CGST tax amount for labor items
+     * @param opCodesList - Array of operation codes/labor
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Total CGST amount for labor
+     */
     static GetLaborCGSTTaxTotal(opCodesList: any, IsIndependentTax: boolean): any;
+    /**
+     * Calculates total IGST tax amount for labor items
+     * @param opCodesList - Array of operation codes/labor
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Total IGST amount for labor
+     */
     static GetLaborIGSTTaxTotal(opCodesList: any, IsIndependentTax: boolean): any;
+    /**
+     * Calculates total SGST tax amount for labor items
+     * @param opCodesList - Array of operation codes/labor
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Total SGST amount for labor
+     */
     static GetLaborSGSTTaxTotal(opCodesList: any, IsIndependentTax: boolean): any;
+    /**
+     * Calculates GST tax breakdown for all parts (CGST, SGST, IGST, Total)
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Array containing [CGST, SGST, IGST, Total Tax] amounts
+     */
     static GetPartGSTTaxTotal(PartsList: any, IsIndependentTax: boolean): number[];
+    /**
+     * Groups parts by HSN code for tax reporting and compliance
+     * @param Parts - Array of parts to group
+     * @param TaxCodes - Available tax codes
+     * @param DecimalsNumber - Number of decimal places
+     * @returns Tax grouping information organized by HSN codes
+     */
     static GetTaxGroupingForPartsByHSN(Parts: any, TaxCodes: any, DecimalsNumber: number): any[];
+    /**
+     * Adds combined tax percentage calculation to each part based on tax codes
+     * @param Parts - Array of parts to process
+     * @param TaxCodes - Available tax codes for lookup
+     * @returns Parts array with added tax percentage information
+     */
     static GetCombinedTaxPercentage(Parts: any, TaxCodes: any): any;
+    /**
+     * Compares and groups parts by HSN code and tax rates
+     * @param Parts - Array of parts to compare
+     * @param TaxCodes - Available tax codes
+     * @returns Array of parts grouped by HSN code and tax rates
+     */
     static ComparePartsByHSN(Parts: any, TaxCodes: any): any[];
+    /**
+     * Generates detailed tax information grouped by HSN codes for compliance reporting
+     * @param FinalMatchedParts - Array of grouped parts by HSN
+     * @param TaxCodes - Available tax codes
+     * @param DecimalsNumber - Number of decimal places for formatting
+     * @returns Array of HSN-wise tax information objects
+     */
     static GetTaxGroupingInfoByHSN(FinalMatchedParts: any, TaxCodes: any, DecimalsNumber: any): any[];
+    /**
+     * Retrieves GST values (CGST, SGST, IGST) based on tax code lookup
+     * @param TCode - Tax code identifier
+     * @param TaxCodes - Array of available tax codes
+     * @returns Array containing [CGST, SGST, IGST] values for the tax code
+     */
     static GetGSTValueBasedOnTaxCode(TCode: any, TaxCodes: any): any[];
 }

package/dist/sales-receive/sales-receive-totals.service.js

@@ -3,39 +3,71 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SalesReceiveTotalsService = void 0;
 const tr_utils_1 = require("../utils/tr-utils");
 const aggregation_1 = require("../aggregation/aggregation");
+/**
+ * Service class for calculating sales receive totals including taxes, discounts and final amounts
+ */
 class SalesReceiveTotalsService {
+    /**
+     * Main method to calculate totals for sales receive operations
+     * @param opCodesList - Array of operation codes/labor items
+     * @param PartsList - Array of parts/items to be processed
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @param DetailedInfo - Whether to include detailed breakdown information
+     * @param Disc - Discount amount
+     * @param Perc - Discount percentage
+     * @param TaxCodes - Available tax codes for GST calculations
+     * @param WithItems - Whether to include items in the response
+     * @param Settings - General settings object
+     * @param EntitySettings - Entity-specific settings including decimal places
+     * @returns Object containing calculated totals and breakdown information
+     */
     static GetTotalsValue(opCodesList, PartsList, IsIndependentTax, DetailedInfo, Disc, Perc, TaxCodes, WithItems, Settings, EntitySettings = {}) {
-        // LPerc = TrUtils.SetPercToStringIfNull(LPerc);
-        // PPerc = TrUtils.SetPercToStringIfNull(PPerc);
+        // Sanitize input parameters to ensure valid values
         Perc = tr_utils_1.TrUtils.SetPercToStringIfNull(Perc);
-        // LDisc = TrUtils.SetValueToZeroIfNull(LDisc);
-        // PDisc = TrUtils.SetValueToZeroIfNull(PDisc);
         Disc = tr_utils_1.TrUtils.SetValueToZeroIfNull(Disc);
-        // opCodesList = this.CalculateLaborValues(opCodesList, IsIndependentTax);
+        // Calculate labor part values with tax considerations
         PartsList = this.CalculateLaborPartValues(PartsList, IsIndependentTax);
+        // Get the main totals data
         let finalTotalsData = this.GetFinalRODataForSave(opCodesList, PartsList, IsIndependentTax, Disc, Perc, DetailedInfo, Settings, EntitySettings.DecimalsNumber);
+        // Add detailed breakdown if requested
         if (DetailedInfo) {
             finalTotalsData = this.GetDetailedTotalsData(finalTotalsData, IsIndependentTax, opCodesList, PartsList, TaxCodes, EntitySettings.DecimalsNumber);
         }
+        // Include items in response if requested
         if (WithItems) {
-            // finalTotalsData.Ops = opCodesList;
             finalTotalsData.Items = PartsList;
         }
         return finalTotalsData;
     }
+    /**
+     * Calculates labor part values including discounts and taxes
+     * @param PartsList - Array of parts to be processed
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Processed parts list with calculated values
+     */
     static CalculateLaborPartValues(PartsList, IsIndependentTax) {
         PartsList = this.ResetLaborPartValues(PartsList, IsIndependentTax);
         return PartsList;
     }
+    /**
+     * Resets and recalculates labor part values including discounts and taxes
+     * @param PartsList - Array of parts to be processed
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Parts list with reset and recalculated values
+     */
     static ResetLaborPartValues(PartsList, IsIndependentTax) {
         PartsList.forEach((Part) => {
+            // Reset invalid values to defaults
             Part = this.ResetLaborPartValueIfInvalid(Part);
+            // Set minimum quantity to 1 if zero
             if (tr_utils_1.TrUtils.IsZero(Part.Qty)) {
                 Part.Qty = 1;
             }
+            // Calculate total discounted price
             Part.DiscountedPrice = (0, aggregation_1.addition)(Part.Disc, Part.RecDisc);
-            // Part.AfterPartDisc = Part.NetAmt;
+            // Calculate amount after discount
             Part.AfterPartDisc = (0, aggregation_1.subtraction)(Part.UnAmt, Part.Disc, Part.RecDisc);
+            // Calculate amount after tax based on tax type
             if (IsIndependentTax) {
                 Part.AfterPartTax = (0, aggregation_1.addition)(Part.AfterPartDisc, Part.CGST, Part.SGST, Part.IGST);
             }
@@ -45,6 +77,11 @@ class SalesReceiveTotalsService {
         });
         return PartsList;
     }
+    /**
+     * Resets part values to zero if they are null or invalid
+     * @param Part - Individual part item to reset
+     * @returns Part with reset values
+     */
     static ResetLaborPartValueIfInvalid(Part) {
         Part.UnPr = tr_utils_1.TrUtils.SetValueToZeroIfNull(Part.UnPr);
         Part.Disc = tr_utils_1.TrUtils.SetValueToZeroIfNull(Part.Disc);
@@ -54,51 +91,93 @@ class SalesReceiveTotalsService {
         Part.IGST = tr_utils_1.TrUtils.SetValueToZeroIfNull(Part.IGST);
         return Part;
     }
+    /**
+     * Prepares final repair order data for saving with calculated totals
+     * @param LaborList - Array of labor items
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @param Disc - Discount amount
+     * @param Perc - Discount percentage
+     * @param DetailedInfo - Whether to include detailed information
+     * @param Settings - General settings
+     * @param DecimalsNumber - Number of decimal places for calculations
+     * @returns Final totals data object ready for saving
+     */
     static GetFinalRODataForSave(LaborList, PartsList, IsIndependentTax, Disc, Perc, DetailedInfo, Settings, DecimalsNumber) {
         let finalTotalsData = {};
+        // Set discount values
         finalTotalsData = this.SetMainDiscountValues(Disc, Perc, finalTotalsData, DetailedInfo);
+        // Add settings to response
         finalTotalsData.Settings = Settings;
+        // Calculate customer totals
         finalTotalsData = this.GetFinalCustomerTotalsData(finalTotalsData, [], PartsList, IsIndependentTax, DetailedInfo, DecimalsNumber);
         return finalTotalsData;
     }
+    /**
+     * Sets main discount values in the totals data object
+     * @param Disc - Discount amount
+     * @param Perc - Discount percentage
+     * @param finalTotalsData - Totals data object to update
+     * @param DetailedInfo - Whether to include detailed information
+     * @returns Updated totals data with discount values
+     */
     static SetMainDiscountValues(Disc, Perc, finalTotalsData, DetailedInfo) {
-        // finalTotalsData.LDisc = LDisc;
-        // finalTotalsData.LPerc = LPerc;
-        // finalTotalsData.PDisc = PDisc;
-        // finalTotalsData.PPerc = PPerc;
         finalTotalsData.Disc = Disc;
         finalTotalsData.Perc = Perc;
         if (DetailedInfo) {
-            // finalTotalsData.FixedLDisc = LDisc;
-            // finalTotalsData.FixedPDisc = PDisc;
             finalTotalsData.FixedDisc = Disc;
         }
         return finalTotalsData;
     }
+    /**
+     * Calculates final customer totals including subtotals, taxes, and rounded amounts
+     * @param finalTotalsData - Existing totals data object
+     * @param LaborList - Array of labor items
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @param DetailedInfo - Whether to include detailed information
+     * @param DecimalsNumber - Number of decimal places for calculations
+     * @returns Updated totals data with customer calculations
+     */
     static GetFinalCustomerTotalsData(finalTotalsData, LaborList, PartsList, IsIndependentTax, DetailedInfo, DecimalsNumber = 2) {
+        // Calculate subtotal after discounts
         let CustomerAfterDiscTotals = this.GetSubTotalFor([], PartsList);
-        // let CustLaborTaxTotal = this.GetLaborTaxTotalFor([], IsIndependentTax);
+        // Calculate parts tax total
         let CustPartTaxTotal = this.GetPartsTaxTotalFor(PartsList, IsIndependentTax);
+        // Set subtotal with proper decimal formatting
         finalTotalsData.SubTotal = tr_utils_1.TrUtils.FixedTo(CustomerAfterDiscTotals, DecimalsNumber);
-        // let CustLaborDiscTotal = this.GetLaborDiscountedTotal(LaborList, IsIndependentTax, finalTotalsData);
+        // Calculate discount totals
         let CustPartsDiscTotal = this.GetPartDiscountedTotal(PartsList, IsIndependentTax, finalTotalsData);
-        // let CustLaborTotalAfterDisc = this.GetLaborTotalAfterDiscount(LaborList);
         let CustPartsTotalAfterDisc = this.GetPartsTotalAfterDiscount(PartsList);
+        // Calculate sum total
         finalTotalsData.STotal = (0, aggregation_1.addition)(CustPartsDiscTotal, CustPartsTotalAfterDisc);
+        // Calculate final customer total
         let CustTotal = this.GetCustomerTotalBasedOnTaxType(finalTotalsData, 0, CustPartTaxTotal, [], PartsList, IsIndependentTax);
+        // Calculate rounding difference and final total
         finalTotalsData.Round = (0, aggregation_1.subtraction)(Math.round(CustTotal), CustTotal);
         finalTotalsData.Total = Math.round(CustTotal);
+        // Add detailed information if requested
         if (DetailedInfo) {
             finalTotalsData.FixedSubTotal = tr_utils_1.TrUtils.FixedTo(CustomerAfterDiscTotals, DecimalsNumber);
             finalTotalsData.FixedTotal = tr_utils_1.TrUtils.FixedTo(CustTotal, DecimalsNumber);
         }
         return finalTotalsData;
     }
+    /**
+     * Calculates subtotal for labor and parts combined
+     * @param LaborList - Array of labor items
+     * @param PartsList - Array of parts
+     * @returns Calculated subtotal amount
+     */
     static GetSubTotalFor(LaborList, PartsList) {
-        // let LaborTotalAfterDisc: any = this.GetLaborTotalAfterDiscount(LaborList);
         let PartsTotalAfterDisc = this.GetPartsTotalAfterDiscount(PartsList);
         return PartsTotalAfterDisc;
     }
+    /**
+     * Calculates total amount for parts after applying discounts
+     * @param PartsList - Array of parts
+     * @returns Total parts amount after discounts
+     */
     static GetPartsTotalAfterDiscount(PartsList) {
         let PartsTotalAfterDisc = 0;
         PartsList.forEach((Part) => {
@@ -106,29 +185,36 @@ class SalesReceiveTotalsService {
         });
         return PartsTotalAfterDisc;
     }
+    /**
+     * Generates detailed totals data including tax breakdowns and groupings
+     * @param finalTotalsData - Existing totals data
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @param opCodesList - Array of operation codes
+     * @param PartsList - Array of parts
+     * @param TaxCodes - Available tax codes
+     * @param DecimalsNumber - Number of decimal places
+     * @returns Enhanced totals data with detailed breakdowns
+     */
     static GetDetailedTotalsData(finalTotalsData, IsIndependentTax, opCodesList, PartsList, TaxCodes, DecimalsNumber = 2) {
-        // finalTotalsData.CustLaborDiscTotal = this.GetLaborDiscountedTotal(opCodesList, IsIndependentTax, finalTotalsData);
+        // Add parts discount and total information
         finalTotalsData.CustPartsDiscTotal = this.GetPartDiscountedTotal(PartsList, IsIndependentTax, finalTotalsData);
-        // finalTotalsData.CustLaborTotalAfterDisc = this.GetLaborTotalAfterDiscount(opCodesList);
         finalTotalsData.CustPartsTotalAfterDisc = this.GetPartsTotalAfterDiscount(PartsList);
-        // finalTotalsData.CustLaborTotalBeforeDisc = TrUtils.FixedTo(finalTotalsData.CustLaborTotalAfterDisc
-        //     + finalTotalsData.CustLaborDiscTotal);
         finalTotalsData.CustPartsTotalBeforeDisc = (0, aggregation_1.addition)(finalTotalsData.CustPartsTotalAfterDisc, finalTotalsData.CustPartsDiscTotal);
-        // finalTotalsData.CustLaborITax = this.GetLaborTaxTotalFor(opCodesList, IsIndependentTax);
-        // finalTotalsData.CustLaborSGST = this.GetLaborSGSTTaxTotal(opCodesList, IsIndependentTax);
-        // finalTotalsData.CustLaborCGST = this.GetLaborCGSTTaxTotal(opCodesList, IsIndependentTax);
-        // finalTotalsData.CustLaborIGST = this.GetLaborIGSTTaxTotal(opCodesList, IsIndependentTax);
+        // Get GST tax breakdown
         let TaxInfo = this.GetPartGSTTaxTotal(PartsList, IsIndependentTax);
         finalTotalsData.CustPartITax = tr_utils_1.TrUtils.SetValueToZeroIfNull(TaxInfo[3]);
         finalTotalsData.CustPartCGST = tr_utils_1.TrUtils.SetValueToZeroIfNull(TaxInfo[0]);
         finalTotalsData.CustPartIGST = tr_utils_1.TrUtils.SetValueToZeroIfNull(TaxInfo[2]);
         finalTotalsData.CustPartSGST = tr_utils_1.TrUtils.SetValueToZeroIfNull(TaxInfo[1]);
-        // finalTotalsData.CustLaborAfterTax = addition(finalTotalsData.CustLaborITax, finalTotalsData.CustLaborTotalAfterDisc);
+        // Calculate after tax amount
         finalTotalsData.CustPartAfterTax = (0, aggregation_1.addition)(finalTotalsData.CustPartITax, finalTotalsData.CustPartsTotalAfterDisc);
+        // Add tax grouping information
         finalTotalsData.CustTaxGroupData = this.GetTaxGroupingForPartsByHSN(tr_utils_1.TrUtils.Stringify(PartsList), TaxCodes, DecimalsNumber);
         finalTotalsData.CustTaxGroupDataByPerc = this.GetTaxGroupingForPartsByPerc(PartsList, TaxCodes, DecimalsNumber);
+        // Add rounding information
         finalTotalsData.CustTotalRoundedBy = tr_utils_1.TrUtils.FixedTo(finalTotalsData.Round, DecimalsNumber);
         finalTotalsData.CustRoundedTotal = tr_utils_1.TrUtils.FixedTo(finalTotalsData.Total, DecimalsNumber);
+        // Format all numeric values to proper decimal places
         for (var key in finalTotalsData) {
             if (key !== 'Total' && key !== 'SubTotal' &&
                 key !== 'LDisc' && key !== 'LPerc' && key !== 'PDisc' &&
@@ -139,17 +225,34 @@ class SalesReceiveTotalsService {
         }
         return finalTotalsData;
     }
+    /**
+     * Groups parts by tax percentage for consolidated tax reporting
+     * @param Parts - Array of parts to group
+     * @param TaxCodes - Available tax codes
+     * @param DecimalsNumber - Number of decimal places
+     * @returns Array of parts grouped by tax percentage
+     */
     static GetTaxGroupingForPartsByPerc(Parts, TaxCodes, DecimalsNumber) {
+        // Add combined tax percentage to each part
         Parts = this.GetCombinedTaxPercentage(tr_utils_1.TrUtils.Stringify(Parts), TaxCodes);
-        // Parts = this.ResetPartsHSNIfInvalid(Parts);
+        // Group parts with same tax percentages
         let FinalMatchedParts = this.ComparePartsByPerc(Parts, TaxCodes);
+        // Generate tax grouping information
         return this.GetTaxGroupingInfoByHSN(FinalMatchedParts, TaxCodes, DecimalsNumber);
     }
+    /**
+     * Compares and groups parts by tax percentage rates
+     * @param Parts - Array of parts to compare
+     * @param TaxCodes - Available tax codes
+     * @returns Array of grouped parts with same tax percentages
+     */
     static ComparePartsByPerc(Parts, TaxCodes) {
         let FinalMatchedParts = [];
         Parts === null || Parts === void 0 ? void 0 : Parts.forEach((Part) => {
+            // Find parts with matching tax amounts that haven't been grouped yet
             let MatchedPartsBasedOnHSN = Parts.filter((argPart) => {
                 let PartFound = false;
+                // Check if part is already in a group
                 FinalMatchedParts.forEach((FinalArgParts) => {
                     let PartIndex = FinalArgParts.findIndex((FinalArgPart) => {
                         return FinalArgPart._id === argPart._id;
@@ -158,35 +261,44 @@ class SalesReceiveTotalsService {
                         PartFound = true;
                     }
                 });
-                // let argGSTValues: any[] = this.GetGSTValueBasedOnTaxCode(argPart.TCode, TaxCodes);
-                // let argCGST = argGSTValues[0];
-                // let argSGST = argGSTValues[1];
-                // let argIGST = argGSTValues[2];
-                // let partGSTValues: any[] = this.GetGSTValueBasedOnTaxCode(Part.TCode, TaxCodes);
-                // let partCGST = partGSTValues[0];
-                // let partSGST = partGSTValues[1];
-                // let partIGST = partGSTValues[2];
+                // Return parts with same tax percentages that aren't already grouped
                 return (!PartFound) &&
                     (argPart.CGSTAmt === Part.CGSTAmt) && (argPart.IGSTAmt === Part.IGSTAmt) &&
                     (argPart.SGSTAmt === Part.SGSTAmt);
             });
+            // Add group if it contains parts
             if (MatchedPartsBasedOnHSN.length !== 0) {
                 FinalMatchedParts.push(MatchedPartsBasedOnHSN);
             }
         });
         return FinalMatchedParts;
     }
+    /**
+     * Calculates total discounted amount for all parts
+     * @param PartsList - Array of parts
+     * @param isTaxable - Whether parts are taxable
+     * @param finalTotalsData - Existing totals data
+     * @returns Total discounted amount including overall part discount
+     */
     static GetPartDiscountedTotal(PartsList, isTaxable, finalTotalsData) {
         let PartsDiscountedTotal = 0;
         let overallPartDisc = 0;
+        // Add overall part discount if not taxable
         if (!isTaxable) {
             overallPartDisc = tr_utils_1.TrUtils.SetValueToZeroIfNull(finalTotalsData.PDisc);
         }
+        // Sum up individual part discounts
         PartsList.forEach((Part) => {
             PartsDiscountedTotal = (0, aggregation_1.addition)(PartsDiscountedTotal, Part.DiscountedPrice);
         });
         return (0, aggregation_1.addition)(PartsDiscountedTotal, overallPartDisc);
     }
+    /**
+     * Calculates total tax amount for all parts
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Total tax amount for all parts
+     */
     static GetPartsTaxTotalFor(PartsList, IsIndependentTax) {
         let TotalTaxAmt = 0;
         if (IsIndependentTax) {
@@ -196,28 +308,56 @@ class SalesReceiveTotalsService {
         }
         return TotalTaxAmt;
     }
+    /**
+     * Calculates customer total based on tax calculation type
+     * @param finalTotalsData - Existing totals data
+     * @param LaborTaxAmount - Total labor tax amount
+     * @param PartsTaxAmount - Total parts tax amount
+     * @param LaborList - Array of labor items
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Final customer total based on tax type
+     */
     static GetCustomerTotalBasedOnTaxType(finalTotalsData, LaborTaxAmount, PartsTaxAmount, LaborList, PartsList, IsIndependentTax) {
-        // let LaborTotalAfterDisc: any = this.GetLaborTotalAfterDiscount(LaborList);
         let PartsTotalAfterDisc = this.GetPartsTotalAfterDiscount(PartsList);
         if (IsIndependentTax) {
+            // Add tax amounts to the total
             return (0, aggregation_1.addition)(PartsTotalAfterDisc, LaborTaxAmount, PartsTaxAmount);
         }
         else {
+            // Subtract discount from the total
             return (0, aggregation_1.subtraction)(PartsTotalAfterDisc, finalTotalsData.Disc);
         }
     }
+    /**
+     * Calculates items total after applying discounts (percentage or fixed)
+     * @param PartsTotalAfterDisc - Parts total after discount
+     * @param PartsTaxAmount - Parts tax amount
+     * @param MainPDisc - Main parts discount amount
+     * @param PDiscInPerc - Parts discount percentage
+     * @returns Final items total after all discounts
+     */
     static ItemsTotalAfterDiscount(PartsTotalAfterDisc, PartsTaxAmount, MainPDisc, PDiscInPerc) {
         let ItemsTotal = (0, aggregation_1.addition)(PartsTotalAfterDisc, PartsTaxAmount);
+        // Apply discount if present
         if (!tr_utils_1.TrUtils.IsZero(MainPDisc)) {
             if (!tr_utils_1.TrUtils.IsEmpty(PDiscInPerc)) {
+                // Apply percentage discount
                 ItemsTotal = (0, aggregation_1.subtraction)(ItemsTotal, (0, aggregation_1.division)((0, aggregation_1.multiply)(ItemsTotal, Number(PDiscInPerc)), 100));
             }
             else {
+                // Apply fixed discount
                 ItemsTotal = (0, aggregation_1.subtraction)(ItemsTotal, MainPDisc);
             }
         }
         return ItemsTotal;
     }
+    /**
+     * Calculates total CGST tax amount for labor items
+     * @param opCodesList - Array of operation codes/labor
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Total CGST amount for labor
+     */
     static GetLaborCGSTTaxTotal(opCodesList, IsIndependentTax) {
         let TotalTaxAmt = 0;
         if (IsIndependentTax) {
@@ -227,6 +367,12 @@ class SalesReceiveTotalsService {
         }
         return TotalTaxAmt;
     }
+    /**
+     * Calculates total IGST tax amount for labor items
+     * @param opCodesList - Array of operation codes/labor
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Total IGST amount for labor
+     */
     static GetLaborIGSTTaxTotal(opCodesList, IsIndependentTax) {
         let TotalTaxAmt = 0;
         if (IsIndependentTax) {
@@ -236,6 +382,12 @@ class SalesReceiveTotalsService {
         }
         return TotalTaxAmt;
     }
+    /**
+     * Calculates total SGST tax amount for labor items
+     * @param opCodesList - Array of operation codes/labor
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Total SGST amount for labor
+     */
     static GetLaborSGSTTaxTotal(opCodesList, IsIndependentTax) {
         let TotalTaxAmt = 0;
         if (IsIndependentTax) {
@@ -245,6 +397,12 @@ class SalesReceiveTotalsService {
         }
         return TotalTaxAmt;
     }
+    /**
+     * Calculates GST tax breakdown for all parts (CGST, SGST, IGST, Total)
+     * @param PartsList - Array of parts
+     * @param IsIndependentTax - Whether tax is calculated independently
+     * @returns Array containing [CGST, SGST, IGST, Total Tax] amounts
+     */
     static GetPartGSTTaxTotal(PartsList, IsIndependentTax) {
         let TotalCGSTAmt = 0;
         let TotalSGSTAmt = 0;
@@ -260,30 +418,56 @@ class SalesReceiveTotalsService {
         }
         return [TotalCGSTAmt, TotalSGSTAmt, TotalIGSTAmt, TotalTaxAmt];
     }
+    /**
+     * Groups parts by HSN code for tax reporting and compliance
+     * @param Parts - Array of parts to group
+     * @param TaxCodes - Available tax codes
+     * @param DecimalsNumber - Number of decimal places
+     * @returns Tax grouping information organized by HSN codes
+     */
     static GetTaxGroupingForPartsByHSN(Parts, TaxCodes, DecimalsNumber) {
+        // Add combined tax percentage to parts
         Parts = this.GetCombinedTaxPercentage(Parts, TaxCodes);
-        // Parts = this.ResetPartsHSNIfInvalid(Parts);
+        // Group parts by HSN code
         let FinalMatchedParts = this.ComparePartsByHSN(Parts, TaxCodes);
+        // Generate HSN-based tax grouping information
         return this.GetTaxGroupingInfoByHSN(FinalMatchedParts, TaxCodes, DecimalsNumber);
     }
+    /**
+     * Adds combined tax percentage calculation to each part based on tax codes
+     * @param Parts - Array of parts to process
+     * @param TaxCodes - Available tax codes for lookup
+     * @returns Parts array with added tax percentage information
+     */
     static GetCombinedTaxPercentage(Parts, TaxCodes) {
         Parts.forEach((Part) => {
+            // Ensure HSN is not null
             if (tr_utils_1.TrUtils.IsNull(Part.HSN)) {
                 Part.HSN = '';
             }
+            // Get GST values based on tax code
             let GSTValues = this.GetGSTValueBasedOnTaxCode(Part.TCode, TaxCodes);
             Part.CGSTAmt = tr_utils_1.TrUtils.SetValueToZeroIfNull(GSTValues[0]);
             Part.SGSTAmt = tr_utils_1.TrUtils.SetValueToZeroIfNull(GSTValues[1]);
             Part.IGSTAmt = tr_utils_1.TrUtils.SetValueToZeroIfNull(GSTValues[2]);
+            // Calculate combined tax percentage
             Part.CombinedTaxPercentage = (0, aggregation_1.addition)(Part.CGSTAmt, Part.SGSTAmt, Part.IGSTAmt);
         });
         return Parts;
     }
+    /**
+     * Compares and groups parts by HSN code and tax rates
+     * @param Parts - Array of parts to compare
+     * @param TaxCodes - Available tax codes
+     * @returns Array of parts grouped by HSN code and tax rates
+     */
     static ComparePartsByHSN(Parts, TaxCodes) {
         let FinalMatchedParts = [];
         Parts.forEach((Part) => {
+            // Find parts with same HSN and tax rates that haven't been grouped
             let MatchedPartsBasedOnHSN = Parts.filter((argPart) => {
                 let PartFound = false;
+                // Check if part is already in a group
                 FinalMatchedParts.forEach((FinalArgParts) => {
                     let PartIndex = FinalArgParts.findIndex((FinalArgPart) => {
                         return FinalArgPart._id === argPart._id;
@@ -292,24 +476,25 @@ class SalesReceiveTotalsService {
                         PartFound = true;
                     }
                 });
-                // let argGSTValues: any[] = this.GetGSTValueBasedOnTaxCode(argPart.TCode, TaxCodes);
-                // let argCGST = argGSTValues[0];
-                // let argSGST = argGSTValues[1];
-                // let argIGST = argGSTValues[2];
-                // let partGSTValues: any[] = this.GetGSTValueBasedOnTaxCode(Part.TCode, TaxCodes);
-                // let partCGST = partGSTValues[0];
-                // let partSGST = partGSTValues[1];
-                // let partIGST = partGSTValues[2];
+                // Return parts with same HSN and tax rates that aren't grouped yet
                 return (argPart.HSN === Part.HSN) && (!PartFound) &&
                     (argPart.CGSTAmt === Part.CGSTAmt) && (argPart.IGSTAmt === Part.IGSTAmt) &&
                     (argPart.SGSTAmt === Part.SGSTAmt);
             });
+            // Add group if it contains parts
             if (MatchedPartsBasedOnHSN.length !== 0) {
                 FinalMatchedParts.push(MatchedPartsBasedOnHSN);
             }
         });
         return FinalMatchedParts;
     }
+    /**
+     * Generates detailed tax information grouped by HSN codes for compliance reporting
+     * @param FinalMatchedParts - Array of grouped parts by HSN
+     * @param TaxCodes - Available tax codes
+     * @param DecimalsNumber - Number of decimal places for formatting
+     * @returns Array of HSN-wise tax information objects
+     */
     static GetTaxGroupingInfoByHSN(FinalMatchedParts, TaxCodes, DecimalsNumber) {
         let HSNTaxInfo = [];
         FinalMatchedParts.forEach((MatchedPart) => {
@@ -319,8 +504,10 @@ class SalesReceiveTotalsService {
             let CGSTAmt = 0;
             let SGSTAmt = 0;
             let IGSTAmt = 0;
+            // Get HSN code and tax percentage from first item
             let HSN = MatchedPart[0].HSN;
             TaxInfo.CombinedTaxPercentage = MatchedPart[0].CombinedTaxPercentage;
+            // Calculate totals for all parts in this HSN group
             MatchedPart.forEach((argMatchedGSTPart) => {
                 TaxOnAmount = (0, aggregation_1.addition)(TaxOnAmount, tr_utils_1.TrUtils.FixedTo(argMatchedGSTPart.AfterPartDisc, DecimalsNumber));
                 TaxAmount = (0, aggregation_1.addition)(TaxAmount, tr_utils_1.TrUtils.FixedTo(argMatchedGSTPart.CGST, DecimalsNumber));
@@ -330,6 +517,7 @@ class SalesReceiveTotalsService {
                 SGSTAmt = (0, aggregation_1.addition)(SGSTAmt, tr_utils_1.TrUtils.FixedTo(argMatchedGSTPart.SGST, DecimalsNumber));
                 IGSTAmt = (0, aggregation_1.addition)(IGSTAmt, tr_utils_1.TrUtils.FixedTo(argMatchedGSTPart.IGST, DecimalsNumber));
             });
+            // Build tax information object
             TaxInfo.HSN = HSN;
             TaxInfo.CGSTAmt = CGSTAmt;
             TaxInfo.SGSTAmt = SGSTAmt;
@@ -337,38 +525,47 @@ class SalesReceiveTotalsService {
             TaxInfo.TotalTaxableAmount = tr_utils_1.TrUtils.FixPriceValue(TaxOnAmount, DecimalsNumber);
             TaxInfo.TotalTaxAmount = tr_utils_1.TrUtils.FixPriceValue(TaxAmount, DecimalsNumber);
             TaxInfo.ItemsCount = MatchedPart.length;
-            // let GSTValues: any[] = this.GetGSTValueBasedOnTaxCode(MatchedPart[0].TCode, TaxCodes);
-            // TaxInfo.CGST = GSTValues[0];
-            // TaxInfo.SGST = GSTValues[1];
-            // TaxInfo.IGST = GSTValues[2];
             TaxInfo.CGST = MatchedPart[0].CGSTAmt;
             TaxInfo.IGST = MatchedPart[0].IGSTAmt;
             TaxInfo.SGST = MatchedPart[0].SGSTAmt;
+            // Only add if there's a taxable amount
             if (TaxOnAmount !== 0) {
                 HSNTaxInfo.push(TaxInfo);
             }
         });
         return HSNTaxInfo;
     }
+    /**
+     * Retrieves GST values (CGST, SGST, IGST) based on tax code lookup
+     * @param TCode - Tax code identifier
+     * @param TaxCodes - Array of available tax codes
+     * @returns Array containing [CGST, SGST, IGST] values for the tax code
+     */
     static GetGSTValueBasedOnTaxCode(TCode, TaxCodes) {
         let CGST = 0;
         let SGST = 0;
         let IGST = 0;
+        // Return zeros if tax code is null
         if (tr_utils_1.TrUtils.IsNull(TCode)) {
             return [CGST, SGST, IGST];
         }
+        // Find tax code in the array
         let TCodeIndex = TaxCodes.findIndex((TaxCode) => {
             return TaxCode._id === Number(TCode);
         });
+        // Return appropriate tax values based on tax type
         if (TCodeIndex !== -1) {
             if (TaxCodes[TCodeIndex].Type === 'Intra') {
+                // Intra-state: CGST + SGST
                 return [TaxCodes[TCodeIndex].CGST, TaxCodes[TCodeIndex].SGST, 0];
             }
             else {
+                // Inter-state: IGST only
                 return [0, 0, TaxCodes[TCodeIndex].IGST];
             }
         }
         else {
+            // Tax code not found, return zeros
             return [CGST, SGST, IGST];
         }
     }

package/dist/sales-receive/sales-total-calculation.d.ts

@@ -0,0 +1,5 @@
+export declare function SalesTotalCalculations(items?: any[], ops?: any[], isTaxable?: boolean): any;
+/**
+ * Enhanced version with decimal places control
+ */
+export declare function SalesTotalCalculationsWithDecimals(items?: any[], ops?: any[], isTaxable?: boolean, decimalPlaces?: number): any;

package/dist/sales-receive/sales-total-calculation.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalesTotalCalculations = SalesTotalCalculations;
+exports.SalesTotalCalculationsWithDecimals = SalesTotalCalculationsWithDecimals;
+const math_operations_1 = require("../shared/math-operations");
+const util_1 = require("../shared/util");
+/**
+ * Safely handles null/undefined arrays and returns empty array
+ */
+function safeArray(arr) {
+    return Array.isArray(arr) ? arr : [];
+}
+function SalesTotalCalculations(items = [], ops = [], isTaxable = false) {
+    // Handle null/undefined arrays
+    const safeItems = safeArray(items);
+    const safeOps = safeArray(ops);
+    // Initialize all totals
+    let total = 0;
+    let subtotalOnItems = 0;
+    let subtotalOnLabor = 0;
+    let subtotal = 0;
+    let totalTax = 0;
+    let totalTaxOnItems = 0;
+    let totalTaxOnLabor = 0;
+    let totalDiscount = 0;
+    let totalDiscountOnItems = 0;
+    let totalDiscountOnLabor = 0;
+    let roundOff = 0;
+    // Tax breakdown totals - only calculate if taxable
+    let totalSGST = 0;
+    let totalCGST = 0;
+    let totalIGST = 0;
+    let totalSGSTOnItems = 0;
+    let totalCGSTOnItems = 0;
+    let totalIGSTOnItems = 0;
+    let totalSGSTOnLabor = 0;
+    let totalCGSTOnLabor = 0;
+    let totalIGSTOnLabor = 0;
+    // Calculate items totals with null safety
+    safeItems.forEach((item) => {
+        const itemDisc = (0, util_1.GetNumber)(item.Disc);
+        const itemRecDisc = (0, util_1.GetNumber)(item.RecDisc);
+        const itemUnAmt = (0, util_1.GetNumber)(item.UnAmt);
+        totalDiscountOnItems = (0, math_operations_1.Add)(totalDiscountOnItems, itemDisc, itemRecDisc);
+        subtotalOnItems = (0, math_operations_1.Add)(subtotalOnItems, itemUnAmt);
+        // Only calculate tax if taxable
+        if (isTaxable) {
+            const itemSGST = (0, util_1.GetNumber)(item.SGST);
+            const itemCGST = (0, util_1.GetNumber)(item.CGST);
+            const itemIGST = (0, util_1.GetNumber)(item.IGST);
+            // Add individual tax amounts for items
+            totalSGSTOnItems = (0, math_operations_1.Add)(totalSGSTOnItems, itemSGST);
+            totalCGSTOnItems = (0, math_operations_1.Add)(totalCGSTOnItems, itemCGST);
+            totalIGSTOnItems = (0, math_operations_1.Add)(totalIGSTOnItems, itemIGST);
+            totalTaxOnItems = (0, math_operations_1.Add)(totalTaxOnItems, itemSGST, itemCGST, itemIGST);
+        }
+    });
+    // Calculate operations/labor totals with null safety
+    safeOps.forEach((op) => {
+        const opDisc = (0, util_1.GetNumber)(op.Disc);
+        const opRecDisc = (0, util_1.GetNumber)(op.RecDisc);
+        const opAmt = (0, util_1.GetNumber)(op.Amt);
+        totalDiscountOnLabor = (0, math_operations_1.Add)(totalDiscountOnLabor, opDisc, opRecDisc);
+        subtotalOnLabor = (0, math_operations_1.Add)(subtotalOnLabor, opAmt);
+        // Only calculate tax if taxable
+        if (isTaxable) {
+            const opSGST = (0, util_1.GetNumber)(op.SGST);
+            const opCGST = (0, util_1.GetNumber)(op.CGST);
+            const opIGST = (0, util_1.GetNumber)(op.IGST);
+            // Add individual tax amounts for operations/labor
+            totalSGSTOnLabor = (0, math_operations_1.Add)(totalSGSTOnLabor, opSGST);
+            totalCGSTOnLabor = (0, math_operations_1.Add)(totalCGSTOnLabor, opCGST);
+            totalIGSTOnLabor = (0, math_operations_1.Add)(totalIGSTOnLabor, opIGST);
+            totalTaxOnLabor = (0, math_operations_1.Add)(totalTaxOnLabor, opSGST, opCGST, opIGST);
+        }
+    });
+    // Calculate combined totals
+    totalDiscount = (0, math_operations_1.Add)(totalDiscountOnItems, totalDiscountOnLabor);
+    totalTax = (0, math_operations_1.Add)(totalTaxOnItems, totalTaxOnLabor);
+    subtotal = (0, math_operations_1.Add)(subtotalOnItems, subtotalOnLabor);
+    // Calculate combined tax breakdown totals only if taxable
+    if (isTaxable) {
+        totalSGST = (0, math_operations_1.Add)(totalSGSTOnItems, totalSGSTOnLabor);
+        totalCGST = (0, math_operations_1.Add)(totalCGSTOnItems, totalCGSTOnLabor);
+        totalIGST = (0, math_operations_1.Add)(totalIGSTOnItems, totalIGSTOnLabor);
+    }
+    // FIXED CALCULATION: Correct order of operations
+    // Step 1: Calculate net amount after discount
+    const netAmountAfterDiscount = (0, math_operations_1.Subtract)(subtotal, totalDiscount);
+    // Step 2: Add tax if taxable
+    total = isTaxable ? (0, math_operations_1.Add)(netAmountAfterDiscount, totalTax) : netAmountAfterDiscount;
+    // FIXED ROUNDING: Use Math.round instead of Math.floor
+    const roundedTotal = Math.round(total);
+    roundOff = (0, math_operations_1.Subtract)(roundedTotal, total);
+    // Update total to rounded value
+    total = roundedTotal;
+    // Base return object
+    const result = {
+        total,
+        subtotal,
+        totalDiscount,
+        roundOff,
+        subtotalOnItems,
+        subtotalOnLabor,
+        totalDiscountOnItems,
+        totalDiscountOnLabor,
+        netAmountAfterDiscount
+    };
+    // Only include tax fields if taxable
+    if (isTaxable) {
+        result.totalTax = totalTax;
+        result.totalTaxOnItems = totalTaxOnItems;
+        result.totalTaxOnLabor = totalTaxOnLabor;
+        result.totalSGST = totalSGST;
+        result.totalCGST = totalCGST;
+        result.totalIGST = totalIGST;
+        result.totalSGSTOnItems = totalSGSTOnItems;
+        result.totalCGSTOnItems = totalCGSTOnItems;
+        result.totalIGSTOnItems = totalIGSTOnItems;
+        result.totalSGSTOnLabor = totalSGSTOnLabor;
+        result.totalCGSTOnLabor = totalCGSTOnLabor;
+        result.totalIGSTOnLabor = totalIGSTOnLabor;
+    }
+    return result;
+}
+/**
+ * Enhanced version with decimal places control
+ */
+function SalesTotalCalculationsWithDecimals(items = [], ops = [], isTaxable = false, decimalPlaces = 2) {
+    const result = SalesTotalCalculations(items, ops, isTaxable);
+    // Round all values to specified decimal places
+    const roundToDecimals = (num) => Math.round(num * Math.pow(10, decimalPlaces)) / Math.pow(10, decimalPlaces);
+    // Base rounded result
+    const roundedResult = {
+        total: roundToDecimals(result.total),
+        subtotal: roundToDecimals(result.subtotal),
+        totalDiscount: roundToDecimals(result.totalDiscount),
+        roundOff: roundToDecimals(result.roundOff),
+        subtotalOnItems: roundToDecimals(result.subtotalOnItems),
+        subtotalOnLabor: roundToDecimals(result.subtotalOnLabor),
+        totalDiscountOnItems: roundToDecimals(result.totalDiscountOnItems),
+        totalDiscountOnLabor: roundToDecimals(result.totalDiscountOnLabor),
+        netAmountAfterDiscount: roundToDecimals(result.netAmountAfterDiscount)
+    };
+    // Only include tax fields if taxable
+    if (isTaxable) {
+        roundedResult.totalTax = roundToDecimals(result.totalTax);
+        roundedResult.totalTaxOnItems = roundToDecimals(result.totalTaxOnItems);
+        roundedResult.totalTaxOnLabor = roundToDecimals(result.totalTaxOnLabor);
+        roundedResult.totalSGST = roundToDecimals(result.totalSGST);
+        roundedResult.totalCGST = roundToDecimals(result.totalCGST);
+        roundedResult.totalIGST = roundToDecimals(result.totalIGST);
+        roundedResult.totalSGSTOnItems = roundToDecimals(result.totalSGSTOnItems);
+        roundedResult.totalCGSTOnItems = roundToDecimals(result.totalCGSTOnItems);
+        roundedResult.totalIGSTOnItems = roundToDecimals(result.totalIGSTOnItems);
+        roundedResult.totalSGSTOnLabor = roundToDecimals(result.totalSGSTOnLabor);
+        roundedResult.totalCGSTOnLabor = roundToDecimals(result.totalCGSTOnLabor);
+        roundedResult.totalIGSTOnLabor = roundToDecimals(result.totalIGSTOnLabor);
+    }
+    return roundedResult;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shareneus",
-  "version": "1.4.96",
+  "version": "1.4.98",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",