tango-app-api-payment-subscription 3.5.27 → 3.5.29

package/docs/superpowers/specs/2026-07-09-quarterly-invoices-449-design.md

@@ -0,0 +1,108 @@
+# Quarterly Invoice Creation Script — clientId 449 (Apr/May/Jun 2025)
+
+**Date:** 2026-07-09
+**File to create:** `scripts/create-quarterly-invoices-449.js`
+
+## Goal
+
+Create **3 invoices** for clientId `449`, one per billing group, each covering the
+**Apr–Jun 2025 quarter (FY 25-26)** as three per-month line-item blocks. This is a
+one-off backfill of quarterly billing.
+
+Target groups (all confirmed to exist on clientId 449, all INR, all GST prefix `33`):
+
+| Group name                    | _id                        | GST             | stores |
+|-------------------------------|----------------------------|-----------------|--------|
+| LILLE BY CHALLANI             | `6a4f37925d8071b6ae34d1a2` | 33AALCC7452J1ZF | 6      |
+| FEDHA JEWELS PRIVATE LIMITED  | `6a4f37298b8646bec2a1f630` | 33AAFCF8793V1ZL | 7      |
+| CHALLANI JEWELLERY MART       | `6a4f32644cde0c2869be2e52` | 33AAIFC5600Q1ZC | 2      |
+
+Client 449: `priceType: standard`, `status: active`.
+
+## Invoice series & shape
+
+- **Series: `INV-`** (normal series), NOT TINV-. Number format `INV-25-26-NNNNN`,
+  continuing the highest `invoiceIndex` for `^INV-25-26-` (matches controller logic).
+- `advanceInvoice: false`, `advancePeriod` omitted.
+- **One invoice document per group** whose `products` array contains three month-blocks
+  (Apr 2025, May 2025, Jun 2025), each line tagged `month: 'MMM YYYY'`.
+- `advanceMonths: 3` recorded for reference (bundled quarter), but the invoice is a normal
+  INV- invoice — the quarterly nature lives in the line items, not the advance flag.
+- No `storeDetails` block (that is TINV-only in the controller).
+
+## Pricing — actual per-month snapshots, prorated
+
+Client 449 is `priceType: standard`, so we replicate the **standard-price** path from
+`createInvoice` → `standardPrice()`. For each group, for each of Apr/May/Jun 2025:
+
+1. **Snapshot selection:** pick the latest daily-pricing doc with
+   `dateISO <= end-of-month`, sorted `dateISO: -1`, `limit 1` — the actual snapshot for
+   that month (differs from the controller, which always takes the newest snapshot).
+2. **Days basis:** `daysInMonth` of that month (Apr=30, May=31, Jun=30).
+3. **Basepricing doc:** resolved via the same rule as `resolveBasePricingScope` —
+   group-wise doc when `client.billingGroupWisePricing` is on AND a group doc exists,
+   else the brand-level doc (`groupId` unset). Read `negotiatePrice` from `standard[]`.
+4. **overallStore products:** filter to `group.stores`, keep `workingdays > 0`, group by
+   (product, workingdays), sum store counts. Prorate:
+   `workingdays >= daysInMonth` → `price * count` (full month);
+   else `(price / daysInMonth) * workingdays * count`. `proRata: 'flat'` on the group
+   forces full-month working days.
+5. **billingType** perZone / perCamera for `tangoZone` / `tangoTraffic`: multiply by zone
+   / camera counts exactly as the controller does.
+6. **billingMethod `eachStore`** products: emit one line per store (per-store proration),
+   as in the controller.
+7. Tag every produced line with `month: 'MMM YYYY'` for that month.
+
+The three months' line arrays are concatenated into the single `products` array.
+
+**Empty-month handling:** if a month has no snapshot `<=` its end, or the group has no
+running stores that month, that month contributes zero lines. The script logs this
+**loudly** (WARN per group/month) so a short invoice is never produced silently.
+
+## Invoice document fields (mirrors controller `data`)
+
+- `invoice: INV-25-26-NNNNN`, `invoiceIndex`
+- `groupId`, `groupName`, `clientId: '449'`
+- `companyName` = uppercased `registeredCompanyName`; `companyAddress` built from group
+  address fields (`addressLineOne+addressLineTwo+city,state,country -pinCode`), matching
+  the controller
+- `GSTNumber` = group.gst, `PlaceOfSupply` = group.placeOfSupply
+- `products` = concatenated month-blocks
+- `amount` = Σ line amounts (roundAmount, inr); `tax` = CGST 9% + SGST 9% (GST prefix `33`);
+  `totalAmount` = roundAmount(amount + tax)
+- `currency: 'inr'`, `stores` = running-store count from the latest snapshot within Jun 2025
+- `billingDate` = today (creation date, per controller convention), `monthOfbilling: '04'`
+- `dueDate` = billingDate + (group.paymentTerm || 30) days
+- `status: 'pendingCsm'`, `paymentStatus: 'unpaid'`, `paymentMethod: 'Online'`
+- `advanceInvoice: false`, `advanceMonths: 3`
+
+## Number allocation across the 3 invoices
+
+Compute the starting index once (max `invoiceIndex` for `^INV-25-26-`), then increment
+locally per group so the three invoices get consecutive numbers within one run. In
+dry-run, the numbers shown are provisional (no write, so the counter is not advanced).
+
+## Safety & idempotency
+
+- **Dry-run by default.** Prints, per group: invoice number, per-month per-product
+  breakdown (product, storeCount, price, working-days/period, amount), subtotal, CGST,
+  SGST, total, and any empty-month WARNs. Writes nothing.
+- **`--apply`** performs the inserts via `invoiceModel.create`.
+- **Duplicate guard:** before creating a group's invoice, check for an existing
+  `INV-`-series invoice for that `groupId` already carrying a `products.month = 'Apr 2025'`
+  line. If found, SKIP that group with a warning (prevents double-billing on re-run).
+- **No side effects:** no PDF, no email, no OpenSearch activity log, no PO mapping.
+- **Connection:** reuse `getConnection()` from `config/database/database.js` (or
+  `MONGO_URI` override), and the `tango-api-schema` models — same as existing scripts.
+
+## Flags
+
+- `node scripts/create-quarterly-invoices-449.js` → DRY RUN
+- `node scripts/create-quarterly-invoices-449.js --apply` → write
+- `--clientId=449` (default 449), `--year=2025` (Q1 = Apr/May/Jun of this calendar year;
+  FY label derived as `YY-(YY+1)`)
+
+## Out of scope
+
+TINV/advance series, multi-client support, PDF/email generation, non-standard (step)
+pricing beyond what `standardPrice` covers for this client.

