メインコンテンツへスキップ

CSVファイル - SmartHR連携 (家族情報)

  • 更新

本レシピはStandardプラン以上の有償プランでご利用いただけます。ご利用をご希望の場合は下記よりお問い合わせください。

お問い合わせ | ActRecipe

 

家族情報のCSVファイルをSmartHRへ連携する方法を解説します。
レシピを使用するには事前にSmartHRの利用契約が必要になります。

 

0.事前準備

  1. 「CSVファイル - SmartHR連携 (家族情報)」レシピを使用するには、事前にSmartHR Plusでのアプリの登録が必要となります。
  2. 以下のSmartHR Plusにアクセスし、画面右上の「ログイン」ボタンよりSmartHRへログインします
    https://www.smarthr.plus/apps/actrecipe
  3. 続いて「連携をはじめる」ボタン(青色)をクリックします
  4. アプリのインストール確認画面にて「連携をはじめる」ボタンをクリックします
  5. アプリの連携が完了しますと上記「2」のボタンが「アプリを開く」に変わりますので、同ボタンをクリックします
  6. 以下の確認画面が表示されますので「連携を許可」をクリックします(※)

連携するユーザはSmartHRの「管理者」権限を保持している必要があります。

 

SmartHR_Plus_ActRecipe.png

 

※ 
ActRecipeのアカウントを保持しておりActRecipeにログインしていない場合にはログインをしてください。
ActRecipeのアカウントが未作成の場合は「無料ではじめる」ボタンよりアカウントを作成し、通知メールに従ってください。

 

1.マイレシピへの登録

メニューの「シェアレシピ」から、「CSVファイル - SmartHR連携 (家族情報)」にチェックを入れ、画面下にある登録ボタンを押下します。シェアレシピの画面に「CSVファイル - SmartHR連携 (家族情報)」が表示されない場合はSmartHR Plusの画面からやり直してください。
続いて「マイレシピ」から、操作メニューより「編集」を選択します。
参考：シェアレシピ・マイレシピとはなんですか？

 

ヘッダーでは、レシピ名とレシピ説明を変更することができます。
参考：レシピヘッダーでは何を設定すれば良いですか？

 

2.CSVファイルとSmartHR項目のマッピング設定

「Convert CSV data to SmartHR format」タスクを押下し、設定を展開します。

「CSVデータファイル」からはSmartHRにアップロードするCSVファイルを選択します。事前にActRecipeの「ファイル一覧」メニューよりCSVファイルのアップロードをお願いします。
後述するマッピングを使用しない場合はCSVファイル上の全てのデータがSmartHRへ連携されます。

デフォルトのインポート項目は以下の通りです。

"紐づく従業員のID","従業員 社員番号","従業員 姓","従業員 名","配偶者 家族ID","配偶者 続柄","配偶者 姓","配偶者 名","配偶者 姓（ヨミガナ）","配偶者 名（ヨミガナ）","配偶者 生年月日","配偶者 性別","配偶者 職業","配偶者 家族コード","配偶者 基礎年金番号","配偶者 同居・別居の別","配偶者 住所（郵便番号）","配偶者 住所（都道府県）","配偶者 住所（市区町村）","配偶者 住所（丁目・番地）","配偶者 住所（建物名・部屋番号）","配偶者 住所（ヨミガナ）","配偶者 住所（国コード）","配偶者 電話番号","配偶者 障害者区分","配偶者 障害者手帳の種類","配偶者 障害者手帳の交付年月日","配偶者 海外居住時の送金額（単位：円）","配偶者 社会保険の扶養状況","配偶者 社会保険の年間収入（単位: 円）","配偶者 社会保険の月間収入（単位: 円）","配偶者 社会保険の被扶養者になった日","配偶者 社会保険の被扶養者になった理由","配偶者 社会保険の被扶養者でなくなった日","配偶者 社会保険の扶養から削除された理由","配偶者 社会保険の扶養から削除された理由（その他の場合）","配偶者 税法上の扶養状況","配偶者 税法上の年間所得見積額（単位: 円）","配偶者 税法上の被扶養者になった日","配偶者 税法上の被扶養者になった理由","配偶者 税法上の被扶養者でなくなった日","配偶者 税法上の扶養から削除された理由","配偶者 税法上の扶養から削除された理由（その他の場合）","家族1 家族ID","家族1 続柄","家族1 姓","家族1 名","家族1 姓（ヨミガナ）","家族1 名（ヨミガナ）","家族1 生年月日","家族1 性別","家族1 職業","家族1 家族コード","家族1 同居・別居の別","家族1 住所（郵便番号）","家族1 住所（都道府県）","家族1 住所（市区町村）","家族1 住所（丁目・番地）","家族1 住所（建物名・部屋番号）","家族1 住所（ヨミガナ）","家族1 住所（国コード）","家族1 電話番号","家族1 障害者区分","家族1 障害者手帳の種類","家族1 障害者手帳の交付年月日","家族1 海外居住時の送金額（単位：円）","家族1 留学生","家族1 社会保険の扶養状況","家族1 社会保険の年間収入（単位: 円）","家族1 社会保険の月間収入（単位: 円）","家族1 社会保険の被扶養者になった日","家族1 社会保険の被扶養者になった理由","家族1 社会保険の被扶養者でなくなった日","家族1 社会保険の扶養から削除された理由","家族1 社会保険の扶養から削除された理由（その他の場合）","家族1 税法上の扶養状況","家族1 税法上の年間所得見積額（単位: 円）","家族1 税法上の被扶養者になった日","家族1 税法上の被扶養者になった理由","家族1 税法上の被扶養者でなくなった日","家族1 税法上の扶養から削除された理由","家族1 税法上の扶養から削除された理由（その他の場合）"

 

