メインコンテンツにスキップ

【機能設定】SmartHR連携における初期設定

SmartHR連携における初期設定について説明いたします。

対応者:近藤純一

本ページでは、SmartHR連携における初期設定について、ご説明しています。 他サービスとの連携についての説明はありません。

⚠️ 注意点

  1. 現在は「SmartHR」との連携のみ対応しております。

  2. データ連携にはSmartHRでアクセストークンが発行できる管理者権限が必要です。管理者もしくは情報システム担当者の方へ共有・連携の上ご対応をお願いします。

■ 目次

SmartHR連携機能でできること

SmartHRに登録されている従業員データを、Nstockの「役員・従業員」に取り込むことができます。連携を行う上では、SmartHR側で事前に 外部連携用のアクセストークンの発行 を行う必要があります。

  • SmartHRから従業員情報を自動で取得し、差分をプレビューできる

  • 取り込みたい従業員を選んで、まとめてインポートできる

  • 氏名・メールアドレス・住所・在籍状況などの変更を検知して反映できる

連携の仕組み

SmartHR連携はAnyflow(外部連携プラットフォーム)を経由して行います。

初回設定時にSmartHRの認証を行うと、以降はNstockの画面からSmartHRのデータを取得・更新できるようになります。

SmartHRからNstockに連携されるデータは、以下を参照ください。

▼ 参考

⚠️ 注意点

既存の従業員データとの照合は「社員番号」で行います。SmartHR側の社員番号とNstock側の社員番号が一致するものが「更新対象」として表示されます。

そのため、Nstock側で社員番号の登録が必須となります。


1. SmartHR側でアクセストークンの発行を行う

アクセストークンの発行方法については、SmartHR側のヘルプページも参照ください。

まずは、自社のSmartHRアカウントにログインします。

以下の画面は、SmartHRでアクセストークンが発行できる管理者権限を持つ方に表示される項目です。表示されていない場合は、管理者もしくは情報システム担当者の方へ連携の上ご対応をお願いします。

左側メニュー欄の画面上部にある「共通設定」を開きます。

その後、「外部システム連携」をクリックします。

アクセストークン」を選択して開きます。

画面右側にある[+新規発行]をクリックします。

アクセストークンを払い出すための画面に移りますので、以下の情報を入力します。

  • アクセストークン名:例)社内勤怠システム連携用

  • メモ:アクセストークンの用途や説明を入力

  • アクセス制限ルール:確認の上選択

この時、「リソースのアクセス許可」にて参照項目のチェックを行います。

Nstockへの連携には、以下2つの項目にチェックが必須です。

  • 従業員情報:参照(更新にチェックはしない)

  • 会社情報:参照

それ以外の項目については、チェックを外していただくことを推奨しています。

※ チェックが付いていてもデータ連携時にエラーは起こりません。

また、ページ内下部に[従業員項目のアクセス許可]という項目が表示されます。

Nstockへのデータ連携には、以下表の「論理名」「物理名」の参考にチェックを入れる必要があるため、確認の上すべての項目にチェックを入れてください。

Nstockへのデータ連携にチェックが必要な参照項目

論理名

物理名

ユーザID

id

社員番号

emp_code

雇用形態

employment_type

在籍状況

emp_status

last_name

first_name

ビジネスネーム:姓

business_last_name

ビジネスネーム:名

business_first_name

電話番号

tel_number

住所

address

メールアドレス

email

入社年月日

entered_at

退職年月日

resigned_at

退職事由

resigned_reason

国籍 / 国籍コード

nationality_code

必要な参照項目にもチェックを入れたら、登録をしてアクセストークンを発行します。

発行した際に以下の例のようなトークンが表示されるので、そのトークンはコピーをして必ず控えておくようにしてください。

例)shr_5b55_xoxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

ここまでで、SmartHR側のアクセストークンの発行が完了します。

2. Nstock側でSmartHRとの認証設定を行う

が完了したら、次にNstock側での設定方法についてです。

Nstockの事務局アカウントにログインし[設定]>[機能設定-データ連携]を選択します。「SmartHR連携」の項目が表示されたら選択します。

SmartHR 従業員情報の取り込みにある[インストール]のボタンをクリックします。

データ連携の設定画面に移りますので、新規で設定される場合は、「新しい認証を追加」を押してください。

以下の赤枠の箇所の入力を行います。

内容を入力すると、SmartHR_アクセストークン名の書かれた項目が表示されます。

こちらを選択し[完了]を押します。

SmartHR 従業員情報の取り込みの設定が完了しました

が表示されたら、無事にNstockとSmartHRとの連携が完了となります。

その他補足

SmartHR側からNstockに連携されるデータ一覧

SmartHRからは以下の情報がNstockに連携され取り込まれます。

Nstock 項目名

SmartHR 項目名

変更可否

ビジネスネーム

ビジネスネーム姓, ビジネスネーム名

変更できる

電話番号

電話番号

変更できる

メールアドレス1

メールアドレス

変更可能(⚠️変更をするためには選択が必要 )

メールアドレス2

変更できない

管理番号

変更できない

社員番号

社員番号

変更できる

国コード

国籍コード

変更できる

郵便番号

現住所 - 郵便番号

変更できる

都道府県

現住所 - 都道府県

変更できる

市区町村

現住所 - 市区町村

変更できる

丁目・番地

現住所 - 丁目・番地

変更できる

建物名・部屋番号

現住所 - 建物名・部屋番号

変更できる

在籍状況

在籍状況

変更できる

入社年月日

入社年月日

条件付きで変更可能(⚠️ 入社日起算のSOがあるとエラー)

退職年月日

退職年月日

変更できる

退職事由

退職事由

変更できる

会社との関係

雇用形態

変更できない

データ連携が上手くいかない場合

データ連携の設定を行う際、「コネクションの作成が失敗しました」と表示された場合、入力内容に誤りがある可能性があります。

SmartHR側のサブドメイン、発行したアクセストークンを再度ご確認の上登録ください。

データ連携を削除する方法

一度連携したデータを削除したい場合、[設定]>[機能設定-データ連携]から、

右側の[操作▼]を選択してください。

「連携機能オフ」という項目を選択いただくと、連携情報を削除することができます。

こちらの回答で解決しましたか?