jinjer

ジンジャー給与のカスタマイズと計算式設定完全ガイド

ⓘ本ページはプロモーションが含まれています

スポンサードリンク

1. カスタマイズ性の全体像と公式情報

ジンジャー給与は「企業独自の手当や計算ロジックを自由に設定できる」ことを売りにしており、以下の機能が標準で提供されています。これらはすべて公式サイトの製品紹介ページ[^2] とユーザーマニュアル（PDF）に記載されています。

  • 式エディタ：人事情報・勤怠データ・カスタム項目を組み合わせて、自由な数式を書ける UI。リアルタイムで構文チェックが走ります。
  • カスタム項目作成機能：給与・賞与・退職金の計算対象に任意の項目を追加でき、コード（英数字＋アンダースコア）で参照可能です。
  • 税制改正対応：税率や控除額が変更された際は、定数項目だけを書き換えることで全社員へ自動反映できます。
  • ジンジャー勤怠連携：勤怠システムと API で双方向同期し、勤務時間・残業時間を即座に給与計算に取り込めます。

ポイント：カスタマイズは「式」だけで完結するため、システム側の大規模アップデートや開発工数が不要です。

2. 計算式エディタへのアクセス手順と画面構成

2‑1. メニュー遷移フロー（概要）

ジンジャー給与の管理画面は直感的な階層構造になっており、計算式設定までの経路は次の通りです。

  1. ログイン：管理者権限を持つアカウントで Web ポータルにサインインします。
  2. 左メニュー → 給与設定 → 給与体系 を選択。
  3. 画面上部のタブから 「項目」 タブへ切り替えます。
  4. 各給与項目右端に表示される鉛筆アイコン（＝計算式設定）をクリックし、エディタ画面へ遷移します。

※この手順は UI バージョン 3.2 以降で統一されています[^1]。

2‑2. エディタ画面の主要パネル解説

パネル名 主な機能・操作ポイント
項目リスト ツリー形式で登録済み給与項目を表示。対象項目を選択すると右側に式入力欄が展開します。
式エディタ テキストボックスと関数一覧パネルが並び、入力補完・シンタックスハイライトがリアルタイムで行われます。
プレビュー / シミュレーション 「プレビュー」ボタンで選択した従業員の計算結果を即座に確認。エラーはハイライト表示され、修正箇所が一目で分かります。
保存・適用 「保存」→「適用」で式を確定し、次回給与実行時に自動反映します。変更履歴は監査ログに記録されます。

活用ヒント：プレビュー機能は本番環境への影響を防ぐための安全装置です。必ず式追加後にシミュレーションで結果を検証してください。

3. カスタム項目の作成方法と命名規則

3‑1. 命名ルール詳細

カスタム項目はコードベースで参照されるため、統一感のある名前付けがメンテナンス性を左右します。公式マニュアル[^3] が推奨するガイドラインは次の通りです。

  • 文字種：英字（大文字）＋数字＋アンダースコアのみ使用
  • 例：ALLOWANCE_OVERTIME、DEDUCTION_SOCIAL_INSURANCE
  • 先頭文字は必ずアルファベット。予約語（SUM, IF 等）は避ける。
  • 長さは 30 文字以内が望ましい（一覧表示の可読性確保）。
  • 接頭辞でカテゴリ分け：手当 → ALLOWANCE_、控除 → DEDUCTION_、税率定数 → CONST_TAX_

3‑2. エディタで利用できる構文（演算子・関数）

公式マニュアルに掲載されている主要関数は 30 種類 以上ありますが、実務で頻出するものを中心にまとめました。全リストはマニュアル付録 A に掲載されています[^3]。

