<p>いつもSmartHRをご利用いただきありがとうございます。</p><p>このたび、家族情報に関するAPIで、扶養状況によって設定可能な配偶者情報項目の取得や登録・更新ができるようになります。</p><p>APIを使ったサービスをご利用いただいている場合は、必ず以下の変更点をご確認、または開発担当者様へご共有の上、ご対応をお願いいたします。<br></p><h2 id="hd8343bc35f"><strong>リリース予定日</strong></h2><p>2025年3月</p><p>※確定し次第、更新します。</p><h2 id="hef5d2624e0"><strong>APIの変更箇所</strong></h2><ul><li>家族リストの取得<ul><li>GET /v1/crews/{crew_id}/dependents</li></ul></li><li>家族の取得<ul><li>GET /v1/crews/{crew_id}/dependents/{id}</li></ul></li><li>家族の登録<ul><li>POST /v1/crews/{crew_id}/dependents</li></ul></li><li>家族の更新<ul><li>PUT /v1/crews/{crew_id}/dependents/{id}</li></ul></li><li>家族の部分更新<ul><li>PATCH /v1/crews/{crew_id}/dependents/{id}</li></ul></li></ul><h2 id="h39eedbddf5"><strong>変更内容</strong></h2><h3 id="h6f00644577"><strong>追加される項目</strong></h3><ul><li>被扶養者（第3号被保険者）になった理由<ul><li><code>spouse_dependent_qualification_reason_type</code><ul><li>被扶養者（第3号被保険者）になった理由に入る値<ul><li>ア 被保険者が被用者保険制度に加入<ul><li><code>joined_employee_ins</code></li></ul></li><li>イ a. 被保険者の所属する年金制度等の変更: 厚生年金保険 -&gt; 共済組合<ul><li><code>changed_soc_ins_to_mutual_aid</code></li></ul></li><li>イ b. 被保険者の所属する年金制度等の変更: 共済組合 -&gt; 厚生年金保険<ul><li><code>changed_mutual_aid_to_soc_ins</code></li></ul></li><li>イ c. 被保険者の所属する年金制度等の変更: 共済組合 -&gt; 共済組合<ul><li><code>changed_mutual_aid_to_mutual_aid</code></li></ul></li><li>ウ 婚姻<ul><li><code>marriage</code></li></ul></li><li>エ 被扶養者の離職（2号喪失）<ul><li><code>retired</code></li></ul></li><li>オ 被扶養者の所得減少<ul><li><code>income_decrease</code></li></ul></li><li>カ その他<ul><li><code>others</code></li></ul></li></ul></li></ul></li></ul></li><li>被扶養者（第3号被保険者）でなくなった理由 <ul><li><code>spouse_dependent_disqualification_reason_type</code> <ul><li>被扶養者（第3号被保険者）でなくなった理由に入る値<ul><li>死亡<ul><li><code>dead</code></li></ul></li><li>その他<ul><li><code>others</code></li></ul></li></ul></li></ul></li></ul></li><li>死亡日<ul><li><code>spouse_dependent_disqualification_dead_at</code></li></ul></li><li>その他理由<ul><li><code>spouse_dependent_disqualification_reason</code></li></ul></li></ul><h3 id="hf8559e95db"><strong>家族リストの取得の詳細</strong></h3><p>レスポンスのプロパティに項目が追加されます。リクエストパラメータに変更はありません。</p><pre><code>[
　{
　　&quot;id&quot;: &quot;string&quot;,
　　&quot;crew_id&quot;: &quot;string&quot;,
　　&quot;relation_name&quot;: &quot;string&quot;,
　　...
　　&quot;created_at&quot;: &quot;2024-11-15T10:22:53.727Z&quot;,
　　&quot;updated_at&quot;: &quot;2024-11-15T10:22:53.727Z&quot;,
　　“code”:null, 
　　&quot;spouse_dependent_qualification_reason_type&quot;: &quot;joined_employee_ins&quot;,
　　&quot;spouse_dependent_disqualification_reason_type&quot;: &quot;dead&quot;,
　　&quot;spouse_dependent_disqualification_dead_at&quot;: &quot;2024-11-15&quot;,
　　&quot;spouse_dependent_disqualification_reason&quot;: &quot;string&quot;
　}
]</code></pre><h3 id="h8a41da8e0f"><strong>家族の取得の詳細</strong></h3><p>レスポンスのプロパティに項目が追加されます。リクエストパラメータに変更はありません。</p><pre><code>{
　&quot;id&quot;: &quot;string&quot;, 
　&quot;crew_id&quot;: &quot;string&quot;,
　&quot;relation_name&quot;: &quot;string&quot;,
  ...
　&quot;created_at&quot;: &quot;2024-11-15T10:22:53.727Z&quot;,
　&quot;updated_at&quot;: &quot;2024-11-15T10:22:53.727Z&quot;,
　“code”:null, 
　&quot;spouse_dependent_qualification_reason_type&quot;: &quot;joined_employee_ins&quot;,
　&quot;spouse_dependent_disqualification_reason_type&quot;: &quot;dead&quot;,
　&quot;spouse_dependent_disqualification_dead_at&quot;: &quot;2024-11-15&quot;,
　&quot;spouse_dependent_disqualification_reason&quot;: &quot;string&quot;
}</code></pre><h3 id="haf768e47e5"><strong>家族の登録・家族の更新・家族の部分更新の詳細</strong></h3><p>リクエストボディに項目を追加できます。</p><pre><code>{
　&quot;last_name&quot;: &quot;string&quot;,
　&quot;first_name&quot;: &quot;string&quot;,
　&quot;spouse_dependent_qualification_reason_type&quot;: &quot;joined_employee_ins&quot;,
　&quot;spouse_dependent_disqualification_reason_type&quot;: &quot;dead&quot;,
　&quot;spouse_dependent_disqualification_dead_at&quot;: &quot;2024-11-15&quot;,
　&quot;spouse_dependent_disqualification_reason&quot;: &quot;string&quot;
}</code></pre><h2 id="h3bcda3e6b0"><strong>最後に</strong></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>

SmartHR APIの家族情報の取得・登録項目が追加されます

SSO／SAML認証

文書配付

分析レポート

従業員サーベイ

人事評価

配置シミュレーション

キャリア台帳

学習管理

採用管理

通勤経路検索

有料オプション

設定

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

招待

マイナンバー

手続き

電子申請

届出書類

給与明細

源泉徴収票

お知らせ管理

年末調整

申請

組織図・名簿

スキル管理

HRアナリティクス

データ連携

各種サービス連携

機能で調べる

セキュリティ

SmartHR API

料金と契約内容

サポート

その他