tango-app-api-payment-subscription 3.5.20 → 3.5.22

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tango-app-api-payment-subscription",
-    "version": "3.5.20",
+    "version": "3.5.22",
     "description": "paymentSubscription",
     "main": "index.js",
     "type": "module",

package/src/controllers/brandsBilling.controller.js

@@ -1944,7 +1944,11 @@ export async function billingSummary( req, res ) {
           csm: [ ...( csmByClient.get( key ) || [] ) ].join( ', ' ),
           revenueMonths: {},
           billedStoresMonths: {},
-          installationFee: 0,
+          // Installation fee per month (keyed YYYY-MM). The summary surfaces
+          // ONLY the current month's value — see installationOut below — so the
+          // column stays hidden until the current-month invoice is generated
+          // with an installation fee.
+          installationMonths: {},
           invDollar: 0,
           invInr: 0,
         } );
@@ -1956,7 +1960,8 @@ export async function billingSummary( req, res ) {
       const r = rowOf( inv._id.c );
       r.revenueMonths[inv._id.ym] = Math.round( ( ( inv.revenueInr || 0 ) + ( inv.revenueUsd || 0 ) * usdRate ) * 100 ) / 100;
       r.billedStoresMonths[inv._id.ym] = inv.stores || 0;
-      r.installationFee += ( inv.installationInr || 0 ) + ( inv.installationUsd || 0 ) * usdRate;
+      r.installationMonths[inv._id.ym] = ( r.installationMonths[inv._id.ym] || 0 ) +
+        ( inv.installationInr || 0 ) + ( inv.installationUsd || 0 ) * usdRate;
       r.invDollar += ( inv.dollarInvoices || 0 );
       r.invInr += ( inv.inrInvoices || 0 );
       if ( inv.companyName ) {
@@ -2074,7 +2079,11 @@ export async function billingSummary( req, res ) {
       // in native USD for dollar clients.
       revCur = revCur == null ? null : Math.round( revCur );
       const revPrevOut = revPrev == null ? null : Math.round( revPrev );
-      const installationOut = r.installationFee ? Math.round( r.installationFee ) : null;
+      // Show the installation fee ONLY for the current month, and only once
+      // that month's invoice (which carries the installationFee line) exists.
+      // Until then it's null so the UI hides the whole column.
+      const curInstallation = r.installationMonths[curKey] || 0;
+      const installationOut = curInstallation ? Math.round( curInstallation ) : null;
       // Registered Entity from the billings collection (distinct group names).
       // First name shown in the column; the full list is sent so the UI can
       // reveal the others on hover. Fall back to the invoice company name when

package/src/controllers/estimate.controller.js

@@ -7,7 +7,7 @@ import Handlebars from '../utils/validations/helper/handlebar.helper.js';
 import fs from 'fs';
 import path from 'path';
 import htmlpdf from 'html-pdf-node';
-import { symbolFor } from '../utils/currency.js';
+import { symbolFor, roundAmount } from '../utils/currency.js';
 import { getInvoiceCcEmails } from './invoice.controller.js';
 
 // Build the estimate PDF buffer + the template data + a safe filename. Shared
@@ -45,7 +45,9 @@ async function buildEstimatePdf( estimate ) {
     companyAddress: e.companyAddress || '',
     GSTNumber: e.GSTNumber || '',
     PlaceOfSupply: e.PlaceOfSupply || '',
-    groupName: e.groupName || '',
+    // "Default Group" is the placeholder used when no real billing group was
+    // chosen — don't surface it on the estimate (the template hides empty).
+    groupName: ( e.groupName && e.groupName !== 'Default Group' ) ? e.groupName : '',
     period: e.period || '',
     createdDate: e.createdDate ? dayjs( e.createdDate ).format( 'DD/MM/YYYY' ) : '',
     validTill: e.validTill ? dayjs( e.validTill ).format( 'DD/MM/YYYY' ) : '',
@@ -211,11 +213,13 @@ export async function createEstimate( req, res ) {
         { 'clientName': 1, 'paymentInvoice.currencyType': 1 },
     );
 
-    const amount = Math.round( Number( b.amount ) || 0 );
-    let totalAmount = Math.round( Number( b.totalAmount ) || 0 );
+    // INR rounds to whole; other currencies keep 2 decimals.
+    const estimateCurrency = b.currency || ( client?.paymentInvoice?.currencyType === 'dollar' ? 'dollar' : 'inr' );
+    const amount = roundAmount( Number( b.amount ) || 0, estimateCurrency );
+    let totalAmount = roundAmount( Number( b.totalAmount ) || 0, estimateCurrency );
     if ( !totalAmount && amount ) {
       // Default to 18% GST when caller sends only the pre-tax amount.
-      totalAmount = Math.round( amount * 1.18 );
+      totalAmount = roundAmount( amount * 1.18, estimateCurrency );
     }
 
     const { estimate, estimateIndex } = await nextEstimateNumber();
@@ -239,7 +243,7 @@ export async function createEstimate( req, res ) {
       tax: Array.isArray( b.tax ) ? b.tax : [],
       amount,
       totalAmount,
-      currency: b.currency || ( client?.paymentInvoice?.currencyType === 'dollar' ? 'dollar' : 'inr' ),
+      currency: estimateCurrency,
       status: b.status === 'sent' ? 'sent' : 'pending',
       createdDate,
       validTill,
@@ -273,10 +277,12 @@ export async function updateEstimate( req, res ) {
       return res.sendError( 'An accepted estimate cannot be edited.', 409 );
     }
 
-    const amount = Math.round( Number( b.amount ) || 0 );
-    let totalAmount = Math.round( Number( b.totalAmount ) || 0 );
+    // INR rounds to whole; other currencies keep 2 decimals.
+    const estimateCurrency = b.currency || existing.currency;
+    const amount = roundAmount( Number( b.amount ) || 0, estimateCurrency );
+    let totalAmount = roundAmount( Number( b.totalAmount ) || 0, estimateCurrency );
     if ( !totalAmount && amount ) {
-      totalAmount = Math.round( amount * 1.18 );
+      totalAmount = roundAmount( amount * 1.18, estimateCurrency );
     }
 
     // Only the editable fields are updated. The estimate number, index,
@@ -294,7 +300,7 @@ export async function updateEstimate( req, res ) {
       tax: Array.isArray( b.tax ) ? b.tax : existing.tax,
       amount,
       totalAmount,
-      currency: b.currency || existing.currency,
+      currency: estimateCurrency,
       notes: b.notes ?? existing.notes,
       updatedBy: req.user?.email || req.user?.userName || '',
     };

package/src/controllers/invoice.controller.js

@@ -13,7 +13,7 @@ import htmlpdf from 'html-pdf-node';
 import archiver from 'archiver';
 import * as basepricingService from '../services/basePrice.service.js';
 import * as paymentAccountService from '../services/paymentAccount.service.js';
-import { symbolFor } from '../utils/currency.js';
+import { symbolFor, roundAmount, wordFor } from '../utils/currency.js';
 import { invoiceStatusEnum } from '../dtos/validation.dtos.js';
 import { findOneApplicationDefault } from '../services/applicationDefault.service.js';
 import * as assignedStoreService from '../services/assignedStore.service.js';
@@ -162,13 +162,14 @@ export async function createInvoice( req, res ) {
       }
       // Recompute totals from the (possibly expanded) line items so a
       // multi-month advance invoice bills the full period.
+      const customCurrency = req.body.currency || 'inr';
       const customAmount = customAdvanceMonths > 1 ?
-        Math.round( customProducts.reduce( ( s, p ) => s + ( Number( p.amount ) || 0 ), 0 ) ) :
-        Math.round( Number( req.body.amount ) || 0 );
+        roundAmount( customProducts.reduce( ( s, p ) => s + ( Number( p.amount ) || 0 ), 0 ), customCurrency ) :
+        roundAmount( Number( req.body.amount ) || 0, customCurrency );
       const customTotal = customAdvanceMonths > 1 ?
-        Math.round( customProducts.reduce( ( s, p ) => s + ( Number( p.amount ) || 0 ), 0 ) +
-          ( Array.isArray( req.body.tax ) ? req.body.tax.reduce( ( s, t ) => s + ( Number( t.taxAmount ) || 0 ) * customAdvanceMonths, 0 ) : 0 ) ) :
-        Math.round( Number( req.body.totalAmount ) || 0 );
+        roundAmount( customProducts.reduce( ( s, p ) => s + ( Number( p.amount ) || 0 ), 0 ) +
+          ( Array.isArray( req.body.tax ) ? req.body.tax.reduce( ( s, t ) => s + ( Number( t.taxAmount ) || 0 ) * customAdvanceMonths, 0 ) : 0 ), customCurrency ) :
+        roundAmount( Number( req.body.totalAmount ) || 0, customCurrency );
 
       const data = {
         invoice: `${invPrefix}${Finacialyear}-${invoiceNo}`,
@@ -396,7 +397,7 @@ export async function createInvoice( req, res ) {
               productName: 'oneTimeFee',
               period: 'fullmonth',
               storeCount: newStoreCount,
-              amount: Math.round( newStoreCount * oneTimeFeePerStore * 100 ) / 100,
+              amount: roundAmount( newStoreCount * oneTimeFeePerStore, group.currency ),
               price: oneTimeFeePerStore,
               description: `One-Time Fee - ${newStoreCount} stores`,
               HsnNumber: '998314',
@@ -417,21 +418,21 @@ export async function createInvoice( req, res ) {
       // existing GST/IGST/CGST/SGST behavior for legacy records that have
       // no taxCalculationType set yet.
       if ( group.taxCalculationType === 'international' ) {
-        totalAmount = Math.round( amount );
+        totalAmount = roundAmount( amount, group.currency );
       } else if ( group.gst && group.gst.slice( 0, 2 ) == '33' ) {
         let taxAmount = ( amount * 18 ) / 100;
-        totalAmount = Math.round( amount + taxAmount );
+        totalAmount = roundAmount( amount + taxAmount, group.currency );
         taxList.push(
             {
               'currency': '₹',
               'type': 'CGST',
               'value': 9,
-              'taxAmount': ( ( amount * 9 ) / 100 ).toFixed( 2 ),
+              'taxAmount': String( roundAmount( ( amount * 9 ) / 100, group.currency ) ),
             }, {
               'currency': '₹',
               'type': 'SGST',
               'value': 9,
-              'taxAmount': ( ( amount * 9 ) / 100 ).toFixed( 2 ),
+              'taxAmount': String( roundAmount( ( amount * 9 ) / 100, group.currency ) ),
             },
         );
       } else {
@@ -439,13 +440,13 @@ export async function createInvoice( req, res ) {
         if ( group.currency === 'inr' ) {
           taxAmount = ( amount * 18 ) / 100;
         }
-        totalAmount = Math.round( amount + taxAmount );
+        totalAmount = roundAmount( amount + taxAmount, group.currency );
         taxList.push(
             {
               'currency': '₹',
               'type': 'IGST',
               'value': 18,
-              'taxAmount': ( taxAmount ).toFixed( 2 ),
+              'taxAmount': String( roundAmount( taxAmount, group.currency ) ),
             },
         );
       }
@@ -528,14 +529,14 @@ export async function createInvoice( req, res ) {
         invoice: req.body.invoiceId ? req.body.invoiceId : `${invPrefix}${Finacialyear}-${invoiceNo}`,
         products: products,
         status: 'pendingCsm',
-        amount: Math.round( amount ),
+        amount: roundAmount( amount, group.currency ),
         invoiceIndex: req.body.invoiceId ? findInvoice.invoiceIndex : invoiceNo,
         tax: taxList,
         companyName: ( group.registeredCompanyName || '' ).toUpperCase(),
         companyAddress: address,
         PlaceOfSupply: group.placeOfSupply,
         GSTNumber: group.gst,
-        totalAmount: Math.round( totalAmount ),
+        totalAmount: roundAmount( totalAmount, group.currency ),
         clientId: group.clientId,
         paymentMethod: 'Online',
         billingDate: new Date( invoicedate ),
@@ -751,8 +752,8 @@ async function buildAnnexureRows( invoiceInfo, getgroup ) {
     // store's position within the product.
     const price = priceForStore( s.productName, productPosition[s.productName] );
     const runningCost = s.workingdays >= monthDays ?
-      Math.round( price * units * 100 ) / 100 :
-      Math.round( ( price / monthDays ) * s.workingdays * units * 100 ) / 100;
+      roundAmount( price * units, invoiceInfo.currency ) :
+      roundAmount( ( price / monthDays ) * s.workingdays * units, invoiceInfo.currency );
     return {
       productName: s.productName ? s.productName.charAt( 0 ).toUpperCase() + s.productName.slice( 1 ) : '',
       currencyType: invoiceCurrency,
@@ -770,8 +771,9 @@ async function buildAnnexureRows( invoiceInfo, getgroup ) {
     };
   } );
 
-  const totalAmount = Math.round( data.reduce( ( a, x ) => a + ( x.runningCost || 0 ), 0 ) * 100 ) / 100;
-  const totalFormatted = totalAmount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } );
+  const totalAmount = roundAmount( data.reduce( ( a, x ) => a + ( x.runningCost || 0 ), 0 ), invoiceInfo.currency );
+  const fractionDigits = invoiceInfo.currency === 'inr' ? 0 : 2;
+  const totalFormatted = totalAmount.toLocaleString( 'en-IN', { minimumFractionDigits: fractionDigits, maximumFractionDigits: fractionDigits } );
   return { data, totalAmount, totalFormatted };
 }
 
@@ -786,21 +788,24 @@ export async function invoiceDownload( req, res ) {
       // client.paymentInvoice or virtualAccount.currency causes historical
       // invoices to re-render in the wrong currency if those settings change.
       const invoiceCurrency = symbolFor( invoiceInfo.currency );
+      // INR shows whole numbers; every other currency keeps 2 decimals.
+      const fractionDigits = invoiceInfo.currency === 'inr' ? 0 : 2;
+      const moneyFmt = { minimumFractionDigits: fractionDigits, maximumFractionDigits: fractionDigits };
       invoiceInfo.products.forEach( ( item, index ) => {
         item.index = index + 1;
         let [ firstWord, secondWord ] = item.productName.replace( /([a-z])([A-Z])/g, '$1 $2' ).split( ' ' );
         firstWord = firstWord.charAt( 0 ).toUpperCase() + firstWord.slice( 1 );
         item.productName = firstWord + ' ' + secondWord;
-        item.price = item.price .toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } );
-        item.amount = item.amount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } );
+        item.price = roundAmount( item.price, invoiceInfo.currency ).toLocaleString( 'en-IN', moneyFmt );
+        item.amount = roundAmount( item.amount, invoiceInfo.currency ).toLocaleString( 'en-IN', moneyFmt );
         item.currency = invoiceCurrency;
       } );
 
 
       let invoiceDate = dayjs( invoiceInfo.billingDate ).format( 'DD/MM/YYYY' );
 
-      invoiceInfo.totalAmount = Math.round( invoiceInfo.totalAmount );
-      let AmountinWords = inWords( invoiceInfo.totalAmount );
+      invoiceInfo.totalAmount = roundAmount( invoiceInfo.totalAmount, invoiceInfo.currency );
+      let AmountinWords = amountToWords( invoiceInfo.totalAmount, invoiceInfo.currency );
       let getgroup;
       let days = getgroup?.paymentTerm ? getgroup?.paymentTerm : '30';
       let dueDate = invoiceInfo?.dueDate ? dayjs( invoiceInfo?.dueDate ).format( 'DD/MM/YYYY' ) : dayjs().add( days, 'days' ).format( 'DD/MM/YYYY' );
@@ -814,10 +819,10 @@ export async function invoiceDownload( req, res ) {
       invoiceData = {
         ...invoiceInfo._doc,
         clientName: clientDetails.clientName,
-        amount: invoiceInfo.amount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } ),
+        amount: roundAmount( invoiceInfo.amount, invoiceInfo.currency ).toLocaleString( 'en-IN', moneyFmt ),
         extendDays: getgroup?.paymentTerm ? getgroup?.paymentTerm : '30',
         address: clientDetails.billingDetails.billingAddress,
-        subtotal: invoiceInfo.amount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } ),
+        subtotal: roundAmount( invoiceInfo.amount, invoiceInfo.currency ).toLocaleString( 'en-IN', moneyFmt ),
         companyName: invoiceInfo.companyName,
         companyAddress: invoiceInfo.companyAddress,
         PlaceOfSupply: invoiceInfo.PlaceOfSupply,
@@ -826,7 +831,8 @@ export async function invoiceDownload( req, res ) {
         amountwords: AmountinWords,
         Terms: `Term ${getgroup?.paymentTerm ? getgroup?.paymentTerm : '30'}`,
         currencyType: invoiceCurrency,
-        totalAmount: invoiceInfo.totalAmount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } ),
+        currencyWord: wordFor( invoiceInfo.currency ),
+        totalAmount: invoiceInfo.totalAmount.toLocaleString( 'en-IN', moneyFmt ),
         invoiceDate,
         dueDate,
         discountPercentage: invoiceInfo.discountPercentage ? invoiceInfo.discountPercentage : 0,
@@ -985,19 +991,22 @@ async function buildInvoicePdfBuffer( invoiceId ) {
   // field, recorded at creation from the billing group. See invoiceDownload
   // above for the same pattern.
   const invoiceCurrency = symbolFor( invoiceInfo.currency );
+  // INR shows whole numbers; every other currency keeps 2 decimals.
+  const fractionDigits = invoiceInfo.currency === 'inr' ? 0 : 2;
+  const moneyFmt = { minimumFractionDigits: fractionDigits, maximumFractionDigits: fractionDigits };
   invoiceInfo.products.forEach( ( item, index ) => {
     item.index = index + 1;
     let [ firstWord, secondWord ] = item.productName.replace( /([a-z])([A-Z])/g, '$1 $2' ).split( ' ' );
     firstWord = firstWord.charAt( 0 ).toUpperCase() + firstWord.slice( 1 );
     item.productName = firstWord + ' ' + secondWord;
-    item.price = Math.round( item.price ).toLocaleString( 'en-IN' );
-    item.amount = item.amount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } );
+    item.price = roundAmount( item.price, invoiceInfo.currency ).toLocaleString( 'en-IN', moneyFmt );
+    item.amount = roundAmount( item.amount, invoiceInfo.currency ).toLocaleString( 'en-IN', moneyFmt );
     item.currency = invoiceCurrency;
   } );
 
   let invoiceDate = dayjs( invoiceInfo.billingDate ).format( 'DD/MM/YYYY' );
