ForHosting KIT · 金融・お金

EPF計算

月給50,000、本人12%と雇用主12%の拠出、年利8.25%で20年続けると、EPFの残高は7,077,837.34になり、そのうち4,197,837.34が利息です。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

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

計算例

入力した場合

給与: 50,000
従業員の拠出率: 12
雇用主の拠出率: 12
年数: 20
金利: 8.25

結果

毎月の積立額: 12,000
年間拠出額: 144,000
拠出総額: 2,880,000
積立総額: 7,077,837.34

Employee Provident Fund（EPF）は確定拠出の退職制度で、月給の一部が毎月加入者口座に入り、その残高が公表された年利で退職または引出まで増えます。EPF 計算は、汎用の複利成長ツールが名前を付けない計画上の問いに答えます。月給、実際に積立口座へ入る従業員と雇用主の拠出率、勤続の整数年、年利が与えられたとき、退職時に口座に残る corpus はいくらか。この能力はその五入力を受け、毎年の期首残高が示した利率で増え、十二回の月次預入とその預入に対する 6.5 か月相当の利息が加わるという EPF の年末恒等式を適用し、見積 corpus と月次・生涯の拠出と得た利息を返します。

EPF退職時corpusの意味と残高の積み上がり

Employee Provident Fund は確定拠出の口座で、退職時の残高は従業員と雇用主の月次入金を、完了した勤続年ごとに法定または仮定の年利で増やした corpus です。一つの指数で増える一括額と違い、EPF 口座は毎月新しい入金を受けます。月次拠出は、その月給のパーセントで示した従業員率と雇用主率の和に給与を掛けたものです。

利息は貯蓄商品のように各預入の日数では払われません。計画者と本計算が用いる慣例の EPF 年末恒等式は、勤続一年につき一度利息を付けます。期首残高は年利で増え、十二回の月次預入が加わり、年内の預入は六か月半相当の利息を得るものとして扱います。

因子 6.5 は、各月の初めに入れたとみなす十二回の預入が十二か月から一か月まで口座に残る平均です。代数では、r を小数の利率、M を月次拠出とすると、各年は期首残高に (1 プラス r) を掛けるのに加え、M に (12 プラス 6.5 r) を掛けた分を足します。

期首ゼロから整数年後の閉じた形は、その年次加算項に ((1 プラス r) の years 乗から 1 を引いた値) を掛けて r で割ったもの、利率がゼロなら加算項に years を掛けたものです。応答は二桁への half-up 丸め後のその corpus と、月次拠出、生涯の預入合計、corpus からその預入を引いた得た利息を知らせます。

計算例：月給 50000 で従業員・雇用主とも 12 パーセントなら月 12000 の拠出、8.25 パーセントで一年なら corpus は 150435、うち利息は 6435 です。実装は公表金利の生値を調べず、雇用主分を年金と積立に分けず、賃金上限も年中の昇給もモデルしません。

活用例

従業員分と雇用主分のシナリオ

雇用主が十二パーセント全額を入れる場合と、年金分割後の積立分だけの場合の corpus を、組み合わせごとに表を開かずに引用します。

よくある質問

給与が正でないとどうなりますか？

ゼロ、負、欠落、非有限の salary は受け付けません。ゼロより大きい月給を入れてください。検証失敗は課金されません。

拠出率と金利はパーセントですか、小数の分数ですか？

小数の分数ではなくパーセント点で入れてください。十二は給与の十二パーセント、8.25 は年 8.25 パーセントであり、0.12 や 0.0825 ではありません。エンジンは複利の前に百で割ります。

退職時のEPF残高はどう計算しますか？

毎月、給与に2つの拠出率を掛けた額が口座に入ります。年に1回、期首残高に年利が付き、その年の12回分の積立には6.5か月分の利息が加わります。

なぜ6.5か月分の利息で計算するのですか？

積立が1年を通じて行われるためです。毎月初めに入金するとみなすと、12回分の積立は口座に12か月から1か月とどまり、その平均が6.5か月になります。

雇用主の拠出率には何を入れますか？

実際にEPF口座に入る分だけを、月給に対するパーセントで入力します。全額が入るなら12、年金分を除くなら3.67を入れます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/fin/epf

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

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

curl -X POST https://api.kit.forhosting.com/fin/epf \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"salary":50000,"employee_rate":12,"employer_rate":12,"years":20,"interest_rate":8.25}'

