ForHosting KIT · 開発者向けツール

最低必要分配額（RMD）計算ツール

最低必要分配額計算ツールは、退職口座の残高を該当する平均余命分配係数で割り、結果を最も近いセント単位に丸めます。口座名義人と計算年に対応する正しい係数をすでに確認済みの方を対象としています。適用規則で求められる残高と、該当する表または専門家の助言から得た係数をご入力ください。本ツールが行うのは算術計算のみです。分配義務の有無を判断したり、表を選択したり、税務上の助言を提供したりするものではありません。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

残高と分配係数をご用意ください

まず、適用される規則で使用することが求められている退職口座残高をご確認ください。多くの場合は前年末の残高が用いられますが、口座の種類、所有関係、計算対象年によって適切な金額が異なることがあります。次に、口座名義人に適用される平均余命分配係数を入手してください。この係数は単なる年齢や割合ではなく、該当する分配表に示された除数です。口座名義人、要件を満たす配偶者受益者、その他の受益者では異なる表が適用される場合があり、規則も変更される可能性があります。本ツールが内蔵表から自動選択せず、係数の入力をお願いするのはそのためです。これにより計算根拠が明確になり、ご自身が選んでいない前提に基づく見かけだけ正確な結果を避けられます。通貨記号や桁区切りを付けず、両方を通常の数値としてご入力ください。残高は0でも構いませんが負数は使用できず、係数は0より大きい必要があります。引き出しを決定する前に、両方の値を出典と照合してください。

計算方法と丸め処理をご確認ください

計算式は、口座残高を分配係数で割るというものです。係数が同じなら残高が大きいほど必要分配額は増え、残高が同じなら係数が大きいほど必要分配額は減ります。本ツールは回答とともに残高と係数も出力するため、使用した入力値を後から確認できます。入力値自体は変更せず、算出された分配額だけを小数第2位まで丸め、実用的な通貨額として表示します。係数は除数であるため、0または負の値は受け付けません。未入力、文字列、無限大などの有限でない値も拒否されます。結果は決定的であり、同一の有効な入力からは常に同一の出力が得られます。現在の日付、外部サービス、更新される参照表には依存しません。そのため、繰り返し利用するワークシートや自動照合にも適しています。口座管理機関が別の丸め規則を採用している場合は、その提示額を丸め前の商と比較し、実際の分配を手配する際には管理機関の案内に従ってください。

結果の適用範囲にご注意ください

この結果は、入力された1つの残高と1つの係数に対する算術結果としてご利用ください。退職口座の分配義務を包括的に判定するものではありません。本ツールは、分配が必要かどうか、期限がいつか、複数口座を合算できるか、すでに受け取った分配をどう扱うかを判断せず、源泉徴収額も計算しません。また、選択した平均余命表が名義人、受益者、配偶者、口座種類、対象年に適しているかも検証しません。これらの条件によって金額や分配の合算方法が大きく変わる可能性があります。残高の出典と基準日、係数を取得した表と行を記録し、金額を計算したうえで、適用規則が認める場合に限り、すでに完了した対象分配を差し引く方法が有用です。確認に備えて、根拠資料を結果と一緒に保管してください。自動処理では、APIを1回$0.002で利用でき、計算記録とともに保存しやすい名前付き数値フィールドが返されます。適格性、例外、期限、合算規則が不明な場合は、税務の有資格専門家または制度管理者へご相談ください。

活用例

年間引き出し額を確認する

引き出しを手配する前に、該当する退職口座残高を確認済みの分配係数で割って金額を確かめられます。

口座管理機関の計算と照合する

独自に算出した金額を口座明細と比較し、計算に用いた2つの元データも記録できます。

退職設計シートを自動化する

正しい係数を確認済みの口座について、決定的なAPI出力を再現可能な処理に組み込めます。

よくある質問

どのような計算式を使用しますか？

口座残高を入力された平均余命分配係数で割り、結果を小数第2位まで丸めます。

分配係数は自動で選ばれますか？

いいえ。名義人、口座種類、受益者の状況、計算年に適用される係数をご自身で入力していただく必要があります。

どの時点の口座残高を入力すればよいですか？

対象の計算に適用される規則が指定する残高をご入力ください。評価基準日は、公的な案内、制度管理者、または税務専門家にご確認ください。

受益者口座の分配額も計算できますか？

正しい残高と受益者用の分配係数が分かっていれば計算できます。ただし、適用すべき受益者規則や表は本ツールでは判定しません。

APIでの計算料金はいくらですか？

APIは1リクエストあたり$0.002です。同じ決定的な計算をブラウザーでも実行できます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/finance/rmd-calculator

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/finance/rmd-calculator \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account_balance":500000,"distribution_factor":26.5}'

const res = await fetch("https://api.kit.forhosting.com/finance/rmd-calculator", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "account_balance": 500000,
    "distribution_factor": 26.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/rmd-calculator",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "account_balance": 500000,
    "distribution_factor": 26.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/rmd-calculator", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"account_balance":500000,"distribution_factor":26.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"account_balance":500000,"distribution_factor":26.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/rmd-calculator", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "account_balance": 500000,
  "distribution_factor": 26.5
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.rmd_calculator",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →