給与エクスポート連携
グループ別に区切られた期間を封印する際、Klacksはその給与データを外部の給与システムへ自動的に引き渡すことができます。このページでは、そのための前提条件と、なぜこの引き渡しが時折何も出力していないように見えるのか — この機能に関する最も多いサポート事例 — を説明します。
仕組み
前提条件: 給与エクスポート用のアドオン。 給与システムへの自動引き渡しはコア機能ではなく、独自のアドオンを必要とします。このアドオンは設定 > 機能プラグインでインストールされ、かつ有効化されている必要があります。アドオンがインストールされていない、または無効化されているだけの場合、引き渡しは一切何も出力しません — ファイルも、通知も、あなたに見える形のエントリーも何もありません。これはエクスポート設定で無効化されたエクスポート形式よりも厳しい挙動です: そちらは少なくともサーバーログにエントリーを残しますが、ここではそれすらありません。
一度限りの引き渡し(べき等性)。 自動引き渡しは、グループ・連携先システム・正確な日付範囲の組み合わせごとに、ちょうど1回だけ実行されます — これにより、同じ給与データが誤って2回給与システムに届くことを防ぎます。既に封印済みの期間を再度開いて何かを修正し、再び封印すると、2回目の引き渡しは何の通知もなく省略されます: このまったく同じ組み合わせに対しては既に引き渡しエントリーが存在しており、再オープンしてもそのエントリーは消えません。
手動ダウンロードも同じように扱われます。 同じグループ・同じ連携先システム・同じ期間に対する任意の手動給与ダウンロードは、自動引き渡しと同じエントリーを生成します。自動引き渡しより前に実行された手動ダウンロードは、対象期間について、まるで自動引き渡しが既に実行済みであったかのように、その枠を「消費」します。
| なぜ何も(新たに)届かなかったのか | エントリーは存在するか | 後の手動ダウンロードをブロックするか |
|---|---|---|
| アドオンが未インストール/無効 | いいえ | いいえ |
| このまったく同じ組み合わせに対して既に引き渡し済み | はい(期間締めの「ログ」タブで確認可能) | いいえ |
2つの精密なポイント:
- 手動ダウンロードは、サポートによって登録された可能性のあるエクスポート形式の補正を一切反映しません — 連携先システムに対して自動経路では適用されるはずの有効な補正が存在していても、常に標準値を使用します。
- 一度限りのロックは厳密です: 同一のグループ、同一の連携先システム、同一の開始日・終了日の場合にのみ働きます。別の期間や別の連携先システムは、以前の引き渡しによってブロックされることはありません。
封印後に何も届かない場合、または修正後の数値を改めて届ける必要がある場合: まず、該当するアドオンが設定 > 機能プラグインでインストールされ、有効になっているかを確認してください。再オープンして修正を行った後、修正済みの数値を確実に給与システムへ届ける方法は、期間締め画面(「エクスポート」タブ)にある手動エクスポートです — これはアドオンによるロックにも、自動引き渡しの一度限りロックにも影響されません。ただし、こちらもエクスポート形式の補正を反映しないため、この場合はエクスポートされた数値を、有効な補正があれば手動で照合してください。
知っておくと良いこと
- あらゆる引き渡しの前提となるのは、グループ別に区切られた封印済みの期間です — 期間の封印方法については期間締めのページで説明しています。封印と再オープンは、そちらでは管理者ロールに限定されています。
- このページでは、Klacksから給与システムへの給与データのエクスポートについて説明しています。逆方向の流れ — ERPシステムからKlacksへの注文のインポート — については、ERP連携ポイントで説明しています。
- アドオンは設定 > 機能プラグインで一元管理されます: インストール、有効化/無効化、または完全な削除が行えます。
- 無効化されたアドオンはインストールされたままですが、自動引き渡しを、未インストールの場合とまったく同じように完全にブロックします。
直接お試しください: Klacks Playground — ログイン admin@test.com / P@ssw0rt1、データは毎日リセットされます。