SmartHR

​

サポートする機能

従業員マスター連携 アカウント削除 アカウント作成

​

SmartHRとの連携について

SmartHRとの連携については、OAuthを利用した連携とAPI keyを利用した方法があります。 これから新しく連携するお客様は連携が簡単なOAuthでの連携をご利用いただくことを推奨いたします。

​

事前準備

​

SmartHRへのログイン方法

SmartHRログインページにて、メールアドレス・パスワードを入力しログインします。

​

OAuthでの連携（推奨）

OAuthで連携する場合、次のリンクからSmartHR Plusにアクセスし、SmartHRとの連携を許可してください。 SaaS管理: SmartHR Plus （スマートHRプラス）

1. 連携をはじめる をクリックします。
2. SmartHRに管理者権限のアカウントでログインします。ログインが完了すると事前準備は完了ですので、次のインテグレーションのセットアップの項に進んでください。

​

API keyでの連携

API keyで連携する場合は、以下の項目を確認します。 ワークスペースキーの取得方法 SmartHRにログイン後、URLの一部がワークスペースキーとなりますので、コピー・保存しておきます。 https://{ワークスペースキー}.smarthr.jp/ （https:// は含みません） アクセスキーの取得方法 アクセストークンがアクセスキーとなります。次のSmartHR社のサイトを参考にアクセストークンを発行してください。 アクセストークンの発行方法

​

インテグレーションのセットアップ

1. インテグレーション画面にて、SmartHRで検索します。
2. [OAuth]または[API]で連携できます。 a. OAuthでの連携（推奨）：タブからOAuthをクリックして [連携する] をクリックします。以下の項目を設定、選択ください。

   項目	説明
   メールアドレスのカスタム従業員項目名（オプション）	カスタム従業員項目のメールアドレスを取得する場合に、**カスタム従業員項目名（下記画像の赤枠部分）**を入力します。指定した場合、プライマリアドレスとして取得します。カンマ区切りで複数の項目の入力が可能です（先頭の項目がプライマリアドレスとして取得されます）。連携すると、カスタム従業員項目のメールアドレスで自動的に名寄せ（マージ）が可能となります。
   ビジネスネームを優先表示する	SmartHRでビジネスネームが設定されている場合、ユーザー名にビジネスネームを設定します。

   b. APIキーでの連携：タブから[API]を選択し、次の各項目の値を入力し、連携するをクリックします。

   項目	説明
   ワークスペース名	任意の文字列（会社名など）
   ワークスペースキー	前の手順で取得したワークスペースキー
   アクセスキー	前の手順で発行したAPIキー
   メールアドレスのカスタム従業員項目名（オプション）	カスタム従業員項目のメールアドレスを取得する場合に、**カスタム従業員項目名（下記画像の赤枠部分）**を入力します。指定した場合、プライマリアドレスとして取得します。カンマ区切りで複数の項目の入力が可能です（先頭の項目がプライマリアドレスとして取得されます）。連携すると、カスタム従業員項目のメールアドレスで自動的に名寄せ（マージ）が可能となります。
   ビジネスネームを優先表示する	SmartHRでビジネスネームが設定されている場合、ユーザー名にビジネスネームを設定します。

   
3. SmartHRとの連携が成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。正常に完了しない場合は、まず SaaSとの連携に失敗する場合の対処法 に記載のステップをお試しください。それでも解決しない場合は、ご提供いただきたい情報 をご確認のうえ、サポート窓口までお問い合わせください。

​

SmartHR連携時の取得データについて

SmartHRから連携している項目についてはSmartHR Plusに記載しておりますので、ご覧ください。