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