<p>いつもSmartHRをご利用いただきありがとうございます。</p><p>このたび、従業員の「操作できる範囲」に関わるAPIの旧レスポンスを廃止しました。<br>APIを使ったサービスをご利用いただいている場合は、必ず以下の変更点をご確認、または開発担当者様へご共有の上、ご対応をお願いいたします。</p><p><strong>4月23日更新：従業員の「操作できる範囲」に関わるAPIの旧レスポンスを廃止しました。</strong><br><strong>4月9日更新：変更予定日を「2024年4月中旬以降」から「2024年4月22日（月）」に変更しました。</strong><br><strong>3月19日更新：変更予定日を「2024年3月下旬以降」から「2024年4月中旬以降」に変更しました。</strong></p><h2 id="heeab3c392c">開発背景</h2><p>2021年8月に実施した、従業員の「操作できる範囲」の機能改修に伴い、一部のAPIレスポンスデータを廃止予定としておりました。<br>改修直後は後方互換性を担保するためにAPIを保持しておりましたが、一定期間が経過したため当該APIを廃止しました。</p><p>参考：<a href="https://smarthr.jp/update/25870">【権限管理機能】操作できる従業員の範囲を詳細に設定できるようになりました</a></p><h2 id="h7da2b67073">変更日</h2><p>2024年4月22日（月）</p><h2 id="hd536209ab2">廃止API</h2><p>従業員の「操作できる範囲」の権限設定における、以下のAPIを廃止しました。<br>廃止箇所について、今後は crews_scope_condition をご利用ください。</p><table><tbody><tr><td colspan="1" rowspan="1"><p>項目</p></td><td colspan="1" rowspan="1"><p>廃止API</p></td></tr><tr><td colspan="1" rowspan="1"><p>本人が所属する部署</p></td><td colspan="1" rowspan="1"><p>crews_scope_department</p></td></tr><tr><td colspan="1" rowspan="1"><p>本人が所属する部署＋配下の部署</p></td><td colspan="1" rowspan="1"><p>crews_scope_department_subtree</p></td></tr><tr><td colspan="1" rowspan="1"><p>配下の部署</p></td><td colspan="1" rowspan="1"><p>crews_scope_department_descendant</p></td></tr></tbody></table><h3 id="h4258c4b7e8">対象箇所</h3><p>［権限設定］&gt;［従業員関連］タブ&gt;［操作できる範囲］&gt;［本人＋指定した範囲の従業員］</p><figure><img src="https://images.microcms-assets.io/assets/9811eab4844a4b34a789be7746858abf/d9c169e45915410fa4ab87830daf4563/image1-3-800x550.png" alt="" width="800" height="550"></figure><h3 id="h12a684d8da">APIのレスポンス例</h3><h4 id="h011a48d86e">1. 部署：本人が所属する部署（crews_scope: crews_scope_condition）</h4><pre><code>{
    &quot;role&quot;: {
        &quot;id&quot;: &quot;string&quot;,
        &quot;name&quot;: &quot;テスト (本人が所属する部署)&quot;,
        &quot;description&quot;: &quot;&quot;,
        &quot;crews_scope&quot;: &quot;crews_scope_condition&quot;,
        &quot;crews_scope_query&quot;: {
            &quot;op&quot;: &quot;and&quot;,
            &quot;conditions&quot;: [
                {
                    &quot;key&quot;: &quot;department&quot;,
                    &quot;value&quot;: &quot;same_departments&quot;,
                    &quot;operator&quot;: &quot;eq&quot;
                },
                {
                    &quot;key&quot;: &quot;employment_type&quot;,
                    &quot;value&quot;: &quot;&quot;,
                    &quot;operator&quot;: &quot;all&quot;
                }
            ]
        },
        &quot;session_timeout_in&quot;: null,
        &quot;preset_type&quot;: null
    },
}</code></pre><h4 id="h8799fece53">2. 部署：本人が所属する部署＋配下の部署（crews_scope:crews_scope_condition）</h4><pre><code>{
    &quot;role&quot;: {
        &quot;id&quot;: &quot;string&quot;,
        &quot;name&quot;: &quot;テスト (本人が所属する部署 + 配下の部署)&quot;,
        &quot;description&quot;: &quot;&quot;,
        &quot;crews_scope&quot;: &quot;crews_scope_condition&quot;,
        &quot;crews_scope_query&quot;: {
            &quot;op&quot;: &quot;and&quot;,
            &quot;conditions&quot;: [
                {
                    &quot;key&quot;: &quot;department&quot;,
                    &quot;value&quot;: &quot;same_departments_subtree&quot;,
                    &quot;operator&quot;: &quot;eq&quot;
                },
                {
                    &quot;key&quot;: &quot;employment_type&quot;,
                    &quot;value&quot;: &quot;&quot;,
                    &quot;operator&quot;: &quot;all&quot;
                }
            ]
        },
        &quot;session_timeout_in&quot;: null,
        &quot;preset_type&quot;: null
    },
}</code></pre><h4 id="h4496a196ea">3. 部署：配下の部署（crews_scope:crews_scope_condition）</h4><pre><code>{
    &quot;role&quot;: {
        &quot;id&quot;: &quot;string&quot;,
        &quot;name&quot;: &quot;テスト (配下の部署)&quot;,
        &quot;description&quot;: &quot;&quot;,
        &quot;crews_scope&quot;: &quot;crews_scope_condition&quot;,
        &quot;crews_scope_query&quot;: {
            &quot;op&quot;: &quot;and&quot;,
            &quot;conditions&quot;: [
                {
                    &quot;key&quot;: &quot;department&quot;,
                    &quot;value&quot;: &quot;same_departments_descendant&quot;,
                    &quot;operator&quot;: &quot;eq&quot;
                },
                {
                    &quot;key&quot;: &quot;employment_type&quot;,
                    &quot;value&quot;: &quot;&quot;,
                    &quot;operator&quot;: &quot;all&quot;
                }
            ]
        },
        &quot;session_timeout_in&quot;: null,
        &quot;preset_type&quot;: null
    },
}</code></pre><h2 id="h3bcda3e6b0">最後に</h2><p>SmartHRでは、ご利用企業の声を積極的にサービス開発の参考にしていきたいと考えております。機能や画面のデザインなど、なにか気になることがございましたら、お気軽にお伝えください。</p><p>SmartHRの機能追加、改善に関する情報は「アップデート情報」や「リリースノート」にて、株式会社SmartHRの企業情報に関するニュースはFacebook・X（旧Twitter）からもお知らせしています。</p><p>よろしければ「いいね！」「フォロー」をお願いします。</p><ul><li><a href="https://smarthr.jp/update">お知らせ</a></li><li><a href="https://knowledge.smarthr.jp/hc/ja/categories/360004438553?_ga=2.81550226.407776416.1639365461-1044674420.1627633649&amp;_gac=1.149314884.1638332231.Cj0KCQiAtJeNBhCVARIsANJUJ2GzXPgWcy-_DVzIhzpDVfTxerb7Q2gl8kmudpxemSYGOFA4oMYU-rIaAhwdEALw_wcB">リリースノート</a></li><li><a href="https://www.facebook.com/smarthrjp/">Facebookページ</a></li><li><a href="https://twitter.com/smarthr_jp">X（旧Twitter）</a></li></ul><p>今後とも、SmartHRをよろしくお願いいたします。</p>

従業員の「操作できる範囲」に関わるAPIの旧レスポンスを廃止しました（04/23更新）

SSO／SAML認証

文書配付

分析レポート

従業員サーベイ

人事評価

配置シミュレーション

キャリア台帳

学習管理

採用管理

通勤経路検索

有料オプション

設定

従業員リスト・従業員情報

招待

マイナンバー

手続き

電子申請

届出書類

給与明細

源泉徴収票

お知らせ管理

年末調整

申請

組織図・名簿

スキル管理

HRアナリティクス

データ連携

各種サービス連携

機能で調べる

セキュリティ

SmartHR API

料金と契約内容

サポート

その他