员工

获取定义的员工类型列表

返回值结构

员工类型

员工列表接口

请求参数说明

返回值结构

Employee类型

任职类型

LineReporter类型

Position类型

图片类型

返回值举例

{
  "totalCount": 88,
  "list": [
    {
      "id": 6874,
      "fullName": "王源",
      "code": "E233",
      "gender": "MALE",
      "dateOfBirth": "1980-01-01",
      "onboardDate": "2019-04-01",
      "becomeRegularDate": "2019-07-01",
      "status": "ONBOARD",
      "costCenter": "201840113",
      "departmentName": "财务部",
      "departmentPath": "百香果科技/财务部",
      "depId": 2292,
      "depCode": "5d327f464562ebdd68e21db5",
      "jobClassId": 3300,
      "jobClassName": "开发工程师",
      "legalEntityId": 11,
      "legalEntityName": "百香果科技",
      "managerId": 55,
      "managerName": "石睿",
      "superiorId": 89,
      "superiorName": "连战",
      "paymentInfo": {
        "bankName":"招商银行",
        "bankCode": "CMB",
        "bankBranch": "招商银行上海南西支行",
        "bankAccountName": "王源",
        "bankAccountNo": "6225100810081008"
      },
      "currentJobInfo": {
        "legalEntityCode": "91310109MA1G000000",
        "legalEntityName": "百香果科技（上海）有限公司"
      },
      "contractInfo": {
        "email": "test@163.com",
        "companyEmail": "test@hrsaas.com"
      },
      "userDefinedFields": {
        "亲属卡姓名": "王天明",
        "亲属卡关系": "父子"
      }
    }
  ]
}

接口调用场景举例

获取2022年5月16日当天的在职和离职员工

{"filter":"(employeeStatus eq 'ONBOARD' or employeeStatus eq 'QUIT' ) and startDate le '2022-05-16' and endDate ge '2022-05-16'",
 "offset":0,
 "limit":20,
 "orderby":"id desc"
}

获取2022年1月1日到2022年5月31日期间的离职员工

{"filter":"(employeeStatus eq 'QUIT') and startDate le '2022-01-01' and endDate ge '2022-05-31'",
 "offset":0,
 "limit":20,
 "orderby":"id desc"
}

创建在职员工或已离职员工

根据员工ID部分更新员工信息

返回值结构为 Employee类型

可更新的员工属性列表

联系信息属性列表

请求示例，下面的请求将更新员工的gender，companyEmail和自定义字段”自定义字段A“这三个属性的值

{

  "userDefinedFields": {
    "自定义字段A": "333"
  },
  "gender":"MALE",
  "contactInfo":{
       "companyEmail":"abc@163.com"
  } 
}

根据员工ID获取员工详情

返回值结构为 Employee类型

根据员工工号获取员工详情

返回值结构为 Employee类型

获取员工当次入职周期最后一份合同

{
    "id": 219,
    "termType": "NONFIXED_PERIOD",
    "startDate": "2020-05-21",
    "endDate": null,
    "signType": "OFFLINE",
    "docNo": "LD00000215",
    "legalEntity": {
        "id": 67,
        "no": "67",
        "path": "FW47",
        "name": "FW47",
        "enName": null,
        "orgType": "Company",
        "subType": "公司",
        "startDate": "1900-01-01",
        "endDate": "9999-12-31",
        "subTypeId": 548,
        "code": null
    },
    "docType": {
        "id": 1,
        "systemDefault": false,
        "internalCode": null,
        "category": "CONTRACT",
        "name": "劳动合同",
        "signMode": "COMPANY_EMPLOYEE",
        "description": "劳动合同",
        "applySecurityGroup": false,
        "sealType": "OFFICIAL_SEAL",
        "sealTypeDsiplayName": null,
        "datePropertyType": "MANDATORY"
    },
    "doc": {
        "id": 138,
        "docTitle": "刘琳-劳动合同",
        "docNo": "LD00000215",
        "createScene": null,
        "sceneBoId": null,
        "createdDate": "2022-01-26",
        "fileType": "jpg",
        "employeeSignStatus": null,
        "employerSignStatus": null,
        "uploadedForSign": false,
        "signType": "OFFLINE",
        "signMode": "COMPANY_EMPLOYEE",
        "docRef": {
            "tags": null,
            "name": "Picture05.jpg",
            "contentType": null,
            "hashKey": "Fl2LqBE19GbY2Z12x7wS7zGWs57Q",
            "url": "https://cdn.hrsaas.com/Fl2LqBE19GbY2Z12x7wS7zGWs57Q?e=1694502455&token=Sp-MbD5rQQjENG5qycL-DNNl2eCT8yo6IJRA_bwR:HWfO52nTPFTh6SzldxeVT2TIKtc=",
            "downloadUrl": "https://cdn.hrsaas.com/Fl2LqBE19GbY2Z12x7wS7zGWs57Q?e=1694502455&token=Sp-MbD5rQQjENG5qycL-DNNl2eCT8yo6IJRA_bwR:HWfO52nTPFTh6SzldxeVT2TIKtc=&attname=Picture05.jpg",
            "previewUrl": "https://api.yozocloud.cn/checkUrl?k=49085245813476556892246&url=https%3A%2F%2Fcdn.hrsaas.com%2FFl2LqBE19GbY2Z12x7wS7zGWs57Q%3Fe%3D1694502455%26token%3DSp-MbD5rQQjENG5qycL-DNNl2eCT8yo6IJRA_bwR%3AHWfO52nTPFTh6SzldxeVT2TIKtc%3D%26attname%3DPicture05.jpg&noCache=false&type=jpg&isCopy=0"
        },
        "signedDocRef": {
            "tags": null,
            "name": "Picture05.jpg",
            "contentType": null,
            "hashKey": "Fl2LqBE19GbY2Z12x7wS7zGWs57Q",
            "url": "https://cdn.hrsaas.com/Fl2LqBE19GbY2Z12x7wS7zGWs57Q?e=1694502455&token=Sp-MbD5rQQjENG5qycL-DNNl2eCT8yo6IJRA_bwR:HWfO52nTPFTh6SzldxeVT2TIKtc=",
            "downloadUrl": "https://cdn.hrsaas.com/Fl2LqBE19GbY2Z12x7wS7zGWs57Q?e=1694502455&token=Sp-MbD5rQQjENG5qycL-DNNl2eCT8yo6IJRA_bwR:HWfO52nTPFTh6SzldxeVT2TIKtc=&attname=Picture05.jpg",
            "previewUrl": "https://api.yozocloud.cn/checkUrl?k=49085245813476556892246&url=https%3A%2F%2Fcdn.hrsaas.com%2FFl2LqBE19GbY2Z12x7wS7zGWs57Q%3Fe%3D1694502455%26token%3DSp-MbD5rQQjENG5qycL-DNNl2eCT8yo6IJRA_bwR%3AHWfO52nTPFTh6SzldxeVT2TIKtc%3D%26attname%3DPicture05.jpg&noCache=false&type=jpg&isCopy=0"
        },
        "signInvitationSent": null,
        "signRequested": false,
        "signStatus": "SIGNING"
    },
    "leftDays": 2913285,
    "expiredDays": null,
    "imported": true,
    "baseId": null,
    "renewRequest": null,
    "terminated": false,
    "terminateDate": null,
    "contractStatus": "ACTIVE",
    "terminate": null,
    "state": "Archived"
}

