従業員一覧を取得する
このピースでできることfreee人事労務 の接続方法ステップ 1：workrun のリダイレクト URL を確認するステップ 2：freee でアプリケーションを登録するステップ 3：workrun に接続を追加するピースの設定項目1. 事業所（必須）2. 給与計算対象外の従業員を含める（任意）
このピースでできること
- freee人事労務に登録されている従業員の一覧を取得します。
- 取得する事業所を選んで、その事業所の従業員だけを取得できます。
- 給与計算対象外の従業員を含めるかどうかを選べます。
- 一度に取得できるのは最大 300 件までです。
freee人事労務 の接続方法
workrun と freee人事労務 を接続するには、freee の OAuth クライアント（クライアントID・クライアントシークレット） が必要です。
ステップ 1：workrun のリダイレクト URL を確認する
- workrun で freee人事労務 のアクション／トリガーをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。
ステップ 2：freee でアプリケーションを登録する
- freeeアプリストア でアプリケーションを登録します。
- コールバックURL に、ステップ 1 でコピーしたリダイレクト URL をそのまま登録します。
- 権限設定 で、以下の項目にチェックを入れます。
- ［人事労務］従業員: 参照・更新
- 「カスタムAPI呼び出し」アクションを利用する場合は、そのエンドポイントに対応する権限も追加してください
- 発行された クライアントID と クライアントシークレット をコピーしておきます。
スコープ一覧
| スコープ名 | 説明 |
|---|---|
| read | freee人事労務のデータの参照を許可します。 |
| write | freee人事労務のデータの作成・更新を許可します。 |
ステップ 3：workrun に接続を追加する
- ステップ 1 の接続画面に戻り、クライアントID と クライアントシークレット をそれぞれ貼り付けます。
- 「接続」 をクリックすると、freee の認証画面が開きます。
- freee にログインし、連携する事業所を選択します。
- workrun に対するアクセスを 「許可」 します。
- 画面が自動で閉じ、接続が完了します。
ピースの設定項目
1. 事業所（必須）
- 従業員を取得したい事業所を、一覧から選びます。
- 接続を選ぶと、そのアカウントが所属する事業所が自動で読み込まれます。接続を設定していない場合は「認証情報を設定してください」と表示されるので、先に接続を選んでください。
[設定例]
2. 給与計算対象外の従業員を含める（任意）
- オンにすると、給与計算の対象外に設定されている従業員も取得結果に含めます。
- オフの場合は、給与計算対象の従業員だけが取得されます。
[設定例]