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/Party Period Balance — entity reference
REFERENCE · Last reviewed

Party Period Balance — entity reference

The stored total of posted journal lines for one customer or supplier under one control account (such as receivables or payables) in one fiscal period and business unit. Posting adds every line that posts to an account marked as a control account and names a party; lines on other accounts never create these rows. Rebuild Balances on the fiscal period recalculates them, and Verify Ledger compares them with the posted journals. Customer and supplier ledgers, ageing and statements are worked out from the journal lines and open items, not from these rows. Creating, editing, cloning or deleting a row from a screen, an import or the data API is refused. The record is in no app; rows are named PPB- followed by a random code.

Fields

FieldLabelTypeRequiredWhat it does
BusinessUnitIdBusiness UnitLookup → BusinessUnitBusiness unit of the posted lines this row totals. Unlike GL period balances, party rows are not split by branch, GST registration or cost centre; the record page does not show this field.
ClosingBalanceClosing BalanceCurrencyOpening Balance plus Period Debit minus Period Credit, rounded to two decimals. Because the opening is 0, it is the period's net movement for the party (for receivables, invoiced less received in the period), not the total the party owes.
ControlGLAccountIdControlGL AccountLookup → GLAccountThe control account the party's lines were posted to, such as trade receivables or trade payables.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
FiscalPeriodIdFiscal PeriodLookup → FiscalPeriodThe fiscal period the totals belong to: the period of the journal.
GLAccountNameNameText, uniqueYesNot stored. A value typed here is not saved.
IdIdGuidYes
ModifiedByIdModified ByLookup → UserAccountYes
OpeningBalanceOpening BalanceCurrencyAlways 0 for rows created by posting or by Rebuild Balances, and Rebuild Balances keeps whatever is stored. It is not the party's balance brought forward.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe company of the journal that first created the row. It is not one of the values that decide which row a line is added to. Rows recreated by Rebuild Balances leave it blank.
PartyAccountIdParty AccountLookup → AccountThe customer or supplier whose posted movement this row totals, taken from the journal line's party.
PeriodCreditPeriod CreditCurrencyTotal of the credit amounts posted for this party, control account and business unit in the period. Verify Ledger reports a difference from the posted journals as party balance drift.
PeriodDebitPeriod DebitCurrencyTotal of the debit amounts posted for this party, control account and business unit in the period.
RecordTypeIdRecord TypeGuid, hidden
UIPropsUI PropsText
UpdatedDateTimeUpdated OnDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteAlways fails. The platform rejects direct deletion of derived subledger balances; use the rebuild-ledger-balances action on the fiscal period to resync them with the posted ledger.
DeleteEntityDeleteDeleteDeleteEntity
DeleteRowDeleteDeleteDeleteRow
EditEntityEditEditAlways fails. The row is a projection of the ledger, and hand-editing it would break the invariant that party balances under a control account sum to that account's GL period balance. Post or reverse a journal, or rebuild the period.
EditRowEditEditEditRow
NewNewNewAlways fails. Subledger balances are derived from posted control-account journal lines and may only be written by the posting and rebuild services; post a journal against the control account with a party to create the row.