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

Tax — entity reference

One tax component of a tax group, such as CGST 9%, added on the group's Taxes tab; taxes have no menu entry of their own. When a line carries the group, every tax of the group is calculated as the line's taxable value (quantity net of cancellations times price, less line discounts unless the customer takes discounts after tax) times the rate, written into the line slot named by Posting Field Name, and added to the line's Tax Amount. Changing a tax does not recalculate lines already saved; a line is recalculated when its tax group, item, SKU, amount or quantity changes. Expense voucher lines use the group differently: they ignore the slot, skip TCS taxes and taxes with a zero rate, and split the line's tax across the rest in proportion to their rates.

Fields

FieldLabelTypeRequiredWhat it does
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
ExternalIdExternalTextIdentifier of the tax in an external system, for imports and integrations.
IdIdGuidYes
LastModifiedByIdLastModifiedByGuid
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextRequired; taxes are not numbered automatically. Shown on lines and printouts as the tax's name. GST returns classify each slot by this name: it must contain CGST, SGST (or UTGST), IGST or CESS for the amount to land in the right GST column.
OwnerIdOwnerLookup → UserAccountYes
PostingFieldNamePosting Field NamePickListWhich of the line's six tax slots (Tax1 to Tax6) holds this tax. Give each tax in a group its own slot: two taxes on the same slot overwrite each other on the line but are both added to Tax Amount. A tax with no slot is added to Tax Amount but is not stored in a slot, so it is not posted or reported. In a Document Level group the slot must be Tax1. Values: Tax1, Tax2, Tax3, Tax4, Tax5, Tax6.
RateRatePercentThe percentage, entered as a number such as 9 for 9%. Applied to the line's taxable value.
RecordTypeIdRecord TypeGuid, hidden
TaxGroupIdTax GroupLookup → TaxGroupThe group this tax belongs to. Set automatically when the tax is added from the group's Taxes tab.
TaxNameTaxNameTextStored only and not on any form; lines take the name from Name.
TypeTax TypePickListTax Type: CGST, IGST, SGST, TCS or TDS. Copied to the line slot and used by finance posting to choose the tax GL account. A slot with no tax type is skipped when the document's journal is booked. Values: SGST, TCS, TDS, CGST, IGST.
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
EditListHeaderEditEditInlineEditListHeader
EditListRowEditEditEditListRow
NewNewNewNew
NewQAPNewNewInlineNew

Validations

ValidationApplies toError messageNotes
Posting Field ValidationErrorPosting Field Name must be 'Tax1' when Tax Group Type is 'Document Level'.Requires Posting Field Name to be 'Tax1' when Tax Group Type is 'Document Level'