SmartHR連携について

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で操作したスタッフにメールアドレスが登録されていれば、エラー内容が通知されます。