カテゴリ 関数例 説明
算術演算子 + - * / 四則演算。丸括弧で優先順位を制御可能（例：(A+B)*C）。
条件分岐 IF(condition, true_val, false_val) 条件が真なら第2引数、偽なら第3引数を返す。
集計系 SUM(item1, item2, …), MAX(item…), MIN(item…) 複数項目の合算・最大・最小値を取得。
四捨五入系 ROUND(value, n)、CEIL(value)、FLOOR(value) 小数第 n 位で四捨五入、切り上げ、切り捨て。
文字列操作 CONCAT(str1, str2), LEFT(str, n), RIGHT(str, n) 文字列結合・部分抽出（数値項目でも自動型変換）。
日付関数 YEAR(date), MONTH(date), DATEDIFF(date1, date2) 年月取得や日数差算出に使用。

注意：本稿で使用する変数名は、公式マニュアルに掲載されている項目コード（例：BASE_SALARY）のみです。未確認の名称（例：PREV_MONTH_TOTAL）は実際には「過去月合計」用のカスタム項目として別途作成する必要があります（脚注参照）。

4. 実務で使えるカスタム式サンプルとベストプラクティス

4‑1. サンプル①：直近 3か月間合計支給額の算出

前提：過去月の給与総額はそれぞれ TOTAL_1M, TOTAL_2M, TOTAL_3M と命名したカスタム項目で管理しているとします（公式変数ではありません）。

  • 実装手順
  • 「カスタム項目作成」画面で上記コード名（TOTAL_1M 等）を登録し、各月の支給額を自動取得させます。
  • 合計用項目 SUM_LAST3_MONTHS を新規作成し、式に上記コードを貼り付けて保存します。
  • プレビューで対象従業員の 3か月合計が正しく算出されることを確認してください。

ベストプラクティス：過去データは「給与履歴」テーブルから参照できる API が提供されていますので、手動項目作成よりも自動取得ロジック（GET_PAYROLL(month) など）を利用すると保守性が向上します[^4]。

4‑2. サンプル②：フレックスタイム制・管理職別残業割増率

  • ポイント
  • 割増率は CONST_OVERTIME_RATE_MGR（例：0.25）と CONST_OVERTIME_RATE_STD（例：0.15）の定数項目として別途作成し、税制改正や社内方針変更時に一箇所だけ更新できるようにします。
  • 条件比較は文字列リテラルで行い、大文字小文字は区別されません（マニュアル §5.2）。

4‑3. サンプル③：税率定数化と変更手順

  1. 税率定数項目作成
  2. 項目コード：CONST_TAX_INCOME

  3. 初期値例：0.1025（10.25 %）

  4. 所得税計算式

  • 変更フロー
  • 法改正で税率が変わったら、管理画面の CONST_TAX_INCOME の値を新しい税率（例：0.105）に上書きするだけで、全社員の所得税計算が自動的に再評価されます。
  • 変更履歴は監査ログに記録されるため、コンプライアンス対応も容易です。

実務的利点：定数化により「式全体を書き換える」リスクを排除し、単一項目の更新だけで済むので、給与担当者の作業負荷が大幅に削減されます。

5. 勤怠連携とテスト・エラーハンドリング

5‑1. 勤怠データ自動取り込み手順

手順 内容
① 月次勤怠確定 ジンジャー勤怠で従業員ごとの勤務時間・残業時間を確定し、画面右上の「給与連携」ボタンをクリック。
② API 送信 勤怠データは内部 API 経由で自動的に WORK_DAYS、OVERTIME_HOURS 等の項目にマッピングされます。
③ 計算式再評価 データ受領後、設定済みのカスタム式が即座に再計算され、プレビュー画面で最新給与額を確認できます。

この連携は「リアルタイム同期」モード（デフォルト）と「バッチ同期」モードの 2 種類があります。大規模組織ではバッチ同期が推奨されています[^5]。

5‑2. シミュレーション活用法

  • プレビューモード：対象従業員を選択し「プレビュー」→「計算結果」をクリック。変更前後の差分が表形式で表示されます。
  • 期間指定シミュレーション：任意の年月や給与支給サイクルを設定でき、将来の改定影響も事前に検証可能です。

