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

Tax Group Rule — entity reference

One rule that hands its tax group to matching document lines, added on the tax group's Taxes tab and numbered in the TGI series. A rule matches a line when its Item, SKU and Item Lot Type are empty or equal to the line's, its Item Group is empty or contains the line's item, its Tax Supply Type equals the document's exactly (empty matches only empty), and the document's creation time falls between Date Effective From and Date Effective Till. Rules are tried in order of their group's Sequence Number, highest first, and the first match wins; within one sequence the order is not defined. Rules are applied when a line is added, not when an existing line is edited.

Fields

FieldLabelTypeRequiredWhat it does
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DateEffectiveFromDate Effective FromDateFirst moment the rule applies. Compared with when the document was created, not with its document date.
DateEffectiveTillDate Effective TillDateLast moment the rule applies, compared with the document's creation time. Empty means no end. Must be later than Date Effective From, otherwise the save is refused with 'Date Effective Till should not be Backdated'.
ExternalIdExternalText, unique
IdIdGuidYes
ItemGroupIdItem GroupLookup → ItemGroupLimits the rule to items that are members of this item group. Any item group type works; members whose Is Active is turned off are skipped. The field app's offline preview does not apply it, and the server recalculates when the order syncs.
ItemIdItemLookup → ItemLimits the rule to one item. Empty matches every item, which makes the rule a catch-all for its group.
ItemLotTypeIdItem Lot TypeLookup → ItemLotTypeLimits the rule to lines with this item lot type. Empty matches any lot type.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameText, uniqueRule number, given automatically from the TGI series.
OwnerIdOwnerLookup → UserAccountYes
PlaceOfSupplyTypePlaceOfSupplyTypeTextStored only and not on any form. Supply typing is done through Tax Supply Type.
RecordTypeIdRecord TypeGuid, hidden
ServiceContractItemIdService Contract ItemLookup → ItemStored only. It does not limit the rule, so a rule that sets only this field behaves like a catch-all.
SKUIdSKULookup → SKULimits the rule to one SKU of the item. Empty matches any SKU. The list shows the chosen item's SKUs.
TaxGroupIdTax GroupLookup → TaxGroupThe group this rule hands to a matching line. Set automatically when the rule is added from the group's Taxes tab.
TaxSupplyTypeTax Supply TypePickListMust equal the document's Tax Supply Type exactly. On India tenants documents are stamped Within State, Outside State, Export, SEZ or Exempt; the seeded list here offers only Within State and Outside State, so add Export or SEZ to the list if you need rules for those. An empty value matches only documents with an empty supply type. Exempt documents never take a tax group, except a reverse-charge bill. 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