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

Budget — entity reference

A budget is the plan for one company's fiscal year, optionally for one business unit, written as an amount per GL account on its Budget Line children. It is maintained in the Finance Setup app under Planning and read on the Budget vs Actual screen (Financials app, Analysis & Planning), which shows the budget as an income statement beside the posted actuals for the same fiscal year, with Variance and Variance %, or as budget-only and monthly layouts. Only one active budget may exist per company, business unit and fiscal year. A budget whose Status is Confirmed is locked: only Status may change, and its lines cannot be added or edited. A budget is a comparison baseline only. It posts nothing, reserves nothing and blocks no transaction.

Fields

FieldLabelTypeRequiredWhat it does
BusinessUnitIdBusiness UnitLookup → BusinessUnitOptional division for the whole budget. Part of the one-active-budget scope (an empty business unit is its own scope), and when set the Actual column of Budget vs Actual counts only postings carrying this unit.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
FiscalYearIdFiscal YearLookup → FiscalYearThe fiscal year the plan covers. Not required by the form, but the Budget vs Actual screen lists budgets by fiscal year, and the one-active-budget check only runs once it is set, so a budget without one is effectively unusable.
IdIdGuidYes
IsActiveIs ActiveBooleanOn for new budgets. Only active budgets block a second budget for the same company, business unit and fiscal year, so turning it off retires a superseded plan without deleting it. Turning it back on is not re-checked against other active budgets. It cannot change while the budget is Confirmed.
LabelLabelTextOptional display name. When filled in, the Budget vs Actual screen lists the budget by this label instead of its Name.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameText, uniqueYesThe budget's name, typed by the user because budgets have no automatic numbering. Required and unique across all budgets. Shown in the Budget vs Actual picker only when Label is empty.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe company (legal entity) whose plan this is, not a customer or supplier. Part of the one-active-budget scope, and the company whose chart of accounts Budget vs Actual reads. Hidden on tenants that run a single company, where the fiscal year's company is used.
PlannedAmountPlanned AmountCalculated (calculated)Read-only total of the lines' Budget Amount, recalculated whenever the budget or one of its lines is saved. It adds income and expense lines together, so it is a size check rather than a profit figure.
RecordTypeIdRecord TypeGuid, hidden
StatusStatusPickListDraft while the plan is being built. Confirmed locks the budget: any save that changes a field other than Status is refused, and its lines cannot be added or edited (they can still be deleted). Set it back to Draft on its own to revise. Cancelled is a label only and does not hide the budget. An Approved value, never set by the system, would lock it too. Values: Draft, Cancelled, Confirmed.
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
EditInlineEdit InlineEditInlineEdit
EditListRowEditEditEditListRow
NewNewNewNew