获取员工银行账户列表

{
    "totalCount": 2,
    "list": [
        {
            "id": 9308,
            "userDefinedFields": {
                "开户行银联号": "45425"
            },
            "udfCodeNameMap": {},
            "udfLinkedBOMap": {},
            "udfConfigurableEnumMap": {},
            "employeeId": 57438,
            "bankName": "中国工商银行",
            "bankCode": "ICBC",
            "bankCity": "唐山市",
            "bankCityName": "唐山市",
            "bankBranch": "工商支行",
            "bankAccountNo": "132531253215",
            "bankAccountName": "杨大拿",
            "memo": "33",
            "usageType": "PAYROLL_CARD",
            "usageTypeName": "工资卡",
            "bankProvince": null
        },
        {
            "id": 9307,
            "userDefinedFields": {},
            "udfCodeNameMap": {},
            "udfLinkedBOMap": {},
            "udfConfigurableEnumMap": {},
            "employeeId": 57438,
            "bankName": "中国农业银行",
            "bankCode": "ABC",
            "bankCity": "北京市",
            "bankCityName": "北京市",
            "bankBranch": null,
            "bankAccountNo": null,
            "bankAccountName": null,
            "memo": null,
            "usageType": "CORPORATE_CARD",
            "usageTypeName": "商务卡",
            "bankProvince": null
        }
    ]
}

获取员工教育经历列表

{
    "totalCount": 1,
    "list": [
        {
            "id": 560,
            "userDefinedFields": {
                "奖学金": "50000"
            },
            "udfCodeNameMap": {},
            "udfLinkedBOMap": {},
            "udfConfigurableEnumMap": {},
            "employeeId": 57438,
            "employeeCode": "JYS0487",
            "employeeName": "杨大拿",
            "school": "澳门大学",
            "highest": true,
            "startDate": "2019-09-23",
            "endDate": "2023-09-11",
            "credentials": "MASTER",
            "acquiredDate": "2023-09-11",
            "major": "工商管理",
            "degree": "MASTER",
            "studyAbroad": true,
            "studyAbroadCountry": "澳门",
            "mode": "FULL_TIME",
            "degreeAttachments": {
                "attachments": [
                    {
                        "tags": null,
                        "name": "毕业证书.pdf",
                        "contentType": null,
                        "hashKey": "640_1694415175490_517.gif",
                        "url": "https://cdn.hrsaas.com/640_1694415175490_517.gif?e=1694501559&token=Sp-MbD5rQQjENG5qycL-DNNl2eCT8yo6IJRA_bwR:V0OI6CD95oOTWEfBDEXjpRjHeEo=",
                        "downloadUrl": "https://cdn.hrsaas.com/640_1694415175490_517.gif?e=1694501559&token=Sp-MbD5rQQjENG5qycL-DNNl2eCT8yo6IJRA_bwR:V0OI6CD95oOTWEfBDEXjpRjHeEo=&attname=640.gif",
                        "previewUrl": "https://api.yozocloud.cn/checkUrl?k=49085245813476556892246&url=https%3A%2F%2Fcdn.hrsaas.com%2F640_1694415175490_517.gif%3Fe%3D1694501559%26token%3DSp-MbD5rQQjENG5qycL-DNNl2eCT8yo6IJRA_bwR%3AV0OI6CD95oOTWEfBDEXjpRjHeEo%3D%26attname%3D640.gif&noCache=false&type=gif&isCopy=0"
                    }
                ]
            },
            "credentialsCN": "硕士",
            "degreeCN": "硕士",
            "modeCN": "全日制统考"
        }
    ]
}