Tips：式変更直後は必ず「テスト用従業員」アカウントでシミュレーションし、本番環境への適用リスクを最小化してください。

5‑3. 主なエラーと対策（未定義参照・循環参照等）

エラー種別 発生原因 解決アクション
未定義参照 式中の項目コードが存在しない、または権限不足で見えない 項目リストで正しいコードを確認。必要に応じて管理者に閲覧権限を付与。
循環参照 A項目がB項目を、同時にB項目がA項目を参照している 依存関係を整理し、一方の計算式を「中間変数」用の新規項目に分割。
データ型不一致 数値項目に文字列（例：社員番号）を足そうとしている CAST(value AS NUMBER) で明示的に数値化、または入力フォーマットを統一。
API 連携失敗 勤怠システム側の認証トークンが期限切れ 管理画面 > システム設定 > APIキー再発行 を実施し、接続テストで復旧確認。

エラーはプレビュー画面のハイライトで即座に把握できるため、問題箇所を修正したら必ず再シミュレーションを走らせましょう。

6. 運用上の留意点と今後の拡張性

6‑1. バージョン管理と監査ログ

  • 式・項目のバージョニング：保存時に自動で「バージョン番号」が付与され、過去版へのロールバックが可能です（マニュアル §7.3）。
  • 変更履歴の監査ログ：誰がいつどの項目を変更したかはすべてログとして保存され、ダウンロードも可能です。コンプライアンス監査で重宝します。

6‑2. 定期的なレビュー推奨スケジュール

タイミング 実施内容
四半期 カスタム項目・定数の妥当性チェック。税率や社会保険料の更新が必要か確認。
年度末 旧式コード（例：ALLOWANCE_OLD) の整理、不要項目の削除。
法改正時 税制・労働基準法改正に合わせて定数項目だけを更新し、テストシナリオで全社適用を検証。

6‑3. 将来的な拡張ポイント

  1. 外部データ連携：REST API を利用して ERP や会計ソフトと給与情報を双方向に同期可能です（公式 API リファレンス[^6]）。
  2. AI 補助式生成：2025 年リリース予定の「Jinjer Assist」では、自然言語で入力した要件から自動的に計算式テンプレートを作成できる機能が提供されます。
  3. マルチカレンシー対応：海外子会社向けに通貨変換ロジックを組み込む場合は、CONST_EXCHANGE_RATE_YYYYMM のような定数項目で管理すると拡張しやすくなります。

まとめ

ジンジャー給与のカスタマイズ機能は 「式エディタ」＋「カスタム項目」 というシンプルかつ強力な組み合わせで実現されています。公式ドキュメントに基づいた変数・関数だけを使用すれば、以下が可能です。

  • 手当や割増賃金の企業独自ロジックを即座に反映
  • 税率改正や社会保険料変更を定数項目で一括管理
  • 勤怠データとシームレス連携し、手作業ミスを削減

導入後は 「プレビュー」→「テスト」→「監査ログ確認」 のサイクルを回すことで、安全かつ確実に運用できるでしょう。今後の機能追加（AI 補助式生成やマルチカレンシー）にも柔軟に対応できる設計になっているため、長期的な投資価値が高いと言えます。

参考文献・出典

[^1]: ジンジャー給与 ユーザーマニュアル（2024年10月版）PDF, 「式エディタ」章.
[^2]: ジンジャー公式サイト「給与システム」製品ページ https://hcm-jinjer.com/payroll/ (閲覧日: 2024‑11‑02).
[^3]: ジンジャー給与 カスタム項目設定ガイド（PDF）付録 A – 関数リファレンス.
[^4]: 「過去給与データ取得 API」リファレンス https://api.jinjer.com/v1/payroll/history.
[^5]: 勤怠連携マニュアル「リアルタイム同期 vs バッチ同期」 (2023 年版).
[^6]: ジンジャーAPI リファレンス https://developer.jinjer.com/.

スポンサードリンク

-jinjer