xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField SalesCRMRewardsClaimsInventoryProcurementWarehouse 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
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/Budget Line — entity reference
REFERENCE · Last reviewed

Budget Line — entity reference

One budgeted amount for a GL account inside a Budget, optionally pinned to a fiscal period and to business unit, branch, cost-centre and partner dimensions. At most one line may exist per budget + GL account + fiscal period, and the amount must be greater than zero when entered; lines cannot be added or edited once the parent budget is Confirmed or Approved. Variance and forecast group lines by GL account and sum BudgetAmount, deriving the favourable/adverse sign from the account's Schedule III classification rather than from anything on the line; the budget income statement phases a line with no fiscal period evenly across the year's periods.

Fields

FieldLabelTypeRequiredWhat it does
BranchIdBranchLookup → BranchBranch dimension recorded on the line for reporting and for parity with the ledger's posting dimensions. No first-party budget service filters on it — variance scopes by the header's business unit and cost centre, and the availability gate by business unit only — so budgeting the same account by branch will not by itself produce branch-separated variance.
BudgetAmountBudget AmountCurrencyThe planned figure, validated to be strictly greater than zero when entered — enter it as a positive magnitude for both income and expense accounts. The favourable-versus-adverse direction is never taken from this value's sign; variance derives it from the account's Schedule III classification (credit-nature accounts are over budget when actual falls short, debit-nature when actual exceeds).
BudgetIdBudgetLookup → Budget
BusinessUnitIdBusiness UnitLookup → BusinessUnitLine-level business unit. It is the only line dimension the availability gate filters on: when a caller supplies a business unit, both the budget side (these lines) and the consumption side (period balances) are narrowed to it.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
FiscalPeriodIdFiscal PeriodLookup → FiscalPeriodOptional month/period this amount belongs to. Leave it null for an annual line: the budget income statement then spreads the amount evenly across the year's periods, whereas a period-stamped line lands wholly in that period's column. It is also part of the duplicate-line key, so the same GL account may appear once per period plus once more as an unphased annual line.
GLAccountIdGL AccountLookup → GLAccountThe account being budgeted — the grain of every downstream comparison.
IdIdGuidYes
ModifiedByIdModified ByLookup → UserAccountYes
NameGL Account NameText, uniqueYesThe platform record-name key for the line, carrying the display label 'GL Account Name'. It is a plain text key, not a link to the chart of accounts — the account is held in GLAccountId, and nothing in the budget services reads this column.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe owning company, duplicated onto the line. The availability gate matches lines on this column directly rather than walking up to the parent budget, so a line whose company does not match its budget's is skipped by the gate even though variance (which joins via BudgetId) still counts it.
RecordTypeIdRecord TypeGuid, hidden
UIPropsUI PropsText
UpdatedDateTimeUpdated OnDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete in a list page
EditEditEditEdit
EditListRowEditEditEditListRow
NewNewNewNew

Lookup filters

FilterLookup fieldNotes
GL Account FilterGLAccountId