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

Tax Group — entity reference

A named set of tax components (its Taxes, such as CGST 9% and SGST 9%) that is applied together to a document line, plus the Tax Group Rules that decide which lines get it. When a line is added to an order, invoice, quote, opportunity, delivery order, credit note, service order, purchase order, requisition or bill, the platform looks at every active tax group whose Partner Account, Branch and Partner Account Group are empty or fit the document, collects their rules, sorts them by the group's Sequence Number (highest first) and writes the first matching rule's group onto the line. Every tax of that group is then calculated on the line's taxable value and stored in the line's tax slots. Rule specificity never counts: only the sequence decides between matching rules. Sequence Number is on no seeded form, so unless an administrator adds it every group has 0 and the winner among matching rules is not predictable. Groups live in the Sales and Procurement settings apps (Pricing & Tax), the Tax Center app and the tax settings app (GST Setup).

Fields

FieldLabelTypeRequiredWhat it does
BranchIdBranchLookup → BranchLimits the group to documents raised in that branch. Empty means every branch. The list shows the branches of the chosen Partner Account. Hidden on tenants that run a single location.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DescriptionDescriptionTextFree text for administrators. Not used in any calculation.
ExternalIdExternalTextIdentifier of the group in an external system, for imports and integrations.
IdIdGuidYes
IsActiveActiveBooleanOnly active groups are considered when a line's tax group is chosen automatically. A new group is inactive until this is turned on. Turning it off retires all the group's rules at once, but lines that already carry the group keep it, and a user can still pick an inactive group on a line by hand.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameText, uniqueThe group's name, shown in every Tax Group field on documents and lines. Must be unique across the tenant; a duplicate is refused with a message that the name already exists.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountGroupIdPartner Account GroupLookup → AccountGroupLimits the group to documents whose Partner Account is an active member of this account group. Only account groups of type Tax count; a group of any other type matches no document.
PartnerAccountIdPartner AccountLookup → AccountLimits the group to documents of that company (the document's Partner Account). Empty means every company. Hidden on tenants that run a single company.
RecordTypeIdRecord TypeGuid, hidden
SequenceNumberSequence NumberNumberDecides which rule wins when rules in several groups match the same line: rules of the group with the highest sequence are tried first. It is the only tie-breaker, so a catch-all rule in a high-sequence group beats an item-specific rule in a lower one. Defaults to 0 and is not on the seeded Tax Group forms; an administrator must add it to the layout to set it.
TaxApplicabilityTax ApplicabilityPickListApply All Taxes or Apply Any Tax. Stored for reference only: every tax in the group is always applied, whatever this says. Values: Apply All Taxes, Apply Any Tax.
TaxCustomLogicTax Custom LogicTextStored text with no effect on any calculation.
TaxGroupTypeTax Group TypePickListDocument Level or Line Level. Its only effect is a validation on the group's taxes: in a Document Level group every tax must use Posting Field Name Tax1. Which way a group is used is decided by the field that points at it (a line's Tax Group or a document header's Tax Group), not by this value. Values: Document Level, Line Level.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

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

Lookup filters

FilterLookup fieldNotes
Branch for Partner AccountBranchId
Partner AccountPartnerAccountId