package/package.json

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

package/scripts/test-advanceNewStore.mjs

@@ -0,0 +1,70 @@
+import assert from 'node:assert';
+import dayjs from 'dayjs';
+import {
+  previousPeriodMonths, isNewStore, proratedAmount,
+  standardPriceFor, buildStepTiersByProduct, stepPriceForPosition,
+} from '../src/utils/advanceNewStore.util.js';
+
+// previousPeriodMonths: quarterly clicked in July 2026 → Apr, May, Jun 2026
+{
+  const today = dayjs('2026-07-15');
+  const r = previousPeriodMonths('quarterly', today);
+  assert.deepStrictEqual(r.months.map((m) => m.label), ['Apr 2026', 'May 2026', 'Jun 2026']);
+  assert.strictEqual(r.months[0].daysInMonth, 30); // April
+  assert.strictEqual(dayjs(r.periodStart).format('YYYY-MM-DD'), '2026-04-01');
+  assert.strictEqual(dayjs(r.periodEnd).format('YYYY-MM-DD'), '2026-06-30');
+}
+// halfyearly → last 6 completed months
+{
+  const r = previousPeriodMonths('halfyearly', dayjs('2026-07-15'));
+  assert.deepStrictEqual(r.months.map((m) => m.label),
+    ['Jan 2026', 'Feb 2026', 'Mar 2026', 'Apr 2026', 'May 2026', 'Jun 2026']);
+}
+// yearly, year-boundary: clicked Feb 2026 → prior 12 months Feb 2025 .. Jan 2026
+{
+  const r = previousPeriodMonths('yearly', dayjs('2026-02-10'));
+  assert.strictEqual(r.months[0].label, 'Feb 2025');
+  assert.strictEqual(r.months[r.months.length - 1].label, 'Jan 2026');
+  assert.strictEqual(r.months.length, 12);
+}
+// quarterly across year boundary: clicked Feb 2026 → Nov 2025, Dec 2025, Jan 2026
+{
+  const r = previousPeriodMonths('quarterly', dayjs('2026-02-10'));
+  assert.deepStrictEqual(r.months.map((m) => m.label), ['Nov 2025', 'Dec 2025', 'Jan 2026']);
+}
+// isNewStore inclusivity
+{
+  const start = dayjs('2026-04-01').toDate();
+  const end = dayjs('2026-06-30').toDate();
+  assert.strictEqual(isNewStore(dayjs('2026-04-01').toDate(), start, end), true);
+  assert.strictEqual(isNewStore(dayjs('2026-06-30').toDate(), start, end), true);
+  assert.strictEqual(isNewStore(dayjs('2026-03-31').toDate(), start, end), false);
+  assert.strictEqual(isNewStore(dayjs('2026-07-01').toDate(), start, end), false);
+  assert.strictEqual(isNewStore(null, start, end), false);
+  assert.strictEqual(isNewStore(undefined, start, end), false);
+}
+// proratedAmount matches annexure math: 3000/31*15 = 1451.6 → 1452
+{
+  assert.strictEqual(proratedAmount(3000, 31, 15), 1452);
+  assert.strictEqual(proratedAmount(3000, 30, 30), 3000); // full month
+  assert.strictEqual(proratedAmount(0, 31, 15), 0);
+}
+// standardPriceFor
+{
+  const std = [{ productName: 'Tango Traffic', negotiatePrice: 1499, basePrice: 1570 }];
+  assert.strictEqual(standardPriceFor(std, 'Tango Traffic'), 1499);
+  assert.strictEqual(standardPriceFor(std, 'Tango Zone'), 0);
+  assert.strictEqual(standardPriceFor([{ productName: 'X', basePrice: 500 }], 'X'), 500); // falls back to basePrice
+}
+// step tiers: position resolution + beyond-range fallback to last tier
+{
+  const tiers = buildStepTiersByProduct([
+    { productName: 'Tango Traffic', storeRange: '101-200', negotiatePrice: 900 },
+    { productName: 'Tango Traffic', storeRange: '1-100', negotiatePrice: 1000 },
+  ]);
+  assert.strictEqual(stepPriceForPosition(tiers, 'Tango Traffic', 50), 1000);  // tier 1
+  assert.strictEqual(stepPriceForPosition(tiers, 'Tango Traffic', 150), 900);  // tier 2
+  assert.strictEqual(stepPriceForPosition(tiers, 'Tango Traffic', 250), 900);  // beyond → last tier
+  assert.strictEqual(stepPriceForPosition(tiers, 'Missing', 1), 0);
+}
+console.log('ALL ADVANCE-NEWSTORE UTIL TESTS PASSED');

