> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinba.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SmartHR

> SmartHR で従業員（クルー）の一覧・作成・更新・削除・招待を行う

## 概要

SmartHR ツールでは、SmartHR の従業員（クルー）を管理できます。ページネーション付き一覧取得、詳細取得、作成、更新、削除、招待、部署解除が可能です。

## 主な機能

* `SMARTHR_LIST_CREWS`
  * 従業員（クルー）一覧を取得。ページネーションと在職状況でのフィルタに対応。
* `SMARTHR_GET_CREW`
  * 指定した ID の従業員の詳細を取得。
* `SMARTHR_CREATE_CREW`
  * 氏名・メール・性別・雇用情報などで新規従業員を作成。
* `SMARTHR_UPDATE_CREW`
  * 既存の従業員を更新。指定したフィールドのみ更新されます。
* `SMARTHR_DELETE_CREW`
  * ID で従業員を削除。ステータスによっては削除できない場合があります。
* `SMARTHR_INVITE_CREW`
  * 従業員に招待を送信。招待者のユーザー ID が必要です。
* `SMARTHR_DELETE_CREW_DEPARTMENTS`
  * 従業員のすべての部署割り当てを解除。

## 認証

設定手順は [SmartHR 認証情報](/ja/pages/credentials/smarthr) を参照してください。

各ツールでは **subdomain**（SmartHR のインスタンス URL）と **access\_token** が必要です。アクセストークンはワークスペースのシークレットに SmartHR 認証情報として保存し、ツールの config で subdomain とともに指定します。

**注意**: API 認証情報は厳重に管理し、公開リポジトリにコミットしないでください。

### 例: クルー一覧取得と1件の詳細取得

```yaml theme={null}
- id: list_crews
  tool: SMARTHR_LIST_CREWS
  config:
    - name: subdomain
      value: "https://example.daruma.space"
    - name: access_token
      value: "{{secrets.SMARTHR_ACCESS_TOKEN.access_token}}"
  input:
    - name: page
      value: 1
    - name: per_page
      value: 10

- id: get_crew
  tool: SMARTHR_GET_CREW
  needs: ["list_crews"]
  config:
    - name: subdomain
      value: "https://example.daruma.space"
    - name: access_token
      value: "{{secrets.SMARTHR_ACCESS_TOKEN.access_token}}"
  input:
    - name: id
      value: "{{steps.list_crews.result.result[0].id}}"
```