// Vendor Settlement — Create/Edit modal + expandable detail row const { useState: vmSt, useEffect: vmEf, useMemo: vmMemo } = React; // ── Expandable detail for a saved Vendor Settlement row ────────────────────────────────────── function VendorSettleDetail({ s }) { const { navigate } = React.useContext(window.AppCtx) || {}; const rows = s.purchaseRows || []; const t = window.vsCalcTotals(rows, { total: s.dieselDeduction || 0 }, s.deductions || []); // ── Split Allocation Traceability — diesel records locked to THIS settlement // via vendorSettledInId, restricted to ones carrying Split/Vendor role // allocation metadata (spec §7–8: cross-module traceability + drilldown). const splitDiesel = React.useMemo(function () { return (Store.all('dieselRecords', 'group') || []).filter(function (d) { return d.vendorSettledInId === s.id && (d.dieselAllocRole === 'Split' || d.dieselAllocRole === 'Vendor'); }); }, [s.id]); const H = ({ c, right }) => {c}; const D = ({ c, fw, col, right, mono }) => {c}; return (
Purchase Orders ({rows.length})
{!rows.length ?
No purchase lines recorded on this settlement.
: (
{rows.map(function (row, i) { const isSettled = row.settlementStatus === 'Fully Settled'; return ( {row.poNo}} /> ); })}
TOTALS{window.formatQuantity(t.qty)}{window.fmtCur(t.gross)}
)}
Settlement Summary
{[ ['Gross Purchase Amount', window.fmtCur(t.gross), 'var(--ok)'], ['Vendor Diesel', t.dsl ? '− ' + window.fmtCur(t.dsl) : 'None', '#B45309'], ['Manual Deductions', t.manDeds ? '− ' + window.fmtCur(t.manDeds) : 'None', '#DC2626'], ['Total Deductions', '− ' + window.fmtCur(t.totalD), '#DC2626']]. map(function (row) { return
{row[0]}{row[1]}
; })} {s.dieselDeductionEnabled === 'No' ?
Diesel deduction disabled for this settlement.
: (t.dsl > 0 && s.dieselCompanyName) ?
Diesel sourced from: {s.dieselCompanyName}
: null}
NET PAYABLE{window.fmtCur(t.net)}
{(parseFloat(s.amountPaid) || 0) > 0 && <>
Amount Paid− {window.fmtCur(s.amountPaid)}
Outstanding 0 ? '#DC2626' : 'var(--ok)' }}>{window.fmtCur(s.outstandingBalance || 0)}
}
Settlement Info
{[ ['Company', s.companyId === 'group' ? 'OM Group (All Companies)' : Store.name('companies', s.companyId) || '—'], ['Paid Through Company', s.paidThroughCompanyName || Store.name('companies', s.paidThroughCompanyId) || '—'], ['Vendor', s.vendorName || '—'], ['Period', window.fmtDate(s.periodFrom) + ' – ' + window.fmtDate(s.periodTo)], ['Status', ''], ['Created', s.createdDate ? window.fmtDate(s.createdDate) : '—'], ['Created By', s.createdBy || '—'], ['Approved By', s.approvedBy || '—']]. map(function (row) { if (row[0] === 'Status') return
Status
; return
{row[0]}{row[1]}
; })}
{(s.deductions || []).length > 0 && (
Manual Deductions ({s.deductions.length})
{['Type', 'Amount', 'Reference', 'Date', 'Created By', 'Remarks'].map(function (h) { return ; })}{s.deductions.map(function (d) { return ( ); })}
{h}
{window.fmtCur(d.amount)} {d.reference || '—'} {d.date ? window.fmtDate(d.date) : '—'} {d.createdBy || '—'} {d.remarks || '—'}
)} {(s.payments || []).length > 0 && (
Payments ({s.payments.length})
{['Date', 'Amount', 'Mode', 'Reference', 'Payment Reference', 'Remarks'].map(function (h) { return ; })}{s.payments.map(function (p) { return ( ); })}
{h}
{window.fmtDate(p.date)} {window.fmtCur(p.amount)} {p.mode} {p.reference || '—'} {p.chequeNumber || '—'} {p.remarks || '—'}
)} {splitDiesel.length > 0 && (
🟣 Split Allocation Diesel ({splitDiesel.length})
{['Date', 'Vehicle', 'Transporter', 'Challan', 'Role', 'Vendor Share', 'Transport Share', 'Total', ''].map(function (h) { return ; })}{splitDiesel.map(function (d) { var total = parseFloat(d.deductionAmount) || parseFloat(d.amount) || 0; return ( ); })}
{h}
{window.fmtDate(d.date)} {d.vehicleFull || '—'} {d.transporterName || '—'} {d.challanNumber || '—'} {window.fmtCur(d.vendorAllocAmount || total)} {d.dieselAllocRole === 'Split' ? window.fmtCur(d.transportAllocAmount || 0) : '—'} {window.fmtCur(total)}
These diesel deductions were generated automatically from a Diesel Split Allocation and included in this settlement's diesel total.
)}
); } // ── Create / Edit Vendor Settlement modal ──────────────────────────────────────────────────── function VendorSettleModal({ item, coId, isGroup, session, onSaved, onClose }) { // Shared CompanyDropdown from settlements.jsx (same component as Transporter Settlement) const CompanyDrop = window.CompanyDropdown; const blank = { companyId: isGroup ? 'group' : coId, paidThroughCompanyId: isGroup ? '' : coId, vendorId: '', periodFrom: '', periodTo: '', status: 'Pending', notes: '', dieselDeductionEnabled: 'Yes', dieselCompanyId: '' }; const [form, setF0] = vmSt(item ? { ...item } : { ...blank }); const [deds, setDeds] = vmSt(item?.deductions || []); const [payments, setPayments] = vmSt(item?.payments || []); const [confirmNegative, setConfirmNegative] = vmSt(false); const [tick, setTick] = vmSt(0); vmEf(function () { const unsub = Store.on(function () { setTick(function (t) { return t + 1; }); }); return unsub; }, []); const companies = Store.all('companies'); const vendors = window.filterAssigned(Store.all('vendors'), isGroup ? form.companyId || '' : coId); const eff = isGroup ? form.companyId : coId; const sf = (k, v) => setF0(function (p) { return { ...p, [k]: v, ...(k === 'companyId' && v !== 'group' ? { paidThroughCompanyId: v } : {}) }; }); const eligibleAudit = vmMemo(function () { if (!form.vendorId || !form.periodFrom || !form.periodTo) return { eligible: [], vendorLinked: [], matchedVendor: 0, rejects: {} }; return window.vsAuditEligiblePurchases(form.vendorId, form.periodFrom, form.periodTo, eff, item ? item.id : null); }, [form.vendorId, form.periodFrom, form.periodTo, eff, tick]); const eligiblePurchases = eligibleAudit.eligible; const purchaseRows = vmMemo(function () { return window.vsBuildPurchaseRows(eligiblePurchases); }, [eligiblePurchases, tick]); // Diesel is deducted from a company independently selectable from the Purchase Order company — // real OM Group operations often issue diesel from a different group company than the one that // raised the PO. dieselCompanyId is blank by default (falls back to the settlement/PO company, // i.e. the original behaviour) so existing settlements are unaffected until a user opts in. const dieselEnabled = (form.dieselDeductionEnabled || 'Yes') === 'Yes'; const dieselCoId = form.dieselCompanyId || eff; const vendorDiesel = vmMemo(function () { if (!dieselEnabled || !form.vendorId || !form.periodFrom || !form.periodTo) return { records: [], total: 0, litres: 0 }; return window.vsGetVendorDiesel(form.vendorId, form.periodFrom, form.periodTo, dieselCoId, item ? item.id : null); }, [dieselEnabled, form.vendorId, form.periodFrom, form.periodTo, dieselCoId, tick]); const t = vmMemo(function () { return window.vsCalcTotals(purchaseRows, vendorDiesel, deds); }, [purchaseRows, vendorDiesel, deds]); const amountPaid = vmMemo(function () { return payments.reduce(function (s, p) { return s + (parseFloat(p.amount) || 0); }, 0); }, [payments]); const outstanding = Math.max(0, t.net - amountPaid); const showPreview = form.vendorId && form.periodFrom && form.periodTo; const duplicateWarning = vmMemo(function () { if (!form.vendorId || !form.periodFrom || !form.periodTo) return null; // Scoped to the SAME company — a vendor settled for OM Transport is not a duplicate of the // same vendor settled for OM Enterprises over the same period (valid multi-company behaviour). // An OM Group (all-companies) settlement overlaps every company, so it always warns. // This is a WARNING only — it never removes Purchase Orders from the settlement. const vsIds = window.vsResolveVendorIds(form.vendorId).ids; const wantCo = window.vsResolveCompanyId(eff); const existing = (Store.all('vendorSettlements', 'group') || []).filter(function (s) { if (item && s.id === item.id) return false; if (vsIds.indexOf(s.vendorId) === -1) return false; if (s.status === 'Cancelled') return false; if (window.vsResolveCompanyId(s.companyId) !== wantCo && s.companyId !== 'group' && wantCo !== 'group') return false; return s.periodFrom <= form.periodTo && s.periodTo >= form.periodFrom; }); return existing.length > 0 ? existing[0] : null; }, [form.vendorId, form.periodFrom, form.periodTo, eff, item, tick]); function addDed() { setDeds(function (p) { return [...p, { id: window.uid(), type: 'Adjustment', customType: '', othersDescription: '', amount: '', remarks: '', reference: '', date: new Date().toISOString().slice(0, 10), createdBy: session?.userName || '' }]; }); } function updDed(i, k, v) { setDeds(function (p) { return p.map(function (d, j) { return j === i ? { ...d, [k]: v } : d; }); }); } function remDed(i) { setDeds(function (p) { return p.filter(function (_, j) { return j !== i; }); }); } function addPayment() { setPayments(function (p) { return [...p, { id: window.uid(), amount: '', mode: 'Bank Transfer', reference: '', chequeNumber: '', date: new Date().toISOString().slice(0, 10), remarks: '' }]; }); } function updPayment(i, k, v) { setPayments(function (p) { return p.map(function (x, j) { return j === i ? { ...x, [k]: v } : x; }); }); } function remPayment(i) { setPayments(function (p) { return p.filter(function (_, j) { return j !== i; }); }); } function save(e) { e.preventDefault(); if (isGroup && !form.companyId) { window.toast && window.toast('Please select a company or OM Group', 'er'); return; } if (!form.vendorId) { window.toast && window.toast('Select a vendor', 'er'); return; } if (!form.periodFrom || !form.periodTo) { window.toast && window.toast('Set settlement period', 'er'); return; } if (!form.paidThroughCompanyId) { window.toast && window.toast('Select the Paid Through Company', 'er'); return; } // Validate Others deductions have a description for (let i = 0; i < deds.length; i++) { if (deds[i].type === 'Others' && !(deds[i].othersDescription || '').trim()) { window.toast && window.toast('Please enter the adjustment description for deduction #' + (i + 1) + '.', 'er'); return; } } if (duplicateWarning && !item) { window.toast && window.toast('A settlement already exists for this vendor overlapping this period.', 'er'); return; } if (t.dsl > t.gross) { window.toast && window.toast('Diesel deduction cannot exceed gross purchase amount for this vendor.', 'er'); return; } // Payment-mode-driven instrument/reference validation — centralized via vsPayModeConfig so // Cheque/Bank Transfer/RTGS/NEFT (and any future mode) are enforced without per-mode code here. for (let i = 0; i < payments.length; i++) { const cfg = window.vsPayModeConfig(payments[i].mode); if (cfg.refRequired && !(payments[i].chequeNumber || '').trim()) { window.toast && window.toast('Payment #' + (i + 1) + ': ' + cfg.refLabel + ' is required.', 'er'); return; } } // Duplicate payment reference check (within this settlement + across all vendor settlements) const refs = payments.map(function (p) { return (p.reference || p.chequeNumber || '').trim(); }).filter(Boolean); if (new Set(refs).size !== refs.length) { window.toast && window.toast('Duplicate payment reference within this settlement.', 'er'); return; } const allOtherRefs = (Store.all('vendorSettlements') || []).filter(function (s) { return !item || s.id !== item.id; }).flatMap(function (s) { return (s.payments || []).map(function (p) { return (p.reference || p.chequeNumber || '').trim(); }); }).filter(Boolean); const dupAcrossSettlements = refs.some(function (r) { return allOtherRefs.includes(r); }); if (dupAcrossSettlements) { window.toast && window.toast('Payment reference already used in another settlement.', 'er'); return; } if (t.net < 0 && !confirmNegative) { setConfirmNegative(true); return; } const vendor = Store.byId('vendors', form.vendorId); const now = new Date().toISOString().slice(0, 16).replace('T', ' '); const prevHist = item?.statusHistory || []; const newHist = item && item.status === form.status ? prevHist : [...prevHist, { status: form.status, changedBy: session?.userName || 'System', changedAt: now, remarks: '' }]; const purchaseIds = purchaseRows.map(function (r) { return r.purchaseId; }).filter(function (v, i, a) { return a.indexOf(v) === i; }); const data = { ...form, vendorName: vendor?.name || '', deductions: deds, payments: payments, purchaseRows: purchaseRows, purchaseIds: purchaseIds, paidThroughCompanyName: form.paidThroughCompanyId ? Store.name('companies', form.paidThroughCompanyId) || '' : '', grossPurchaseAmount: t.gross, dieselDeduction: t.dsl, dieselDeductionEnabled: dieselEnabled ? 'Yes' : 'No', dieselCompanyId: dieselEnabled ? dieselCoId : '', dieselCompanyName: dieselEnabled ? (dieselCoId === 'group' ? 'OM Group (All Companies)' : Store.name('companies', dieselCoId) || '') : '', totalDeductions: t.totalD, netPayable: t.net, amountPaid: amountPaid, outstandingBalance: outstanding, poCount: t.rowCount, totalQuantity: t.qty, statusHistory: newHist, approvedDate: form.status !== 'Pending' && !item?.approvedDate ? new Date().toISOString().slice(0, 10) : item?.approvedDate || '', approvedBy: form.status !== 'Pending' && !item?.approvedBy ? session?.userName || '' : item?.approvedBy || '', paidBy: amountPaid > 0 ? session?.userName || '' : item?.paidBy || '', paidDate: amountPaid > 0 ? new Date().toISOString().slice(0, 10) : item?.paidDate || '', createdDate: item?.createdDate || new Date().toISOString().slice(0, 10), createdBy: item?.createdBy || session?.userName || '', editedBy: item ? session?.userName || '' : item?.editedBy || '', settlementDate: new Date().toISOString().slice(0, 10), }; let settlementId; if (item) { Store.update('vendorSettlements', item.id, data); Store.addLog('UPDATE', 'Vendor Settlement', 'Updated: ' + (vendor?.name || '')); settlementId = item.id; } else { settlementId = Store.add('vendorSettlements', data); Store.addLog('CREATE', 'Vendor Settlement', 'Created: ' + (vendor?.name || '')); } if (purchaseIds.length) window.vsUpdatePurchaseSettlementStatus(purchaseIds, settlementId, form.status); if (vendorDiesel.records.length) window.vsUpdateVendorDieselStatus(vendorDiesel.records, settlementId, form.status); window.toast && window.toast(item ? 'Vendor settlement updated' : 'Vendor settlement created', 'ok'); onSaved(); } const iSt = { width: '100%', height: 26, border: '1px solid var(--bdr)', borderRadius: 'var(--r)', fontSize: 12, fontFamily: 'var(--font)', outline: 'none', padding: '0 6px', background: '#fff' }; return (