package/scripts/test-outstandingLines.mjs

@@ -0,0 +1,36 @@
+import assert from 'node:assert';
+import { groupOutstandingRowsToLines } from '../src/services/outstandingStores.service.js';
+
+// Rows for same product+month sum into one line; storeCount counts the rows,
+// price carries the per-store unit rate.
+{
+  const rows = [
+    { product: 'Tango Traffic', month: 'Apr 2026', amount: 1000, unitPrice: 1499 },
+    { product: 'Tango Traffic', month: 'Apr 2026', amount: 500, unitPrice: 1499 },
+    { product: 'Tango Traffic', month: 'May 2026', amount: 700, unitPrice: 1499 },
+    { product: 'Tango Zone', month: 'Apr 2026', amount: 300, unitPrice: 350 },
+  ];
+  const lines = groupOutstandingRowsToLines(rows);
+  // 3 distinct (product, month) groups.
+  assert.strictEqual(lines.length, 3);
+  const traApril = lines.find((l) => l.productName === 'Tango Traffic' && l.month === 'Apr 2026');
+  assert.strictEqual(traApril.amount, 1500);
+  assert.strictEqual(traApril.storeCount, 2); // two rows merged
+  assert.strictEqual(traApril.price, 750);    // AVERAGE per store: 1500 / 2
+  assert.strictEqual(traApril.description, 'Outstanding Apr 2026');
+  assert.strictEqual(traApril.HsnNumber, '998314');
+  const traMay = lines.find((l) => l.productName === 'Tango Traffic' && l.month === 'May 2026');
+  assert.strictEqual(traMay.amount, 700);
+  assert.strictEqual(traMay.storeCount, 1);
+  assert.strictEqual(traMay.price, 700);      // single store: avg == amount
+  const zoneApr = lines.find((l) => l.productName === 'Tango Zone' && l.month === 'Apr 2026');
+  assert.strictEqual(zoneApr.amount, 300);
+  assert.strictEqual(zoneApr.storeCount, 1);
+  assert.strictEqual(zoneApr.price, 300);     // single store: avg == amount
+}
+// Empty input → [].
+{
+  assert.deepStrictEqual(groupOutstandingRowsToLines([]), []);
+  assert.deepStrictEqual(groupOutstandingRowsToLines(null), []);
+}
+console.log('ALL OUTSTANDING-LINES TESTS PASSED');

package/src/controllers/advanceNewStoreExport.controller.js

@@ -0,0 +1,58 @@
+import * as billingService from '../services/billing.service.js';
+import dayjs from 'dayjs';
+import { logger } from 'tango-app-api-middleware';
+import ExcelJS from 'exceljs';
+import { computeOutstandingRows } from '../services/outstandingStores.service.js';
+import { previousPeriodMonths } from '../utils/advanceNewStore.util.js';
+
+const COLUMNS = [
+  { header: 'Store Name', key: 'storeName', width: 28 },
+  { header: 'Store ID', key: 'storeId', width: 16 },
+  { header: 'Product', key: 'product', width: 20 },
+  { header: 'Month', key: 'month', width: 14 },
+  { header: 'Working Days', key: 'workingDays', width: 14 },
+  { header: 'Deployment Date', key: 'deploymentDate', width: 16 },
+  { header: 'Unit Price', key: 'unitPrice', width: 14 },
+  { header: 'Amount', key: 'amount', width: 14 },
+];
+
+function isPeriodAllowed( advancePeriod ) {
+  return [ 'quarterly', 'halfyearly', 'yearly' ].includes( advancePeriod );
+}
+
+export async function advanceNewStoreExport( req, res ) {
+  try {
+    const groupId = req.query?.groupId;
+    if ( !groupId ) {
+      return res.sendError( 'groupId query parameter is required', 400 );
+    }
+    const group = await billingService.findOne( { _id: groupId } );
+    if ( !group ) {
+      return res.sendError( 'Billing group not found', 404 );
+    }
+    if ( !group.advanceInvoice || !isPeriodAllowed( group.advancePeriod ) ) {
+      return res.sendError( 'Group is not on quarterly/halfyearly/yearly advance invoicing', 400 );
+    }
+
+    const { months } = previousPeriodMonths( group.advancePeriod, dayjs() );
+    const rows = await computeOutstandingRows( group, dayjs() );
+
+    const wb = new ExcelJS.Workbook();
+    const ws = wb.addWorksheet( 'New Stores' );
+    ws.columns = COLUMNS;
+    ws.getRow( 1 ).font = { bold: true };
+    for ( const r of rows ) {
+      ws.addRow( r );
+    }
+    const buf = await wb.xlsx.writeBuffer();
+
+    const periodLabel = months.length ? `${months[0].label}_to_${months[months.length - 1].label}`.replace( / /g, '' ) : 'period';
+    const filename = `new-stores-${( group.groupName || 'group' ).replace( /[^a-z0-9]+/gi, '-' )}-${periodLabel}.xlsx`;
+    res.set( 'Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' );
+    res.set( 'Content-Disposition', `attachment; filename="${filename}"` );
+    return res.send( buf );
+  } catch ( error ) {
+    logger.error( { error, function: 'advanceNewStoreExport' } );
+    return res.sendError( error, 500 );
+  }
+}

