2
0
mirror of https://github.com/frappe/books.git synced 2024-11-14 17:34:04 +00:00
books/models/helpers.ts

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

1248 lines
29 KiB
TypeScript
Raw Normal View History

import { Fyo, t } from 'fyo';
import { Doc } from 'fyo/model/doc';
2024-08-09 05:11:54 +00:00
import {
Action,
ColumnConfig,
DocStatus,
LeadStatus,
RenderData,
} from 'fyo/model/types';
import { DateTime } from 'luxon';
2022-05-23 05:30:54 +00:00
import { Money } from 'pesa';
import { safeParseFloat } from 'utils/index';
import { Router } from 'vue-router';
import {
AccountRootType,
AccountRootTypeEnum,
} from './baseModels/Account/types';
import { numberSeriesDefaultsMap } from './baseModels/Defaults/Defaults';
2022-11-22 09:12:49 +00:00
import { Invoice } from './baseModels/Invoice/Invoice';
2023-12-22 08:50:35 +00:00
import { SalesQuote } from './baseModels/SalesQuote/SalesQuote';
import { StockMovement } from './inventory/StockMovement';
import { StockTransfer } from './inventory/StockTransfer';
2023-05-04 10:45:12 +00:00
import { InvoiceStatus, ModelNameEnum } from './types';
2024-08-09 05:11:54 +00:00
import { Lead } from './baseModels/Lead/Lead';
2024-01-30 12:55:50 +00:00
import { PricingRule } from './baseModels/PricingRule/PricingRule';
2024-02-01 11:34:52 +00:00
import { ApplicablePricingRules } from './baseModels/Invoice/types';
2024-08-22 11:24:14 +00:00
import { LoyaltyProgram } from './baseModels/LoyaltyProgram/LoyaltyProgram';
import { CollectionRulesItems } from './baseModels/CollectionRulesItems/CollectionRulesItems';
import { isPesa } from 'fyo/utils';
2024-08-23 06:07:15 +00:00
import { Party } from './baseModels/Party/Party';
2024-09-11 10:41:16 +00:00
import { CouponCode } from './baseModels/CouponCode/CouponCode';
import { SalesInvoice } from './baseModels/SalesInvoice/SalesInvoice';
2024-10-08 06:54:48 +00:00
import { AppliedCouponCodes } from './baseModels/AppliedCouponCodes/AppliedCouponCodes';
import { ValidationError } from 'fyo/utils/errors';
export function getQuoteActions(
fyo: Fyo,
schemaName: ModelNameEnum.SalesQuote
): Action[] {
2023-12-22 08:50:35 +00:00
return [getMakeInvoiceAction(fyo, schemaName)];
}
2024-08-09 05:11:54 +00:00
export function getLeadActions(fyo: Fyo): Action[] {
return [getCreateCustomerAction(fyo), getSalesQuoteAction(fyo)];
}
2022-12-01 08:31:23 +00:00
export function getInvoiceActions(
fyo: Fyo,
schemaName: ModelNameEnum.SalesInvoice | ModelNameEnum.PurchaseInvoice
): Action[] {
2022-04-14 08:01:33 +00:00
return [
2022-11-22 09:12:49 +00:00
getMakePaymentAction(fyo),
2022-12-01 08:31:23 +00:00
getMakeStockTransferAction(fyo, schemaName),
2022-11-22 09:12:49 +00:00
getLedgerLinkAction(fyo),
2023-09-23 11:15:22 +00:00
getMakeReturnDocAction(fyo),
2022-11-22 09:12:49 +00:00
];
}
export function getStockTransferActions(
fyo: Fyo,
schemaName: ModelNameEnum.Shipment | ModelNameEnum.PurchaseReceipt
): Action[] {
return [
getMakeInvoiceAction(fyo, schemaName),
getLedgerLinkAction(fyo, false),
getLedgerLinkAction(fyo, true),
2023-07-01 07:31:00 +00:00
getMakeReturnDocAction(fyo),
];
}
2022-12-01 08:31:23 +00:00
export function getMakeStockTransferAction(
fyo: Fyo,
schemaName: ModelNameEnum.SalesInvoice | ModelNameEnum.PurchaseInvoice
): Action {
let label = fyo.t`Shipment`;
if (schemaName === ModelNameEnum.PurchaseInvoice) {
label = fyo.t`Purchase Receipt`;
}
2022-11-22 09:12:49 +00:00
return {
2022-12-01 08:31:23 +00:00
label,
2022-11-30 06:59:52 +00:00
group: fyo.t`Create`,
2022-11-22 09:12:49 +00:00
condition: (doc: Doc) => doc.isSubmitted && !!doc.stockNotTransferred,
action: async (doc: Doc) => {
const transfer = await (doc as Invoice).getStockTransfer();
if (!transfer || !transfer.name) {
2022-11-22 09:12:49 +00:00
return;
}
2022-04-14 08:01:33 +00:00
2022-11-22 09:12:49 +00:00
const { routeTo } = await import('src/utils/ui');
const path = `/edit/${transfer.schemaName}/${transfer.name}`;
await routeTo(path);
2022-04-14 08:01:33 +00:00
},
2022-11-22 09:12:49 +00:00
};
}
export function getMakeInvoiceAction(
fyo: Fyo,
2023-12-22 08:50:35 +00:00
schemaName:
| ModelNameEnum.Shipment
| ModelNameEnum.PurchaseReceipt
| ModelNameEnum.SalesQuote
): Action {
let label = fyo.t`Sales Invoice`;
if (schemaName === ModelNameEnum.PurchaseReceipt) {
label = fyo.t`Purchase Invoice`;
}
return {
label,
group: fyo.t`Create`,
condition: (doc: Doc) => {
if (schemaName === ModelNameEnum.SalesQuote) {
2023-12-22 08:50:35 +00:00
return doc.isSubmitted;
} else {
2023-12-22 08:50:35 +00:00
return doc.isSubmitted && !doc.backReference;
}
},
action: async (doc: Doc) => {
2023-12-22 08:50:35 +00:00
const invoice = await (doc as SalesQuote | StockTransfer).getInvoice();
if (!invoice || !invoice.name) {
return;
}
const { routeTo } = await import('src/utils/ui');
const path = `/edit/${invoice.schemaName}/${invoice.name}`;
await routeTo(path);
},
};
}
2024-08-09 05:11:54 +00:00
export function getCreateCustomerAction(fyo: Fyo): Action {
return {
group: fyo.t`Create`,
label: fyo.t`Customer`,
condition: (doc: Doc) => !doc.notInserted,
2024-08-09 05:11:54 +00:00
action: async (doc: Doc, router) => {
2024-08-09 10:26:10 +00:00
const customerData = (doc as Lead).createCustomer();
if (!customerData.name) {
2024-08-09 05:11:54 +00:00
return;
}
2024-08-09 10:26:10 +00:00
await router.push(`/edit/Party/${customerData.name}`);
2024-08-09 05:11:54 +00:00
},
};
}
export function getSalesQuoteAction(fyo: Fyo): Action {
return {
group: fyo.t`Create`,
label: fyo.t`Sales Quote`,
condition: (doc: Doc) => !doc.notInserted,
2024-08-09 05:11:54 +00:00
action: async (doc, router) => {
2024-08-09 10:26:10 +00:00
const salesQuoteData = (doc as Lead).createSalesQuote();
if (!salesQuoteData.name) {
2024-08-09 05:11:54 +00:00
return;
}
2024-08-09 10:26:10 +00:00
await router.push(`/edit/SalesQuote/${salesQuoteData.name}`);
2024-08-09 05:11:54 +00:00
},
};
}
2022-11-22 09:12:49 +00:00
export function getMakePaymentAction(fyo: Fyo): Action {
return {
2022-11-30 06:59:52 +00:00
label: fyo.t`Payment`,
group: fyo.t`Create`,
2022-11-22 09:12:49 +00:00
condition: (doc: Doc) =>
doc.isSubmitted && !(doc.outstandingAmount as Money).isZero(),
2023-04-19 07:43:46 +00:00
action: async (doc, router) => {
const schemaName = doc.schema.name;
2022-11-22 09:12:49 +00:00
const payment = (doc as Invoice).getPayment();
if (!payment) {
return;
}
await payment?.set('referenceType', schemaName);
2023-04-19 07:43:46 +00:00
const currentRoute = router.currentRoute.value.fullPath;
2022-11-22 09:12:49 +00:00
payment.once('afterSync', async () => {
await payment.submit();
2023-04-19 07:43:46 +00:00
await doc.load();
await router.push(currentRoute);
2022-11-22 09:12:49 +00:00
});
2023-11-17 06:42:35 +00:00
const hideFields = ['party', 'for'];
if (!fyo.singles.AccountingSettings?.enableInvoiceReturns) {
hideFields.push('paymentType');
}
2023-04-19 07:43:46 +00:00
if (doc.schemaName === ModelNameEnum.SalesInvoice) {
hideFields.push('account');
} else {
hideFields.push('paymentAccount');
}
await payment.runFormulas();
2022-11-22 09:12:49 +00:00
const { openQuickEdit } = await import('src/utils/ui');
await openQuickEdit({
doc: payment,
2023-04-19 07:43:46 +00:00
hideFields,
2022-11-22 09:12:49 +00:00
});
},
};
2022-04-14 08:01:33 +00:00
}
export function getLedgerLinkAction(fyo: Fyo, isStock = false): Action {
2022-12-01 08:31:23 +00:00
let label = fyo.t`Accounting Entries`;
let reportClassName: 'GeneralLedger' | 'StockLedger' = 'GeneralLedger';
if (isStock) {
label = fyo.t`Stock Entries`;
reportClassName = 'StockLedger';
}
return {
label,
2022-11-30 06:59:52 +00:00
group: fyo.t`View`,
condition: (doc: Doc) => doc.isSubmitted,
action: async (doc: Doc, router: Router) => {
const route = getLedgerLink(doc, reportClassName);
await router.push(route);
},
};
}
export function getLedgerLink(
doc: Doc,
reportClassName: 'GeneralLedger' | 'StockLedger'
) {
return {
name: 'Report',
params: {
reportClassName,
defaultFilters: JSON.stringify({
referenceType: doc.schemaName,
referenceName: doc.name,
}),
},
};
}
2023-07-01 07:31:00 +00:00
export function getMakeReturnDocAction(fyo: Fyo): Action {
return {
label: fyo.t`Return`,
group: fyo.t`Create`,
condition: (doc: Doc) =>
2023-09-23 11:15:22 +00:00
(!!fyo.singles.AccountingSettings?.enableInvoiceReturns ||
!!fyo.singles.InventorySettings?.enableStockReturns) &&
2023-07-01 07:31:00 +00:00
doc.isSubmitted &&
!doc.isReturn,
action: async (doc: Doc) => {
2023-09-23 11:15:22 +00:00
let returnDoc: Invoice | StockTransfer | undefined;
if (doc instanceof Invoice || doc instanceof StockTransfer) {
returnDoc = await doc.getReturnDoc();
}
2023-07-01 07:31:00 +00:00
if (!returnDoc || !returnDoc.name) {
return;
}
const { routeTo } = await import('src/utils/ui');
const path = `/edit/${doc.schemaName}/${returnDoc.name}`;
await routeTo(path);
},
};
}
export function getTransactionStatusColumn(): ColumnConfig {
2022-04-14 08:01:33 +00:00
return {
label: t`Status`,
2022-04-14 08:01:33 +00:00
fieldname: 'status',
fieldtype: 'Select',
2022-06-14 09:10:46 +00:00
render(doc) {
const status = getDocStatus(doc) as InvoiceStatus;
const color = statusColor[status] ?? 'gray';
const label = getStatusText(status);
2022-06-14 09:10:46 +00:00
2022-04-14 08:01:33 +00:00
return {
template: `<Badge class="text-xs" color="${color}">${label}</Badge>`,
};
},
};
}
2024-08-09 05:11:54 +00:00
export function getLeadStatusColumn(): ColumnConfig {
return {
label: t`Status`,
fieldname: 'status',
fieldtype: 'Select',
render(doc) {
const status = getLeadStatus(doc) as LeadStatus;
const color = statusColor[status] ?? 'gray';
const label = getStatusTextOfLead(status);
return {
template: `<Badge class="text-xs" color="${color}">${label}</Badge>`,
};
},
};
}
2022-06-14 09:10:46 +00:00
export const statusColor: Record<
2024-08-09 05:11:54 +00:00
DocStatus | InvoiceStatus | LeadStatus,
2022-06-14 09:10:46 +00:00
string | undefined
> = {
'': 'gray',
2022-04-14 08:01:33 +00:00
Draft: 'gray',
2024-08-09 05:11:54 +00:00
Open: 'gray',
Replied: 'yellow',
Opportunity: 'yellow',
2022-04-14 08:01:33 +00:00
Unpaid: 'orange',
Paid: 'green',
2024-08-09 05:11:54 +00:00
Interested: 'yellow',
Converted: 'green',
Quotation: 'green',
2022-06-14 09:10:46 +00:00
Saved: 'gray',
NotSaved: 'gray',
Submitted: 'green',
2022-04-14 08:01:33 +00:00
Cancelled: 'red',
2024-08-09 05:11:54 +00:00
DonotContact: 'red',
Return: 'green',
ReturnIssued: 'green',
2022-04-14 08:01:33 +00:00
};
export function getStatusText(status: DocStatus | InvoiceStatus): string {
switch (status) {
case 'Draft':
return t`Draft`;
case 'Saved':
return t`Saved`;
case 'NotSaved':
return t`Not Saved`;
case 'Submitted':
return t`Submitted`;
case 'Cancelled':
return t`Cancelled`;
case 'Paid':
return t`Paid`;
case 'Unpaid':
return t`Unpaid`;
2023-07-01 07:31:00 +00:00
case 'Return':
return t`Return`;
case 'ReturnIssued':
return t`Return Issued`;
default:
return '';
}
2022-06-14 09:10:46 +00:00
}
2024-08-09 05:11:54 +00:00
export function getStatusTextOfLead(status: LeadStatus): string {
switch (status) {
case 'Open':
return t`Open`;
case 'Replied':
return t`Replied`;
case 'Opportunity':
return t`Opportunity`;
case 'Interested':
return t`Interested`;
case 'Converted':
return t`Converted`;
case 'Quotation':
return t`Quotation`;
case 'DonotContact':
return t`Do not Contact`;
default:
return '';
}
}
export function getLeadStatus(
doc?: Lead | Doc | RenderData
): LeadStatus | DocStatus {
if (!doc) {
return '';
}
return doc.status as LeadStatus;
}
2022-06-14 09:10:46 +00:00
export function getDocStatus(
doc?: RenderData | Doc
): DocStatus | InvoiceStatus {
if (!doc) {
return '';
}
if (doc.notInserted) {
return 'Draft';
2022-04-14 08:01:33 +00:00
}
2022-06-14 09:10:46 +00:00
if (doc.dirty) {
return 'NotSaved';
}
if (!doc.schema?.isSubmittable) {
return 'Saved';
}
return getSubmittableDocStatus(doc);
}
function getSubmittableDocStatus(doc: RenderData | Doc) {
if (
[ModelNameEnum.SalesInvoice, ModelNameEnum.PurchaseInvoice].includes(
doc.schema.name as ModelNameEnum
)
) {
return getInvoiceStatus(doc);
}
2023-07-01 07:31:00 +00:00
if (
[ModelNameEnum.Shipment, ModelNameEnum.PurchaseReceipt].includes(
2023-08-01 05:42:13 +00:00
doc.schema.name as ModelNameEnum
2023-07-01 07:31:00 +00:00
)
) {
2023-08-01 05:42:13 +00:00
if (!!doc.returnAgainst && doc.submitted && !doc.cancelled) {
2023-07-01 07:31:00 +00:00
return 'Return';
}
2023-08-01 05:42:13 +00:00
if (doc.isReturned && doc.submitted && !doc.cancelled) {
2023-07-01 07:31:00 +00:00
return 'ReturnIssued';
}
}
2022-06-14 09:10:46 +00:00
if (!!doc.submitted && !doc.cancelled) {
return 'Submitted';
}
if (!!doc.submitted && !!doc.cancelled) {
return 'Cancelled';
}
return 'Saved';
}
export function getInvoiceStatus(doc: RenderData | Doc): InvoiceStatus {
2023-09-23 11:15:22 +00:00
if (doc.submitted && !doc.cancelled && doc.returnAgainst) {
return 'Return';
}
if (doc.submitted && !doc.cancelled && doc.isReturned) {
return 'ReturnIssued';
}
2022-06-14 09:10:46 +00:00
if (
doc.submitted &&
!doc.cancelled &&
(doc.outstandingAmount as Money).isZero()
) {
return 'Paid';
}
if (
doc.submitted &&
!doc.cancelled &&
(doc.outstandingAmount as Money).isPositive()
) {
return 'Unpaid';
2022-04-14 08:01:33 +00:00
}
if (doc.cancelled) {
2022-06-14 09:10:46 +00:00
return 'Cancelled';
2022-04-14 08:01:33 +00:00
}
2022-06-14 09:10:46 +00:00
return 'Saved';
2022-04-14 08:01:33 +00:00
}
2023-05-04 10:45:12 +00:00
export function getSerialNumberStatusColumn(): ColumnConfig {
2023-04-25 07:07:29 +00:00
return {
label: t`Status`,
fieldname: 'status',
fieldtype: 'Select',
render(doc) {
2023-05-04 10:45:12 +00:00
let status = doc.status;
if (typeof status !== 'string') {
status = 'Inactive';
}
const color = serialNumberStatusColor[status] ?? 'gray';
const label = getSerialNumberStatusText(status);
2023-04-25 07:07:29 +00:00
return {
template: `<Badge class="text-xs" color="${color}">${label}</Badge>`,
};
},
};
}
2023-05-04 10:45:12 +00:00
export const serialNumberStatusColor: Record<string, string | undefined> = {
2023-04-25 07:07:29 +00:00
Inactive: 'gray',
Active: 'green',
2023-05-04 10:45:12 +00:00
Delivered: 'blue',
2023-04-25 07:07:29 +00:00
};
2023-05-04 10:45:12 +00:00
export function getSerialNumberStatusText(status: string): string {
2023-04-25 07:07:29 +00:00
switch (status) {
case 'Inactive':
return t`Inactive`;
case 'Active':
return t`Active`;
case 'Delivered':
return t`Delivered`;
default:
return t`Inactive`;
}
}
2023-06-06 08:59:08 +00:00
export function getPriceListStatusColumn(): ColumnConfig {
return {
label: t`Enabled For`,
fieldname: 'enabledFor',
fieldtype: 'Select',
2023-06-07 04:45:26 +00:00
render({ isSales, isPurchase }) {
2023-06-06 22:39:46 +00:00
let status = t`None`;
2023-06-06 08:59:08 +00:00
2023-06-07 04:45:26 +00:00
if (isSales && isPurchase) {
status = t`Sales and Purchase`;
} else if (isSales) {
status = t`Sales`;
} else if (isPurchase) {
status = t`Purchase`;
2023-06-06 08:59:08 +00:00
}
return {
template: `<Badge class="text-xs" color="gray">${status}</Badge>`,
};
},
};
}
2024-01-30 12:55:50 +00:00
export function getIsDocEnabledColumn(): ColumnConfig {
2023-06-06 22:42:38 +00:00
return {
label: t`Enabled`,
fieldname: 'enabled',
fieldtype: 'Data',
render(doc) {
2023-06-07 04:45:26 +00:00
let status = t`Disabled`;
2023-06-06 22:42:38 +00:00
let color = 'orange';
2023-06-07 04:45:26 +00:00
if (doc.isEnabled) {
2023-06-06 22:42:38 +00:00
status = t`Enabled`;
color = 'green';
}
return {
template: `<Badge class="text-xs" color="${color}">${status}</Badge>`,
};
},
};
}
export async function getExchangeRate({
fromCurrency,
toCurrency,
date,
}: {
fromCurrency: string;
toCurrency: string;
date?: string;
}) {
if (!fetch) {
return 1;
}
if (!date) {
date = DateTime.local().toISODate();
}
const cacheKey = `currencyExchangeRate:${date}:${fromCurrency}:${toCurrency}`;
let exchangeRate = 0;
if (localStorage) {
exchangeRate = safeParseFloat(localStorage.getItem(cacheKey) as string);
}
if (exchangeRate && exchangeRate !== 1) {
return exchangeRate;
}
try {
const res = await fetch(
`https://api.vatcomply.com/rates?date=${date}&base=${fromCurrency}&symbols=${toCurrency}`
);
const data = (await res.json()) as {
base: string;
data: string;
rates: Record<string, number>;
};
exchangeRate = data.rates[toCurrency];
} catch (error) {
exchangeRate ??= 1;
}
if (localStorage) {
localStorage.setItem(cacheKey, String(exchangeRate));
}
return exchangeRate;
}
export function isCredit(rootType: AccountRootType) {
switch (rootType) {
case AccountRootTypeEnum.Asset:
return false;
case AccountRootTypeEnum.Liability:
return true;
case AccountRootTypeEnum.Equity:
return true;
case AccountRootTypeEnum.Expense:
return false;
case AccountRootTypeEnum.Income:
return true;
default:
return true;
}
}
2022-10-12 09:29:43 +00:00
export function getNumberSeries(schemaName: string, fyo: Fyo) {
const numberSeriesKey = numberSeriesDefaultsMap[schemaName];
if (!numberSeriesKey) {
return undefined;
}
const defaults = fyo.singles.Defaults;
2022-10-12 09:29:43 +00:00
const field = fyo.getField(schemaName, 'numberSeries');
const value = defaults?.[numberSeriesKey] as string | undefined;
return value ?? (field?.default as string | undefined);
}
export function getDocStatusListColumn(): ColumnConfig {
return {
label: t`Status`,
fieldname: 'status',
fieldtype: 'Select',
render(doc) {
const status = getDocStatus(doc);
const color = statusColor[status] ?? 'gray';
const label = getStatusText(status);
return {
template: `<Badge class="text-xs" color="${color}">${label}</Badge>`,
};
},
};
}
type ModelsWithItems = Invoice | StockTransfer | StockMovement;
export async function addItem<M extends ModelsWithItems>(name: string, doc: M) {
if (!doc.canEdit) {
return;
}
const items = (doc.items ?? []) as NonNullable<M['items']>[number][];
let item = items.find((i) => i.item === name);
if (item) {
const q = item.quantity ?? 0;
await item.set('quantity', q + 1);
return;
}
await doc.append('items');
item = doc.items?.at(-1);
if (!item) {
return;
}
await item.set('item', name);
}
2024-01-30 12:55:50 +00:00
2024-08-22 11:24:14 +00:00
export async function createLoyaltyPointEntry(doc: Invoice) {
const loyaltyProgramDoc = (await doc.fyo.doc.getDoc(
ModelNameEnum.LoyaltyProgram,
doc?.loyaltyProgram
)) as LoyaltyProgram;
if (!loyaltyProgramDoc.isEnabled) {
return;
}
const expiryDate = new Date(Date.now());
expiryDate.setDate(
expiryDate.getDate() + (loyaltyProgramDoc.expiryDuration || 0)
);
2024-08-22 12:29:26 +00:00
let loyaltyProgramTier;
let loyaltyPoint: number;
if (doc.redeemLoyaltyPoints) {
loyaltyPoint = -(doc.loyaltyPoints || 0);
} else {
loyaltyProgramTier = getLoyaltyProgramTier(
loyaltyProgramDoc,
doc?.grandTotal as Money
) as CollectionRulesItems;
if (!loyaltyProgramTier) {
return;
}
2024-08-22 11:24:14 +00:00
2024-08-22 12:29:26 +00:00
const collectionFactor = loyaltyProgramTier.collectionFactor as number;
loyaltyPoint = Math.round(doc?.grandTotal?.float || 0) * collectionFactor;
2024-08-22 11:24:14 +00:00
}
const newLoyaltyPointEntry = doc.fyo.doc.getNewDoc(
ModelNameEnum.LoyaltyPointEntry,
{
loyaltyProgram: doc.loyaltyProgram,
customer: doc.party,
invoice: doc.name,
postingDate: doc.date,
purchaseAmount: doc.grandTotal,
expiryDate: expiryDate,
loyaltyProgramTier: loyaltyProgramTier?.tierName,
loyaltyPoints: loyaltyPoint,
}
);
return await newLoyaltyPointEntry.sync();
}
export async function getAddedLPWithGrandTotal(
fyo: Fyo,
loyaltyProgram: string,
loyaltyPoints: number
) {
const loyaltyProgramDoc = (await fyo.doc.getDoc(
ModelNameEnum.LoyaltyProgram,
loyaltyProgram
)) as LoyaltyProgram;
const conversionFactor = loyaltyProgramDoc.conversionFactor as number;
return fyo.pesa((loyaltyPoints || 0) * conversionFactor);
}
export function getLoyaltyProgramTier(
loyaltyProgramData: LoyaltyProgram,
grandTotal: Money
): CollectionRulesItems | undefined {
if (!loyaltyProgramData.collectionRules) {
return;
}
let loyaltyProgramTier: CollectionRulesItems | undefined;
for (const row of loyaltyProgramData.collectionRules) {
if (isPesa(row.minimumTotalSpent)) {
const minimumSpent = row.minimumTotalSpent;
if (!minimumSpent.lte(grandTotal)) {
continue;
}
if (
!loyaltyProgramTier ||
minimumSpent.gt(loyaltyProgramTier.minimumTotalSpent as Money)
) {
loyaltyProgramTier = row;
}
}
}
return loyaltyProgramTier;
}
2024-08-23 06:07:15 +00:00
export async function removeLoyaltyPoint(doc: Doc) {
if (!doc.loyaltyProgram) {
return;
}
2024-08-23 06:07:15 +00:00
const data = (await doc.fyo.db.getAll(ModelNameEnum.LoyaltyPointEntry, {
fields: ['name', 'loyaltyPoints', 'expiryDate'],
filters: {
loyaltyProgram: doc.loyaltyProgram as string,
invoice: doc.isReturn
? (doc.returnAgainst as string)
: (doc.name as string),
},
})) as { name: string; loyaltyPoints: number; expiryDate: Date }[];
if (!data.length) {
return;
}
2024-08-23 06:07:15 +00:00
const loyalityPointEntryDoc = await doc.fyo.doc.getDoc(
ModelNameEnum.LoyaltyPointEntry,
data[0].name
);
const party = (await doc.fyo.doc.getDoc(
ModelNameEnum.Party,
doc.party as string
)) as Party;
await loyalityPointEntryDoc.delete();
await party.updateLoyaltyPoints();
}
2024-10-08 06:54:48 +00:00
export async function getPricingRulesOfCoupons(
doc: SalesInvoice,
couponName?: string,
pricingRuleDocNames?: string[]
): Promise<PricingRule[] | undefined> {
if (!doc?.coupons?.length && !couponName) {
return;
}
let appliedCoupons: CouponCode[] = [];
const couponsToFetch = couponName
? [couponName]
: (doc?.coupons?.map((coupon) => coupon.coupons) as string[] | []);
2024-10-08 06:54:48 +00:00
if (couponsToFetch?.length) {
appliedCoupons = (await doc.fyo.db.getAll(ModelNameEnum.CouponCode, {
fields: ['*'],
filters: { name: ['in', couponsToFetch] },
})) as CouponCode[];
2024-10-08 06:54:48 +00:00
}
console.log('pricingRuleDocNames', pricingRuleDocNames);
2024-10-08 06:54:48 +00:00
const filteredPricingRuleNames = appliedCoupons.filter(
(val) => val.pricingRule === pricingRuleDocNames![0]
);
if (!filteredPricingRuleNames.length) {
return;
}
const pricingRuleDocsForItem = (await doc.fyo.db.getAll(
ModelNameEnum.PricingRule,
{
fields: ['*'],
filters: {
name: ['in', pricingRuleDocNames as string[]],
isEnabled: true,
isCouponCodeBased: true,
},
orderBy: 'priority',
order: 'desc',
}
)) as PricingRule[];
console.log('pricingRuleDocsForItem', pricingRuleDocsForItem);
2024-10-08 06:54:48 +00:00
return pricingRuleDocsForItem;
}
2024-02-01 11:34:52 +00:00
export async function getPricingRule(
2024-10-08 06:54:48 +00:00
doc: Invoice,
couponName?: string
2024-09-09 04:08:02 +00:00
): Promise<ApplicablePricingRules[] | undefined> {
2024-02-01 11:34:52 +00:00
if (
!doc.fyo.singles.AccountingSettings?.enablePricingRule ||
!doc.isSales ||
!doc.items
) {
2024-09-09 04:08:02 +00:00
return;
2024-02-01 11:34:52 +00:00
}
const pricingRules: ApplicablePricingRules[] = [];
for (const item of doc.items) {
if (item.isFreeItem) {
continue;
}
const pricingRuleDocNames = (
await doc.fyo.db.getAll(ModelNameEnum.PricingRuleItem, {
fields: ['parent'],
filters: {
item: item.item as string,
unit: item.unit as string,
},
})
).map((doc) => doc.parent) as string[];
2024-10-08 06:54:48 +00:00
let pricingRuleDocsForItem;
const pricingRuleDocs = (await doc.fyo.db.getAll(
2024-02-01 11:34:52 +00:00
ModelNameEnum.PricingRule,
{
fields: ['*'],
filters: {
name: ['in', pricingRuleDocNames],
isEnabled: true,
2024-10-08 06:54:48 +00:00
isCouponCodeBased: false,
2024-02-01 11:34:52 +00:00
},
orderBy: 'priority',
order: 'desc',
}
)) as PricingRule[];
2024-10-08 06:54:48 +00:00
if (pricingRuleDocs.length) {
pricingRuleDocsForItem = pricingRuleDocs;
}
if (!pricingRuleDocs.length || couponName) {
const couponPricingRules: PricingRule[] | undefined =
await getPricingRulesOfCoupons(
doc as SalesInvoice,
couponName,
pricingRuleDocNames
);
pricingRuleDocsForItem = couponPricingRules as PricingRule[];
}
if (!pricingRuleDocsForItem) {
continue;
}
2024-02-01 11:34:52 +00:00
const filtered = filterPricingRules(
pricingRuleDocsForItem,
doc.date as Date,
item.quantity as number,
item.amount as Money
);
if (!filtered.length) {
continue;
}
const isPricingRuleHasConflicts = getPricingRulesConflicts(filtered);
2024-02-01 11:34:52 +00:00
if (isPricingRuleHasConflicts) {
continue;
}
pricingRules.push({
applyOnItem: item.item as string,
pricingRule: filtered[0],
});
}
2024-10-08 06:54:48 +00:00
2024-02-01 11:34:52 +00:00
return pricingRules;
}
2024-01-30 12:55:50 +00:00
export function filterPricingRules(
pricingRuleDocsForItem: PricingRule[],
sinvDate: Date,
quantity: number,
amount: Money
): PricingRule[] | [] {
const filteredPricingRules: PricingRule[] | undefined = [];
for (const pricingRuleDoc of pricingRuleDocsForItem) {
if (canApplyPricingRule(pricingRuleDoc, sinvDate, quantity, amount)) {
filteredPricingRules.push(pricingRuleDoc);
}
}
return filteredPricingRules;
}
export function canApplyPricingRule(
pricingRuleDoc: PricingRule,
sinvDate: Date,
quantity: number,
amount: Money
): boolean {
// Filter by Quantity
if (
(pricingRuleDoc.minQuantity as number) > 0 &&
quantity < (pricingRuleDoc.minQuantity as number)
) {
return false;
}
if (
(pricingRuleDoc.maxQuantity as number) > 0 &&
quantity > (pricingRuleDoc.maxQuantity as number)
) {
return false;
}
// Filter by Amount
if (
!pricingRuleDoc.minAmount?.isZero() &&
amount.lte(pricingRuleDoc.minAmount as Money)
) {
return false;
}
if (
!pricingRuleDoc.maxAmount?.isZero() &&
amount.gte(pricingRuleDoc.maxAmount as Money)
) {
return false;
}
// Filter by Validity
if (
pricingRuleDoc.validFrom &&
2024-08-19 07:30:25 +00:00
new Date(sinvDate.setHours(0, 0, 0, 0)).toISOString() <
pricingRuleDoc.validFrom.toISOString()
2024-01-30 12:55:50 +00:00
) {
return false;
}
2024-09-18 05:39:44 +00:00
2024-01-30 12:55:50 +00:00
if (
pricingRuleDoc.validTo &&
2024-08-19 07:30:25 +00:00
new Date(sinvDate.setHours(0, 0, 0, 0)).toISOString() >
pricingRuleDoc.validTo.toISOString()
2024-01-30 12:55:50 +00:00
) {
return false;
}
return true;
}
2024-09-11 10:41:16 +00:00
export function canApplyCouponCode(
couponCodeData: CouponCode,
amount: Money,
sinvDate: Date
): boolean {
// Filter by Amount
if (
!couponCodeData.minAmount?.isZero() &&
amount.lte(couponCodeData.minAmount as Money)
) {
return false;
}
if (
!couponCodeData.maxAmount?.isZero() &&
amount.gte(couponCodeData.maxAmount as Money)
) {
return false;
}
// Filter by Validity
if (
couponCodeData.validFrom &&
new Date(sinvDate.setHours(0, 0, 0, 0)).toISOString() <
couponCodeData.validFrom.toISOString()
) {
return false;
}
if (
couponCodeData.validTo &&
new Date(sinvDate.setHours(0, 0, 0, 0)).toISOString() >
couponCodeData.validTo.toISOString()
) {
return false;
}
return true;
}
export async function getApplicableCouponCodesName(
couponName: string,
sinvDoc: SalesInvoice
) {
const couponCodeDatas = (await sinvDoc.fyo.db.getAll(
ModelNameEnum.CouponCode,
{
fields: ['*'],
filters: {
name: couponName,
isEnabled: true,
},
}
)) as CouponCode[];
if (!couponCodeDatas || !couponCodeDatas.length) {
return [];
}
2024-10-08 06:54:48 +00:00
const applicablePricingRules = await getPricingRule(sinvDoc, couponName);
if (!applicablePricingRules?.length) {
return [];
}
return applicablePricingRules
?.filter(
(rule) => rule?.pricingRule?.name === couponCodeDatas[0].pricingRule
)
.map((rule) => ({
pricingRule: rule.pricingRule.name,
coupon: couponCodeDatas[0].name,
}));
}
2024-10-08 06:54:48 +00:00
export async function validateCouponCode(
doc: AppliedCouponCodes,
value: string,
sinvDoc?: SalesInvoice
) {
const coupon = await doc.fyo.db.getAll(ModelNameEnum.CouponCode, {
fields: [
'minAmount',
'maxAmount',
'pricingRule',
'validFrom',
'validTo',
'maximumUse',
'used',
'isEnabled',
],
filters: { name: value },
});
if (!coupon[0]?.isEnabled) {
throw new ValidationError(
'Coupon code cannot be applied as it is not enabled'
);
}
if ((coupon[0]?.maximumUse as number) <= (coupon[0]?.used as number)) {
throw new ValidationError(
'Coupon code has been used maximum number of times'
);
}
if (!doc.parentdoc) {
doc.parentdoc = sinvDoc;
}
const applicableCouponCodesNames = await getApplicableCouponCodesName(
value,
doc.parentdoc as SalesInvoice
);
if (!applicableCouponCodesNames?.length) {
throw new ValidationError(
t`Coupon ${value} is not applicable for applied items.`
);
}
const couponExist = doc.parentdoc?.coupons?.some(
(coupon) => coupon?.coupons === value
);
if (couponExist) {
throw new ValidationError(t`${value} already applied.`);
}
if (
(coupon[0].minAmount as Money).gte(doc.parentdoc?.grandTotal as Money) &&
!(coupon[0].minAmount as Money).isZero()
) {
throw new ValidationError(
t`The Grand Total must exceed ${
(coupon[0].minAmount as Money).float
} to apply the coupon ${value}.`
);
}
if (
(coupon[0].maxAmount as Money).lte(doc.parentdoc?.grandTotal as Money) &&
!(coupon[0].maxAmount as Money).isZero()
) {
throw new ValidationError(
t`The Grand Total must be less than ${
(coupon[0].maxAmount as Money).float
} to apply this coupon.`
);
}
if ((coupon[0].validFrom as Date) > (doc.parentdoc?.date as Date)) {
throw new ValidationError(
t`Valid From Date should be less than Valid To Date.`
);
}
if ((coupon[0].validTo as Date) < (doc.parentdoc?.date as Date)) {
throw new ValidationError(
t`Valid To Date should be greater than Valid From Date.`
);
}
}
export function removeFreeItems(sinvDoc: SalesInvoice) {
if (!sinvDoc || !sinvDoc.items) {
return;
}
if (!!sinvDoc.isPricingRuleApplied) {
return;
}
for (const item of sinvDoc.items) {
if (item.isFreeItem) {
sinvDoc.items = sinvDoc.items?.filter(
(invoiceItem) => invoiceItem.name !== item.name
);
}
}
}
export async function updatePricingRule(sinvDoc: SalesInvoice) {
const applicablePricingRuleNames = await getPricingRule(sinvDoc);
if (!applicablePricingRuleNames || !applicablePricingRuleNames.length) {
sinvDoc.pricingRuleDetail = undefined;
sinvDoc.isPricingRuleApplied = false;
removeFreeItems(sinvDoc);
return;
}
2024-10-22 10:28:26 +00:00
const appliedPricingRuleCount = sinvDoc?.items?.filter(
(val) => val.isFreeItem
).length;
2024-10-08 06:54:48 +00:00
setTimeout(() => {
(async () => {
if (appliedPricingRuleCount !== applicablePricingRuleNames?.length) {
await sinvDoc.appendPricingRuleDetail(applicablePricingRuleNames);
await sinvDoc.applyProductDiscount();
}
})();
}, 1);
}
2024-01-30 12:55:50 +00:00
export function getPricingRulesConflicts(
pricingRules: PricingRule[]
): undefined | boolean {
2024-01-30 12:55:50 +00:00
const pricingRuleDocs = Array.from(pricingRules);
const firstPricingRule = pricingRuleDocs.shift();
if (!firstPricingRule) {
return;
}
const conflictingPricingRuleNames: string[] = [];
for (const pricingRuleDoc of pricingRuleDocs.slice(0)) {
2024-02-01 11:34:52 +00:00
if (pricingRuleDoc.priority !== firstPricingRule?.priority) {
continue;
2024-01-30 12:55:50 +00:00
}
2024-02-01 11:34:52 +00:00
conflictingPricingRuleNames.push(pricingRuleDoc.name as string);
2024-01-30 12:55:50 +00:00
}
if (!conflictingPricingRuleNames.length) {
2024-02-01 11:34:52 +00:00
return;
2024-01-30 12:55:50 +00:00
}
return true;
2024-02-01 11:34:52 +00:00
}
export function roundFreeItemQty(
quantity: number,
roundingMethod: 'round' | 'floor' | 'ceil'
): number {
return Math[roundingMethod](quantity);
2024-01-30 12:55:50 +00:00
}