-  invoiceInfo.totalAmount = Math.round( invoiceInfo.totalAmount );
-  let AmountinWords = inWords( invoiceInfo.totalAmount );
+  invoiceInfo.totalAmount = roundAmount( invoiceInfo.totalAmount, invoiceInfo.currency );
+  let AmountinWords = amountToWords( invoiceInfo.totalAmount, invoiceInfo.currency );
   let getgroup;
   if ( invoiceInfo.groupId ) {
     getgroup = await billingService.findOne( { _id: invoiceInfo.groupId } );
@@ -1010,10 +1019,10 @@ async function buildInvoicePdfBuffer( invoiceId ) {
   let invoiceData = {
     ...invoiceInfo._doc,
     clientName: clientDetails.clientName,
-    amount: invoiceInfo.amount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } ),
+    amount: roundAmount( invoiceInfo.amount, invoiceInfo.currency ).toLocaleString( 'en-IN', moneyFmt ),
     extendDays: getgroup?.paymentTerm ? getgroup?.paymentTerm : '30',
     address: clientDetails.billingDetails.billingAddress,
-    subtotal: invoiceInfo.amount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } ),
+    subtotal: roundAmount( invoiceInfo.amount, invoiceInfo.currency ).toLocaleString( 'en-IN', moneyFmt ),
     companyName: invoiceInfo.companyName,
     companyAddress: invoiceInfo.companyAddress,
     PlaceOfSupply: invoiceInfo.PlaceOfSupply,