package/src/controllers/invoice.controller.js

@@ -20,6 +20,7 @@ import * as assignedStoreService from '../services/assignedStore.service.js';
 import * as bankTransactionService from '../services/bankTransaction.service.js';
 import { getInrRate, getAdditionalProducts } from './brandsBilling.controller.js';
 import { applyInvoiceToPurchaseOrder } from './purchaseOrder.controller.js';
+import { computeOutstandingRows, groupOutstandingRowsToLines } from '../services/outstandingStores.service.js';
 
 // Pulls CSM + Finance head emails (stored under applicationDefault
 // type=invoice, subType=heads) AND the per-client CSMs assigned via
@@ -418,6 +419,45 @@ export async function createInvoice( req, res ) {
         logger.error( { error: oneTimeErr, function: 'createInvoice.oneTimeFee', clientId: group.clientId } );
       }
 
+      // Outstanding stores: when this group was flagged in the popup, append the
+      // previous-period new-store charges as grouped line items (one per product
+      // per month, tagged "Outstanding {Month}") so they're billed on this same
+      // invoice and taxed with the rest. Same dataset as the download export.
+      const outstandingGroupIds = ( req.body.outstandingGroupIds || [] ).map( String );
+      // Only append on a genuine ADVANCE invoice run (isAdvance). When an
+      // advance already covers this month we generate a normal monthly REUSE
+      // invoice (advanceCoverProducts set, isAdvance false) — appending here
+      // too would double-bill the same outstanding stores.
+      if ( isAdvance &&
+           outstandingGroupIds.includes( String( group._id ) ) &&
+           [ 'quarterly', 'halfyearly', 'yearly' ].includes( group.advancePeriod ) ) {
+        try {
+          const outRows = await computeOutstandingRows( group, dayjs() );
+          const outLines = groupOutstandingRowsToLines( outRows );
+          for ( const line of outLines ) {
+            products.push( {
+              productName: line.productName,
+              description: line.description,
+              month: line.month,
+              amount: line.amount,
+              // Per-store rate + outstanding store count so the invoice's Rate
+              // and Quantity/Stores columns render (amount stays authoritative —
+              // it's the summed prorated total, not price × count).
+              price: line.price,
+              storeCount: line.storeCount,
+              HsnNumber: line.HsnNumber,
+              totalZoneCount: 0,
+              totalTrafficCameraCount: 0,
+              totalZoneCameraCount: 0,
+              outstanding: true,
+            } );
+          }
+        } catch ( outErr ) {
+          logger.error( { error: outErr, function: 'createInvoice.outstanding', groupId: group._id } );
+          // Non-fatal: never block invoice generation over the outstanding add-on.
+        }
+      }
+
       let amount = products.reduce( ( sum, product ) => sum + product.amount, 0 );
       let taxList = [];
       let totalAmount = 0;
@@ -2038,38 +2078,54 @@ export async function clientInvoiceList( req, res ) {
     let filterEndDate = '';
 
     if ( !hasMonthYear ) {
+      // Start = start-of-month (00:00:00); End = end-of-month (23:59:59.999)
+      // via .toDate() so invoices on the last day (with any time) are included.
       if ( req.body?.filter && req.body.filter == 'current' ) {
-        filterStartDate = new Date( dayjs().startOf( 'month' ).format( 'YYYY-MM-DD' ) );
-        filterEndDate = new Date( dayjs().endOf( 'month' ).format( 'YYYY-MM-DD' ) );
+        filterStartDate = dayjs().startOf( 'month' ).toDate();
+        filterEndDate = dayjs().endOf( 'month' ).toDate();
       }
       if ( req.body?.filter && req.body.filter == 'prev' ) {
-        filterStartDate = new Date( dayjs().subtract( 1, 'month' ).startOf( 'month' ).format( 'YYYY-MM-DD' ) );
-        filterEndDate = new Date( dayjs().subtract( 1, 'month' ).endOf( 'month' ).format( 'YYYY-MM-DD' ) );
+        filterStartDate = dayjs().subtract( 1, 'month' ).startOf( 'month' ).toDate();
+        filterEndDate = dayjs().subtract( 1, 'month' ).endOf( 'month' ).toDate();
       }
       // Rolling windows. 'last3' = the prototype's "Last 3 Months" (was the
       // legacy 'last' id, which silently meant 12 months and made every other
       // filter look broken). 'last' is kept as an alias of 'last3' so older
       // clients don't break mid-deploy.
       if ( req.body?.filter && ( req.body.filter == 'last3' || req.body.filter == 'last' ) ) {
-        filterStartDate = new Date( dayjs().subtract( 3, 'month' ).startOf( 'month' ).format( 'YYYY-MM-DD' ) );
-        filterEndDate = new Date( dayjs().endOf( 'month' ).format( 'YYYY-MM-DD' ) );
+        filterStartDate = dayjs().subtract( 3, 'month' ).startOf( 'month' ).toDate();
+        filterEndDate = dayjs().endOf( 'month' ).toDate();
       }
       if ( req.body?.filter && req.body.filter == 'last6' ) {
-        filterStartDate = new Date( dayjs().subtract( 6, 'month' ).startOf( 'month' ).format( 'YYYY-MM-DD' ) );
-        filterEndDate = new Date( dayjs().endOf( 'month' ).format( 'YYYY-MM-DD' ) );
+        filterStartDate = dayjs().subtract( 6, 'month' ).startOf( 'month' ).toDate();
+        filterEndDate = dayjs().endOf( 'month' ).toDate();
       }
       if ( req.body?.filter && req.body.filter == 'last12' ) {
-        filterStartDate = new Date( dayjs().subtract( 12, 'month' ).startOf( 'month' ).format( 'YYYY-MM-DD' ) );
-        filterEndDate = new Date( dayjs().endOf( 'month' ).format( 'YYYY-MM-DD' ) );
+        filterStartDate = dayjs().subtract( 12, 'month' ).startOf( 'month' ).toDate();
+        filterEndDate = dayjs().endOf( 'month' ).toDate();
       }
 
       if ( req.body?.filter ) {
+        // billingDate may be stored as a Date OR a string on legacy rows. A raw
+        // { billingDate: { $gte: <Date> } } range compares across BSON types for
+        // string rows and silently fails to filter — so the Duration filter
+        // appeared to "show all". Coerce to a Date in an $expr, mirroring the
+        // Month/Year filter below.
+        const billingDateExpr = {
+          $cond: [
+            { $eq: [ { $type: '$billingDate' }, 'date' ] },
+            '$billingDate',
+            { $toDate: '$billingDate' },
+          ],
+        };
         query.push( {
           $match: {
-            $and: [
-              { billingDate: { $gte: filterStartDate } },
-              { billingDate: { $lte: filterEndDate } },
-            ],
+            $expr: {
+              $and: [
+                { $gte: [ billingDateExpr, filterStartDate ] },
+                { $lte: [ billingDateExpr, filterEndDate ] },
+              ],
+            },
           },
         } );
       }

package/src/routes/billing.routes.js

@@ -6,12 +6,15 @@ import { triggerPaymentReminders } from '../controllers/paymentReminderTrigger.c
 import { createPurchaseOrder, getPurchaseOrders, updatePurchaseOrder, deletePurchaseOrder } from '../controllers/purchaseOrder.controller.js';
 import { createBillingGroup, deleteBillingGroup, getAllBillingGroups, getBillingGroups, getClientProducts, getInvoices, getLeadProducts, getBaseProducts, onetimePayment, subscribedStoreList, updateBillingGroup, gstinLookup } from '../controllers/billing.controllers.js';
 import { billingGroupSchema, clientProductsValid, createBillingGroupsSchema, deleteBillingGroupsSchema, getBillingGroupsSchema, getInvoiceSchema, leadProductsValid, onetimeFeeValid, subscribedStoreListSchema, updateBillingGroupsSchema } from '../dtos/validation.dtos.js';
+import { advanceNewStoreExport } from '../controllers/advanceNewStoreExport.controller.js';
 
 
 billingRouter.post( '/get-subscribed-store-list', isAllowedSessionHandler, accessVerification( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isAdd' ] } ] } ), validate( subscribedStoreListSchema ), subscribedStoreList );
 
 billingRouter.get( '/get-all-billing-groups', isAllowedSessionHandler, accessVerification( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isAdd' ] } ] } ), validate( getBillingGroupsSchema ), getAllBillingGroups );
 
+billingRouter.get( '/advance-newstore-export', isAllowedSessionHandler, accessVerification( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isAdd' ] } ] } ), advanceNewStoreExport );
+
 billingRouter.post( '/create-group', isAllowedSessionHandler, accessVerification( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isAdd' ] } ] } ), validate( createBillingGroupsSchema ), createBillingGroup );
 
 billingRouter.put( '/update-group', isAllowedSessionHandler, accessVerification( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isAdd' ] } ] } ), validate( updateBillingGroupsSchema ), updateBillingGroup );

package/src/routes/invoice.routes.js

@@ -21,47 +21,47 @@ function superadminBypass( accessConfig ) {
 }
 
 
-invoiceRouter.post( '/createInvoice', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), createInvoice );
-invoiceRouter.post( '/regerateInvoice', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), createInvoice );
-invoiceRouter.post( '/invoiceDownload/bulk', isAllowedSessionHandler, accessVerification( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), invoiceDownloadBulk );
+invoiceRouter.post( '/createInvoice', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), createInvoice );
+invoiceRouter.post( '/regerateInvoice', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), createInvoice );
+invoiceRouter.post( '/invoiceDownload/bulk', isAllowedSessionHandler, accessVerification( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), invoiceDownloadBulk );
 invoiceRouter.post( '/invoiceDownload/:invoiceId', isAllowedSessionHandler, invoiceDownload );
-invoiceRouter.post( '/clientInvoiceList', isAllowedSessionHandler, accessVerification( { userType: [ 'tango', 'client' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), clientInvoiceList );
-invoiceRouter.post( '/creditTransactionlist', isAllowedSessionHandler, accessVerification( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), creditTransactionlist );
+invoiceRouter.post( '/clientInvoiceList', isAllowedSessionHandler, accessVerification( { userType: [ 'tango', 'client' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), clientInvoiceList );
+invoiceRouter.post( '/creditTransactionlist', isAllowedSessionHandler, accessVerification( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), creditTransactionlist );
 invoiceRouter.post( '/pendingInvoices', isAllowedSessionHandler, pendingInvoices );
-invoiceRouter.post( '/applyDiscount', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), applyDiscount );
+invoiceRouter.post( '/applyDiscount', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), applyDiscount );
 invoiceRouter.post( '/migrateInvoice', migrateInvoice );
-invoiceRouter.post( '/PaymentStatusChange', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), PaymentStatusChange );
-invoiceRouter.post( '/recordPayment', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), recordPayment );
+invoiceRouter.post( '/PaymentStatusChange', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), PaymentStatusChange );
+invoiceRouter.post( '/recordPayment', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), recordPayment );
 invoiceRouter.post( '/checkPaymentStatus', checkPaymentStatus );
 invoiceRouter.get( '/getInvoice/:invoiceId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango', 'client' ], access: [ ] } ), getInvoice );
-invoiceRouter.get( '/invoiceAnnexure/:invoiceId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango', 'client' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), invoiceAnnexure );
-invoiceRouter.get( '/invoiceBankDetails/:invoiceId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango', 'client' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), invoiceBankDetails );
-invoiceRouter.put( '/updateInvoice', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), updateInvoice );
+invoiceRouter.get( '/invoiceAnnexure/:invoiceId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango', 'client' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), invoiceAnnexure );
+invoiceRouter.get( '/invoiceBankDetails/:invoiceId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango', 'client' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), invoiceBankDetails );
+invoiceRouter.put( '/updateInvoice', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), updateInvoice );
 invoiceRouter.get( '/getClientBasePricing/:clientId', isAllowedSessionHandler, getClientBasePricing );