インポート時に必須となる項目は以下の通りです。
[従業員 社員番号、姓、名、生年月日、性別、同居・別居の別、続柄] (*1)

「紐づく従業員のID」「従業員 社員番号」「姓」「名」「続柄」が既存データと一致する場合は更新を行い、一致しない場合は新規登録となります。このうち「紐づく従業員のID」は必須項目ではないためブランクでもインポートができます。ただし、インポート対象の「従業員 社員番号」はSmartHRに存在しない値を指定する必要があります。なお、既存の配偶者とは別の配偶者をインポートで追加することはできないためSmartHRの画面上よりご対応ください。

*1 「姓」「名」「生年月日」「性別」「同居・別居の別」「続柄」は、ぞれぞれ「配偶者 姓」や「配偶者 生年月日」等に置き換えてデータをご用意ください。

 

ここから先の記述はIT担当者向けの内容となりますので、SmartHRへアップロードするCSVを固定にされたい場合や設定内容がご不明な場合はスキップしてください。

CSV内のデータを変換したり一部のデータに絞り込んでSmartHRへ連携する場合にはマッピング機能を使用します。

JSONファイルはSmartHRとCSVファイルのマッピング設定をまとめたものとなりますので、検証等で設定変更を繰り返したい場合にはダウンロードアイコンから設定ファイルをバックアップしてください。

 

 

04-2.png

 

続いて、「Convert CSV data to SmartHR format」タスクの画面について説明します。
【入力設定】

  • 文字コード：入力ファイル(変換元ファイル)の文字コードを選択します。
  • ヘッダーあり/なし：入力ファイルにヘッダーが含まれる場合は「ヘッダーあり」、ヘッダーが含まれない場合は「ヘッダーなし」にします。この設定によって後述します「出力指定」の指定方法が異なりますのでご注意ください。
  • 区切り文字：入力ファイルの区切り文字を入力します。デフォルトはカンマ(,)です。

【入力フィルター】
入力フィルタでは、データファイルから選択したインポートファイルの連携項目を任意の条件に基づいて絞り込むことが可能になります。フィルタ項目の増減は下部の「(+)」アイコン、または、右側の「(-)」アイコンより行っていただけます。

  • 入力項目：インポートファイルのヘッダー名を指定します。
  • 条件：以下の条件の内いずれかを指定します。
    • 次に等しい：入力項目で指定した項目が、以下の”値”にて指定した値と等しい場合に出力します。
    • 次に等しくない：入力項目で指定した項目が、以下の”値”にて指定した値と等しくない場合に出力します。
    • が空：入力項目で指定した項目が、空欄である場合に出力します。
    • が空ではない：入力項目で指定した項目が、空欄ではない場合に出力します。
  • 値：絞り込みたい条件に基づき値を入力します。
    「XXXX, YYYY」のようにカンマ区切りで入力することで、複数の値を一括で指定することも可能です。
  • AND・OR：複数の条件を「かつ(AND)」「または(OR)」で組み合わせることができます。
    条件行の左右に「( 」および「 ) 」のプルダウンから条件のグルーピングもでき、「(A かつ B) または (C かつ D)」といった、特定の条件をグループ化して優先させる複雑な絞り込みも可能です。
    ※対応可能なネストは1階層（括弧は一重）までです。
    ( ) によるグルーピングは可能ですが、(( )) のように括弧を二重に設定することには対応しておりませんのでご注意ください。
    スクリーンショット 2026-05-18 110905.png
     

【出力設定】

  • 出力ファイル種別：出力ファイルの種類を「CSV」または「TEXT」から選択します。
  • ヘッダー出力する/しない：出力ファイルのヘッダーの有無を選択します。
  • 文字コード：出力ファイルの文字コードを「UTF-8」「SHIFT_JIS」「SHIFT_JIS (CP932)」から選択します。
  • 区切り文字：出力ファイルの区切り文字を設定します。
  • クォート：出力ファイルデータについて「"文字列"」のようにクォートを付与する対象を選択します。
  • 桁数を超える処理：下記の「出力フォーマット」において、指定した桁数を超過した場合の処理を選択します。

