xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Interest Policy — entity reference
REFERENCE · Last reviewed

Interest Policy — entity reference

The terms for interest on overdue payments: rate, method, principal basis, day count, grace and tolerance, minimum and maximum charge, GST and posting accounts, and who the terms apply to. Interest runs read the policies when they compute: for each overdue item the most specific active policy wins (party and company, then party, then company, then everyone), with the higher Priority and then the later Effective From breaking ties. Policies are kept in Finance Setup under Overdue Interest.

Fields

FieldLabelTypeRequiredWhat it does
AppliesToDirectionApplies To DirectionPickListReceivable (customers who pay you late) or Payable (suppliers you pay late). Blank means both directions. A run considers only policies that match its own direction or are blank. Direction does not count towards specificity, so a blank-direction policy for a party still beats a company-wide Receivable policy. Values: Receivable, Payable.
BasisBasisPickListThe principal the rate is applied to. Outstanding Balance (the default when blank) replays each payment, so part-payments stop earning interest on the day they are allocated. Original Amount uses the document's full amount. Current Open Amount uses the item's open amount at the time of the run for every overdue day, so after a part-payment the next run can charge nothing. Interest always stops on the day the item is fully paid. Values: Outstanding Balance, Original Amount, Current Open Amount.
ChargeOnSettledItemsCharge On Settled ItemsBooleanWhen on (the default, and when blank), an item that has since been paid still owes interest for the days it was late, up to the day before it was cleared. Switch it off to skip fully settled items altogether.
CompoundingFrequencyCompounding FrequencyPickListMonthly, Quarterly, Half Yearly or Yearly. Used only when Method is Compound. Blank is read as Monthly. Values: Monthly, Quarterly, Half Yearly, Yearly.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DayCountDay CountPickListDays-in-year convention: Actual/365 (the default when blank), Actual/360, Actual/366, Actual/Actual (365 or 366 for each calendar year) or 30E/360 (every month counts as 30 days and the year as 360). Values: Actual/365, Actual/360, Actual/366, Actual/Actual, 30E/360.
DescriptionDescriptionLongMultiLineTextFree text for the contract clause or the reason for the terms. Not read by the calculation.
EffectiveFromEffective FromDateFirst date the policy can apply. Compared with the run's As Of Date only: the policy in force on that date prices the item's whole overdue history, not just the new days. Blank means no start limit.
EffectiveToEffective ToDateLast date the policy can apply, compared with the run's As Of Date. Blank means open-ended. Cannot be earlier than Effective From.
GraceDaysGrace DaysNumberDays after the due date before interest starts. The first chargeable day is the due date plus grace plus one, and grace days are never charged. Cannot be negative.
GstRatePercentGST Rate %PercentMust be greater than zero when GST Applicable is on, or the policy cannot be saved. The calculation does not use it: the GST on interest always follows the original invoice's own rates.
IdIdGuid, hiddenYes
InterestGLAccountIdInterest GL AccountLookup → GLAccountAccount for the interest: income for a receivable policy, expense for a payable one. Used as chosen when set. When blank, posting looks for an account of the charge's company marked with the interest-income (or interest-expense) control type, then for an account of type Other Income (or General and Administrative Expense). Read when the run posts, so changing it affects draft charges too.
IsActiveIs ActiveBooleanOnly active policies are considered. A policy whose switch is off or blank is ignored by every run. Switch it off rather than deleting a policy that charges have used.
IsGstApplicableGST ApplicableBooleanCharge GST on the interest. The tax rates and HSN/SAC come from the tax recorded on the original invoice, never from this policy. Items with no recorded invoice tax, which includes supplier bills and debit notes raised by hand, are skipped as GST cannot be determined.
LabelLabelTextOptional descriptive title shown in the policy list.
MaximumChargePercentOfPrincipalMaximum Charge % of PrincipalPercentCeiling on the total interest one item can ever bear, as a percentage of the item's original amount. Blank means no cap; zero or less is refused. When the cap cuts a charge, the charge records the uncapped figure in Capped Amount, and once the cap is reached later runs charge nothing more.
MethodMethodPickListSimple or Compound. Compound adds the interest to the principal at each Compounding Frequency rest, counted from the item's first chargeable day, so how often runs happen does not change the result. Blank is read as Simple. Values: Simple, Compound.
MinimumChargeAmountMinimum Charge AmountCurrencyFloor for one charge, before tax. When the interest for a window is below it, no charge is raised and the days are not used up, so the amount keeps building and a later run charges it. Cannot be negative.
MinimumDaysOverdueMinimum Days OverdueNumberExtra tolerance counted after grace: nothing is charged until the item is more than grace plus this many days past due. Once crossed, interest is charged back to the first day after grace. Cannot be negative.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesYour name for the policy. Required. It is also the last tie-breaker when two policies have the same scope, priority and start date.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdCompanyLookup → AccountYour own company (legal entity) the terms belong to, not the customer. Only company accounts can be picked. Blank means every company. A run scoped to one company considers only that company's policies and the everyone policies.
PartyAccountIdPartyLookup → AccountThe one customer or supplier these terms were negotiated for. Blank means every party. A party policy beats any company-wide or everyone policy for that party's items. It cannot be the same account as the Company.
PriorityPriorityNumberTie-breaker between policies with the same scope (party and company, party, company or everyone). The higher number wins; blank counts as 0. It never lets a wider policy beat a narrower one.
RatePercentRate %PercentThe rate as the contract quotes it, as a whole-number percentage for the Rate Period: 2 with Per Month is 2% a month, 18 with Per Annum is 18% a year. Must be greater than zero, and a monthly rate above 100 is refused as a likely typing error.
RatePeriodRate PeriodPickListPer Annum, Per Month or Per Day: the period the Rate % is quoted for. Every rate is converted to a yearly rate before the calculation, so 2% Per Month and 24% Per Annum charge the same. Blank is read as Per Annum. Values: Per Annum, Per Month, Per Day.
RecordTypeIdRecord TypeGuid, hidden
SubscriptionKeySubscription KeyGuid, hiddenYes
TaxGLAccountIdTax GL AccountLookup → GLAccountAccount for the GST on interest. Used as chosen when set. When blank, posting looks for a company account marked tax payable (or tax credit for payable), then one of type Other Current Liability (or Tax Credit). Only read when a charge carries tax.
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
DeleteDeleteDeleteDelete Interest Policy
EditEditEditEdit Interest Policy
EditInLineEditEditInlineEdit Interest Policy
NewNewNewNew Interest Policy

Lookup filters

FilterLookup fieldNotes
CompanyPartnerAccountId
PartyAccountPartyAccountId