const res = await fetch("https://api.kit.forhosting.com/fin/epf", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "salary": 50000,
    "employee_rate": 12,
    "employer_rate": 12,
    "years": 20,
    "interest_rate": 8.25
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/epf",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "salary": 50000,
    "employee_rate": 12,
    "employer_rate": 12,
    "years": 20,
    "interest_rate": 8.25
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/epf", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"salary":50000,"employee_rate":12,"employer_rate":12,"years":20,"interest_rate":8.25}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"salary":50000,"employee_rate":12,"employer_rate":12,"years":20,"interest_rate":8.25}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/epf", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "salary": 50000,
  "employee_rate": 12,
  "employer_rate": 12,
  "years": 20,
  "interest_rate": 8.25
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.epf",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

厳密に正でない給与は、逆払いの物語や無給の月を作らず invalid_input で失敗します。

入力契約、応答の形、誤りの扱い

salary がゼロまたは負なら、salary は正の数でなければならないというメッセージで失敗します。正でない月給は拠出の土台として成り立たず、逆払いや無給の月として黙って扱ってはならない、必須の守りです。years が正の整数でないとき — ゼロ、負の回数、端数 — は部分年の付利規則を作らず失敗します。拠出率と金利はゼロから百まで（両端を含む）でなければなりません。金利ゼロは有効で、corpus は生涯の預入に等しくなります。段階給が必要ならご自身の昇給予定と組み合わせてください。すでに同じ給与と金利の前提を共有するページ、ワークシート、勤続年の一括シナリオ向けの、透明な五入力の EPF 退職 corpus が製品の問いであるときは、ここから始めてください。必須欄五つを含む JSON 本体を POST してください。salary は拠出率が掛かる月給で、ゼロより大きい有限数です（別名 monthly_salary、basic、wage）。employee_rate は従業員拠出をパーセントで、たとえば十二は給与の十二パーセントです（別名 employee、ee_rate）。employer_rate は実際に EPF 口座へ入る雇用主拠出をパーセントで示します（別名 employer、er_rate）。years は勤続年で、一から六十までの正の整数です（別名 service、tenure、n）。interest_rate は年利をパーセントで、たとえば 8.25 です（別名 rate、interest、annual_rate）。各数値欄は JSON の数でも数字の文字列でも届きます。欠落、空文字、真偽値、非有限値は欄名付きの invalid_input で失敗し、課金されません。成功時は salary、employee_rate、employer_rate、years、interest_rate を返し、monthly_contribution、annual_contribution、total_contribution を返し、corpus と interest_earned を二桁へ half-up し、閉じた形を述べる短い公式文字列を付けます。雇用主の十二パーセントが年金制度と積立に分かれるなら、口座に入らなかった金で corpus が膨らまないよう、EPF 分だけを employer_rate にしてください。

EPF計算が役立つ場面

確定拠出の退職を教える教育者は、月 50000 を 8.25 パーセントで一年と二十年に分けた教室例を植え、ゼロや負の給与を打ったときの硬い失敗を示せます。生の金利フィードも乱数の種も時計もありません。検証失敗は残高を消費しません。手取りと長期貯蓄を比べる給与と HR のチームは、同じ基本給を十二たす十二と、十二たす 3.67（年金分割後の EPF 分）で送り、一つの契約から corpus と interest_earned を読めます。実装は tier A の parse なので、成功した呼び出しはモデルトークンも外向きネットワークもなく公開の基本価格 $0.002 です。

連携の活用例

退職時corpusの計画

月給、従業員と雇用主の EPF 率、勤続年、年利を、記事・計画ツール・ページの widget 向けの見積 corpus と得た利息へ変えます。

確定拠出の教室確認

学習者に salary、率、years、interest_rate を送らせ、給与が正の数でないときの硬い失敗を含め、EPF の年末恒等式を確かめます。

技術的な質問

退職時の EPF corpus はどう計算しますか。

月次拠出 M は salary に (employee_rate プラス employer_rate) を掛けて百で割った値です。r を interest_rate を百で割った値とすると、corpus は M に (12 プラス 6.5 r) を掛け、((1 プラス r) の years 乗から 1 を引いた値) を掛けて r で割ったもの、利率がゼロならその加算項に years を掛けたものです。結果は二桁へ half-up します。

雇用主率には年金（EPS）分が含まれますか。

送った場合に限ります。本計算は受け取った employer_rate を EPF 口座へ入れます。雇用主の十二パーセントが年金制度と積立に分かれるなら、corpus が膨らまないよう EPF 分だけを employer_rate にしてください。

EPF計算の費用はいくらですか。

ブラウザの道具は無料です。API 要求は成功した呼び出しごとに前払い残高から $0.002 です。不正な入力は課金されません。

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