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

SmartHR - スプレッドシート連携 (OAuth)

  • 更新

本レシピはFreeプランにて無料でご利用いただけます。アカウント登録が完了されていない場合は下記よりご登録ください。

ActRecipe Freeプラン | 無料で始めるiPaaS | ActRecipe

 

SmartHRの従業員情報をGoogleスプレッドシートに出力する方法を解説します。

レシピを使用するには事前にSmartHR、および、Google Workspaceの利用契約が必要になります。

 

任意の項目をスプレッドシートに連携されたい場合は下記のレシピをご利用ください。
SmartHR - カスタムスプレッドシート連携 (OAuth)

 

0.事前準備

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

SmartHR_Plus_ActRecipe.png

 

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

 

1.マイレシピへの登録

メニューの「シェアレシピ」から、「SmartHR - スプレッドシート連携 (OAuth)」にチェックを入れ、画面下にある登録ボタンを押下します。シェアレシピの画面に「SmartHR - スプレッドシート連携 (OAuth)」が表示されない場合はSmartHR Plusの画面からやり直してください。

01.png

 

 

メニューの「マイレシピ」から、コピーしたレシピの編集ボタンを押下します。

02.png

 

レシピ名とレシピ説明を任意に入力し、変更した場合は保存ボタンを押下します。

03.png

 

2.SmartHRの認証情報設定

「SmartHR 社員情報取得 (OAuth)」を押下し、設定を展開します。
本タスクでは、「取得データの種類」より「物理名」または「論理名」を選択します。物理名と論理名の違いは下記の通りです。

  • 物理名：システム上設定されているラベル名や項目名が取得されます。例えば、性別項目は「gender」というラベル名となり、値は「male」「female」となります。
  • 論理名：画面に表示されるラベル名や項目名が取得されます。例えば、性別項目は「戸籍上の性別」というラベル名となり、値は「男性」「女性」となります。

04.png

SmartHRとのOAuth接続を切断する場合は「OAuthを切断する」をクリックし、下記の確認画面より右下の削除アイコンをクリックします。

05.png

 

3.Googleスプレッドシートの出力設定

「Google Sheets - Write CSV data」を押下し、設定を展開します。

06.png

「GOOGLESHEETSにACTRECIPE権限を付与します」を押下します。
※「アカウントの選択」画面が表示されない場合、ブラウザのポップアップ画面がブロックされている可能性があります。ポップアップを許可後、再度リンクを押下してください。

 

Googleドライブを利用するアカウントを選択します。

14.png 

 

内容を確認して「許可」を押下すると、ダイアログが閉じ、ActRecipeトークンが自動入力されます。

15.png

 

・スプレッドシートのデータを上書きする場合は「データ上書き」にチェックを入れます。

・「スプレッドシートのURL」には取得したSmartHRの情報を書き込むURLを入力します。
　スプレッドシートの共有リンクの取得方法はこちらをご覧ください。

・連携時に新たなシートを作成する場合は「新しいシートを作成する」にチェックを付けます。

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

「マイレシピ」から「実行」ボタンを押下します。 

07.png

 

レシピの実行に成功すると指定したGoogleスプレッドシートにSmartHRの社員情報が連携されます。

08.png

 

Googleスプレッドシートに連携されるデータ一覧は以下の通りです。

「在籍状況」が「退職済み」(物理名：retired)以外の全てのデータを取得します。

 

■物理名を指定した場合

user_id,emp_code,last_name,first_name,biz_establishment.name,department1,department2,department3,employment_type.name,last_name_yomi,first_name_yomi,business_last_name,business_first_name,business_last_name_yomi,business_first_name_yomi,birth_at,gender,email,tel_number,address.zip_code,address.pref,address.city,address.street,address.building,address.literal_yomi,address.country_number,address_head_of_family,address_relation_name,emergency_relation_name,emergency_last_name,emergency_first_name,emergency_last_name_yomi,emergency_first_name_yomi,emergency_tel_number,emergency_address.zip_code,emergency_address.pref,emergency_address.city,emergency_address.street,emergency_address.building,emergency_address.literal_yomi,emergency_address.country_number,resident_card_address.zip_code,resident_card_address.pref,resident_card_address.city,resident_card_address.street,resident_card_address.building,resident_card_address.literal_yomi,resident_card_address_head_of_family,resident_card_address_relation_name,position,occupation,emp_status,entered_at,resigned_at,resigned_reason,emp_ins_insured_person_number,emp_ins_qualified_at,emp_ins_disqualified_at,soc_ins_insured_person_number,hel_ins_insured_person_number,basic_pension_number,soc_ins_qualified_at,soc_ins_disqualified_at,monthly_income_currency,monthly_income_goods,monthly_standard_income_updated_at,monthly_standard_income_hel,monthly_standard_income_pns,payment_period.name,having_spouse,spouse_yearly_income,nearest_station_and_line,commutation_1_expenses,commutation_1_period,commutation_1_single_fare,commutation_2_expenses,commutation_2_period,commutation_2_single_fare,foreign_resident_last_name,foreign_resident_first_name,foreign_resident_middle_name,foreign_resident_card_number,nationality_code,resident_status_type,resident_status_other_reason,resident_end_at,having_ex_activity_permission,other_be_workable_type,contract_type,contract_start_on,contract_end_on,contract_renewal_type,handicapped_type,handicapped_note_type,handicapped_note_delivery_at,working_student_flag,school_name,enrolled_at,working_student_income,employment_income_flag,business_income_flag,devidend_income_flag,estate_income_flag,widow_type,widow_reason_type,widow_memo,tax_cd,bank_account1.name,bank_account1.bank_code,bank_account1.bank_branch_code,bank_account1.account_type,bank_account1.account_number,bank_account1.account_holder_name,bank_account2.name,bank_account2.bank_code,bank_account2.bank_branch_code,bank_account2.account_type,bank_account2.account_number,bank_account2.account_holder_name,bank_account3.name,bank_account3.bank_code,bank_account3.bank_branch_code,bank_account3.account_type,bank_account3.account_number,bank_account3.account_holder_name,bank_account4.name,bank_account4.bank_code,bank_account4.bank_branch_code,bank_account4.account_type,bank_account4.account_number,bank_account4.account_holder_name