【出力フォーマット】
出力フォーマットでは、入力ファイルを用いてどのようなアウトプットとするかを決定します。マッピング項目の増減は下部の「(+)」アイコン、または、右側の「(-)」アイコンより行っていただけます。
画面における「項目名」はSmartHRの項目名を指しており、「出力指定」はCSVファイルのヘッダー項目を指しております。SmartHRの項目とその説明は以下の資料をご確認ください。

SmartHR家族情報連携項目(インポート用)v1.0

「型」や「桁数」や「出力区分」は任意の設定を行なっていただくことができます。
インポート項目にないカラムが含まれている場合、インポート処理は「成功」と表示されますが、存在しないカラムのデータはSmartHRにはインポートされず、無視されます。
インポートを行う際は、事前にSmartHRの連携可能なインポート項目とCSVファイルのカラムが一致しているか必ずご確認ください。

【出力フィルター】
出力フィルターでは、出力フォーマットによって出力されたファイルを任意の条件に基づいて絞り込むことが可能になります。フィルタ項目の増減は下部の「(+)」アイコン、または、右側の「(-)」アイコンより行っていただけます。

  • 括弧 ( )：複数の条件をグループ化して優先順位を指定できます。各条件行の左端に開始括弧「(」、右端に終了括弧「)」を設定できます。
    ※ 対応可能なネストは1階層（括弧は一重）までです。( ) によるグルーピングは可能ですが、(( )) のように括弧を二重に設定することはできません。
  • 出力項目：出力フォーマットにて、設定した項目を指定します。
  • 条件：以下の条件の内いずれかを指定します。
    • 次に等しい：出力項目で指定した項目が、以下の”値”にて指定した値と等しい場合に出力します。
    • 次に等しくない：出力項目で指定した項目が、以下の”値”にて指定した値と等しくない場合に出力します。
    • が空：出力項目で指定した項目が、空欄である場合に出力します。
    • が空ではない：出力項目で指定した項目が、空欄ではない場合に出力します。
  • 値：絞り込みたい条件に基づき値を入力します。
     「営業部, 開発部」のようにカンマ区切りで入力することで、複数の値を一括で指定することも可能です。

  • AND・OR：複数の条件を「かつ(AND)」「または(OR)」で組み合わせることができます。
    複数の条件を設定した場合、上から順番に1つずつ評価（直列評価）されます。
    例：条件A AND 条件B OR 条件C は、(条件A かつ 条件B) または 条件C として処理されます。

    【例】

  • 条件A AND ( 条件B OR 条件C )
    → 条件Aを満たし、かつ「条件Bまたは条件Cのどちらか」を満たすデータを出力します。

  • ( 条件A AND 条件B ) OR ( 条件C AND 条件D )
    → 「条件AとBの両方」を満たす、または「条件CとDの両方」を満たすデータを出力します。 

    出力フィルタ（修正後）.png

給与ソフト等に合わせた各種テンプレートは下記ページをご覧ください。
SmartHR用インポート・エクスポートテンプレート

出力指定の条件指定方法のサポートは有償プランにて承っております。詳しくはお問い合わせください。

 

3.SmartHRの認証情報設定

「SmartHR - Update or Register Family Information」を押下し、設定を展開します。

SmartHRと連携済みであれば「サブドメイン」にお客様のSmartHR環境のサブドメインが表示されます。

SmartHRとのOAuth接続を切断する場合は「テナントの変更・解除」をクリックし、続いて「接続解除」をクリックします。

 

レシピを実行する (自動実行はこちら)

マイレシピの操作メニューより「実行」を選択することでレシピを実行できます。
画面イメージや履歴の確認方法は以下をご参照ください。

参考：レシピを実行するにはどうすれば良いですか？

 

レシピ実行の結果は、レシピ実行履歴からご確認いただけます。レシピの実行に成功すると、CSVファイルの情報がSmartHRへ連携・登録されます。また出力結果のCSVファイルが「results_[インポートファイル名].csv」のフォーマットでファイル一覧に出力され、登録ができなかったレコードはその原因についても表示されます。
レシピの実行に失敗した場合、履歴の実行ログからその原因等が出力されます。出力結果のCSVファイルと合わせてご確認ください。

 

【注意事項】CSVファイル - SmartHR連携 (家族情報) でインポート可能な情報の取扱いについて

  •  インポートできる従業員の範囲・項目は、設定時に利用したSmartHRのアカウントの権限設定を反映します。目的と用途に応じた権限のSmartHRのアカウントを使って設定を行なってください。
    詳しくは、*従業員関連の閲覧・作成・更新・削除の権限を設定する* を参照してください。
    https://support.smarthr.jp/ja/help/articles/1500001368101/

 

Freeプランについて
このレシピはActRecipeのFreeプランでご利用いただけます。Freeプランの制約事項や有償プランへの移行は下記をご覧ください。
 

 

このレシピで連携できるSaaSについて

 

その他のSmartHR連携ができるレシピ

 

関連記事