すべてのコレクション
🔗外部サービス(アプリ)との連携
SmartHR
SmartHR「従業員情報の更新」の更新項目一覧
SmartHR「従業員情報の更新」の更新項目一覧

SmartHR「従業員情報の更新従業員情報の更新（更新対象の項目をテキストで指定）」の「更新対象の項目」の指定方法について説明します。

Yoom 運営事務局 avatar
対応者：Yoom 運営事務局
一週間前以上前にアップデートされました

SmartHR「従業員情報の更新従業員情報の更新（更新対象の項目をテキストで指定）」の「更新対象の項目」の指定方法について説明します。

最新情報はSmartHRのAPI仕様書をご確認ください。

更新対象の項目

「更新対象の項目」に指定する値：説明という順で記載しています

  • user_id：ユーザーID

  • biz_establishment_id：事業所ID

  • emp_code：社員番号

  • emp_type：雇用形態

    • 値には次のいずれかを入力：board_member, full_timer, contract_worker, permatemp, part_timer, outsourcing_contractor,etc

  • emp_status：在籍状況

    • 値には次のいずれかを入力：absent, retired

  • last_name：姓 *

  • first_name：名 *

  • last_name_yomi：姓（カタカナ） *

  • first_name_yomi：string名（カタカナ） *

  • business_last_name：ビジネスネーム：姓

  • business_first_name：ビジネスネーム：名

  • business_last_name_yomi：ビジネスネーム：姓（カタカナ）

  • business_first_name_yomi：ビジネスネーム：名（カタカナ）

  • birth_at：生年月日 *

    • YYYY-MM-DDで入力してください

  • gender：戸籍上の性別 *

    • 値は次のいずれかを入力：male, female

  • tel_number：電話番号

  • address：現住所 *

    • 「住所の入力方法」をご確認ください。

  • address_head_of_family：世帯主

  • address_relation_name：世帯主の続柄

  • email：メールアドレス

  • emergency_relation_name：緊急連絡先の続柄

  • emergency_last_name： 緊急連絡先の姓

  • emergency_first_name：緊急連絡先の名

  • emergency_last_name_yomi：緊急連絡先の姓（カタカナ）

  • emergency_first_name_yomi：緊急連絡先の名（カタカナ）

  • emergency_tel_number：緊急連絡先の電話番号

  • emergency_address：緊急連絡先の住所

    • 「住所の入力方法」をご確認ください。

  • resident_card_address：住民票住所

    • 「住所の入力方法」をご確認ください。

  • resident_card_address_head_of_family：住民票住所の世帯主

  • resident_card_address_relation_name：続柄（住民票住所の世帯主）

  • position：役職

  • occupation：業務内容

  • entered_at：入社年月日

    • YYYY-MM-DDで入力してください

  • resigned_at：退職年月日

    • YYYY-MM-DDで入力してください

  • resigned_reason：退職事由

  • emp_ins_insured_person_number：雇用保険の被保険者番号

  • emp_ins_insured_person_number_unknown_reason_type：雇用保険被保険者番号未記載理由

    • 値は次のいずれかを入力：no_work_experience, never_joined,unknown

  • emp_ins_qualified_at：雇用保険の資格取得年月日

    • YYYY-MM-DDで入力してください

  • emp_ins_disqualified_at：雇用保険の資格喪失年月日

    • YYYY-MM-DDで入力してください

  • previous_workplace：雇用保険に加入していた会社名

  • previous_employment_start_on：雇用保険に加入していた会社の在籍開始日

  • previous_employment_end_on：雇用保険に加入していた会社の在籍終了日

  • soc_ins_insured_person_number：厚生年金保険の被保険者整理番号

    • 半角数字で入力してください

  • hel_ins_insured_person_number：健康保険の被保険者整理番号

    • 半角数字で入力してください

  • basic_pension_number：基礎年金番号

  • first_enrolling_in_emp_pns_ins_flag：boolean(optional)厚生年金初加入フラグ

    • true / falseで入力してください

  • basic_pension_number_unknown_reason_type：基礎年金番号未記載理由

    • 値は次のいずれかを入力：non_pensionable, unknown

  • first_workplace：最初に厚生年金へ加入した会社名

  • first_workplace_address_text：最初に厚生年金へ加入した会社の住所文字列

  • first_employment_start_on：最初に厚生年金へ加入した会社の在籍開始日

    • YYYY-MM-DDで入力してください

  • first_employment_end_on：最初に厚生年金へ加入した会社の在籍終了日

    • YYYY-MM-DDで入力してください

  • last_workplace：最後に厚生年金へ加入した会社名

  • last_workplace_address_text：最後に厚生年金へ加入した会社の住所文字列

  • last_employment_start_on：最後に厚生年金へ加入した会社の在籍開始日

    • YYYY-MM-DDで入力してください

  • last_employment_end_on：最後に厚生年金へ加入した会社の在籍終了日

    • YYYY-MM-DDで入力してください

  • soc_ins_qualified_at：社会保険の資格取得年月日

    • YYYY-MM-DDで入力してください

  • soc_ins_disqualified_at：社会保険の資格喪失年月日

    • YYYY-MM-DDで入力してください

  • having_spouse：配偶者の有無

    • true / falseで入力してください

  • spouse_yearly_income：配偶者の年収

    • 半角数字で入力してください

  • monthly_income_currency：報酬月額（通貨）

    • 半角数字で入力してください

  • monthly_income_goods：報酬月額（現物）

    • 半角数字で入力してください

  • monthly_standard_income_updated_at：標準報酬月額の改定年月

    • YYYY-MM-DDで入力してください

  • monthly_standard_income_hel：健康保険の標準報酬月額

    • 半角数字で入力してください

  • monthly_standard_income_pns：厚生年金の標準報酬月額

    • 半角数字で入力してください

  • nearest_station_and_line：通勤経路

  • commutation_1_expenses：通勤手当1の定期券代

    • 半角数字で入力してください

  • commutation_1_period：通勤手当1の期間

    • 値は次のいずれかを入力：commutation_period_1_month, commutation_period_3_month, commutation_period_6_month

  • commutation_1_single_fare：通勤手当1の片道運賃

    • 半角数字で入力してください

  • commutation_2_expenses：通勤手当2の定期券代

    • 半角数字で入力してください

  • commutation_2_period：通勤手当2の期間

    • 値は次のいずれかを入力：commutation_period_1_month, commutation_period_3_month, commutation_period_6_month

  • commutation_2_single_fare：通勤手当2の片道運賃

    • 半角数字で入力してください

  • 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：在留期日

    • YYYY-MM-DDで入力してください

  • having_ex_activity_permission：資格外活動許可の有無

    • 値は次のいずれかを入力：permitted, none

  • other_be_workable_type：派遣・請負就労区分

    • 値は次のいずれかを入力：other_be_workable, others

  • department：部署

  • contract_type：契約種別

    • 値は次のいずれかを入力：unlimited, fixed_term

  • contract_start_on：契約開始日

    • YYYY-MM-DDで入力してください

  • contract_end_on：契約終了日

    • YYYY-MM-DDで入力してください

  • contract_renewal_type：契約更新の有無

    • 値は次のいずれかを入力：renewal, none, auto_renewal

  • tax_cd：課税区分

    • 値は次のいずれかを入力：kou, otsu, hei, reward, non_resident, no_taxation_required

  • handicapped_type：障害者区分

    • 値は次のいずれかを入力：ordinary_handicapped, special_handicapped

  • handicapped_note_type：障害者手帳の種類

  • handicapped_note_delivery_at：障害者手帳の交付年月日

    • YYYY-MM-DDで入力してください

  • working_student_flag：勤労学生フラグ

    • true / falseで入力してください

  • school_name：勤労学生：学校名

  • enrolled_at：勤労学生：入学年月日

    • YYYY-MM-DDで入力してください

  • working_student_income：勤労学生：所得の見積額

    • 半角数字で入力してください

  • employment_income_flag：給与所得フラグ

    • true / falseで入力してください

  • business_income_flag：事業所得フラグ

    • true / falseで入力してください

  • devidend_income_flag：配当所得フラグ

    • true / falseで入力してください

  • estate_income_flag：不動産所得フラグ

    • true / falseで入力してください

  • widow_type：寡婦・ひとり親

    • 値は次のいずれかを入力：widow, special_widow, widower, single_parent

  • widow_reason_type：寡婦・ひとり親の理由

    • 値は次のいずれかを入力：divorce, bereavement, missing, unmarried

  • widow_memo：寡婦・ひとり親の備考

  • employment_type_id：雇用形態のID

  • department_ids：所属する部署のID

    • ["部署ID", "部署ID"]という形式で指定してください

  • payment_period_id：給与支給形態

住所の入力方法

住所は下記形式で入力してください

"country_number" : "国コード", "zip_code" : "郵便番号", "pref" : "都道府県", "city" : "市区町村",  "street" : "丁目・番地", "building" : "建物名・部屋番号", "literal_yomi" : "ヨミガナ"

注意事項

  • 以下の項目（*）が入力済みの従業員に対して、これらのいずれかを欠けさせる更新はできません。

    • last_name

    • first_name

    • last_name_yomi

    • first_name_yomi

    • gender

    • birth_at

    • address
      ​

  • 部署データの構造変更に伴い、department パラメータの利用は非推奨となりました。 今後は department_ids パラメータをご利用ください
    ​

  • 雇用形態データの構造変更に伴い、emp_type パラメータの利用は非推奨となりました。 今後は employment_type_id パラメータをご利用ください。

こちらの回答で解決しましたか？