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

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

Yoom 運営事務局 avatar
対応者:Yoom 運営事務局
2年以上前に更新

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 パラメータをご利用ください。

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