@trustbank-inc/furusato-tax-simulation

v2.0.3

Published

8 months ago

furusato-tax-simulation ====

0High
0Medium
0Low

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ファイルをご覧ください。

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

furusato-tax-simulation

概要

インストール

npmを利用する

利用方法

npmを利用する

各関数の値

簡易シミュレーション

プロパティ

家族構成

年収

詳細シミュレーション

入力項目のプロパティ

ひとり親

配偶者

出力項目のプロパティ

beforeDonationDeductionDetailのプロパティ

afterDonationDeductionDetailのプロパティ

IncomeTaxBeforeDonationDeductionDetailのプロパティ

ResidentTaxBeforeDonationDeductionDetailのプロパティ

IncomeTaxAfterDonationDeductionDetailのプロパティ

ResidentTaxAfterDonationDeductionDetailのプロパティ

ライセンス

`beforeDonationDeductionDetail`のプロパティ

`afterDonationDeductionDetail`のプロパティ

`IncomeTaxBeforeDonationDeductionDetail`のプロパティ

`ResidentTaxBeforeDonationDeductionDetail`のプロパティ

`IncomeTaxAfterDonationDeductionDetail`のプロパティ

`ResidentTaxAfterDonationDeductionDetail`のプロパティ