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 Charge — entity reference
REFERENCE · Last reviewed

Interest Charge — entity reference

Interest charged on one overdue open item for one accrual window, with the full calculation behind the amount. Charges are created only by Compute Interest on an interest run (one per chargeable item), reviewed as Draft, and posted by Post Interest on the run: a receivable charge raises a customer debit note, a payable charge writes a journal and a supplier open item. The charges are listed in Finance Setup under Overdue Interest.

Fields

FieldLabelTypeRequiredWhat it does
AnnualRatePercentAnnual Rate % p.a.PercentThe policy's rate converted to per annum: a 2% per month policy shows 24 here.
BranchIdBranchLookup → BranchBranch of the overdue item, copied so the posted entries keep it.
BusinessUnitIdBusiness UnitLookup → BusinessUnitBusiness unit of the overdue item, copied so the posted entries keep it.
CalculationNoteCalculation NoteLongMultiLineTextThe calculation in words (principal, annual rate, days and denominator, method and day count, and the result), written at compute time. It also becomes the narration of the posted debit note or journal. Use it to check a charge by hand.
CappedAmountCapped AmountCurrencyFilled only when the policy's Maximum Charge % of Principal cut this charge down. Empty means the cap did not apply.
ChargedDaysCharged DaysNumberDays billed in this window, counting both ends.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CumulativeInterestAmountCumulative InterestCurrencyTotal interest earned on the item from its first chargeable day to Period To. On the item's latest charge it equals the sum of Interest Amount over all of the item's charges except cancelled ones.
DayCountDay CountPickListThe day-count convention copied from the policy at compute time: Actual/365, Actual/360, Actual/366, Actual/Actual or 30E/360. Values: Actual/365, Actual/360, Actual/366, Actual/Actual, 30E/360.
DayCountDenominatorDay Count DenominatorNumberThe days-in-year figure the calculation divided by, for example 365 or 360.
DebitNoteIdDebit NoteLookup → DebitNoteThe customer debit note that posting a receivable charge raised: created already approved, posted at once, dated on the run's As Of Date and linked to the original invoice when that invoice still exists. Its posting creates the journal and the receivable open item.
DirectionDirectionPickListReceivable (interest a customer owes you) or Payable (interest on your own overdue supplier items), copied from the open item. Values: Receivable, Payable.
DocumentNumberDocument NumberTextNumber of the overdue document, copied from the open item so the charge reads on its own.
DueDateDue DateDateDue date of the overdue item, or its document date when it has no due date. Interest starts the day after this date plus the policy's grace days.
GSTRegistrationIdGST RegistrationLookup → GSTRegistrationGST registration of the overdue item, copied to the debit note or journal.
IdIdGuid, hiddenYes
InterestAmountInterest AmountCurrencyInterest billed by this window, before tax. The system works out the item's total interest since its first chargeable day and bills the part not already taken by earlier Draft, Posted or Waived charges. Posting uses this stored amount.
InterestOpenTransactionIdInterest Open ItemLookup → OpenTransactionThe supplier open item a posted payable charge raised, due on the run's As Of Date. Empty for receivable charges, whose open item belongs to the debit note.
InterestPolicyIdInterest PolicyLookup → InterestPolicyThe interest policy that governed this item when the charge was computed: the most specific active, in-date policy for the item's party and company. Posting takes the interest and tax accounts from it.
InterestRunIdInterest RunLookup → InterestRunThe run whose Compute Interest created this charge. Posting, cancelling and recomputing all act on a run's charges, never on a charge alone.
JournalIdJournalLookup → JournalThe journal a posted payable charge wrote directly (interest expense debited, the payable account credited). Empty for receivable charges, whose journal belongs to the debit note.
LabelLabelTextReadable title of the form 'Interest on <document number> (<from>..<to>)'. It is copied to the debit note's label when the charge posts, which is the easiest way to find the note.
MethodMethodPickListSimple or Compound, copied from the policy at compute time. Values: Simple, Compound.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesSystem-built identifier of the form INT-<document number>-<short item key>-<window end yyyyMMdd>, so two items with the same document number never share a name.
OpenTransactionIdOpen ItemLookup → OpenTransactionThe overdue open item (usually a posted invoice) that the interest is charged on. Not the same as Interest Open Item, which is the item a posted payable charge raised.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdCompanyLookup → AccountCompany of the overdue item. Posting looks for the company's interest income and tax accounts when the policy names none.
PartyAccountIdPartyLookup → AccountThe customer or supplier the overdue item belongs to, and who the debit note or open item is raised against.
PeriodFromPeriod FromDateFirst day charged in this window: the item's first chargeable day (due date plus grace days plus one), or the day after the end of the item's previous Draft, Posted or Waived charge.
PeriodToPeriod ToDateLast day charged, inclusive. Usually the run's As Of Date; earlier when the item was fully paid before it, because interest stops the day before the day it is cleared. The next run for the item starts the following day.
PrincipalAmountPrincipal AmountCurrencyThe amount the rate was applied to. On the Outstanding Balance basis it is the time-weighted average balance over the window (Weighted Principal-Days divided by the days), not the balance on any single day.
RecordTypeIdRecord TypeGuid, hidden
ReviewReasonReview ReasonLongMultiLineTextExplains why review is needed, naming how the interest was split across the invoice's rates.
ReviewRequiredReview RequiredBooleanTicked when GST on the interest was split across an invoice that mixes taxable and exempt lines, so a person should confirm the split before posting. It does not stop posting.
SourceEntityNameSource Entity NameTextThe kind of document behind the charged open item, for example Invoice. Only an invoice-sourced charge links its debit note to the original invoice.
SourceRecordIdSource RecordGuidInternal identifier of the document behind the charged open item.
StatusStatusPickListDraft (computed, waiting to post), Posted (in the ledger), Waived (forgiven; its days stay used and are never charged again) or Cancelled (its run was cancelled; its days are released for a later run). Set only by the actions. Recomputing a run removes its Draft charges and builds new ones. Reversed is never set by the system. Values: Draft, Posted, Waived, Cancelled, Reversed.
SubscriptionKeySubscription KeyGuid, hiddenYes
TaxAmountTax AmountCurrencyGST on the interest, apportioned from the original invoice's recorded tax. Empty when GST does not apply. Posting refuses the charge if the invoice's tax has changed since compute.
TaxRatePercentTax Rate %PercentBlended GST rate on the interest, for information only. It is empty when the policy does not apply GST. The rate and HSN/SAC of each part are on the debit note's lines, taken from the original invoice's recorded tax.
TotalAmountTotal AmountCurrencyInterest plus tax: what the party owes for this window, and the amount of the debit note (or payable open item) raised when the charge posts.
TotalOverdueDaysTotal Overdue DaysNumberDays the item was past its due date on the run's As Of Date, for information only. It includes grace days and days already billed by earlier charges, so it is usually larger than Charged Days.
UpdatedDateTimeModified DateDateAndTimeYes
WaiveReasonWaive ReasonLongMultiLineTextFilled with 'Waived' when Waive Charge is used. The button asks for no reason, so edit this field afterwards to record why.
WeightedPrincipalDaysWeighted Principal-DaysDecimalSum of balance times days over the window. Each part-payment lowers the balance from the day it was allocated, so this shows exactly how payments reduced the interest.

Actions

ActionLabelTypeWhat it does
DeleteDeleteDeleteDelete Interest Charge
EditEditEditEdit Interest Charge
EditInLineEditEditInlineEdit Interest Charge
NewNewNewNew Interest Charge
WaiveInterestChargeWaive ChargeServerAction (WaiveInterestCharge)Forgives this draft charge. The accrual window stays consumed — the days are forgiven, not deferred to the next run.