Femas HR
API Document
API SPEC
API Document
API SPEC
  1. 人事
  • 根目錄
    • 身分權限認證
      • 用戶登入
    • 資料讀取
      • 人事
        • 取得人員資料
        • 取得人員異動資料
        • 取得公司資料
        • 取得部門資料
        • 取得部門異動資料
        • 取得職稱資料
        • 取得職等資料
        • 取得職級資料
        • 取得員工類別資料
        • 取得學歷類別資料
        • 取得國別資料
        • 取得系統員工大頭照片
      • 差勤
        • 取得差假資料
        • 取得加班資料
        • 取得差勤資訊
        • 取得假日行事曆資料
      • 排班
        • 取得排班資訊
      • 薪資
        • 取得成本中心資料
        • 取得員工薪資發放方式
        • 取得員工薪資基本資料
        • 取得員工薪資明細表
        • 取得傳票資料
    • 資料寫入
      • 人事
        • 人員新進作業
          POST
        • 調派人員作業
          POST
        • 離退人員作業
          POST
        • 留停人員作業
          POST
        • 人員復職回任作業
          POST
        • 人員資料批次更新作業
          POST
        • 員工眷屬批量維護作業
          POST
        • 部門批量維護作業
          POST
      • 薪資
        • 成本中心批量維護作業
API Document
API SPEC
API Document
API SPEC
  1. 人事

人員新進作業

POST
https://mock.apidog.com/m1/1073975-0-default/fsapi/V3/su_new_user.json
資料寫入人事

請求

主體參數application/json必填

範例
{
    "datas":[
        {
            "user_sn":"A0001",
            "base":{
                "name":"王大明",
                "en_name":"Master",
                "sex":"M",
                "country_sn":"TW",
                "id_num":"A123456789",
                "birthday":"2000-01-01",
                "married":"1",
                "passport_number":"888800088",
                "passport_name":"DA MING,WANG",
                "id_num_type":"0",
                "user_title_name":"辦事員",
                "position_title_name":"業務資深經理",
                "user_grade":"2",
                "job_grade":"A",
                "user_type_name":"正式人員",
                "property":"1",
                "job_duty":"處理資訊事務",
                "business_type_name":"業務A",
                "card_number":"123",
                "clock_location_sn":"cp1;cp2;cp3;no-limit",
                "org_name":"123有限公司",
                "department_name":"資訊部",
                "sub_dept_name":"資安科",
                "onsite_dept_name":"管理部",
                "back_seniority":"24",
                "arrivedate":"2023-10-06",
                "holiday_calendar_name":"主要行事曆",
                "annual_ext_days":"8",
                "addr_zip":"888",
                "addr":"A省B市C區D路一段888號",
                "cont_addr_zip":"888",
                "cont_addr":"A省B市C區D路一段888號",
                "email":"[email protected]",
                "homephone":"0987654321",
                "cellphone":"0234567890",
                "officephone1":"0234567890",
                "officephone2":"0234567890",
                "emergency_contact1":"王父",
                "emergency_phone1":"0888888888",
                "emergency_contact2":"王母",
                "emergency_phone2":"0555555555",
                "current_job_assumed":"2023-10-06",
                "officially_hired":"2023-10-06",
                "grade_transferred":"2023-10-06",
                "job_rotated":"2023-10-06",
                "main_job_assumed":"2023-10-06",
                "leavedate":"2030-01-01",
                "passwd":"12345",
                "sso_id":"00000",
                "week_avg_hours":"40",
                "pwd_life":"2030-01-01",
                "boss_sn":"B0001",
                "union_join":"2023-10-06",
                "remark":"測試註記",
                "shift_type":"常日A班",
                "day_hours":"8",
                "account_username":"A0001",
                "account_passwd":"test000",
                "pgroup_name":"一般使用者",
                "cost_center_name":"員工",
                "wf_group":"一般員工",
                "advanced_fields":[
                    {
                        "code":"q1",
                        "value":"牡羊"
                    }
                ],
                "education_record":[
                    {
                        "name":"測試大學",
                        "type_name":"學士",
                        "department":"會計系",
                        "start_date":"2016-09-01",
                        "end_date":"2020-05-30",
                        "status":"graduated"
                    }
                ],
                "work_experience":[
                    {
                        "type":"0",
                        "org_name":"測試機構",
                        "department_name":"測試部門",
                        "sub_dept_name":"測試科組課別",
                        "user_title_name":"測試職稱",
                        "user_grade":"測試職等",
                        "job_grade":"測試職級",
                        "director_name":"測試直屬主管",
                        "onsite_dept_name":"測試派駐部門",
                        "started_date":"2023-09-01",
                        "end_date":"2024-05-30",
                        "seniority":"8",
                        "leave_reason":"到職",
                        "job_content":"一般業務",
                        "comments":"因為工作不適合而換工作"
                    }
                ],
                "military_service_record":[
                    {
                        "army":"陸軍",
                        "label":"二兵"
                    }
                ],
                "language_skill":[
                    {
                        "language":"english",
                        "listen":"3",
                        "speak":"3",
                        "read":"3",
                        "write":"3"
                    }
                ],
                "computer_skills":"無",
                "other_skills":"無",
                "interests":"無"
            },
            "lvday":{
                "lvdays_record_year":"2023",
                "avail_hours":"20",
                "personal_hours":"20",
                "sick_hours":"20",
                "agent":["A0002", " A0003", " A0004"],
                "pass":false
            },
            "dependant":{
                "datas":[
                    {
                        "dependant_name":"王小明",
                        "dependant_id_num":"B123456789",
                        "birthday":"2000-01-02",
                        "id_exp":"2050-01-01",
                        "relation":"兄弟",
                        "title":"弟"
                    },
                    {
                        "dependant_name":"王中明",
                        "dependant_id_num":"C123456789"
                    }
                ],
                "pass":false
            },
            "salary":{
                "salary_group":"全體員工",
                "reason":"新進",
                "start_date":"2023-10-06",
                "end_date":"2024-10-06",
                "unsteady":"0",
                "tax_rate":"0.05",
                "minimum_tax":"1",
                "tmp_Payment1":"轉帳/700/01234567895632",
                "tmp_Payment2":"現金",
                "tmp_Payment3":"匯款/052/09556855214522/30000/備註一/備註二",
                "otpay_base_type":1,
                "otpay_base":"3000",
                "res_lvdays_type":2,
                "res_lvdays_base":"503",
                "datas":[
                    {
                        "code":"100",
                        "v01":"300000"
                    },
                    {
                        "code":"150",
                        "v01":"2000"

                    },
                    {
                        "code":"103",
                        "v01":"200"
                    }
                ],
                "pass":false
            },
            "insurance":{
                "type":"勞保",
                "joined":"2023-10-06",
                "start_date":"2023-10-06",
                "insur_salary":"30000",
                "subsidy_item":"中度身心障礙,輕度身心障礙",
                "identity":"員工_202310",
                "special_id":"2",
                "fund_exempt":"0",
                "labor_salary":"3000",
                "social_insurance_type":"1",
                "pass":false
            },
            "pension":{
                "system_name":"新制",
                "identity":"員工_202310",
                "joined":"2023-10-06",
                "start_date":"2023-10-06",
                "pension_salary":"30000",
                "user_rate":"6",
                "pass":false
            }
        }
    ]
}

