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

Tax Group Rule — entity reference

Decides which TaxGroup a document line receives for its item — the Item entity itself carries no tax group, so this is the only mapping. A rule matches when its item, SKU and item lot type are each either equal to the line's or left blank, its TaxSupplyType equals the header's exactly (including both being empty), the parent group's partner account and branch fit the header, and the header's creation timestamp falls inside the effective-date window. It is the header's CreatedDateTime, not its document date, that is tested against the window.

Fields

FieldLabelTypeRequiredWhat it does
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DateEffectiveFromDate Effective FromDateTested against the parent document's CreatedDateTime — the record's creation timestamp, not its document date — so a back-dated document is matched by when it was entered, and a rule dated from today will apply to a document keyed today for last month.
DateEffectiveTillDate Effective TillDateEnd of validity, compared against the same document creation timestamp. Empty leaves the rule open-ended.
ExternalIdExternalText, unique
IdIdGuidYes
ItemGroupIdItem GroupLookup → ItemGroupBecause the item, SKU and lot-type tests all pass on a blank value, a rule scoped only by item group matches every line it is offered rather than only the group's items.
ItemIdItemLookup → ItemEmpty turns the rule into a catch-all that matches every line. Combined with ordering by the parent group's sequence alone, a stray blank-item rule in a high-sequence group is the usual cause of an unexpected tax group on a line.
ItemLotTypeIdItem Lot TypeLookup → ItemLotTypeOptional narrowing to one item lot type; empty matches any. Like SKU it filters but does not raise the rule's precedence.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameText, unique
OwnerIdOwnerLookup → UserAccountYes
PlaceOfSupplyTypePlaceOfSupplyTypeTextStored on the rule but read nowhere in the platform, so it narrows nothing; supply typing is done through TaxSupplyType alone.
RecordTypeIdRecord TypeGuid, hidden
ServiceContractItemIdService Contract ItemLookup → ItemNot consulted by the tax resolver, so it cannot be used to give service-contract lines a different tax group; such a rule behaves as an unscoped one.
SKUIdSKULookup → SKUOptional narrowing to one SKU; empty matches any SKU. It never promotes a rule in the ordering — only the parent group's sequence decides which matching rule wins.
TaxGroupIdTax GroupLookup → TaxGroupThe group the rule hands to the line: the winning rule's value is written straight into the line's TaxGroupId, and every tax component of that group is then applied.
TaxSupplyTypeTax Supply TypePickListCompared for exact equality with the header's supply type, empty included — a rule naming a supply type can never match a header that leaves it blank, and a rule that leaves it blank can never match a header that sets one. The seeded vocabulary is 'Within State' and 'Outside State'. Values: Within State, Outside State.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete
EditEditEditEdit
EditInLineEditEditInlineEdit
EditListHeaderEditEditInlineEditListHeader
EditListRowEditEditEditListRow
NewNewNewNew
NewInLineNewNewInlineNew

Validations

ValidationApplies toError messageNotes
Date Effective Till Rule ValidationDateEffectiveTill, ErrorDate Effective Till should not be BackdatedEnsures effective-till date is not on or before effective-from date

Lookup filters

FilterLookup fieldNotes
Sku For ItemSKUIdSKU For Item