@@ -1022,7 +1031,8 @@ async function buildInvoicePdfBuffer( invoiceId ) {
     amountwords: AmountinWords,
     Terms: `Term ${getgroup?.paymentTerm ? getgroup?.paymentTerm : '30'}`,
     currencyType: invoiceCurrency,
-    totalAmount: invoiceInfo.totalAmount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } ),
+    currencyWord: wordFor( invoiceInfo.currency ),
+    totalAmount: invoiceInfo.totalAmount.toLocaleString( 'en-IN', moneyFmt ),
     invoiceDate,
     dueDate,
     discountPercentage: invoiceInfo.discountPercentage ? invoiceInfo.discountPercentage : 0,
@@ -1208,6 +1218,32 @@ function inWords( num ) {
   return str.toLowerCase().split( ' ' ).map( ( word ) => word.charAt( 0 ).toUpperCase() + word.slice( 1 ) ).join( ' ' );
 }
 
+// Sub-unit (fraction) name per currency for the "Total In Words" cents part.
+// INR is whole-number only, so it has no fraction.
+const CURRENCY_FRACTION_WORDS = {
+  dollar: 'Cents',
+  singaporedollar: 'Cents',
+  euro: 'Cents',
+  aed: 'Fils',
+};
+
+// Spell out an amount. INR -> whole number only. Other currencies keep 2
+// decimals, so the cents are spelled out too when non-zero
+// (e.g. 3191.10 -> "Three Thousand One Hundred And Ninety One and Ten Cents").
+function amountToWords( value, currency ) {
+  const n = Number( value ) || 0;
+  if ( currency === 'inr' ) {
+    return inWords( Math.round( n ) );
+  }
+  const whole = Math.trunc( n );
+  const cents = Math.round( ( n - whole ) * 100 );
+  const fraction = CURRENCY_FRACTION_WORDS[currency] || 'Cents';
+  if ( cents > 0 ) {
+    return `${inWords( whole )} and ${inWords( cents )} ${fraction}`;
+  }
+  return inWords( whole );
+}
+
 
 // Resolve which basepricing doc applies to a billing group. When the client
 // has billingGroupWisePricing enabled AND a doc exists for this group, returns
