Product Guides
Login for full accessGet a demo

Finding Applicable Taxes

Part 2 of 3

Suggest Edits

Now that we know which location codes to use for Astrid, we can find the taxes that will potentially apply for this payroll.

We're going to be making a single request ("LocationTaxRequest") to the locationTax endpoint:

https://ste.symmetry.com/ste-hosted/v1/locationTax

LocationTaxRequest

The following request will return all potentially applicable taxes based on the two location codes, as well as any unique parameters used in the calculation of those taxes:

{
  "LocationTaxRequest": {
    "taxReferenceFull": [
      {
        "locationCodeFull": "STATE:80-CNTY:000-CITY:0000",
        "payDate": "2023-01-13"
      },
      {
        "locationCodeFull": "STATE:82-CNTY:000-CITY:0000",
        "payDate": "2023-01-13"
      }
    ]
  }
}

Sample LocationTaxResponse

After we send that request, we'll get the following lengthy response back from the STE:

{
  "LocationTaxResponse": {
    "httpStatusCode": 200,
    "errorStatus": {
      "errorMessage": "No error",
      "errorCode": 0
    },
    "taxItemFull": [
      {
        "max_contribution_period": 1,
        "isEmployerTax": false,
        "AverageAssessmentRate": 0,
        "jurisdictionData": [
          {
            "parameterName": "DATE_OF_BIRTH",
            "provinceCode": "80",
            "dataType": "String",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Employee Date of Birth",
            "uniqueTaxID": "80-000-0000-CPP-000",
            "taxEffectiveDate": "1900-01-01",
            "regex": "^([12][0-9]{3}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01]))$",
            "description": "Date of Birth",
            "helpText": "Employee date of birth",
            "defaultValue": "1900-01-01",
            "isOptional": true,
            "regexType": "PickList",
            "certificateLineNo": "Publication T4001, Chapter 2, Special Situations"
          },
          {
            "parameterName": "CPP_DEDUCTIONS",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Non-pensionable Earnings Deductions",
            "uniqueTaxID": "80-000-0000-CPP-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Federal CPP Deductions",
            "helpText": "Amounts that are not included in pensionable earnings, such as deductions allocated to a member of the clergy.",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "listValues": "TRUE=True, FALSE=False",
            "parameterName": "TRANSFERRED",
            "provinceCode": "80",
            "dataType": "Boolean",
            "provinceAbbreviation": "CAN",
            "regexDescription": "'True' or 'False'",
            "uniqueTaxID": "80-000-0000-CPP-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^(TRUE|FALSE)$",
            "description": "Quebec-Employee Transferred Outside Quebec",
            "helpText": "A flag for transferring employees. Set to 'True' for Quebec employees transferred outside Quebec during the year.",
            "defaultValue": "FALSE",
            "isOptional": true,
            "regexType": "PickList",
            "certificateLineNo": "Publication T4127, Employees who were transferred by their employer from Quebec to a location outside Quebec during the year"
          },
          {
            "parameterName": "COMMISSION_DURATION",
            "provinceCode": "80",
            "dataType": "Integer",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Number of Days Since Last Commission Payment",
            "uniqueTaxID": "80-000-0000-CPP-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+)$",
            "description": "Number of Days Since Last Commission Payment",
            "helpText": "N, The number of days since the last commission payment. The minimum basic exemption amount of $67.30 is included in the formula in line with CPP legislation",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor N"
          },
          {
            "listValues": "TRUE=True, FALSE=False",
            "parameterName": "EXCLUDE_CPP_EXEMPTION",
            "provinceCode": "80",
            "dataType": "Boolean",
            "provinceAbbreviation": "CAN",
            "regexDescription": "'True' or 'False'",
            "uniqueTaxID": "80-000-0000-CPP-000",
            "taxEffectiveDate": "1900-01-01",
            "regex": "^(TRUE|FALSE)$",
            "description": "Exclude CPP Exemption",
            "helpText": "'True' if the CPP exemption was already applied for the current pay period and should be excluded from the calculation, or else 'False'",
            "defaultValue": "FALSE",
            "isOptional": true,
            "regexType": "PickList",
            "certificateLineNo": ""
          },
          {
            "parameterName": "CPP_F5B_YTD",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Deductions for CPP additional contributions YTD",
            "uniqueTaxID": "80-000-0000-CPP-000",
            "taxEffectiveDate": "2023-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Year-to-date deductions for CPP additional contributions",
            "helpText": "Deductions for Canada Pension Plan additional contributions deducted from previous bonus(es) and retroactive payment(s)",
            "defaultValue": "0.00",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor F5B_YTD"
          }
        ],
        "MaximumInsurable": 0,
        "country": "CA",
        "provinceCode": "80",
        "rate": 0.0595,
        "max_contribution": 3754.45,
        "provinceAbbreviation": "CAN",
        "basicAmount": 0,
        "taxEffectiveDate": "2023-01-01",
        "annual_max": 66600,
        "description": "Canada Pension Plan Tax",
        "provinceName": "Canadian Federal",
        "LCPRate": 0,
        "LCPAmount": 0,
        "uniqueTaxID": "80-000-0000-CPP-000",
        "v1Rate": 0
      },
      {
        "max_contribution_period": 1,
        "isEmployerTax": false,
        "AverageAssessmentRate": 0,
        "jurisdictionData": [
          {
            "parameterName": "EI_DEDUCTIONS",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Non-insurable Earnings Deductions",
            "uniqueTaxID": "80-000-0000-EI-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Federal Employment Insurance Deductions",
            "helpText": "Amounts that are not included in insurable earnings, as described in the Canada.ca definition of pensionable and insurable earnings.",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          }
        ],
        "MaximumInsurable": 0,
        "country": "CA",
        "provinceCode": "80",
        "rate": 0.0163,
        "max_contribution": 1002.45,
        "provinceAbbreviation": "CAN",
        "basicAmount": 0,
        "taxEffectiveDate": "2023-01-01",
        "annual_max": 61500,
        "description": "Canada Employment Insurance Tax",
        "provinceName": "Canadian Federal",
        "LCPRate": 0,
        "LCPAmount": 0,
        "uniqueTaxID": "80-000-0000-EI-000",
        "v1Rate": 0
      },
      {
        "max_contribution_period": 1,
        "max_contribution": 3754.45,
        "AverageAssessmentRate": 0,
        "MaximumInsurable": 0,
        "country": "CA",
        "v1Rate": 0,
        "rate": 0.0595,
        "provinceCode": "80",
        "basicAmount": 0,
        "provinceName": "Canadian Federal",
        "taxEffectiveDate": "2023-01-01",
        "annual_max": 66600,
        "description": "Canada Employer Pension Plan Tax",
        "isEmployerTax": true,
        "LCPRate": 0,
        "LCPAmount": 0,
        "uniqueTaxID": "80-000-0000-ER_CPP-000",
        "provinceAbbreviation": "CAN"
      },
      {
        "max_contribution_period": 1,
        "isEmployerTax": true,
        "AverageAssessmentRate": 0,
        "jurisdictionData": [
          {
            "parameterName": "REDUCED_ER_EI_RATE_BY",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Employer EI rate reduction percent",
            "uniqueTaxID": "80-000-0000-ER_EI-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Reduce Employer EI Rate By Percent",
            "helpText": "Employer EI rate reduction percent",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "ER_EI_MULTIPLIER",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Employer EI Multiplier",
            "uniqueTaxID": "80-000-0000-ER_EI-000",
            "taxEffectiveDate": "1900-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Employer EI Multiplier",
            "helpText": "Employer EI Multiplier",
            "defaultValue": "1.4",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          }
        ],
        "MaximumInsurable": 0,
        "country": "CA",
        "provinceCode": "80",
        "rate": 0.02282,
        "max_contribution": 1403.43,
        "provinceAbbreviation": "CAN",
        "basicAmount": 0,
        "taxEffectiveDate": "2023-01-01",
        "annual_max": 61500,
        "description": "Canada Employer Employment Insurance Tax",
        "provinceName": "Canadian Federal",
        "LCPRate": 0,
        "LCPAmount": 0,
        "uniqueTaxID": "80-000-0000-ER_EI-000",
        "v1Rate": 0
      },
      {
        "max_contribution_period": 1,
        "isEmployerTax": false,
        "AverageAssessmentRate": 0,
        "jurisdictionData": [
          {
            "parameterName": "FEDERAL_TOTAL_CLAIM_AMOUNT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Total Claim Amount",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Federal Total Claim Amount",
            "helpText": "TC, 'Total claim amount' reported on federal Form TD1. If Form TD1 is not filed by the employee or pensioner, TC is the basic personal amount, and for non-resident individuals, TC is $0.",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Form TD1, Line 13"
          },
          {
            "parameterName": "BONUS_WITHHELD_AMT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Bonus Withheld Amount",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "1900-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Bonus Withheld Amount",
            "helpText": "Federal Bonus amount withheld. Bonus withheld amount is an optional parameter for employees who have bonus withheld amount with employer.",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127"
          },
          {
            "parameterName": "FEDERAL_TAX_CREDIT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Tax Credit",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Federal Tax Credit",
            "helpText": "K3, Other provincial or territorial non-refundable tax credits (such as medical expenses and charitable donations) authorized by a tax services office or tax centre",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor K3"
          },
          {
            "parameterName": "PRESCRIBED_ZONE_AMOUNT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Prescribed Zone Amount",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Federal Prescribed Zone Amount",
            "helpText": "HD, Annual deduction for living in a prescribed zone, as shown on Form TD1.",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Form TD1, Deduction for living in a prescribed zone"
          },
          {
            "parameterName": "COMMISSION_EXPENSES",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Commission Expenses",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Commission Expenses",
            "helpText": "E, Total commission expenses deductions",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "From TD1, Total commission expenses deductions "
          },
          {
            "parameterName": "PAY_PERIOD_INCOME_DEDUCTIONS",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Pay Period Income Deductions",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Federal Pay Period Income Deductions",
            "helpText": "F2, Alimony or maintenance payments required by a legal document dated before May 1, 1997, to be payroll-deducted authorized by a tax services office or tax centre.",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor F2"
          },
          {
            "parameterName": "APPROVED_SHARES",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Approved Shares",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Federal Approved Shares",
            "helpText": "The amount deducted or withheld during the year for the acquisition by the employee of approved shares of the capital stock of a prescribed labour-sponsored venture capital corporation.",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, formula to calculate LCF"
          },
          {
            "parameterName": "ANNUAL_INCOME_DEDUCTIONS",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Annual Income Deductions",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Federal Annual Income Deductions",
            "helpText": "F1, Annual deductions such as child care expenses and support payments, requested by an employee or pensioner and authorized by a tax services office or tax centre",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor F1"
          },
          {
            "listValues": "TRUE=True, FALSE=False",
            "parameterName": "OUTSIDE_CANADA",
            "provinceCode": "80",
            "dataType": "Boolean",
            "provinceAbbreviation": "CAN",
            "regexDescription": "'True' or 'False'",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^(TRUE|FALSE)$",
            "description": "Employee works outside Canada or in Canada beyond the limits of any province or territory",
            "helpText": "Employee is outside Canada or in Canada beyond the limits of any province or territory.",
            "defaultValue": "FALSE",
            "isOptional": true,
            "regexType": "PickList",
            "certificateLineNo": "Publication T4127, Outside Canada"
          },
          {
            "listValues": "TRUE=True, FALSE=False",
            "parameterName": "OFF_CYCLE_BONUS_ONLY",
            "provinceCode": "80",
            "dataType": "Boolean",
            "provinceAbbreviation": "CAN",
            "regexDescription": "'True' or 'False'",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "1900-01-01",
            "regex": "^(TRUE|FALSE)$",
            "description": "Off-Cycle Bonus-Only Payment",
            "helpText": "True' if this is a bonus-only calculation outside of the regular payroll cycle, or else 'False'",
            "defaultValue": "FALSE",
            "isOptional": true,
            "regexType": "PickList",
            "certificateLineNo": ""
          },
          {
            "parameterName": "UNION_DUES",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Union dues for the pay period",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Union Dues",
            "helpText": "U1, Union dues for the pay period paid to a trade union, an association of public servants, or dues required under the law of a province to a parity or advisory committee or similar body.",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor U1"
          },
          {
            "parameterName": "PENSION_DEDUCTION",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Pension and Saving Plan Deduction for pay period",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Pension and Saving Plan Deduction",
            "helpText": "Pension and Saving Plan Deduction. Used to compute F and annual taxable income",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor F"
          },
          {
            "parameterName": "PENSION_DEDUCTION_YTD",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "The year-to-date Pension and Saving Plan Deduction",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Year-to-date Pension and Saving Plan Deduction",
            "helpText": "Year-to-date Pension and Saving Plan Deduction. Used to compute Factor F4 and annual taxable income",
            "defaultValue": "0.0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor F4"
          },
          {
            "parameterName": "PENSION_DEDUCTION_BONUS",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Form TD1, Deduction for living in a prescribed zone",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Pay Period Pension and Saving Plan Deduction for Bonus",
            "helpText": "F3, Employee registered pension plan or registered retirement savings plan contributions deducted from the current non-periodic payment. You can use this field to apply other tax-deductible amounts to the non-periodic payment, such as union dues.",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor F3"
          },
          {
            "parameterName": "ER_CONTRIBUTION_RESTRICTED_RRSP_AMOUNT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Current pay period employer contributions to the employee's restricted RRSP plan",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2023-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Current pay period employer contributions to the employee's restricted RRSP plan",
            "helpText": "Current pay period employer contributions to the employee's restricted RRSP plan",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "ER_CONTRIBUTION_UNRESTRICTED_RRSP_AMOUNT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Current pay period employer contributions to the employee's unrestricted RRSP plan",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2023-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Current pay period employer contributions to the employee's unrestricted RRSP plan",
            "helpText": "Current pay period employer contributions to the employee's unrestricted RRSP plan",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "RRSP_AMOUNT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Current pay period contributions by the employee to a restricted or unrestricted RRSP plan",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Current pay period contributions by the employee to a restricted or unrestricted RRSP plan",
            "helpText": "Current pay period contributions by the employee to a restricted or unrestricted RRSP plan",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "RRSP_AMOUNT_YTD",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Year-to-date contributions by the employee to a restricted or unrestricted RRSP plan",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Year-to-date contributions by the employee to a restricted or unrestricted RRSP plan",
            "helpText": "Year-to-date contributions by the employee to a restricted or unrestricted RRSP plan",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "RPP_MP_AMOUNT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Pay Period Registered Pension Plan for Money Purchase",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Pay Period Registered Pension Plan for Money Purchase",
            "helpText": "Pay Period Registered Pension Plan for Money Purchase",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "RPP_MP_AMOUNT_YTD",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "The year-to-date Registered Pension Plan for Money Purchase",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Year-to-date Registered Pension Plan for Money Purchase",
            "helpText": "The year-to-date Registered Pension Plan for Money Purchase",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "DB_AMOUNT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Pay Period Defined Benefit",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Pay Period Defined Benefit",
            "helpText": "Pay Period Defined Benefit",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "DB_AMOUNT_YTD",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "The year-to-date Defined Benefit",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Year-to-date Defined Benefit",
            "helpText": "The year-to-date Defined Benefit",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "DPSP_AMOUNT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Pay Period Deferred Profit Sharing Plan",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Pay Period Deferred Profit Sharing Plan",
            "helpText": "Pay Period Deferred Profit Sharing Plan",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          },
          {
            "parameterName": "DPSP_AMOUNT_YTD",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "The year-to-date Deferred Profit Sharing Plan",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Year-to-date Deferred Profit Sharing Plan ",
            "helpText": "The year-to-date Deferred Profit Sharing Plan ",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": ""
          }
        ],
        "MaximumInsurable": 0,
        "country": "CA",
        "provinceCode": "80",
        "rate": 0,
        "max_contribution": 0,
        "provinceAbbreviation": "CAN",
        "basicAmount": 15000,
        "taxEffectiveDate": "2023-01-01",
        "annual_max": 0,
        "description": "Canada Income Tax",
        "provinceName": "Canadian Federal",
        "LCPRate": 0.15,
        "LCPAmount": 750,
        "uniqueTaxID": "80-000-0000-FIT-000",
        "v1Rate": 0
      },
      {
        "max_contribution_period": 1,
        "max_contribution": 0,
        "AverageAssessmentRate": 0,
        "MaximumInsurable": 0,
        "country": "CA",
        "v1Rate": 0,
        "rate": 0,
        "provinceCode": "82",
        "basicAmount": 0,
        "provinceName": "British Columbia",
        "taxEffectiveDate": "2020-01-01",
        "annual_max": 0,
        "description": "British Columbia Employer Health Tax",
        "isEmployerTax": true,
        "LCPRate": 0,
        "LCPAmount": 0,
        "uniqueTaxID": "82-000-0000-ER_HLTH-000",
        "provinceAbbreviation": "BC"
      },
      {
        "max_contribution_period": 1,
        "max_contribution": 0,
        "AverageAssessmentRate": 1.55,
        "MaximumInsurable": 112800,
        "country": "CA",
        "v1Rate": 0,
        "rate": 0,
        "provinceCode": "82",
        "basicAmount": 0,
        "provinceName": "British Columbia",
        "taxEffectiveDate": "2023-01-01",
        "annual_max": 0,
        "description": "British Columbia Workers' Compensation",
        "isEmployerTax": true,
        "LCPRate": 0,
        "LCPAmount": 0,
        "uniqueTaxID": "82-000-0000-ER_WC-000",
        "provinceAbbreviation": "BC"
      },
      {
        "max_contribution_period": 1,
        "isEmployerTax": false,
        "AverageAssessmentRate": 0,
        "jurisdictionData": [
          {
            "parameterName": "PROVINCIAL_TAX_CREDIT",
            "provinceCode": "82",
            "dataType": "Dollar",
            "provinceAbbreviation": "BC",
            "regexDescription": "Tax Credit",
            "uniqueTaxID": "82-000-0000-PIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "British Columbia Tax Credit",
            "helpText": "K3P, Other provincial or territorial tax credits (such as medical expenses and charitable donations) authorized by a tax services office or tax centre",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor K3P"
          },
          {
            "parameterName": "APPROVED_SHARES",
            "provinceCode": "82",
            "dataType": "Dollar",
            "provinceAbbreviation": "BC",
            "regexDescription": "Approved Shares",
            "uniqueTaxID": "82-000-0000-PIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "British Columbia Approved Shares",
            "helpText": "The amount deducted or withheld during the year for the acquisition by the employee of approved shares of the capital stock of a prescribed labour-sponsored venture capital corporation.",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, formula to calculate LCP"
          },
          {
            "parameterName": "PROVINCIAL_ANNUAL_INCOME_DEDUCTIONS",
            "provinceCode": "82",
            "dataType": "Dollar",
            "provinceAbbreviation": "BC",
            "regexDescription": "Annual Income Deductions",
            "uniqueTaxID": "82-000-0000-PIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "British Columbia Annual Income Deductions",
            "helpText": "F1, Annual deductions such as child care expenses and support payments, requested by an employee or pensioner and authorized by a tax services office or tax centre.",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor F1"
          },
          {
            "parameterName": "PROVINCIAL_PAY_PERIOD_INCOME_DEDUCTIONS",
            "provinceCode": "82",
            "dataType": "Dollar",
            "provinceAbbreviation": "BC",
            "regexDescription": "Pay Period Income Deductions",
            "uniqueTaxID": "82-000-0000-PIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "British Columbia Pay Period Income Deductions",
            "helpText": "F2, Alimony or maintenance payments required by a legal document dated before May 1, 1997, to be payroll-deducted authorized by a tax services office or tax centre.",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Publication T4127, Factor F2"
          },
          {
            "parameterName": "PRESCRIBED_ZONE_AMOUNT",
            "provinceCode": "82",
            "dataType": "Dollar",
            "provinceAbbreviation": "BC",
            "regexDescription": "Prescribed Zone Amount",
            "uniqueTaxID": "82-000-0000-PIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "British Columbia Prescribed Zone Amount",
            "helpText": "HD, Annual deduction for living in a prescribed zone, as shown on Form TD1. ",
            "defaultValue": "0",
            "isOptional": false,
            "regexType": "SingleValue",
            "certificateLineNo": "Form TD1, Deduction for living in a prescribed zone"
          },
          {
            "parameterName": "PROVINCIAL_TOTAL_CLAIM_AMOUNT",
            "provinceCode": "82",
            "dataType": "Dollar",
            "provinceAbbreviation": "BC",
            "regexDescription": "Total Claim Amount",
            "uniqueTaxID": "82-000-0000-PIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "British Columbia Total Claim Amount",
            "helpText": "TCP, 'Total claim amount' reported on the provincial or territorial Form TD1. If that form is not filed, TCP is the provincial or territorial basic personal amount.",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Form TD1BC, Line 11"
          },
          {
            "listValues": "TRUE=True, FALSE=False",
            "parameterName": "PROVINCE_OF_EMPLOYMENT",
            "provinceCode": "82",
            "dataType": "Boolean",
            "provinceAbbreviation": "BC",
            "regexDescription": "'True' or 'False'",
            "uniqueTaxID": "82-000-0000-PIT-000",
            "taxEffectiveDate": "1900-01-01",
            "regex": "^(TRUE|FALSE)$",
            "description": "British Columbia is the province of employment",
            "helpText": "British Columbia is the employee's province of employment (POE) ",
            "defaultValue": "FALSE",
            "isOptional": true,
            "regexType": "PickList",
            "certificateLineNo": ""
          }
        ],
        "MaximumInsurable": 0,
        "country": "CA",
        "provinceCode": "82",
        "rate": 0,
        "max_contribution": 0,
        "provinceAbbreviation": "BC",
        "basicAmount": 11981,
        "taxEffectiveDate": "2023-01-01",
        "annual_max": 0,
        "description": "British Columbia Provincial Tax (PIT)",
        "provinceName": "British Columbia",
        "LCPRate": 0,
        "LCPAmount": 0,
        "uniqueTaxID": "82-000-0000-PIT-000",
        "v1Rate": 0
      }
    ],
    "transactionStamp": {
      "totalTransactions": 1,
      "calcDateTime": "2026-03-05T02:56:44Z",
      "transactionType": "LocationTax",
      "failedTransactions": 0,
      "schemaVersion": "v1",
      "steVersion": "2026.2.3"
    }
  }
}