■論理名を指定した場合

ユーザーID,社員番号,姓,名,事業所名,部署1 部署,部署2 部署,部署3 部署,雇用形態,姓（ヨミガナ）,名（ヨミガナ）,ビジネスネーム：姓,ビジネスネーム：名,ビジネスネーム：姓（ヨミガナ）,ビジネスネーム：名（ヨミガナ）,生年月日,戸籍上の性別,メールアドレス,電話番号,現住所（郵便番号）,現住所（都道府県）,現住所（市区町村）,現住所（丁目・番地）,現住所（建物名・部屋番号）,現住所（ヨミガナ）,現住所（国コード）,現住所の世帯主,現住所の世帯主の続柄,緊急連絡先の続柄,緊急連絡先の姓,緊急連絡先の名,緊急連絡先の姓（ヨミガナ）,緊急連絡先の名（ヨミガナ）,緊急連絡先の電話番号,緊急連絡先の住所（郵便番号）,緊急連絡先の住所（都道府県）,緊急連絡先の住所（市区町村）,緊急連絡先の住所（丁目・番地）,緊急連絡先の住所（建物名・部屋番号）,緊急連絡先の住所（ヨミガナ）,緊急連絡先の住所（国コード）,住民票住所（郵便番号）,住民票住所（都道府県）,住民票住所（市区町村）,住民票住所（丁目・番地）,住民票住所（建物名・部屋番号）,住民票住所（ヨミガナ）,住民票住所の世帯主,住民票住所の世帯主の続柄,役職,業務内容,在籍状況,入社年月日,退職年月日,退職事由,雇用保険の被保険者番号,雇用保険の資格取得年月日,雇用保険の資格喪失年月日,厚生年金保険の被保険者整理番号,健康保険の被保険者整理番号,基礎年金番号,社会保険の資格取得年月日,社会保険の資格喪失年月日,報酬月額（通貨）,報酬月額（現物）,標準報酬月額の改定年月日,健康保険の標準報酬月額,厚生年金の標準報酬月額,給与支給形態,配偶者の有無,配偶者の年収,通勤経路,通勤手当1の定期券代,通勤手当1の期間,通勤手当1の片道運賃,通勤手当2の定期券代,通勤手当2の期間,通勤手当2の片道運賃,在留資格認定証明書：姓,在留資格認定証明書：名,在留資格認定証明書：ミドルネーム,在留カード番号,国籍コード,在留資格,在留資格不明理由,在留期日,資格外活動許可の有無,派遣・請負就労区分,契約種別,契約開始日,契約終了日,契約更新の有無,障害者区分,障害者手帳の種類,障害者手帳の交付年月日,勤労学生フラグ,勤労学生：学校名,勤労学生：入学年月日,勤労学生：所得の見積額,勤労学生：給与所得フラグ,勤労学生：事業所得フラグ,勤労学生：配当所得フラグ,勤労学生：不動産所得フラグ,寡婦・ひとり親,寡婦・ひとり親の理由,寡婦・ひとり親の備考,課税区分,給与振込口座1 口座情報の名称,給与振込口座1 銀行コード,給与振込口座1 支店コード,給与振込口座1 預金種別,給与振込口座1 口座番号,給与振込口座1 名義（カタカナ）,給与振込口座2 口座情報の名称,給与振込口座2 銀行コード,給与振込口座2 支店コード,給与振込口座2 預金種別,給与振込口座2 口座番号,給与振込口座2 名義（カタカナ）,給与振込口座3 口座情報の名称,給与振込口座3 銀行コード,給与振込口座3 支店コード,給与振込口座3 預金種別,給与振込口座3 口座番号,給与振込口座3 名義（カタカナ）,給与振込口座4 口座情報の名称,給与振込口座4 銀行コード,給与振込口座4 支店コード,給与振込口座4 預金種別,給与振込口座4 口座番号,給与振込口座4 名義（カタカナ）

 

【注意事項】SmartHR - スプレッドシート連携 (OAuth) で取得可能な従業員情報の取扱いについて

  •  取得できる従業員の範囲・項目は、設定時に利用したSmartHRのアカウントの権限設定を反映します。目的と用途に応じた権限のSmartHRのアカウントを使って設定を行なってください。
    詳しくは、*従業員関連の閲覧・作成・更新・削除の権限を設定する* を参照してください。
    https://support.smarthr.jp/ja/help/articles/1500001368101/
  • Goolgleスプレッドシートの共有権限設定は、共有範囲や有効期間を限定し、ファイルを一般公開しないことを推奨いたします。
    詳しくは、*Google ドライブのファイルを共有する* を参照してください。
    https://support.google.com/drive/answer/2494822?hl=ja

 

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

 

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

 

関連記事