-invoiceRouter.delete( '/deleteInvoice/:invoiceId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), deleteInvoice );
+invoiceRouter.delete( '/deleteInvoice/:invoiceId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), deleteInvoice );
 
 invoiceRouter.post( '/approveInvoiceCsm', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'csmApproval', permissions: [ 'isEdit' ] } ] } ), approveInvoiceCsm );
 invoiceRouter.post( '/approveInvoiceFinance', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'financeApproval', permissions: [ 'isEdit' ] } ] } ), approveInvoiceFinance );
-invoiceRouter.post( '/approveInvoiceApproval', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), approveInvoiceApproval );
+invoiceRouter.post( '/approveInvoiceApproval', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), approveInvoiceApproval );
 
 invoiceRouter.get( '/getInvoiceHeads', isAllowedSessionHandler, getInvoiceHeads );
 invoiceRouter.post( '/updateInvoiceHeads', isAllowedSessionHandler, validate( updateInvoiceHeadsSchema ), updateInvoiceHeads );
 
 // Bank-statement reconciliation (billing "Transactions" tab). Upload mutates
 // the banktransaction collection so it needs edit rights; list is read-only.
-invoiceRouter.post( '/bankStatement/upload', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), uploadBankStatement );
-invoiceRouter.post( '/bankStatement/list', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), bankTransactionList );
-invoiceRouter.get( '/bankStatement/resolveOptions', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), resolveOptions );
-invoiceRouter.post( '/bankStatement/resolve', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), resolveBankTransaction );
+invoiceRouter.post( '/bankStatement/upload', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), uploadBankStatement );
+invoiceRouter.post( '/bankStatement/list', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), bankTransactionList );
+invoiceRouter.get( '/bankStatement/resolveOptions', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), resolveOptions );
+invoiceRouter.post( '/bankStatement/resolve', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), resolveBankTransaction );
 
 // Estimates (quotations) — per-brand quotation documents with their own
 // lifecycle. List/get are read; create/status/delete need edit rights.
-invoiceRouter.post( '/estimate/list', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), estimateList );
-invoiceRouter.post( '/estimate/create', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), createEstimate );
+invoiceRouter.post( '/estimate/list', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), estimateList );
+invoiceRouter.post( '/estimate/create', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), createEstimate );
 invoiceRouter.post( '/estimate/approveCsm', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'csmApproval', permissions: [ 'isEdit' ] } ] } ), approveEstimateCsm );
 invoiceRouter.post( '/estimate/approveFinance', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'financeApproval', permissions: [ 'isEdit' ] } ] } ), approveEstimateFinance );
