Interface ITaxReferenceDataProvider

Namespace

Payetools.IncomeTax.ReferenceData

Assembly

Payetools.IncomeTax.dll

Interface that represents a provider of tax band information.

public interface ITaxReferenceDataProvider

Methods

GetTaxBandsForTaxYearAndPeriod(TaxYear, PayFrequency, int)

Retrieves the tax bands for a given tax year in the form of a dictionary (ReadOnlyDictionary<TKey, TValue>) keyed on tax regime, i.e., CountriesForTaxPurposes.

ReadOnlyDictionary<CountriesForTaxPurposes, TaxBandwidthSet> GetTaxBandsForTaxYearAndPeriod(TaxYear taxYear, PayFrequency payFrequency, int taxPeriod)

Parameters

taxYear TaxYear

Desired tax year.

payFrequency PayFrequency

Pay frequency pertaining. Used in conjunction with the taxPeriod parameter to determine the applicable date (in case of in-year tax changes).

taxPeriod int

Tax period, e.g., 1 for month 1. Currently ignored on the assumption that in-year tax changes are not anticipated but provided for future .

Returns

ReadOnlyDictionary<CountriesForTaxPurposes, TaxBandwidthSet>

ReadOnlyDictionary of TaxBandwidthSet's keyed on tax regime.

Remarks

Although ReadOnlyDictionary is not guaranteed to be thread-safe, in the current implementation the underlying Dictionary is guaranteed not to change, so thread-safety can be assumed.