@trustbank-inc/furusato-tax-simulation
TypeScript icon, indicating that this package has built-in type declarations

2.0.3 • Public • Published

furusato-tax-simulation

ふるさと納税の控除上限額を計算するライブラリです。

概要

簡易的な家族構成・年収を入力することで控除上限額を出力する「簡易シミュレーション」と、寄付者の源泉徴収票の情報をもとに控除上限額を計算する「詳細シミュレーション」の2つで構成されるシミュレーションライブラリです。

インストール

npmを利用する

$ npm i @trustbank-inc/furusato-tax-simulation

利用方法

npmを利用する

import {
    executeEasySimulation,
    executeSpeficSimulation,
    FamilyValues,
    IncomeValues,
    SingleValues,
    SpouseValues
} from '@trustbank-inc/furusato-tax-simulation';

executeEasySimulation(
    FamilyValues.couple,
    IncomeValues.lessThan600
);

executeSpecificSimulation({
    dependentsExcludedChildren: '1',
    dependentsIncludedChildren: '1',
    dependentsSpecialChildren: '1',
    dependentsGeneral: '1',
    dependentsElderlyParentsSeparated: '1',
    dependentsElderlyParentsLivingTogether: '1',
    earthquakeInsurancePremium: '100000',
    disability: '1',
    specialDisabilitySeparated: '1',
    specialDisabilityLivingTogether: '1',
    income: '10000000',
    lifeInsurance: '100000',
    medicalExpense: '100000',
    specialCreditForHousingLoan: '100000',
    mutualAidPremium: '100000',
    capitalGainsUnlistedStock: '100000',
    socialInsurancePremium: '100000',
    single: SingleValues.none,
    spouse: SpouseValues.general,
    spouseIncome: '100000',
    capitalGainsListedStock: '100000',
    widow: false,
    donation: '100000'
});

各関数の値

簡易シミュレーション

プロパティ

Key Value Type
family 家族構成 FamilyValues
Income 年収 IncomeValues

家族構成

Key Value
FamilyValues.coupleAndChild 夫婦+子1人(高校生)
FamilyValues.couple 夫婦
FamilyValues.singleOrNonSupport 独身又は共働き
FamilyValues.pensioner 年金収入者

年収

Key Value
IncomeValues.lessThan150 150万円以下
IncomeValues.lessThan200 200万円以下
IncomeValues.lessThan300 300万円以下
IncomeValues.lessThan400 400万円以下
IncomeValues.lessThan500 500万円以下
IncomeValues.lessThan600 600万円以下
IncomeValues.lessThan700 700万円以下
IncomeValues.lessThan800 800万円以下
IncomeValues.lessThan900 900万円以下
IncomeValues.lessThan1000 1000万円以下
IncomeValues.lessThan1500 1500万円以下
IncomeValues.lessThan2000 2000万円以下
IncomeValues.lessThan3000 3000万円以下
IncomeValues.lessThan5000 5000万円以下
IncomeValues.moreThan10000 1億円以上

詳細シミュレーション

入力項目のプロパティ

Key Value Type
dependentsExcludedChildren 15歳以下の扶養家族 String|Number
dependentsIncludedChildren 16~18歳の扶養家族 String|Number
dependentsSpecialChildren 19~22歳の扶養家族 String|Number
dependentsGeneral 23~69歳の扶養家族 String|Number
dependentsElderlyParentsSeparated 70歳以上の扶養家族 String|Number
dependentsElderlyParentsLivingTogether 70歳以上かつ同居の扶養家族(親・祖父母) String|Number
earthquakeInsurancePremium 地震保険料控除額 String|Number
disability 一般の障害者 String|Number
specialDisabilitySeparated 特別障害者(別居または本人) String|Number
specialDisabilityLivingTogether 同居特別障害者 String|Number
income 本人の給与収入 String|Number
lifeInsurance 生命保険料控除額 String|Number
medicalExpense 医療費控除の金額 String|Number
specialCreditForHousingLoan 住宅借入金等特別控除額 String|Number
mutualAidPremium 小規模企業共済等掛金の金額 String|Number
capitalGainsUnlistedStock 本人の株式譲渡益(非上場) String|Number
single ひとり親に該当するか SingleValues
socialInsurancePremium 社会保険料等の金額 String|Number
spouse 配偶者の有無 SpouseValues
spouseIncome 配偶者の給与収入 String|Number
capitalGainsListedStock 本人の株式譲渡益(上場) String|Number
widow 寡婦に該当するか Boolean

ひとり親

Key Value
SingleValues.none 非該当
SingleValues.singleFather ひとり親(男性)
SingleValues.singleMother ひとり親(女性)

配偶者

Key Value
SpouseValues.none なし
SpouseValues.general 一般の控除対象配偶者(69歳以下)
SpouseValues.elderly 老人控除対象配偶者(70歳以上)

出力項目のプロパティ

Key Value Type
result 理論上の金額 number
donationAmountUnderSelfPay2000 自己負担額が2000円で済む寄附金額 number
beforeDonationDeductionDetail 寄附金控除前の詳細 BeforeDonationDeductionDetail
incomeTaxDifference 所得税における税の軽減額 number
residentTaxDifference 住民税における税の軽減額 number
afterDonationDeductionDetail 寄附金控除後の詳細 AfterDonationDeductionDetail

beforeDonationDeductionDetailのプロパティ

