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

Tax Declaration — entity reference

One employee's deduction claims for one April-to-March financial year, entered and verified by the payroll team. The header names the employee (Resource), the Financial Year and the Status; each Tax Declaration Line claims one deduction section. Every salary-TDS projection, and the year-end salary rows of the TDS return, read the lines of the employee's declarations whose Financial Year matches exactly and whose Status is Verified or Approved; Draft, Submitted and Rejected declarations reduce nothing. There is no Submit or Verify action and no employee self-service form: the status is changed by editing the record. Changing a declaration has no effect until the payroll run is calculated again.

Fields

FieldLabelTypeRequiredWhat it does
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
FinancialYearFinancial YearTextThe April-to-March year of the claims, written like 2026-27. It must be exactly the same text as the payroll period's financial year, or the declaration is ignored without a warning.
IdIdGuidYes
LabelLabelTextNot filled and not on the standard forms.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameText, uniqueYesThe declaration number from the Tax Declaration document setting (series TD). The form asks for a value, but it is replaced with the next number when the record is created.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe employing company. Only partner accounts can be chosen. Shown in the record header; not used by the tax calculation.
RecordTypeIdRecord TypeGuid, hidden
RegimeRegimePickListThe regime the employee mentioned, for reference only. The standard form fills New by default. The tax calculation does not read it; the regime applied is the Tax Regime on the Employee record. Values: Old Regime, New Regime.
ResourceIdResourceLookup → ResourceThe employee the declaration belongs to, as their Resource. The TDS projection matches declarations to employees by this field.
StatusStatusPickListWhere the declaration is in its review: Draft, Submitted, Verified, Approved or Rejected. Only Verified and Approved make the lines count, and the two are treated the same. The standard form shows it as a text box, so it must be typed exactly; it is not on the standard record page, so it is changed through Edit in the list. Values: Draft, Submitted, Verified, Approved, Rejected.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete this TaxDeclaration.
DeleteHeaderDeleteDeleteDeleteHeader
EditEditEditEdit this TaxDeclaration.
EditInLineEditEditInlineEdit
NewNewNewCreate a TaxDeclaration.
ViewViewViewView this TaxDeclaration.

Lookup filters

FilterLookup fieldNotes
PartnerAccountFilterPartnerAccountId