はじめに
クイックスタート
このページでは、ダッシュボードでの準備からAPIキーの発行、最初の計算リクエストまでを順番に説明します。
1. ダッシュボードで準備する
Section titled “1. ダッシュボードで準備する”APIを呼び出す前に、ダッシュボード で次の5ステップを済ませます。
① アカウント登録
Section titled “① アカウント登録”https://app.payroll.basee.io からアカウントを作成します。
② メール認証
Section titled “② メール認証”登録したメールアドレス宛に届く確認メールから、メールアドレスの認証を完了します。
③ 会社を作成する
Section titled “③ 会社を作成する”ダッシュボードから、計算対象となる会社を作成します。
④ 社会保険を設定する
Section titled “④ 社会保険を設定する”会社の詳細画面から、社会保険の設定を行います。設定方法は次の2通りです。
- 都道府県を選び、協会けんぽの料率プリセットを適用する
- 都道府県に加えて、独自の保険料率をインラインで登録する
いずれの場合も都道府県の指定は必須です。
⑤ APIキーを発行する
Section titled “⑤ APIキーを発行する”APIキーの発行に必要なのは、②のメール認証だけです。④の社会保険設定はキー発行の条件ではなく、計算リクエストを送るための前提です(未設定でもキーは発行できますが、計算はできません)。メール認証が済んでいれば、この時点でAPIキーを発行できます。
2. 最初の計算をしてみる
Section titled “2. 最初の計算をしてみる”APIキーを発行したら、月例給与の計算を試してみましょう。以下は最小構成の実行例です(<YOUR_API_KEY> は発行したキーに置き換えてください)。
curl -X POST https://api.payroll.basee.io/v1/payroll/monthly:calculate \ -H "Content-Type: application/json" \ -H "X-API-Key: <YOUR_API_KEY>" \ -d '{ "company_id": "cmp_docs_quickstart_example", "calculation_date": "2026-07-27", "payment_date": "2026-07-27", "period": { "payroll_month": "2026-07", "start_date": "2026-07-01", "end_date": "2026-07-31" }, "employee_snapshot": { "employee_ref": "emp_docs_example_001", "tax_dependent_count": 1, "tax_table_type": "kou", "is_social_insurance_subject": true, "is_employment_insurance_subject": true, "standard_monthly_remuneration": 300000, "care_insurance_subject": false }, "base_pay": 300000, "allowances": [ { "code": "commuting_allowance", "name": "通勤手当", "amount": 15000, "taxable": false, "social_insurance_included": true, "employment_insurance_included": true } ], "custom_deductions": [], "resident_tax_amount": 0 }'employee_snapshot.standard_monthly_remuneration には、呼び出し側で報酬月額から決定した健康保険の標準報酬月額を指定します。厚生年金保険料の計算では、エンジンが厚生年金等級表の最小・最大へ自動クランプします。
報酬月額から標準報酬月額を求めるには、シミュレーションの標準報酬月額 等級解決エンドポイントが使えます。
上記リクエストを2026年8月7日に dev API へ送信した実レスポンスです。資格情報と実会社IDは掲載せず、company_id はドキュメント用のダミー値へ置き換えています。
{ "calculation_id": "calc_0de3b124-ed95-4f20-961c-ce1bfebf1916", "calculation_type": "monthly_payroll", "company_id": "cmp_docs_quickstart_example", "employee_ref": "emp_docs_example_001", "calculated_at": "2026-08-07T05:12:07.894Z", "settings_snapshot": { "company_profile_version": "000001", "tax_table_version": "2026", "social_insurance_rate_version": "attack5-sv-0088a0d4", "employees_pension_rate_version": "fixture-employees-pension-2026-04-01", "employment_insurance_rate_version": "fixture-employment-insurance-2026-04-01", "rounding_rule_version": "fixture-round-half-up-v1" }, "amounts": { "gross_payment": 315000, "taxable_payment": 300000, "social_insurance_subject_amount": 315000, "standard_monthly_remuneration_used": 300000, "employees_pension_standard_monthly_remuneration_used": 300000, "employment_insurance_subject_amount": 315000, "income_tax_basis_amount": 255698, "statutory_deductions": { "health_insurance": 14775, "care_insurance": 0, "childcare_support_contribution": 345, "employees_pension_insurance": 27450, "employment_insurance": 1732, "income_tax": 4710, "resident_tax": 0, "total": 49012 }, "custom_deductions": { "items": [], "total": 0 }, "total_deductions": 49012, "net_payment": 265988 }}上の例では省略していますが、実際のレスポンスにはさらに calculation_trace という配列が含まれます。設定解決(settings_resolution)→支給合計(payment_aggregation)→社会保険料の基礎額(monthly_social_insurance_basis)→健康保険→介護保険→子ども・子育て支援金→厚年標準報酬月額のクランプ(employees_pension_standard_monthly_remuneration)→厚生年金保険→雇用保険→源泉所得税→手取り額算出(net_payment)まで、計算の各ステップを1件ずつ記録したものです。
レスポンスの見どころ
Section titled “レスポンスの見どころ”amounts.statutory_deductions— 健康保険・介護保険・子ども・子育て支援金・厚生年金保険・雇用保険・源泉所得税それぞれの控除額と、その合計です。amounts.standard_monthly_remuneration_used/amounts.employees_pension_standard_monthly_remuneration_used— 前者は健康保険・介護保険・子ども・子育て支援金、後者は厚生年金保険に使用した標準報酬月額です。amounts.net_payment— 総支給額から法定控除・任意控除を差し引いた手取り額です。calculation_trace— 各計算ステップごとに、適用した料率・端数処理ルール・参照したマスタのバージョンが記録されています。検算や監査の根拠として使えます。