<p><strong>2024年7月29日更新：リリース日の変更に伴い修正をしました。</strong></p><p><strong>2024年8月23日更新：リリース日の変更に伴い修正をしました。</strong></p><p><strong>2024年9月4日更新：リリースに伴い文言の修正をしました。</strong></p><p>いつもSmartHRをご利用いただきありがとうございます。</p><p>このたび、従業員の役職情報に関するAPIとWebhookの仕様を変更しました。<br>APIまたはWebhookを使ったサービスをご利用いただいている場合は、必ず以下の変更点をご確認、または開発担当者様へご共有の上、ご対応をお願いいたします。</p><h2 id="heeab3c392c">開発背景</h2><p>これまで、従業員の所属部署、役職情報には最大3つの部署と役職を登録することができました。最大3個までとなっていたことにより、4個以上部署を兼務している従業員の情報をSmartHRに正しく登録できないという課題がありました。</p><p>今回のアップデートにより、部署・役職を最大10個まで登録できるようになります。また、これに伴い従業員の部署および役職情報の管理・表示方法を変更しました。</p><p>画面上の変更点については、下記のお知らせをご覧ください。<br><a href="https://support.smarthr.jp/ja/info/update/lyij4gilu257/">https://support.smarthr.jp/ja/info/update/lyij4gilu257/</a></p><h2 id="h7da2b67073">変更日</h2><p>2024年9月4日</p><h2 id="hef5d2624e0">APIの変更箇所</h2><h3 id="h22db4f3f4f">対象</h3><ol><li>従業員リストの取得<ul><li>GET /v1/crews</li></ul></li><li>従業員取得<ul><li>GET /v1/crews{id}</li></ul></li><li>従業員登録<ul><li>POST /v1/crews</li></ul></li><li>従業員部分更新<ul><li>PATCH /v1/crews/{id}</li></ul></li><li>ユーザーリスト取得<ul><li>GET /v1/users</li></ul></li><li>ユーザー取得<ul><li>GET /v1/users/{id}</li></ul></li><li>会社情報リストの取得<ul><li>GET /v1/companies/crews/{id}</li></ul></li></ol><h3 id="h39eedbddf5">変更内容</h3><h4 id="hbd96ee4580"><strong>1.従業員リストの取得, 2.従業員取得</strong></h4><p>レスポンスが一部追加となります。リクエストパラメータに変更はありません。</p><ul><li>従業員リストの取得: GET /v1/crews</li><li>従業員取得: GET /v1/crews/{id}</li></ul><h5 id="h53f04a8d34"><strong>変更後</strong></h5><ul><li>部署は既存のdepartmentsの配列に部署4以降の情報が追記される</li><li>役職は既存のpositionsの配列に役職4以降の情報が追記される</li></ul><h4 id="hab00b3f556">3.<strong>従業員登録,</strong> 4.<strong>従業員部分更新</strong></h4><p>リクエストパラメーターに変更はありません。</p><ul><li>従業員登録: POST /v1/crews</li><li>従業員部分更新: PATCH /v1/crews/{id}</li></ul><h5 id="h53f04a8d34"><strong>変更後</strong></h5><ul><li>部署はdepartment_idsの配列に部署4以降の情報として部署idを記述することで登録できる</li><li>役職はpositionsの配列に役職4以降の情報として役職名を記述することで登録できる</li></ul><p><br>例：部署1と部署10にそれぞれ部署を設定する場合</p><pre><code>
&quot;department_ids&quot;: [
    &quot;abcabcac-abca-abca-abca-abcabcabcabc&quot;,
    null,
    null,
    null,
    null,
    null,
    null,
    null,
    null,
    &quot;bcabcaca-bcab-bcab-bcab-bcabcabcabca&quot;
  ]</code></pre><p> 例: 役職1に課長、役職10にリーダーを設定する場合</p><pre><code> &quot;positions&quot;: [
    &quot;課長&quot;,
    null,
    null,
    null,
    null,
    null,
    null,
    null,
    null,
    &quot;リーダー&quot;
  ],</code></pre><h4 id="hf56e14f60e"><strong>5.ユーザーリスト取得, 6. ユーザー取得</strong></h4><p>レスポンスが一部追加となります。リクエストパラメータに変更はありません。</p><ul><li>ユーザーリストの取得: GET /v1/users</li><li>ユーザー取得: GET /v1/users/{id}</li></ul><h5 id="h53f04a8d34"><strong>変更後</strong></h5><ul><li>部署は既存のdepartmentsの配列に部署4以降の情報が追記される</li><li>役職は既存のpositionsの配列に役職4以降の情報が追記される</li></ul><h4 id="h7256ef5a58"><strong>7.会社情報リストの取得</strong></h4><p>レスポンスが一部追加となります。リクエストパラメータに変更はありません。</p><ul><li>会社情報リスト取得: GET /v1/companies/crews/{id}</li></ul><h5 id="h53f04a8d34"><strong>変更後</strong></h5><ul><li>部署は既存のdepartmentsの配列に部署4以降の情報が追記される</li><li>役職は既存のpositionsの配列に役職4以降の情報が追記される</li></ul><h2 id="h9e946c669b">Webhookの変更箇所</h2><p>レスポンスが一部変更になりました。<br>Webhookの通知形式については、APIと同様の変更になります。</p><h3 id="h22db4f3f4f">対象</h3><ul><li>crew_created</li><li>crew_updated</li><li>crew_imported</li></ul><h3 id="h39eedbddf5">変更内容</h3><h5 id="ha162c632c5">変更前</h5><ul><li>senderとcrew内のpositions<ul><li>役職がある/ないに関わらず、必ず3個返します。</li></ul></li><li>senderとcrew内のdepartments<ul><li>役職がある/ないに関わらず、必ず3個返します。</li></ul></li></ul><h5 id="h53f04a8d34">変更後</h5><ul><li>senderとcrew内のpositions　<ul><li>役職がある/ないに関わらず、必ず10個返します。</li></ul></li><li>senderとcrew内のdepartments　<ul><li>役職がある/ないに関わらず、必ず10個返します。 </li></ul></li></ul><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とWebhookを変更しました（09/04更新）

SSO／SAML認証

文書配付

分析レポート

従業員サーベイ

人事評価

配置シミュレーション

キャリア台帳

学習管理

採用管理

通勤経路検索

有料オプション

設定

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

招待

マイナンバー

手続き

電子申請

届出書類

給与明細

源泉徴収票

お知らせ管理

年末調整

申請

組織図・名簿

スキル管理

HRアナリティクス

データ連携

各種サービス連携

機能で調べる

セキュリティ

SmartHR API

料金と契約内容

サポート

その他