LocationTaxResponse breakdown

Each object within the "taxItemFull" array represents a separate tax. Most of the properties returned with each tax are purely informational, but we'll need to know about the following ones for right now:

"uniqueTaxID"

The single most important field returned here. As mentioned in our introduction to basic concepts in the STE, these tax IDs are how you'll tell the STE which taxes you actually want calculated. Every tax in the Symmetry Tax Engine has a matching unique tax ID.

If you're a currently licensed STE client, please see Symmetry Unique Tax IDs in our Client Support Center for more information on how tax IDs are formatted and what each part of an ID represents.

"taxEffectiveDate"

The effective date of the most recent update to this tax, prior to the pay date that you input in your request. For example, if the engine already had a 2024 rate update for one of these taxes, it would still not return a 2024 effective date because we entered a 2023 pay date!

Like the input pay date, this will be in YYYY-MM-DD format.

"jurisdictionData"

You'll notice that some taxes were returned with an extra property that the other taxes don't have: "jurisdictionData".

This is returned when the tax will require you to know additional special information about the employee in order to calculate it properly. In the STE, these special elements are commonly referred to as miscellaneous parameters. There are normal parameters that are common to the setup of all taxes in the engine, while these miscellaneous parameters are unique to the specific taxes that they are attached to.

As before, there are several properties returned for each miscellaneous parameter, but we're only going to focus on the ones that we need right now. We'll use the following federal miscellaneous parameter output as an example for the following properties:

      {
            "parameterName": "FEDERAL_TOTAL_CLAIM_AMOUNT",
            "provinceCode": "80",
            "dataType": "Dollar",
            "provinceAbbreviation": "CAN",
            "regexDescription": "Total Claim Amount",
            "uniqueTaxID": "80-000-0000-FIT-000",
            "taxEffectiveDate": "2020-01-01",
            "regex": "^([0-9]+([.][0-9]{0,2})?)$",
            "description": "Federal Total Claim Amount",
            "helpText": "TC, 'Total claim amount' reported on federal Form TD1. If Form TD1 is not filed by the employee or pensioner, TC is the basic personal amount, and for non-resident individuals, TC is $0.",
            "defaultValue": "0",
            "isOptional": true,
            "regexType": "SingleValue",
            "certificateLineNo": "Form TD1, Line 13"
      }
  • "parameterName": The engine's "official name" for the miscellaneous parameter — you can think of this like the ID of the parameter. When you go to set up the tax, you will need to enter this parameter name exactly as written!
    • In this example, the name is FEDERAL_TOTAL_CLAIM_AMOUNT.
  • "description": The "plain English" name of the parameter. For FEDERAL_TOTAL_CLAIM_AMOUNT, this is fittingly just "Federal Total Claim Amount."
  • "uniqueTaxID": A reference to the specific tax that this miscellaneous parameter belongs to.
    • "uniqueTaxID": "80-000-0000-FIT-000" indicates that FEDERAL_TOTAL_CLAIM_AMOUNT belongs to the federal income tax. This may appear obvious since it's included as part of the federal income tax object, but some taxes share parameter names. This allows you to easily keep track of which parameter goes with which tax.
  • "certificateLineNo": If this miscellaneous parameter correlates with a specific line on an employee's tax form, it will be listed here. For 2023, an employee's federal total claim amount comes from "Form TD1, Line 13." You can see the federal Form TD1 here.
  • "regex": This will return the regular expression that the STE uses to validate what you set the miscellaneous parameter to (when calculating taxes).
    • Since the federal total claim amount is a dollar amount, the engine will accept any number with up to two decimal places when setting FEDERAL_TOTAL_CLAIM_AMOUNT. Therefore, the regular expression returned is ^([0-9]+([.][0-9]{0,2})?)$.
    • Other common miscellaneous parameter regular expressions are Booleans (^(TRUE|FALSE)$), integers (^([0-9]+)$), and dates (^([12][0-9]{3}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01]))$), but there are many others as well!
  • "defaultValue": If you don't set this miscellaneous parameter (or if you set it to an invalid value), this is the default value that the engine will use instead.
    • For FEDERAL_TOTAL_CLAIM_AMOUNT, the default value is 0. Knowing an employee's total claim amount is critical to calculating their federal income tax correctly, so you'll want to make sure this is set!

