目次
SmartHRから連携可能なスタッフマスタ情報
SmartHRにて従業員情報を新規作成、更新、インポートしたタイミングでFLAROのスタッフマスタ情報と連携します。
| SmartHR | FLARO |
|---|---|
| 姓 | 姓 |
| 名 | 名 |
| 姓（ヨミガナ） | セイ |
| 名（ヨミガナ） | メイ |
| 生年月日 | 生年月日 |
| 戸籍上の性別 | 性別 |
| メールアドレス | メールアドレス |
| 入社年月日 | 入社日 |
| 退職年月日 | 退職日 |
| 社員番号 | スタッフコード |
| 雇用形態 | 雇用形態※ |
| 部署1 | 所属組織※ |
| 役職1 | 役職※ |
| 住所（郵便番号） | 郵便番号 |
| 住所（市区町村） | 住所1 |
| 住所（丁目・番地） | 住所1 |
| 住所（建物名・部屋番号） | 住所2 |
| 電話番号 | 電話番号 |
※ FLAROに新規登録される時のみ連携します
連携できないスタッフ情報について
FLAROでは姓・名、スタッフコード、入社日、所属組織情報が必須なため、SmartHRの対応項目が未入力の場合は、スタッフマスタ情報が連携されません。
スタッフコードが10文字以上の場合も連携されません。
連携するスタッフ情報について
SmartHRから連携した社員番号とFLAROのスタッフコードをキーとしてFLAROのスタッフマスタ情報を連携します。
SmartHRから連携した社員番号がFLAROのスタッフマスタに存在しない場合、スタッフ情報を新規登録し、存在する場合はスタッフ情報を更新します。
スタッフの新規登録時、権限は閲覧範囲が所属組織、機能権限はレベルが最下位のもので登録されます。
雇用形態・部署・役職の連携について
雇用形態、部署、役職の連携については新規登録時のみとなり、名称ではなく、それぞれのコードがFLAROに登録されているコードと一致する場合に連携されます。
それぞれの適用年月日は入社日で登録されます。
SmartHRでの設定方法
１．［アプリ一覧］の［共通設定］をクリックします。画面左側に表示される共通設定の一覧から
［外部システム連携］をクリックすると、外部システム連携画面が表示されます。
２．[API連携]の[Webhook]をクリックします。画面に表示されている[Webhook を登録する]ボタンを
クリックすると、Webhookの登録画面が表示されます。
３．Webhookの登録画面で以下の内容で入力し[登録する]ボタンをクリックします。
URL：https://{お客様のURLから判断して入力※1}/v1/external/smarthr/staff
※1 お客様がアクセスするFLAROのURLから判断します
https://sample.fl001.flaro.jp の場合、「api.flaro.jp」を入力します
https://sample.fl002.flaro.jp の場合、「fl002.api.flaro.jp」を入力します
Webhook の用途・説明：スタッフ登録・更新用
シークレットトークン：[自動生成]ボタンをクリックする
送信のトリガーとなるイベント：[従業員の追加]、[従業員の更新]にチェックを付ける
４．Webhookの登録画面で以下の内容で入力し[登録する]ボタンをクリックします。
URL：https://{お客様のURLから判断して入力※1}api.flaro.jp/v1/external/smarthr/staff/import
Webhook の用途・説明：スタッフインポート用
シークレットトークン：[自動生成]ボタンをクリックする
送信のトリガーとなるイベント：[従業員のインポート]にチェックを付ける
FLAROでの設定方法
１．設定＞外部連携設定＞SmartHR連携マスタをクリックします。SmartHR連マスタ携画面が表示されます。
２．SmartHR連携マスタ画面で以下の内容で入力し[新規登録]ボタンをクリックします。
シークレットトークン：SmartHRの従業員の追加・更新のWebhookで作成したシークレットトークン
送信のトリガーとなるイベント：[従業員の追加・更新]にチェックを付ける
３．SmartHR連携登録画面で以下の内容で入力し[登録する]ボタンをクリックします。
シークレットトークン：SmartHRの従業員のインポートのWebhookで作成したシークレットトークン
送信のトリガーとなるイベント：[従業員のインポート]にチェックを付ける
SmartHRとのスタッフ情報連携結果を確認する
設定＞外部連携設定＞SmartHR連携をクリックします。SmartHR連携画面が表示されますので、連携の確認を行うことが出来ます。
エラーが発生した場合は、SmartHRで操作したスタッフにメールアドレスが登録されていれば、エラー内容が通知されます。