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

GL Account — entity reference

An account in a company's chart of accounts: the target every journal line debits or credits and the unit every financial statement adds up. Each account belongs to one company through Partner Account. Its Account Type is what posting falls back to when no posting definition matches, its Schedule III Classification decides where its balance appears on the statements, Is Control Account makes a customer or supplier mandatory on every line, and Control Type lets withholding, payroll, expense and clearing postings find it. A chart is usually seeded from a chart template when finance is enabled for a company in Org Settings; ticking GL Posting Enabled on a company also adds a standard starter set marked Is System. See the GL accounts guide at /docs/finance/gl-accounts/ for procedures.

Fields

FieldLabelTypeRequiredWhat it does
AccountBalanceAccount BalanceCalculated (calculated)A legacy stored figure that nothing maintains — it is written as zero when the standard chart of accounts is seeded and is never updated by posting, reversal or rebuild. It is not a live balance; read balances from the GL period-balance rows or from the account-ledger and balance-statement actions.
AccountGroupIdAccount GroupLookup → AccountGroupAn optional grouping of accounts, shown on the create form's main tab and in the Applicability section of the record page.
AccountNumberAccount CodeTextYour chart's code for the account, up to 80 characters. Optional, but chart templates and Enable finance use it to recognise accounts the company already has, so keep codes stable once a template has been applied.
AccountTypeAccount TypePickListYesThe broad classification that drives account determination whenever no posting definition matches: the posting engine looks up an account of the required type for the company, preferring one whose default branch matches the document. Matching ignores spaces and folds several synonyms — tax receivable is treated as tax credit, tax payable and GST payable as other current liability, service and other income as sales, purchases as cost of goods sold, and rent, salary and administrative expense all as expense — so those types cannot be targeted separately by type-based resolution. It is also the fallback for statutory statement classification when no explicit classification is set. Values: Fixed Asset, Accounts Payable, Salaries and Employee Wages, Accounts Receivable, Service Income, Long Term Liability, Rent Expense, Opening Balance Equity, Purchases, Current Assets, Non Current Assets, Other Assets, Tax Credit, Current Liability, Credit Card, Other Liability, Tax Payable, Equity, Income, Inventory, Expense, Retained Earnings, Other Income, Bank, Accumulated Depreciation, Cost Of Goods Sold, Billed Inventory, Unbilled Dispatch, Unbilled Receipt, Sales, Other Current Liability, Other Current Asset, Depreciation Expense, Cash, General and Administrative Expense, Provision.
BranchIdBranchLookup → BranchThe account's default branch, not a restriction: transactions and journal lines that reference this account and leave their own branch empty inherit this value. Type-based account determination also prefers an account whose default branch matches the document's branch over one with no branch at all.
BusinessUnitIdDefault Business UnitLookup → BusinessUnitThe account's default business unit, applied to a journal line only as the last resort — after the line, the journal header and the line's branch have all failed to supply one. That ordering is deliberate: the branch is the system of record for which unit a location rolls into, so letting the account default win first would persist branch and unit pairings that exist nowhere in master data.
ControlTypeControl TypePickListNames which control the account is, so features can find it: withholding tax, payroll payment and posting, statutory challans, expense claims and advances, company cards and inter-business-unit clearing each look up the company's account of a given control type and stop with a message naming it when none exists. The lookup is an exact match on the stored value, which for multi-word controls has no spaces (AccountsReceivable, AccountsPayable, TdsPayable, TdsReceivable, TcsPayable, PayrollPayable and so on), as written by the chart templates. A multi-word value chosen from this list is stored with spaces and is not recognised by those lookups; single-word values such as Bank and Inventory match either way. Keep exactly one account per control type per company. Values: Payroll Payable, PF Payable, Tax Credit, Accounts Payable, Accounts Receivable, TDS Payable, Gratuity Provision, Tax Payable, TCS Payable, Professional Tax Payable, Bank, ESI Payable, Credit Card Payable, Inventory, TDS Salary Payable, Employee Loan, LWF Payable, Employee Advance, Employee Payable, Interest Expense.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CurrencyCurrencyPickList
DescriptionDescriptionMultiLineTextA free-text note on what the account is for. Advisory only: nothing in posting, statement or balance resolution reads it.
DisclosureNoteGroupDisclosure Note GroupTextGroups accounts under a common note in the published statements, used by the statutory return builders to identify sets of accounts — reserve accounts for the deposits return, for example — that cannot be told apart by classification alone.
GLAccountIdGL AccountLookup → GLAccount
IdIdGuidYes
IsActiveIs ActiveBooleanPosting hard-fails on any journal line whose account is explicitly inactive, with a message pointing at the posting definition or the line. Accounts with no value set are treated as usable, so deactivation is an opt-in block rather than a default.
IsControlAccountIs Control AccountBooleanMarks the account as a party subledger control: once set, posting refuses any journal line on this account that does not carry a party, and each posted line also maintains a per-party balance row. Employee-facing and tax-authority controls are deliberately left unflagged because their counterparty is not a customer or supplier account.
IsSystemIs SystemBooleanMarks the standard starter accounts added when GL Posting Enabled is ticked on a company: cash, bank, receivables, payables, inventory, tax, equity, income, cost of sales and expense accounts, each named after the company and given a four-digit code. Accounts seeded from a chart template by Enable finance are not flagged. It records where the account came from; it does not lock the account against editing.
ItemGroupIdItem GroupLookup → ItemGroupAn item group linked to the account, shown in the Applicability section of the record page.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameText, uniqueYesThe account's name as shown in lookups, ledgers and statements. Required. The inactive-account posting error quotes it.
OwnerIdOwnerLookup → UserAccountYes
ParentIdParent GL AccountLookup → GLAccountPoints at the parent account, letting the chart form a hierarchy that statement generators roll balances up through. It is a reporting hierarchy only — posting always happens against the specific account named on the line, never against a parent.
PartnerAccountIdPartner AccountLookup → AccountYesThe company (legal entity) that owns this account, following the finance convention that the partner account is the company rather than a trading counterparty. Chart-of-accounts lookups, control-account lookups and the account-ledger action are all scoped by it, and an account with no company cannot be resolved by type-based account determination.
PostingTypePosting TypePickListA broad asset/liability/income/expense grouping kept for classification and display. The posting engine does not consult it: account determination works from account type and posting definitions, and statutory statement placement works from the statutory classification, so changing this value does not change where anything posts. Values: Asset, Equity, Expense, Cost of Goods Sold, Income, Liability.
RecordTypeIdRecord TypeGuid, hidden
ScheduleIIIClassificationSchedule III ClassificationPickListThe statutory statement node the account's balance aggregates into. When blank the statement builders fall back to deriving a classification from the account type, so an explicit value here is an override used to place an account that the type-based derivation would put in the wrong section. Values: Finance Costs, Property, Plant and Equipment, Short-term Borrowings, Other Current Liabilities, Long-term Borrowings, Trade Payables, Short-term Loans and Advances, Inventories, Deferred Tax Liabilities (Net), Non-current Investments, Cost of Materials Consumed, Other Non-current Assets, Other Income, Reserves and Surplus, Deferred Tax Assets (Net), Short-term Provisions, Intangible Assets, Long-term Loans and Advances, Share Capital, Other Current Assets, Revenue from Operations, Employee Benefits Expense, Changes in Inventories, Current Investments, Depreciation and Amortisation, Trade Receivables, Long-term Provisions, Other Expenses, Tax Expense, Cash and Cash Equivalents, Other Long-term Liabilities, Purchases of Stock-in-Trade.
SubtypeSub TypePickListThe tax component the account holds. Shown on the form only when Account Type is Tax Payable, Tax Credit or Other Current Liability. When set, a tax amount of that component posts to this account and the component is carried onto the journal line so statements can split the figure; when blank, nothing changes. Values: CGST, SGST, IGST, UTGST, Cess, VAT, TDS, TCS.
TaxTypeTax TypePickListValues: CGST, IGST, UTGST, Cess.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete in list page
EditEntityEditEditEdit
EditInLineEditEditInlineEdit in page
EditInListEditEditEdit
GetGLAccountBalancesGL Account Balances (as-on)ServerAction (GetGLAccountBalances)Company-wide account balances are now served by the GetGLAccountStatement action, which returns signed balances per requested column either point-in-time or as an opening/change/closing movement window; that is what the web and mobile balance-statement widgets call. Invoking this name will not produce balances.
GetGLAccountBalancesMatrixGL Account Balances (by dimension)ServerAction (GetGLAccountBalancesMatrix)GL account balances pivoted into columns by branch / business unit / GSTIN / cost centre / period (Balance Statement comparative).
GetGLAccountLedgerGL Account LedgerServerAction (GetGLAccountLedger)Returns the transaction ledger for one GL account: the opening balance as at the from-date, the posted journal lines in the window with a running balance, and the closing balance. It is date-driven rather than period-driven, and accepts optional filters for party (to narrow a control account to a single customer or supplier), branch, business unit, GST registration and cost centre. The account must belong to a company, and the amounts come from the posted ledger, not from the balance cache.
GetGLAccountStatementGL Account StatementServerAction (GetGLAccountStatement)Signed GL balances per column (point-in-time or Opening/Change/Closing movement) for the Balance Statement.
NewNewNewNew

Lookup filters

FilterLookup fieldNotes
Branch For Partner AccountBranchId
Partner Account FilterPartnerAccountId