> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# SmartHR

> SmartHRとの連携手順です。

## サポートする機能

<Badge color="blue">従業員マスター連携</Badge> <Badge color="blue">アカウント削除</Badge> <Badge color="blue">アカウント作成</Badge>

## SmartHRとの連携について

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

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

## 事前準備

### SmartHRへのログイン方法

[SmartHRログインページ](https://app.smarthr.jp/login)にて、メールアドレス・パスワードを入力しログインします。

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1716967342074.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=754c3de7c6d8bcbe3f40284ec8caa7ed" alt="SmartHRログイン画面" width="682" height="636" data-path="images/integrations/zyl6g8sbgx/1716967342074.png" />

### OAuthでの連携（推奨）

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

[SaaS管理:マネーフォワードAdmina SmartHR Plus （スマートHRプラス）](https://www.smarthr.plus/apps/admina)

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

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1716884103805.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=21ccfcd3c1d682c5aac70f9317bb275b" alt="連携をはじめる" width="1558" height="720" data-path="images/integrations/zyl6g8sbgx/1716884103805.png" />

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

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1716884142745.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=d1677a35d57d010b67f2578bf5d74dc8" alt="管理者アカウントでログイン" width="1722" height="418" data-path="images/integrations/zyl6g8sbgx/1716884142745.png" />

### API keyでの連携

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

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

[SmartHR](https://app.smarthr.jp/login)にログイン後、**URLの一部**がワークスペースキーとなりますので、コピー・保存しておきます。

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

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1667902884880.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=ab3c8f0e903932678cf5d46324416fdb" alt="ワークスペースキー" width="1126" height="454" data-path="images/integrations/zyl6g8sbgx/1667902884880.png" />

**アクセスキーの取得方法**

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

[アクセストークンの発行方法](https://knowledge.smarthr.jp/hc/ja/articles/360026266033)

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

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

インテグレーション画面にて、**SmartHR**で検索します。

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1643528978911.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=da8a89d6e9ba1a5471e912d3bf4eaf76" alt="SmartHRを検索" width="1892" height="776" data-path="images/integrations/zyl6g8sbgx/1643528978911.png" />

### OAuthでの連携（推奨）

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

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1716885053422.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=c234f9c4db741ea38228fd935628b679" alt="OAuth連携画面" width="482" height="670" data-path="images/integrations/zyl6g8sbgx/1716885053422.png" />

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

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1668653254526.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=f7d0d87e061aa4e80cbc5eb35706523e" alt="カスタム従業員項目" width="3034" height="1364" data-path="images/integrations/zyl6g8sbgx/1668653254526.png" />

* ビジネスネームを優先表示する: SmartHRでビジネスネームが設定されている場合、Adminaのユーザー名ビジネスネームを設定します。

### APIキーでの連携

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

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1716885311548.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=521bda0c2ab1a7e7accad273d671e2eb" alt="APIキー連携画面" width="487" height="911" data-path="images/integrations/zyl6g8sbgx/1716885311548.png" />

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

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1668653254526.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=f7d0d87e061aa4e80cbc5eb35706523e" alt="カスタム従業員項目" width="3034" height="1364" data-path="images/integrations/zyl6g8sbgx/1668653254526.png" />

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

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

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

SmartHRの連携概要については[連携ページ](https://admina.moneyforward.com/jp/integrations/smarthr)をご覧ください。

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

SmartHRからAdminaに連携している項目については[SmartHR Plus](https://www.smarthr.plus/apps/admina)に記載しておりますので、ご覧ください。

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zyl6g8sbgx/1716885828041.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=bc2f95f6c68899630e0a5a7e882a28ed" alt="SmartHR Plus連携項目" width="861" height="838" data-path="images/integrations/zyl6g8sbgx/1716885828041.png" />