-invoiceRouter.post( '/estimate/approveApproval', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), approveEstimateApproval );
-invoiceRouter.post( '/estimate/update', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), updateEstimate );
-invoiceRouter.post( '/estimate/download/:estimateId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), downloadEstimate );
-invoiceRouter.get( '/estimate/:estimateId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [] } ] } ), getEstimate );
-invoiceRouter.delete( '/estimate/:estimateId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'TangoAdmin', name: 'invoiceApproval', permissions: [ 'isEdit' ] } ] } ), deleteEstimate );
+invoiceRouter.post( '/estimate/approveApproval', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), approveEstimateApproval );
+invoiceRouter.post( '/estimate/update', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), updateEstimate );
+invoiceRouter.post( '/estimate/download/:estimateId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), downloadEstimate );
+invoiceRouter.get( '/estimate/:estimateId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [] } ] } ), getEstimate );
+invoiceRouter.delete( '/estimate/:estimateId', isAllowedSessionHandler, superadminBypass( { userType: [ 'tango' ], access: [ { featureName: 'Global', name: 'Billing', permissions: [ 'isEdit' ] } ] } ), deleteEstimate );

package/src/services/outstandingStores.service.js

@@ -0,0 +1,125 @@
+import * as clientService from './clientPayment.services.js';
+import * as dailyPriceService from './dailyPrice.service.js';
+import * as storeService from './store.service.js';
+import * as basePriceService from './basePrice.service.js';
+import dayjs from 'dayjs';
+import { logger } from 'tango-app-api-middleware';
+import {
+  previousPeriodMonths, isNewStore, proratedAmount,
+  standardPriceFor, buildStepTiersByProduct, stepPriceForPosition,
+} from '../utils/advanceNewStore.util.js';
+
+function isPeriodAllowed( advancePeriod ) {
+  return [ 'quarterly', 'halfyearly', 'yearly' ].includes( advancePeriod );
+}
+
+// Per-(store × product × month) outstanding rows for a group's previous period.
+// This is the SAME dataset the Excel export renders — kept here so the export
+// and invoice generation share one source of truth.
+export async function computeOutstandingRows( group, today = dayjs() ) {
+  if ( !group || !group.advanceInvoice || !isPeriodAllowed( group.advancePeriod ) ) {
+    return [];
+  }
+
+  const { months, periodStart, periodEnd } = previousPeriodMonths( group.advancePeriod, today );
+  const groupStoreIds = ( group.stores || [] ).map( String );
+
+  // New stores: group stores whose edge.firstFileDate is within the period.
+  const storeDocs = groupStoreIds.length ?
+    await storeService.find(
+        { storeId: { $in: groupStoreIds } },
+        { 'storeId': 1, 'storeName': 1, 'edge.firstFileDate': 1 },
+    ) : [];
+  const newStores = storeDocs.filter(
+      ( s ) => isNewStore( s?.edge?.firstFileDate, periodStart, periodEnd ) );
+  const newStoreById = new Map( newStores.map( ( s ) => [ String( s.storeId ), s ] ) );
+
+  // Pricing: standard flat + step tiers, keyed by product. priceType from client.
+  const bp = await basePriceService.findOne(
+      { clientId: group.clientId }, { standard: 1, step: 1, currency: 1 } );
+  const client = await clientService.findOne( { clientId: group.clientId }, { priceType: 1 } );
+  const isStep = client?.priceType === 'step';
+  const stepTiers = isStep ? buildStepTiersByProduct( bp?.step ) : {};
+
+  const rows = [];
+  for ( const m of months ) {
+    // Last dailyPricing snapshot within this month for the client.
+    const snap = ( await dailyPriceService.find(
+        { clientId: group.clientId, dateISO: { $gte: m.start, $lte: m.end } },
+    ) ).sort( ( a, b ) => new Date( b.dateISO ) - new Date( a.dateISO ) )[0];
+    if ( !snap ) {
+      logger.error( { function: 'computeOutstandingRows', msg: 'no snapshot', month: m.label } );
+      continue;
+    }
+    // Step-tier position is 1-based PER PRODUCT, counting only stores that run
+    // that product, in snapshot iteration order — mirrors the per-product
+    // counter in brandsBilling.controller.js (positionByProduct++), not a
+    // fixed group-array index. Reset per month/snapshot.
+    const positionByProduct = {};
+    for ( const store of ( snap.stores || [] ) ) {
+      const ns = newStoreById.get( String( store.storeId ) );
+      for ( const p of ( store.products || [] ) ) {
+        // Advance the per-product position for EVERY store carrying the
+        // product (new or not) so tier positions match the full store set.
+        const pos = ( positionByProduct[p.productName] = ( positionByProduct[p.productName] || 0 ) + 1 );
+        if ( !ns ) {
+          continue; // count position, but only new stores get rows
+        }
+        const workingDays = Number( p.workingdays ) || 0;
+        if ( workingDays <= 0 ) {
+          continue;
+        }
+        const unitPrice = isStep ?
+          stepPriceForPosition( stepTiers, p.productName, pos ) :
+          standardPriceFor( bp?.standard, p.productName );
+        rows.push( {
+          storeName: ns.storeName || store.storeName || '',
+          storeId: String( store.storeId ),
+          product: p.productName || '',
+          month: m.label,
+          workingDays,
+          deploymentDate: ns?.edge?.firstFileDate ? dayjs( ns.edge.firstFileDate ).format( 'YYYY-MM-DD' ) : '',
+          unitPrice,
+          amount: proratedAmount( unitPrice, m.daysInMonth, workingDays ),
+        } );
+      }
+    }
+  }
+  return rows;
+}
+
+// Collapse per-(store × product × month) rows into invoice line items:
+// one line per (productName, month). Amount is the summed prorated total;
+// storeCount is the number of outstanding stores; price is the AVERAGE per-store
+// amount (amount / storeCount), shown in the "Rate" column. Tagged
+// "Outstanding {Month}". Amount is the authoritative billed value; because it
+// sums per-store PRORATED amounts (stores have differing working days), the
+// average rate is a blended figure rather than the flat unit price.
+export function groupOutstandingRowsToLines( rows ) {
+  const byKey = new Map();
+  for ( const r of ( rows || [] ) ) {
+    const key = `${r.product}||${r.month}`;
+    const existing = byKey.get( key );
+    if ( existing ) {
+      existing.amount += Number( r.amount ) || 0;
+      existing.storeCount += 1;
+    } else {
+      byKey.set( key, {
+        productName: r.product,
+        month: r.month,
+        amount: Number( r.amount ) || 0,
+        // Number of outstanding stores billed on this line (the "Quantity"/
+        // "Stores" column).
+        storeCount: 1,
+        description: `Outstanding ${r.month}`,
+        HsnNumber: '998314',
+      } );
+    }
+  }
+  // Rate column = average per-store amount (blended). Computed after summing.
+  const lines = Array.from( byKey.values() );
+  for ( const line of lines ) {
+    line.price = line.storeCount > 0 ? Math.round( line.amount / line.storeCount ) : 0;
+  }
+  return lines;
+}

package/src/utils/advanceNewStore.util.js

@@ -0,0 +1,89 @@
+import dayjs from 'dayjs';
+
+export const PERIOD_MONTHS = { monthly: 1, quarterly: 3, halfyearly: 6, yearly: 12 };
+
+// The last N completed months ending LAST month (relative to `today`), where N
+// is driven by the advance period. Returns month labels ('MMM YYYY') plus each
+// month's start/end Date and actual day count, and the overall period range.
+export function previousPeriodMonths( advancePeriod, today = dayjs() ) {
+  const n = PERIOD_MONTHS[advancePeriod] || 1;
+  const base = dayjs( today );
+  const months = [];
+  // i = n (oldest) .. 1 (last month). month = base minus i months.
+  for ( let i = n; i >= 1; i-- ) {
+    const m = base.subtract( i, 'month' );
+    months.push( {
+      label: m.format( 'MMM YYYY' ),
+      start: m.startOf( 'month' ).toDate(),
+      end: m.endOf( 'month' ).toDate(),
+      daysInMonth: m.daysInMonth(),
+    } );
+  }
+  return {
+    months,
+    periodStart: months.length ? months[0].start : null,
+    periodEnd: months.length ? months[months.length - 1].end : null,
+  };
+}
+
+export function isNewStore( firstFileDate, periodStart, periodEnd ) {
+  if ( !firstFileDate ) {
+    return false;
+  }
+  const d = dayjs( firstFileDate );
+  return ( d.isSame( periodStart ) || d.isAfter( periodStart ) ) &&
+         ( d.isSame( periodEnd ) || d.isBefore( periodEnd ) );
+}
+
+export function proratedAmount( unitPrice, daysInMonth, workingDays ) {
+  const price = Number( unitPrice ) || 0;
+  const days = Number( daysInMonth ) || 0;
+  const wd = Number( workingDays ) || 0;
+  if ( !price || !days ) {
+    return 0;
+  }
+  return Math.round( ( price / days ) * wd );
+}
+
+export function standardPriceFor( standardArr, productName ) {
+  const p = ( standardArr || [] ).find( ( x ) => x.productName === productName );
+  if ( !p ) {
+    return 0;
+  }
+  return Number( p.negotiatePrice ) || Number( p.basePrice ) || 0;
+}
+
+export function buildStepTiersByProduct( stepArr ) {
+  const byProduct = {};
+  for ( const p of ( stepArr || [] ) ) {
+    if ( !p.productName ) {
+      continue;
+    }
+    ( byProduct[p.productName] = byProduct[p.productName] || [] ).push( p );
+  }
+  for ( const name of Object.keys( byProduct ) ) {
+    byProduct[name].sort( ( a, b ) => {
+      const aStart = parseInt( String( a.storeRange || '0' ).split( '-' )[0], 10 ) || 0;
+      const bStart = parseInt( String( b.storeRange || '0' ).split( '-' )[0], 10 ) || 0;
+      return aStart - bStart;
+    } );
+  }
+  return byProduct;
+}
+
+// 1-based position within the product's stores → tier rate; beyond the defined
+// ranges falls back to the last tier (mirrors invoice/brandsBilling stepPrice).
+export function stepPriceForPosition( stepTiersByProduct, productName, positionInProduct ) {
+  const tiers = ( stepTiersByProduct || {} )[productName] || [];
+  if ( !tiers.length ) {
+    return 0;
+  }
+  for ( const tier of tiers ) {
+    const [ min, max ] = String( tier.storeRange || '' ).split( '-' ).map( Number );
+    if ( positionInProduct >= min && positionInProduct <= max ) {
+      return Number( tier.negotiatePrice ) || Number( tier.basePrice ) || 0;
+    }
+  }
+  const last = tiers[tiers.length - 1];
+  return Number( last.negotiatePrice ) || Number( last.basePrice ) || 0;
+}