はじめに
概要
Basee Payroll Engine は、Basee 本体から独立した個別データを持たないステートレスな日本向け給与・賞与計算 API です。従業員のスナップショットと支給項目を送ると、健康保険・介護保険・子ども・子育て支援金・厚生年金・雇用保険・源泉所得税を計算し、控除額と手取り額、そして計算根拠を返します。
- 月例給与計算 — 健康保険・介護保険・子ども・子育て支援金・厚生年金保険・雇用保険・源泉所得税を算出し、手取り額を返します。
- 賞与計算 — 賞与についても同じ6種類の控除を算出します。
- シミュレーション — 社会保険料・雇用保険料・源泉所得税をそれぞれ単独で試算できる3種類のエンドポイントを提供します。
- マスタ照会 — 収録している所得税表・社会保険料率表・厚生年金保険料率表・雇用保険料率表のバージョン一覧を参照できます。
- 計算根拠(trace) — すべてのレスポンスに、既定で適用した料率・端数処理・参照マスタを含む計算ステップの trace を含めます(
calculation_options.include_calculation_trace: falseを指定した場合を除く)。検算や監査に使えます。 - 法改正へのバージョン追従 — 料率・税額表はバージョン管理されており、支払日に応じて有効な版を自動で解決します。改定があっても呼び出し側のコード変更は不要です。
できないこと
Section titled “できないこと”このAPIは、給与計算のうち「間違えられない計算と、終わらない法令追従」だけを引き受ける設計です。次の部分は意図的にスコープ外とし、あなたのシステムや Basee に任せます。
- 年末調整 — 年末調整の計算は行いません。
- 住民税額の計算 — 住民税額そのものは計算せず、リクエストで渡された金額をそのまま控除に反映するだけです。
- 給与明細の発行 — 明細書としての出力・保存は行いません。
- 従業員データ・計算結果の保存 — 従業員台帳や計算結果を保持しません(詳細は下記「ステートレス設計」)。
ステートレス設計
Section titled “ステートレス設計”このAPIは個人データ・計算結果を保持しません。従業員台帳、給与明細・賞与明細、勤怠実績、支払履歴、そしてリクエスト/レスポンスの内容や calculation_trace そのものも、サーバー側には保存されません。保存するのは会社別の計算設定(計算プロファイル・社会保険設定)と、法定マスタ(税額表・料率表・端数処理ルールとそのバージョン・有効期間)だけです。
計算のたびに必要な情報を送り、結果を受け取ったらサーバー側では破棄される——という設計そのものが、個人データの漏洩リスクを構造的に減らします。
現在、このAPIはすべて無料でご利用いただけます。単体利用(Basee本体を使っていないアカウント)についても、現時点では料金は発生しません。
将来的に単体利用は有料化する可能性がありますが、Baseeをご利用中のアカウントは今後も無料でご利用いただけます。