Interface ITaxCalculator

Namespace

Payetools.IncomeTax

Assembly

Payetools.IncomeTax.dll

Interface that represents a calculator for calculating income tax based on tax code, taxable income and tax paid to date. Access to tax calculators is through the TaxCalculatorFactory; in normal use, implementations of ITaxCalculator are not be created directly. An ITaxCalculator instance is specific to a given pay frequency and tax period, which corresponds to an instance of a given PayDate.

public interface ITaxCalculator

Properties

PayFrequency

Gets the pay frequency for this calculator.

PayFrequency PayFrequency { get; }

Property Value

PayFrequency

TaxBandwidths

Gets the set of pro-rata tax bandwidths in use for a given tax year, tax regime and tax period.

TaxPeriodBandwidthSet TaxBandwidths { get; }

Property Value

TaxPeriodBandwidthSet

TaxPeriod

Gets the relevant tax period for this calculator.

int TaxPeriod { get; }

Property Value

int

TaxPeriodCount

Gets the number of tax periods within a given tax year, based on the supplied pay frequency.

int TaxPeriodCount { get; }

Property Value

int

TaxYear

Gets the tax year that this calculator pertains to.

TaxYear TaxYear { get; }

Property Value

TaxYear

Methods

Calculate(decimal, decimal, TaxCode, decimal, decimal, decimal, out ITaxCalculationResult)

Calculates the tax due based on tax code, total taxable salary and total tax paid to date.

void Calculate(decimal totalTaxableSalaryInPeriod, decimal benefitsInKind, TaxCode taxCode, decimal taxableSalaryYearToDate, decimal taxPaidYearToDate, decimal taxUnpaidDueToRegulatoryLimit, out ITaxCalculationResult result)

Parameters

totalTaxableSalaryInPeriod decimal

Taxable pay in period (i.e., gross less pre-tax deductions but including benefits in kind).

benefitsInKind decimal

Benefits in kind element of the taxable pay for the period.

taxCode TaxCode

Individual's tax code.

taxableSalaryYearToDate decimal

Total year to date taxable salary up to and including the end of the previous tax period.

taxPaidYearToDate decimal

Total year to date tax paid up to and including the end of the previous tax period.

taxUnpaidDueToRegulatoryLimit decimal

Any tax outstanding due to the effect of the regulatory limit.

result ITaxCalculationResult

An ITaxCalculationResult containing the tax now due plus related information from the tax calculation.