サポートする機能
従業員マスター連携 アカウント削除 アカウント作成SmartHRとの連携について
SmartHRとAdminaの連携については、OAuthを利用した連携とAPI keyを利用した方法があります。 これから新しく連携するお客様は連携が簡単なOAuthでの連携をご利用いただくことを推奨いたします。事前準備
SmartHRへのログイン方法
SmartHRログインページにて、メールアドレス・パスワードを入力しログインします。
OAuthでの連携(推奨)
OAuthで連携する場合、次のリンクからSmartHR Plusにアクセスし、AdminaとSmartHRの連携を許可ください。 SaaS管理:マネーフォワードAdmina SmartHR Plus (スマートHRプラス)- 連携をはじめる をクリックします。

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

API keyでの連携
API keyで連携する場合は、以下の項目を確認します。 ワークスペースキーの取得方法 SmartHRにログイン後、URLの一部がワークスペースキーとなりますので、コピー・保存しておきます。https://{ワークスペースキー}.smarthr.jp/ (https:// は含みません)

・付与する権限は、従業員情報(/crews)および、アカウント(/users)の参照権限が必須です。
・連携時にカスタムフィールド項目のメールアドレスを取得する場合、追加したカスタム従業員項目の参照権限が必要です。
・連携時にカスタムフィールド項目のメールアドレスを取得する場合、追加したカスタム従業員項目の参照権限が必要です。
インテグレーションのセットアップ
インテグレーション画面にて、SmartHRで検索します。
OAuthでの連携(推奨)
タブからOAuthをクリックして [連携する] をクリックします。以下の項目を設定、選択ください。
- メールアドレスのカスタム従業員項目名(オプション): カスタム従業員項目のメールアドレスを取得する場合に、**カスタム従業員項目名(下記画像の赤枠部分)**を入力します。指定した場合、プライマリアドレスとして取得します。カンマ区切りで複数の項目の入力が可能です(先頭の項目がプライマリアドレスとして取得されます)。連携すると、カスタム従業員項目のメールアドレスで自動的に名寄せ(マージ)が可能となります。

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

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