Determining what information we need

Most miscellaneous parameters are only used for special scenarios, so for our first basic payroll calculation, we're only going to be using the following three:

  • FEDERAL_TOTAL_CLAIM_AMOUNT for the Canadian Federal Income Tax (80-000-0000-FIT-000)
  • PRESCRIBED_ZONE_AMOUNT for the Canadian Federal Income Tax (80-000-0000-FIT-000)
  • PROVINCIAL_TOTAL_CLAIM_AMOUNT for the British Columbia Provincial Tax (82-000-0000-PIT-000)

In order to correctly set these up, we'll need some info from the tax forms that Astrid filled out when she began her employment:

  • When Astrid filled out her 2023 federal Form TD1, she entered a total claim amount of $15,000 in Line 13 (in other words, she only claimed the basic personal amount of $15,000).
    • To represent this, we'll set FEDERAL_TOTAL_CLAIM_AMOUNT to 15000.
  • When Astrid filled out her 2023 federal Form TD1, she entered $0 for the "Deduction for living in a prescribed zone" on page 2.
    • To represent this, we'll set PRESCRIBED_ZONE_AMOUNT to 0.
  • Since Astrid works in British Columbia, she also filled out British Columbia Form TD1BC and entered $11,981 in line 11 for her total claim amount (the British Columbia basic personal amount).
    • To represent this, we'll set PROVINCIAL_TOTAL_CLAIM_AMOUNT to 11981.

👍

In summary, we now have a list of taxes to be calculated for Astrid, as well as a list of miscellaneous parameters that need to be set up in order to get accurate tax withholding amounts.

  • 80-000-0000-CPP-000 (Canada Pension Plan)
  • 80-000-0000-EI-000 (Canada Employment Insurance)
  • 80-000-0000-FIT-000 (Federal Income Tax)
  • 82-000-0000-PIT-000 (British Columbia Provincial Tax)

With all of this info, we can finally move onto calculating the taxes!

Updated 20 days ago

What’s Next

Next we'll calculate payroll taxes and determine Astrid's net pay!

Jump to top