Key Value Type
incomeTaxDetail 寄附金控除前の所得税の詳細 IncomeTaxBeforeDonationDeductionDetail
residentTaxDetail 寄附金控除前の住民税の詳細 ResidentTaxBeforeDonationDeductionDetail

afterDonationDeductionDetailのプロパティ

Key Value Type
incomeTaxDetail 寄附金控除後の所得税の詳細 IncomeTaxAfterDonationDeductionDetail
residentTaxDetail 寄附金控除後の住民税の詳細 ResidentTaxAfterDonationDeductionDetail

IncomeTaxBeforeDonationDeductionDetailのプロパティ

Key Value Type
employmentIncome 給与所得 number
capitalGainsListedStock 譲渡所得(株式譲渡/上場) number
capitalGainsUnlistedStock 譲渡所得(株式譲渡/非上場) number
taxableBaseTotal 課税標準の合計額 number
spousalDeduction 配偶者控除 number
specialSpousalDeduction 配偶者特別控除 number
dependentDeduction 扶養控除 number
socialInsurancePremiumDeduction 社会保険料控除 number
mutualAidPremiumDeduction 小規模企業共済掛金控除 number
lifeInsurancePremiumDeduction 生命保険料控除(所得税ベース) number
earthquakeInsurancePremiumDeduction 地震保険料控除 number
widowDeduction 寡婦控除 number
singleDeduction ひとり親控除 number
disabilityDeduction 障害者控除 number
medicalExpensesDeduction 医療費控除 number
basicDeduction 基礎控除 number
incomeDeductionTotal 所得控除の合計 number
taxableGrossIncome 課税総所得金額 number
taxableCapitalGainsListedStock 課税譲渡所得等の金額(上場株式) number
taxableCapitalGainsUnlistedStock 課税譲渡所得等の金額(一般株式) number
taxableGrossIncomeTax 課税総所得金額に対する税額 number
taxableCapitalGainsListedStockTax 課税譲渡所得(上場株式)に対する税額 number
taxableCapitalGainsUnlistedStockTax 課税譲渡所得(一般株式)に対する税額 number
incomeTaxAfterHousingLoanDeduction 住宅ローン控除後所得税額 number
actualIncomeTax 実際の所得税額 number

ResidentTaxBeforeDonationDeductionDetailのプロパティ

Key Value Type
employmentIncome 給与所得 number
capitalGainsListedStock 譲渡所得(株式譲渡/上場) number
capitalGainsUnlistedStock 譲渡所得(株式譲渡/非上場) number
taxableBaseTotal 課税標準の合計額 number
spousalDeduction 配偶者控除 number
specialSpousalDeduction 配偶者特別控除 number
dependentDeduction 扶養控除 number
socialInsurancePremiumDeduction 社会保険料控除 number
mutualAidPremiumDeduction 小規模企業共済掛金控除 number
lifeInsurancePremiumDeduction 生命保険料控除(所得税ベース) number
earthquakeInsurancePremiumDeduction 地震保険料控除 number
widowDeduction 寡婦控除 number
singleDeduction ひとり親控除 number
disabilityDeduction 障害者控除 number
medicalExpensesDeduction 医療費控除 number
basicDeduction 基礎控除 number
incomeDeductionTotal 所得控除の合計 number
taxableGrossIncome 課税総所得金額 number
taxableCapitalGainsListedStock 課税譲渡所得等の金額(上場株式) number
taxableCapitalGainsUnlistedStock 課税譲渡所得等の金額(一般株式) number
isTaxableResidentTax 住民税は非課税か boolean
gradedIncomeTax 住民税所得割額 number

IncomeTaxAfterDonationDeductionDetailのプロパティ

Key Value Type
donationDeduction 寄附金控除 number
incomeDeductionTotal 所得控除の合計 number
taxableGrossIncome 課税総所得金額 number
taxableCapitalGainsListedStock 課税譲渡所得等の金額(上場株式) number
taxableCapitalGainsUnlistedStock 課税譲渡所得等の金額(一般株式) number
taxableGrossIncomeTax 課税総所得金額に対する税額 number
taxableCapitalGainsListedStockTax 課税譲渡所得(上場株式)に対する税額 number
taxableCapitalGainsUnlistedStockTax 課税譲渡所得(一般株式)に対する税額 number
incomeTaxAfterHousingLoanDeduction 住宅ローン控除後所得税額 number
actualIncomeTax 実際の所得税額 number

ResidentTaxAfterDonationDeductionDetailのプロパティ

Key Value Type
incomeDeductionTotal 所得控除の合計 number
taxableGrossIncome 課税総所得金額 number
taxableCapitalGainsListedStock 課税譲渡所得等の金額(上場株式) number
taxableCapitalGainsUnlistedStock 課税譲渡所得等の金額(一般株式) number
donationDeduction 寄附金税額控除 number
gradedIncomeTax 住民税所得割額 number

ライセンス

このプロジェクトはMITライセンスの元で提供されています。詳細については、LICENSE.txtファイルをご覧ください。

Readme

Keywords

none

Package Sidebar

Install

npm i @trustbank-inc/furusato-tax-simulation

Weekly Downloads

17

Version

2.0.3

License

MIT

Unpacked Size

2.03 MB

Total Files

86

Last publish

Collaborators

  • ryoheiiijima
  • motokoyamazaki
  • momoka-fujikawa
  • kazuyaseotb