目次

SmartHR

Yasuhiro Miyoshi 更新 by Yasuhiro Miyoshi

SmartHRとの連携について

SmartHRとAdminaの連携については、OAuthを利用した連携とAPI keyを利用した方法があります。

これから新しく連携を行うお客様は連携が簡単なOAuthでの連携をご利用いただくことを推奨いたします。

　

事前準備

SmartHRへのログイン方法

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

OAuth での連携（推奨）

OAuthで連携する場合、次のリンクからSmartHR Plusにアクセスし、AdminaとSmartHRの連携を許可ください。

SaaS管理:マネーフォワードAdmina SmartHR Plus （スマートHRプラス）

  1. 連携をはじめる をクリックします。

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

　　　

API keyでの連携

API keyで連携する場合は、以下の項目を確認します。

　

ワークスペースキーの取得方法

SmartHRにログイン後、URLの一部がワークスペースキーとなりますので、コピー・保存しておきます。

https://{ワークスペースキー} .smarthr.jp/ (https:// は含みません）

　

アクセスキーの取得方法

アクセストークンがアクセスキーとなります。次のSmartHR社のサイトを参考にアクセストークンを発行してください。

アクセストークンの発行方法

　

・付与する権限は、従業員情報（/crews）および、アカウント（/users）の参照権限が必須です。
・連携時にカスタムフィールド項目のメールアドレスを取得する場合、追加したカスタム従業員項目の参照権限が必要です。

　

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

マネーフォワードAdminaのインテグレーション画面にて、SmartHRで検索します。

　　

OAuthでの連携（推奨）

タブからOAuthをクリックして [連携する] をクリックします。必要に応じて以下の項目を設定、選択ください。

　

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

　　

APIキーでの連携

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

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

　　

SmartHRとの連携に成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。　

正常に完了しない場合は、インテグレーション画面のステータスタブから編集し、再度連携をお試しください。

解決しない場合はチャットにてお問い合わせください🙏

SmartHRの連携概要については連携ページをご覧ください。

　　　　　　　　　　

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

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

この記事はお役に立ちましたでしょうか？

SmartDB

Smartsheet

お問い合わせ