請求程式碼範例

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
請求請求範例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://mock.apidog.com/m1/1073975-0-default/fsapi/V3/su_new_user.json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datas":[
        {
            "user_sn":"A0001",
            "base":{
                "name":"王大明",
                "en_name":"Master",
                "sex":"M",
                "country_sn":"TW",
                "id_num":"A123456789",
                "birthday":"2000-01-01",
                "married":"1",
                "passport_number":"888800088",
                "passport_name":"DA MING,WANG",
                "id_num_type":"0",
                "user_title_name":"辦事員",
                "position_title_name":"業務資深經理",
                "user_grade":"2",
                "job_grade":"A",
                "user_type_name":"正式人員",
                "property":"1",
                "job_duty":"處理資訊事務",
                "business_type_name":"業務A",
                "card_number":"123",
                "clock_location_sn":"cp1;cp2;cp3;no-limit",
                "org_name":"123有限公司",
                "department_name":"資訊部",
                "sub_dept_name":"資安科",
                "onsite_dept_name":"管理部",
                "back_seniority":"24",
                "arrivedate":"2023-10-06",
                "holiday_calendar_name":"主要行事曆",
                "annual_ext_days":"8",
                "addr_zip":"888",
                "addr":"A省B市C區D路一段888號",
                "cont_addr_zip":"888",
                "cont_addr":"A省B市C區D路一段888號",
                "email":"[email protected]",
                "homephone":"0987654321",
                "cellphone":"0234567890",
                "officephone1":"0234567890",
                "officephone2":"0234567890",
                "emergency_contact1":"王父",
                "emergency_phone1":"0888888888",
                "emergency_contact2":"王母",
                "emergency_phone2":"0555555555",
                "current_job_assumed":"2023-10-06",
                "officially_hired":"2023-10-06",
                "grade_transferred":"2023-10-06",
                "job_rotated":"2023-10-06",
                "main_job_assumed":"2023-10-06",
                "leavedate":"2030-01-01",
                "passwd":"12345",
                "sso_id":"00000",
                "week_avg_hours":"40",
                "pwd_life":"2030-01-01",
                "boss_sn":"B0001",
                "union_join":"2023-10-06",
                "remark":"測試註記",
                "shift_type":"常日A班",
                "day_hours":"8",
                "account_username":"A0001",
                "account_passwd":"test000",
                "pgroup_name":"一般使用者",
                "cost_center_name":"員工",
                "wf_group":"一般員工",
                "advanced_fields":[
                    {
                        "code":"q1",
                        "value":"牡羊"
                    }
                ],
                "education_record":[
                    {
                        "name":"測試大學",
                        "type_name":"學士",
                        "department":"會計系",
                        "start_date":"2016-09-01",
                        "end_date":"2020-05-30",
                        "status":"graduated"
                    }
                ],
                "work_experience":[
                    {
                        "type":"0",
                        "org_name":"測試機構",
                        "department_name":"測試部門",
                        "sub_dept_name":"測試科組課別",
                        "user_title_name":"測試職稱",
                        "user_grade":"測試職等",
                        "job_grade":"測試職級",
                        "director_name":"測試直屬主管",
                        "onsite_dept_name":"測試派駐部門",
                        "started_date":"2023-09-01",
                        "end_date":"2024-05-30",
                        "seniority":"8",
                        "leave_reason":"到職",
                        "job_content":"一般業務",
                        "comments":"因為工作不適合而換工作"
                    }
                ],
                "military_service_record":[
                    {
                        "army":"陸軍",
                        "label":"二兵"
                    }
                ],
                "language_skill":[
                    {
                        "language":"english",
                        "listen":"3",
                        "speak":"3",
                        "read":"3",
                        "write":"3"
                    }
                ],
                "computer_skills":"無",
                "other_skills":"無",
                "interests":"無"
            },
            "lvday":{
                "lvdays_record_year":"2023",
                "avail_hours":"20",
                "personal_hours":"20",
                "sick_hours":"20",
                "agent":["A0002", " A0003", " A0004"],
                "pass":false
            },
            "dependant":{
                "datas":[
                    {
                        "dependant_name":"王小明",
                        "dependant_id_num":"B123456789",
                        "birthday":"2000-01-02",
                        "id_exp":"2050-01-01",
                        "relation":"兄弟",
                        "title":"弟"
                    },
                    {
                        "dependant_name":"王中明",
                        "dependant_id_num":"C123456789"
                    }
                ],
                "pass":false
            },
            "salary":{
                "salary_group":"全體員工",
                "reason":"新進",
                "start_date":"2023-10-06",
                "end_date":"2024-10-06",
                "unsteady":"0",
                "tax_rate":"0.05",
                "minimum_tax":"1",
                "tmp_Payment1":"轉帳/700/01234567895632",
                "tmp_Payment2":"現金",
                "tmp_Payment3":"匯款/052/09556855214522/30000/備註一/備註二",
                "otpay_base_type":1,
                "otpay_base":"3000",
                "res_lvdays_type":2,
                "res_lvdays_base":"503",
                "datas":[
                    {
                        "code":"100",
                        "v01":"300000"
                    },
                    {
                        "code":"150",
                        "v01":"2000"

                    },
                    {
                        "code":"103",
                        "v01":"200"
                    }
                ],
                "pass":false
            },
            "insurance":{
                "type":"勞保",
                "joined":"2023-10-06",
                "start_date":"2023-10-06",
                "insur_salary":"30000",
                "subsidy_item":"中度身心障礙,輕度身心障礙",
                "identity":"員工_202310",
                "special_id":"2",
                "fund_exempt":"0",
                "labor_salary":"3000",
                "social_insurance_type":"1",
                "pass":false
            },
            "pension":{
                "system_name":"新制",
                "identity":"員工_202310",
                "joined":"2023-10-06",
                "start_date":"2023-10-06",
                "pension_salary":"30000",
                "user_rate":"6",
                "pass":false
            }
        }
    ]
}'

回應

🟢200成功
application/json
主體

範例
{
    "response": {
        "status": "Partial fail",
        "data_count": {
            "total": 3,
            "success": 1,
            "err": 2
        },
        "err_datas": [
            {
                "err_msg": "保險身分(identity)錯誤",
                "user_sn": "A0001"
            },
            {
                "err_msg": "部門(department_name)不存在",
                "user_sn": "A0003"
            }
        ]
    }
}
修改時間 2025-11-13 01:11:35
上一頁
取得傳票資料
下一頁
調派人員作業
Built with