本レシピはStandardプラン以上の有償プランでご利用いただけます。ご利用をご希望の場合は下記よりお問い合わせください。
お問い合わせ | ActRecipe
本レシピは、SmartHRの任意の従業員情報を給与奉行iクラウド・給与奉行V ERPクラウド(以降、奉行クラウドと記載)へ連携するレシピ「SmartHR - 給与奉行クラウド連携」実行後、その結果内容を参照する際にご利用いただけます。
本記事では、その設定方法について解説します。
まだ、上記レシピを実行していない場合は、下記のリンクを参考に設定・実行してください。
1.マイレシピへの登録
メニューの「シェアレシピ」から、「奉行クラウド インポート確認」にチェックを入れ、画面下にある登録ボタンを押下します。シェアレシピの画面に「奉行クラウド インポート確認」が表示されない場合はSmartHR Plusの画面からやり直してください。
続いて「マイレシピ」から、操作メニューより「編集」を選択します。
参考:シェアレシピ・マイレシピとはなんですか?
ヘッダーでは、レシピ名とレシピ説明を変更することができます。
参考:レシピヘッダーでは何を設定すれば良いですか?
2.奉行クラウドの接続設定
「奉行クラウド - 社員情報登録」を押下し、設定を展開します。
本タスクでは、以下の項目を設定します。
-
トークン:
- 「認証トークンを取得する」を押下後、奉行クラウドのURL、パスワード等を入力します。
- 「『ActRecipe』から『奉行クラウド』へのアクセスを許可しますか?」に対して「許可する」を押下します。
-
トークンが発行されますので、コピーしてください。
- 対象レシピID:結果内容を参照したい「奉行クラウド連携」レシピのレシピ番号を入力ください。
レシピを実行する (自動実行はこちら)
マイレシピの操作メニューより「実行」を選択することでレシピを実行できます。
画面イメージや履歴の確認方法は以下をご参照ください。
レシピ実行履歴
レシピの実行に成功すると、実行ログに「SmartHR - 給与奉行クラウド連携」実行時に出力されたオペレーションIDごとに結果内容が表示されます。
【結果内容について】
主なエラーログと原因は以下の通りです。
【エラーログ】
ステータス:警告
サーバーメッセージ: [{'index': 0, 'key': 'HM3010001', 'data': '社員番号', 'reason': '社員番号の桁数が、上限の6文字を超えています。'},
【原因】
奉行クラウド側で設定されている「社員番号」の受入可能桁数(この場合は6文字)を、SmartHRから連携された社員番号が超えているためです。
・奉行側の設定変更:「メインメニュー右上 [設定] > [運用設定] > [社員情報]」より、社員番号の桁数設定を拡張してください。
・SmartHR側のデータ修正:奉行側で設定されている桁数内に収まるよう、SmartHR上の社員番号を修正してください。修正完了後、再度インポートレシピを実行します。【エラーログ】
ステータス:警告
サーバーメッセージ:以下の受入記号が正しくありません。
・○○○○○○○○○
タスク処理を正常に終了しました。
【原因】
奉行クラウド側で定義されていない、または無効な項目名(受入記号)がコンバート設定に含まれているためです 。APIリクエスト時に使用する「HM」から始まるヘッダー名などが、奉行側の仕様と一致していない可能性があります。
・コンバート設定の確認: SmartHR - 給与奉行クラウド連携レシピのタスク2>出力フォーマット>項目名の設定を確認し、エラーメッセージに表示された項目名(受入記号)が正しいか、奉行クラウド連携項目と照らし合わせて修正してください。【エラーログ】
ステータス:警告
サーバーメッセージ:: [{'index': 0, 'key': 'HM3011002', 'data': '一般の障害者', 'reason': '障害者区分に指定された値は、範囲外または許可されていません。'}],
【原因】
「障害者区分」などのコード値を登録する項目において、奉行クラウドが許容していない値が連携されたためです 。SmartHR側の設定値が、奉行側が期待する数値コード(例:性別の場合は0や1など)に正しく変換されていない可能性があります。
・コード値の確認と修正: 奉行クラウドの仕様に基づき、対象項目に設定可能なコード値を確認してください。
・コンバート設定の修正: SmartHR - 給与奉行クラウド連携レシピのタスク2>出力フォーマット>出力指定にて、SmartHRの値を奉行側が指定する正しいコード値(数値等)に変換するよう設定を修正し、再度レシピを実行してください。
FAQ
Q1.なぜ「インポート」と「結果確認」でレシピが分かれているのですか?
A1.給与奉行クラウドのAPIは、リクエストを受け付けてから登録完了まで裏側で時間をかけて処理を行う「非同期実行タイプ」であるためです 。そのため、まず登録を依頼するレシピを実行し、その後に「結果確認レシピ」を実行して、登録が正常に完了したかを確認する構成となっています 。
Q2.インポート結果の確認はいつ行えばよいですか?
A2.「SmartHR - 給与奉行クラウド」レシピの実行完了後に行います 。なお、一度確認済みのオペレーションIDを再確認することはできません。
Freeプランについて
このレシピはActRecipeのFreeプランでご利用いただけます。Freeプランの制約事項や有償プランへの移行は下記をご覧ください。
このレシピで連携できるSaaSについて
その他のSmartHR連携ができるレシピ