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

Scheme Account Budget — entity reference

A spend cap for a Scheme (schemeId), in currency. A row with neither partnerAccountId nor partnerAccountGroupId is the scheme-wide (global) budget; a row with one of them caps spend for that partner or partner group. Enforcement reads live SchemeLedger consumption (netSchemeDiscount2 sums), not the stored columns. Budget configuration also gates where discounts land: a Sale Invoice only carries a scheme discount when the scheme has BOTH a global and a partner-scoped budget (unless the scheme sets ignoreBudget); incomplete configurations still apply on the Sale Order, which is a projection stage rather than the consumption of record.

Fields

FieldLabelTypeRequiredWhat it does
BudgetAmountBudget AmountCurrency
BudgetAvailableBudget AvailableCalculated (calculated)Display-only remainder (budgetAmount minus utilization, clamped at zero) refreshed from live SchemeLedger consumption.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
IdIdGuidYes
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYes
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountGroupIdPartner Account GroupLookup → AccountGroup
PartnerAccountIdPartner AccountLookup → AccountScopes the budget to one partner account. A row with neither PartnerAccountId nor PartnerAccountGroupId is the scheme-wide global budget; the Sale Invoice both-tiers rule requires one global and one partner-scoped row to exist.
RecordTypeIdRecord TypeGuid, hidden
SchemeIdSchemeLookup → Scheme
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
UtilisedAmountUtilised AmountCalculated (calculated)
UtilizedAmountUtilized AmountCalculated (calculated)Display-only consumption figure recomputed from live SchemeLedger netSchemeDiscount2 sums scoped to this budget's partner account or group; enforcement reads the ledger directly.

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteListHeaderDeleteDeleteDeleteListHeader
DeleteListRowDeleteDeleteDeleteListRow
EditEditEditEdit
EditInLineEditEditInlineEditInLine
EditListHeaderEditEditInlineEditListHeader
EditListRowEditEditEditListRow
NewNewNewNew

Validations

ValidationApplies toError messageNotes
Available Budget Needs To Be PositiveErrorScheme Budget Exceeded!Ensures available budget is not negative unless the scheme ignores budget