@@ -1638,7 +1674,7 @@ async function standardPrice( group, getClient, baseDate ) {
       if ( store.workingDays >= currentMonthDays ) {
         amount = store.price * storeCount;
       } else {
-        amount = Math.round( ( store.price / currentMonthDays ) * store.workingDays * storeCount * 100 ) / 100;
+        amount = roundAmount( ( store.price / currentMonthDays ) * store.workingDays * storeCount, group.currency );
       }
 
       let description = store.productName === 'tangoZone' ? 'Product category/section analytics' : 'Customer Footfall Analytics';
@@ -1837,7 +1873,7 @@ async function stepPrice( group, getClient ) {
       if ( store.workingDays >= currentMonthDays ) {
         amount = price * storeCount;
       } else {
-        amount = Math.round( ( price / currentMonthDays ) * store.workingDays * storeCount * 100 ) / 100;
+        amount = roundAmount( ( price / currentMonthDays ) * store.workingDays * storeCount, group.currency );
       }
 
       let description = store.productName === 'tangoZone' ? 'Product category/section analytics' : 'Customer Footfall Analytics';
@@ -1913,8 +1949,8 @@ async function stepPrice( group, getClient ) {
     const price = tierPriceForPosition( s.productName, productPosition[s.productName] );
     const fullMonth = s.workingDays >= currentMonthDays;
     const amount = fullMonth ?
-      Math.round( units * price * 100 ) / 100 :
-      Math.round( ( units * ( price / currentMonthDays ) * s.workingDays ) * 100 ) / 100;
+      roundAmount( units * price, group.currency ) :
+      roundAmount( units * ( price / currentMonthDays ) * s.workingDays, group.currency );
     const period = fullMonth ? 'fullMonth' : 'proRate';
     const key = `${s.productName}_${period}_${price}`;
     if ( !grouped[key] ) {
@@ -1931,7 +1967,8 @@ async function stepPrice( group, getClient ) {
     } else if ( grp.productName === 'tangoZone' ) {
       description = 'Product category/section analytics';
     }
-    const amount = Math.round( grp.totalAmount * 100 ) / 100;
+    const amount = roundAmount( grp.totalAmount, group.currency );
+    const zeroPrice = group.currency === 'inr' ? '0' : '0.00';
     return {
       productName: grp.productName,
       period: grp.period,
@@ -1943,7 +1980,7 @@ async function stepPrice( group, getClient ) {
       HsnNumber: '998314',
       amount: amount,
       month: dayjs().format( 'MMM YYYY' ),
-      price: grp.unitCount ? ( amount / grp.unitCount ).toFixed( 2 ) : '0.00',
+      price: grp.unitCount ? String( roundAmount( amount / grp.unitCount, group.currency ) ) : zeroPrice,
     };
   } );
 
@@ -2229,9 +2266,11 @@ export async function clientInvoiceList( req, res ) {
         cards.pendingPaymentCount += 1;
       }
     }
-    cards.outstandingAmount = Math.round( cards.outstandingAmount * 100 ) / 100;
-    cards.overdueAmount = Math.round( cards.overdueAmount * 100 ) / 100;
-    cards.pendingPaymentAmount = Math.round( cards.pendingPaymentAmount * 100 ) / 100;
+    // These card totals are normalised to INR (dollar invoices are multiplied
+    // by usdRate above), so they follow the INR rule: whole numbers.
+    cards.outstandingAmount = roundAmount( cards.outstandingAmount, 'inr' );
+    cards.overdueAmount = roundAmount( cards.overdueAmount, 'inr' );
+    cards.pendingPaymentAmount = roundAmount( cards.pendingPaymentAmount, 'inr' );
 
     res.sendSuccess( { count: count.length, data: invoiceList, cards } );
   } catch ( error ) {
@@ -2363,14 +2402,14 @@ export async function applyDiscount( req, res ) {
   try {
     let invoice = await invoiceService.findOne( { invoice: req.body.invoice } );
     if ( invoice ) {
-      invoice.discountAmount = ( ( invoice.amount * req.body.discount ) / 100 ).toFixed( 2 );
-      invoice.amount = invoice.amount - invoice.discountAmount;
+      invoice.discountAmount = roundAmount( ( invoice.amount * req.body.discount ) / 100, invoice.currency );
+      invoice.amount = roundAmount( invoice.amount - invoice.discountAmount, invoice.currency );
       invoice.discountPercentage = req.body.discount;
       if ( invoice.currency === 'inr' ) {
         if ( invoice.tax.length ) {
           for ( let i = 0; i < invoice.tax.length; i++ ) {
-            invoice.tax[i].taxAmount = ( ( invoice.amount * invoice.tax[i].value ) / 100 ).toFixed( 2 );
-            invoice.totalAmount = ( Number( invoice.amount ) + Number( invoice.tax[i].taxAmount ) ).toFixed( 2 );
+            invoice.tax[i].taxAmount = String( roundAmount( ( invoice.amount * invoice.tax[i].value ) / 100, invoice.currency ) );
+            invoice.totalAmount = roundAmount( Number( invoice.amount ) + Number( invoice.tax[i].taxAmount ), invoice.currency );
           }
         }
       }
@@ -2500,7 +2539,7 @@ export async function recordPayment( req, res ) {
     }
 
     const previousPaid = Number( invoice.paidAmount ) || 0;
-    const newPaid = Math.round( ( previousPaid + amountNum ) * 100 ) / 100;
+    const newPaid = roundAmount( previousPaid + amountNum, invoice.currency );
     const totalAmount = Number( invoice.totalAmount ) || 0;
 
     // Reject overpayment — finance teams want this caught early. They can
@@ -2508,7 +2547,7 @@ export async function recordPayment( req, res ) {
     // invoice total; anything beyond that is a data-entry error.
     if ( totalAmount > 0 && newPaid > totalAmount + 0.01 ) {
       return res.sendError(
-          `Payment exceeds outstanding balance. Outstanding: ${( totalAmount - previousPaid ).toFixed( 2 )}`,
+          `Payment exceeds outstanding balance. Outstanding: ${roundAmount( totalAmount - previousPaid, invoice.currency )}`,
           400,
       );
     }

package/src/controllers/paymentSubscription.controllers.js

@@ -13,11 +13,13 @@ import * as cameraService from '../services/camera.service.js';
 import * as billingService from '../services/billing.service.js';
 import * as paymentAccountService from '../services/paymentAccount.service.js';
 import * as taggingService from '../services/tagging.service.js';
-import { symbolFor } from '../utils/currency.js';
+import { symbolFor, roundAmount, wordFor } from '../utils/currency.js';
 
 
 import dayjs from 'dayjs';
-import Handlebars from 'handlebars';
+// Use the shared Handlebars instance that has our custom helpers
+// (ifExists / neq / gtZero) registered, so invoicePdf1.hbs can use them.
+import Handlebars from '../utils/validations/helper/handlebar.helper.js';
 import fs from 'fs';
 import path from 'path';
 // import { JSDOM } from 'jsdom';
@@ -3092,6 +3094,10 @@ export const invoiceDownload = async ( req, res ) => {
     if ( invoiceInfo ) {
       let clientDetails = await paymentService.findOne( { clientId: invoiceInfo.clientId } );
       let amount = 0;
+      // INR shows whole numbers; every other currency keeps 2 decimals.
+      const invoicePdfCurrency = clientDetails?.paymentInvoice?.currencyType;
+      const invoicePdfFractionDigits = invoicePdfCurrency === 'inr' ? 0 : 2;
+      const invoicePdfMoneyFmt = { minimumFractionDigits: invoicePdfFractionDigits, maximumFractionDigits: invoicePdfFractionDigits };
       invoiceInfo.products.forEach( ( item, index ) => {
         let [ firstWord, secondWord ] = item.product.product.replace( /([a-z])([A-Z])/g, '$1 $2' ).split( ' ' );
         firstWord = firstWord.charAt( 0 ).toUpperCase() + firstWord.slice( 1 );
@@ -3107,25 +3113,25 @@ export const invoiceDownload = async ( req, res ) => {
 
         amount = amount + item.price;
 
-        item.basePrice = Math.round( item.basePrice ).toLocaleString( 'en-IN' );
-        item.price = Math.round( item.price ).toLocaleString( 'en-IN' );
+        item.basePrice = roundAmount( item.basePrice, invoicePdfCurrency ).toLocaleString( 'en-IN', invoicePdfMoneyFmt );
+        item.price = roundAmount( item.price, invoicePdfCurrency ).toLocaleString( 'en-IN', invoicePdfMoneyFmt );
         item.currency = symbolFor( clientDetails?.paymentInvoice?.currencyType );
       } );
       for ( let tax of invoiceInfo.tax ) {
-        tax.taxAmount = tax.taxAmount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } );
+        tax.taxAmount = roundAmount( tax.taxAmount, invoicePdfCurrency ).toLocaleString( 'en-IN', invoicePdfMoneyFmt );
       }
       let invoiceDate = dayjs( invoiceInfo.createdAt ).format( 'DD/MM/YYYY' );
       let days = clientDetails?.paymentInvoice?.extendPaymentPeriodDays || 10;
       let dueDate = invoiceInfo?.dueDate ? dayjs( invoiceInfo?.dueDate ).format( 'DD/MM/YYYY' ) : dayjs().add( days, 'days' ).format( 'DD/MM/YYYY' );
 
       invoiceInfo.totalAmount = invoiceInfo.totalAmount;
-      let AmountinWords = inWords( invoiceInfo.totalAmount );
+      let AmountinWords = amountToWords( invoiceInfo.totalAmount, invoicePdfCurrency );
       invoiceData = {
         ...invoiceInfo._doc,
         clientName: clientDetails.clientName,
         extendDays: clientDetails.paymentInvoice.extendPaymentPeriodDays,
         address: clientDetails.billingDetails.billingAddress,
-        subtotal: amount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } ),
+        subtotal: roundAmount( amount, invoicePdfCurrency ).toLocaleString( 'en-IN', invoicePdfMoneyFmt ),
         companyName: invoiceInfo.companyName,
         companyAddress: invoiceInfo.companyAddress,
         PlaceOfSupply: invoiceInfo.PlaceOfSupply,
@@ -3134,7 +3140,8 @@ export const invoiceDownload = async ( req, res ) => {
         amountwords: AmountinWords,
         Terms: `Term ${clientDetails.paymentInvoice.extendPaymentPeriodDays}`,
         currencyType: symbolFor( clientDetails?.paymentInvoice?.currencyType ),
-        totalAmount: invoiceInfo.totalAmount.toLocaleString( 'en-IN', { minimumFractionDigits: 2, maximumFractionDigits: 2 } ),
+        currencyName: wordFor( invoicePdfCurrency ),
+        totalAmount: roundAmount( invoiceInfo.totalAmount, invoicePdfCurrency ).toLocaleString( 'en-IN', invoicePdfMoneyFmt ),
         invoiceDate,
         dueDate,
       };
@@ -3247,6 +3254,31 @@ function inWords( num ) {
   return str.toLowerCase().split( ' ' ).map( ( word ) => word.charAt( 0 ).toUpperCase() + word.slice( 1 ) ).join( ' ' );
 }
 
+// Sub-unit (fraction) name per currency for the "Total In Words" cents part.
+const CURRENCY_FRACTION_WORDS = {
+  dollar: 'Cents',
+  singaporedollar: 'Cents',
+  euro: 'Cents',
+  aed: 'Fils',
+};
+
+// Spell out an amount. INR -> whole number only. Other currencies keep 2
+// decimals, so the cents are spelled out too when non-zero
+// (e.g. 383.04 -> "Three Hundred And Eighty Three and Four Cents").
+function amountToWords( value, currency ) {
+  const n = Number( value ) || 0;
+  if ( currency === 'inr' ) {
+    return inWords( Math.round( n ) );
+  }
+  const whole = Math.trunc( n );
+  const cents = Math.round( ( n - whole ) * 100 );
+  const fraction = CURRENCY_FRACTION_WORDS[currency] || 'Cents';
+  if ( cents > 0 ) {
+    return `${inWords( whole )} and ${inWords( cents )} ${fraction}`;
+  }
+  return inWords( whole );
+}
+
 export const updateInvoiceStatus = async ( req, res ) => {
   try {
     if ( !req.params?.invoiceId ) {

package/src/hbs/estimatePdf.hbs

@@ -1423,7 +1423,6 @@
                         </div>
                     </div>
                     <div class="_1234"># {{estimate}}</div>
-                    <div><span class="pill pill-{{status}}">{{statusLabel}}</span></div>
 
                 </div>
 

package/src/hbs/invoicePdf.hbs

@@ -881,6 +881,10 @@
             align-self: stretch;
             flex-shrink: 0;
             position: relative;
+            /* Keep the whole totals block (Sub Total ... Total In Words) on a
+               single page so the amount-in-words can't be split across pages. */
+            break-inside: avoid;
+            page-break-inside: avoid;
         }
 
         .frame-2394 {
@@ -1011,6 +1015,8 @@
             justify-content: flex-start;
             flex-shrink: 0;
             position: relative;
+            break-inside: avoid;
+            page-break-inside: avoid;
         }
 
         .text13 {
@@ -1401,12 +1407,14 @@
                         <div class="chennai-tamil-nadu-600006-india">
 
                         </div>
-                        <div class="gstin-33-aagct-3124-r-1-z-2">GSTIN {{GSTNumber}}</div>
+                        {{#ifExists GSTNumber}}<div class="gstin-33-aagct-3124-r-1-z-2">GSTIN {{GSTNumber}}</div>{{/ifExists}}
                     </div>
                 </div>
+                {{#ifExists PlaceOfSupply}}
                 <div class="place_of_supply">
                     Place Of Supply: {{PlaceOfSupply}}
                 </div>
+                {{/ifExists}}
             </div>
             <div class="frame-2698">
                 <div class="frame-9155">
@@ -1560,7 +1568,7 @@
                 <div class="frame-23972">
                     {{#neq discountAmount 0}}
                     <div class="frame-2394">
-                        <div class="text9">Discount ({{discountPercentage}}%)</div>
+                        <div class="text9">Discount</div>
                         <div class="frame-9157">
                             <div class="text10">{{currencyType}} {{discountAmount}}</div>
                         </div>
@@ -1575,12 +1583,14 @@
 
                     {{#if gstApplicable}}
                     {{#each tax }}
+                    {{#gtZero taxAmount}}
                     <div class="frame-2392">
                         <div class="text9">{{type}} ({{value}}%)</div>
                         <div class="frame-9157">
                             <div class="text10">{{../currencyType}} {{taxAmount}}</div>
                         </div>
                     </div>
+                    {{/gtZero}}
                     {{/each }}
                     {{/if}}
 
@@ -1605,22 +1615,7 @@
                         <div class="text11">Total In Words</div>
                         <div class="frame-9157">
                             <div class="text13">
-                                {{#eq billingCurrency 'inr'}}
-                                Indian Rupee
-                                {{/eq}}
-
-                                {{#eq billingCurrency 'dollar'}}
-                                US Dollar
-                                {{/eq}}
-
-                                {{#eq billingCurrency 'singaporedollar'}}
-                                Singapore Dollar
-                                {{/eq}}
-
-                                {{#eq billingCurrency 'euro'}}
-                                Euro
-                                {{/eq}}
-                                {{amountwords}} Only
+                                {{currencyWord}} {{amountwords}} Only
                             </div>
                         </div>
                     </div>

package/src/hbs/invoicePdf1.hbs

@@ -844,6 +844,10 @@
             align-self: stretch;
             flex-shrink: 0;
             position: relative;
+            /* Keep the whole totals block (Sub Total ... Total In Words) on a
+               single page so the amount-in-words can't be split across pages. */
+            break-inside: avoid;
+            page-break-inside: avoid;
         }
 
         .frame-2394 {
@@ -974,6 +978,8 @@
             justify-content: flex-start;
             flex-shrink: 0;
             position: relative;
+            break-inside: avoid;
+            page-break-inside: avoid;
         }
 
         .text13 {
@@ -1368,16 +1374,20 @@
                                 class="billing-address-given-by-the-client-flat-no-012-ground-floor-the-banyan-apartment-jsr-layout-j-p-nagar-9th-phase-alahalli-anjanapura-post-bengaluru-560062-karnataka-india">
                                 {{companyAddress}}
                             </div>
+                            {{#ifExists GSTNumber}}
                             <div class="frame-562">
                               <div class="gstin-33-aafci-2595-g-1-z-9"> GSTIN {{GSTNumber}}</div>
                             </div>
+                            {{/ifExists}}
                         </div>
                     </div>
                 </div>
             </div>
+            {{#ifExists PlaceOfSupply}}
             <div class="place-of-supply-tamil-nadu-33">
                 Place Of Supply: {{PlaceOfSupply}}
             </div>
+            {{/ifExists}}
         </div>
         <div class="invoice-info">
             <div class="card-header">
@@ -1496,12 +1506,14 @@
                         </div>
                     </div>
                     {{#each tax }}
+                    {{#gtZero taxAmount}}
                     <div class="frame-2392">
                         <div class="text9">{{type}} ({{value}}%)</div>
                         <div class="frame-9157">
                             <div class="text10">{{currency}} {{taxAmount}}</div>
                         </div>
                     </div>
+                    {{/gtZero}}
                     {{/each }}
                     <!-- <div class="frame-2398">
                 <div class="text9">CGST (9%)</div>

package/src/utils/currency.js

@@ -13,3 +13,36 @@ export const CURRENCY_SYMBOLS = {
 };
 
 export const symbolFor = ( currency ) => CURRENCY_SYMBOLS[currency] ?? '$';
+
+/**
+ * Words form of each currency, used in the invoice "Total In Words" line.
+ * Keys match billing.currency enums. Unknown keys fall back to 'US Dollar'
+ * to match the pre-existing default.
+ */
+export const CURRENCY_WORDS = {
+  inr: 'Indian Rupee',
+  dollar: 'US Dollar',
+  singaporedollar: 'Singapore Dollar',
+  euro: 'Euro',
+  aed: 'UAE Dirham',
+};
+
+export const wordFor = ( currency ) => CURRENCY_WORDS[currency] ?? 'US Dollar';
+
+/**
+ * Currency-aware monetary rounding.
+ *  - INR  -> rounded to a whole number (no decimals).
+ *  - every other currency -> kept to exactly 2 decimal places.
+ * Returns a Number (not a string) so downstream arithmetic still works.
+ * Non-finite input is normalised to 0.
+ *
+ * @param {number|string} value - the monetary value to round.
+ * @param {string} currency - the currency code (e.g. 'inr', 'dollar').
+ * @return {number} the rounded amount.
+ */
+export const roundAmount = ( value, currency ) => {
+  const n = Number( value );
+  if ( !isFinite( n ) ) return 0;
+  if ( currency === 'inr' ) return Math.round( n );
+  return Math.round( n * 100 ) / 100;
+};

package/src/utils/validations/helper/handlebar.helper.js

@@ -13,5 +13,11 @@ Handlebars.registerHelper( 'gte', function( a, b, options ) {
 Handlebars.registerHelper( 'ifExists', function( value, options ) {
   return value ? options.fn( this ) : options.inverse( this );
 } );
+// Renders the block only when `value` parses to a number greater than zero.
+// Used to hide tax lines (IGST/CGST/SGST) whose amount is 0 / "0" / "0.00".
+Handlebars.registerHelper( 'gtZero', function( value, options ) {
+  const n = Number( String( value ).replace( /,/g, '' ) );
+  return isFinite( n ) && n > 0 ? options.fn( this ) : options.inverse( this );
+} );
 
 export default Handlebars;