通常給与と残業代の計算機

アルゴリズムは完全に決定的であり、同じ入力は給与デモ、人事ボット、フリーランス用シート、継続的インテグレーション用フィクスチャに対して常に同じ JSON を生成します。負の時給は明確な invalid_input エラーで拒否されます。

入力：時給、通常時間、残業時間、倍率

例えば 1.5 は時間半、2 は倍額であり、賃金のパーセンテージではありません。負の時間数と負の倍率も拒否され、符号の取り違えが給与明細上の不条理な負数を生む代わりに明確に失敗します。極端に大きな時給、時間合計、倍率は上限が設定され、Worker isolate の計算が負荷下でも有界で予測可能に保たれます。通常時間と残業時間の区分は、お客様の現地ルールまたは会社方針の下ですでに決まっています。本計算機は週四十時間の閾値や日次残業表を発明せず、送信された値を掛けます。その分離により検索意図が明確になります。すでに通常と OT の分割を知っている人は、法域エンジンではなく金額の行を求めています。単一の支払期間を表す四つの必須フィールドを含む JSON 本体を送信してください。hourly_rate は、非負の有限数または数値文字列としての基本時給です。クライアントが既に別名でフィールドを付けている場合、rate、wage、hourly、pay_rate のエイリアスが受け付けられます。regular_hours は、その基本時給で支払われる定時時間です。エイリアス hours、straight_hours、regular、straight_time は同じ値にマップされるため、フォームビルダーはペイロードを書き直さずに馴染みのあるラベルを保てます。overtime_hours は同一支払期間の割増時間です。エイリアス ot_hours、overtime、ot がサポートされるため、タイムシートのエクスポートは最小限の接着コードで列をマップできます。overtime_multiplier は基本時給の倍数として表される割増です。エイリアス multiplier、ot_multiplier、ot_rate、premium は同じフィールドにマップされます。負の時給は通常の給与明細を表さないため invalid_input で検証に失敗します。四つのフィールドのいずれかが欠けると、欠落キーを名指しして invalid_input で失敗します。すべての検証は金銭計算の前に行われるため、不正なリクエストが半分だけ埋まった給与行を UI が成功と誤読する形で返すことはありません。四つのフィールドを SDK に一度文書化し、デモ、ボット、結合テストで同じ形を再利用してください。

通常給、残業代、総支給の計算方法

中核の式は、タイムシートや週次見積もりで人が手計算するのと同じものです。総支給はその二行の合計であり、通常と残業の収入が一つの不透明な合計に潰れず、別々の構成要素として見えるままです。例：時給が二十、通常時間が四十、残業時間が五、倍率が 1.5 の場合、丸め後に通常給八百、残業代百五十、実効 OT 時給三十、総支給九百五十になります。すべての法域で同じ計算を行うのは意図的な製品範囲です。日次残業閾値、第七日ルール、税源徴収は別の検索意図と別の契約になります。通常給は hourly_rate に regular_hours を掛けた値です。残業代は hourly_rate に overtime_multiplier と overtime_hours を掛けた値です。応答はさらに ot_hourly_rate を hourly_rate に倍率を掛けた値として返し、UI はクライアント側で再計算せずに基本時給の隣に実効残業時給を表示できます。中間積は通常の浮動小数点演算を用い、その後すべての金額フィールドが half-up で小数第二位に丸められるため、結果は長くて分かりにくい二進分数ではなく給与明細上の通貨のように見えます。応答は正規化された時給、通常時間、残業時間、残業倍率をエコーし、続けて ot_hourly_rate、regular_pay、overtime_pay、gross_pay を返し、さらに currency_decimals が 2、method が overtime_gross となり、バージョン間で安定したクライアント分岐が可能です。定時の行だけが必要なときは regular_pay のみを使い、割増の行が必要なレポートでは overtime_pay を、請負請求や週次見積もりで合計額が必要なときは gross_pay を使ってください。

API の使い方、価格、ワークフロー、実用上の制限

人事ボット、フリーランス用ダッシュボード、人材ポータル、タイムシート補助が安定した KIT 契約を必要とする場合は、成功項目あたり $0.002 のプリペイド API を使ってください。検証失敗はエンジンがリクエストを拒否したあと残高を消費しません。手取りの規則を別途すでに把握している場合にのみ、税や控除のツールと本エンドポイントを組み合わせてください。入力は他の KIT parse 項目と同じ保持規則に従い、アルゴリズムは Worker isolate とローカル Node 実行の間で完全に決定的であるため、結果は継続的インテグレーション用フィクスチャに固定しても安全です。SDK を出荷する作者は、half-up の金額丸めを再発明せずに、regular_pay、overtime_pay、gross_pay を給与明細 UI、見積メッセージ、エクスポート列に直接マップできます。製品文で API 価格に言及するときは、カタログ更新後も公開ページがライブの価格下限に揃うよう、カタログのプレースホルダ $0.002 を使ってください。