{item ? 'Edit Vendor Settlement' : 'New Vendor Settlement'}

{isGroup &&
}
No excludes vendor diesel entirely from this settlement.
{dieselEnabled && (
Fetches vendor diesel from this company instead of the Purchase Order company, when diesel was actually issued elsewhere.
)}
{duplicateWarning && (
Duplicate Warning: A settlement already exists for this vendor covering {window.fmtDate(duplicateWarning.periodFrom)} – {window.fmtDate(duplicateWarning.periodTo)} (Status: {duplicateWarning.status}).
)} {showPreview && ( <> {purchaseRows.length === 0 ? ( ) : (
Purchase Orders — {purchaseRows.length} line{purchaseRows.length !== 1 ? 's' : ''}
{['PO NO.', 'DATE', 'MATERIAL', 'QTY', 'RATE', 'AMOUNT', 'AMT+GST', 'CHALLAN', 'VEHICLE', 'STATUS'].map(function (h) { const right = ['QTY', 'RATE', 'AMOUNT', 'AMT+GST'].includes(h); return ; })} {purchaseRows.map(function (row, i) { return ( ); })}
{h}
{row.poNo} {window.fmtDate(row.date)} {row.material} {window.formatQuantity(row.quantity)} {window.fmtCur(row.rate)} {window.fmtCur(row.amount)} {window.fmtCur(row.amountWithGst)} {row.challanNumber} {row.vehicleFull}
)}
Settlement Summary · {t.rowCount} lines · {window.formatQuantity(t.qty)} MT
{[['Gross Purchase', window.fmtCur(t.gross), 'var(--ok)'], ['Vendor Diesel', window.fmtCur(t.dsl), '#B45309'], ['Manual Deductions', window.fmtCur(t.manDeds), '#DC2626'], ['Net Payable', window.fmtCur(t.net), t.net < 0 ? '#DC2626' : 'var(--or)']].map(function (row) { return
{row[1]}
{row[0]}
; })}
{t.net < 0 &&
⚠ Net payable is negative — deductions exceed gross purchase amount. You will be asked to confirm on save.
}
)}
Manual Deductions
{!deds.length ?
No deductions. Add Adjustment, Advance, RTO, Royalty Recovery, Penalty, etc.
: (
{['Type', 'Amount', 'Reference', 'Date', 'Remarks', ''].map(function (h, i) { return ; })} {deds.map(function (d, i) { return ( ); })}
{h}
{d.type === 'Others' && ( )} {d.type === 'Others' && !(d.othersDescription || '').trim() && ( Please enter the adjustment description. )} {d.type === 'Miscellaneous' ?
: }
)}
Payments
{!payments.length ?
No payments recorded yet. Supports multiple / partial payments.
: (
{['Date', 'Amount', 'Mode', 'Reference', 'Payment Reference', 'Remarks', ''].map(function (h, i) { return ; })} {payments.map(function (p, i) { const payCfg = window.vsPayModeConfig(p.mode); const refMissing = payCfg.refRequired && !(p.chequeNumber || '').trim(); return ( ); })}
{h}
{refMissing && {payCfg.refLabel} is required}
TOTAL PAID{window.fmtCur(amountPaid)}
)} {showPreview &&
Outstanding Balance: 0 ? '#DC2626' : 'var(--ok)' }}>{window.fmtCur(outstanding)}
}