获取员工适用薪资包

获取员工适用薪资包
scope:hades:salarypackage:applicative:list

接口作用

根据员工的人事信息和合同信息，匹配并返回该员工适用的薪资包列表。主要用于待入职或在职员工的薪资包分配场景。

接口信息

属性	值
URL	`/open/api/v1/salaryPackage/applicative/list`
Method	POST
Content-Type	application/json
权限标识	`hades:salarypackage:applicative:list`

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
empId	String	否	员工ID（待入职场景可为空）
hrmData	Map<String, Object>	条件必填	人事信息数据，用于薪资包匹配。与 contractInfoData 至少有一个不为空
contractInfoData	List<Map<String, Object>>	条件必填	合同信息数据，用于薪资包匹配。与 hrmData 至少有一个不为空

请求示例:

{
  "corpId": "corp_123456",
  "empId": "emp_001",
  "hrmData": {
    "department": "技术部",
    "position": "高级工程师",
    "employeeType": "正式"
  },
  "contractInfoData": [
    {
      "contractType": "劳动合同",
      "startDate": "2024-01-01",
      "endDate": "2026-12-31"
    }
  ]
}

返回参数

参数名	类型	说明
code	Integer	状态码，0表示成功
msg	String	返回消息
data	List<SalaryPackageResponse>	适用的薪资包列表

SalaryPackageResponse 字段说明:

参数名	类型	说明
packageId	String	薪资包ID
packageName	String	薪资包名称

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "packageId": "pkg_001",
      "packageName": "技术岗位薪资包"
    },
    {
      "packageId": "pkg_002",
      "packageName": "管理岗位薪资包"
    }
  ]
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
    "corpId": "",
    "empId": "",
    "hrmData": {
        "basicInfo": {
            "employeeNumber": "13",
            "idType": "others",
            "idNumber": "54",
            "idName": "能文昊",
            "validPeriodOfId": "2020-11-11",
            "idAddress": "山西省 厦头市 解放区 衷侬67号 62号门牌",
            "dateOfBirth": "2025-06-22",
            "ethnicity": "han",
            "gender": "male",
            "nativeRegion": "commodo laboris mollit laborum",
            "currentResidentialAddress": "陕西省 长沙市 天峨县 索巷248号 46号院",
            "maritalStatus": "spinsterhood",
            "politicalStatus": "masses",
            "hukouType": "local_town",
            "hukouLocation": [
                "11",
                "1101"
            ],
            "dateEnteredWorkforce": "2024-11-12",
            "email": "pybsbt.g1x@hotmail.com",
            "personalEmail": "g6nmzi21@yahoo.com.cn",
            "socialSecurityAccount": "velit do non",
            "providentFundAccount": "40",
            "customizeData": {
                "field_emp_numb_011": 11,
                "field_emp_sele_020": "selection_64b704465fb64bdd84b36a7d34d4d6dc"
            }
        },
        "workInfo": {
            "mainDepartment": "1",
            "jobTitle": "670f8bc82e7ff16dc2800d85",
            "jobLevel": "64632f5703984a612b68e4a8",
            "manager": "emp_e2615c90cfd74fb79bd93194bedab3e4",
            "workLocation": "selection_f37eb133d7a44d3d92b006580908141e",
            "costCenter": "1",
            "customizeData": {
                "field_emp_stri_036": "1111",
                "field_emp_sele_024": "selection_14391b87df9e4d01bb3db07d3bc84eef"
            }
        },
        "workStatusInfo": {
            "employeeStatus": "probation",
            "employeeType": "regular",
            "probationDate": "2025-06-09",
            "probationPeriod": 2,
            "customizeData": {
                "field_emp_addr_008": [
                    "11",
                    "1101"
                ],
                "field_emp_date_011": "2024-10-1"
            }
        }
    },
    "contractInfoData": [
        {
            "gmtModified": "2025-04-29 02:00:24",
            "endDate": "2026-04-18",
            "contractType": "yy测试合同类型",
            "signStatus": "not_start",
            "templateId": "contract_template_xxxxxxxxxxxxxx",
            "delete": "normal",
            "signPeople_source": [
                {
                    "id": "emp_xxxxxxxxxxxxxx",
                    "name": "张三",
                    "status": "NORMAL",
                    "effectDate": "2024-08-06 00:00:00",
                    "order": null,
                    "code": null,
                    "orgName": null,
                    "value": "emp_xxxxxxxxxxxxxx",
                    "label": "张三"
                }
            ],
            "field_contract_stri_011": "34gbf",
            "signEntity": "esigntest测试企业PABY",
            "renewalsNumber": "第3次",
            "id": "xxxxxxxxxxxxxx",
            "templateObjectId_source": [
                {
                    "id": "xxxxxxxxxxxxxx",
                    "name": "yy测试劳动",
                    "status": "NORMAL",
                    "effectDate": null,
                    "order": null,
                    "code": null,
                    "orgName": null,
                    "value": "xxxxxxxxxxxxxx",
                    "label": "yy测试劳动"
                }
            ],
            "renewalsNumber_source": [
                {
                    "label": "第3次",
                    "value": "threeTimeSign",
                    "order": null,
                    "status": null,
                    "markValue": null,
                    "orgLabel": null
                }
            ],
            "templateObjectId": "yy测试劳动",
            "beforeContractId": "xxxxxxxxxxxxxx",
            "contractType_source": [
                {
                    "id": "contract_type_xxxxxxxx",
                    "name": "yy测试合同类型",
                    "status": "NORMAL",
                    "effectDate": null,
                    "order": null,
                    "code": null,
                    "orgName": null,
                    "value": "contract_type_xxxxxxxx",
                    "label": "yy测试合同类型"
                }
            ],
            "contractStatus": "waitApprove",
            "corpId": "",
            "contractApprovalStatus": "not_start",
            "gmtCreate": "2025-04-25 15:36:27",
            "contractPeriod_source": [
                {
                    "label": "固定期限-1年",
                    "value": "fixedTermOneYear",
                    "order": null,
                    "status": null,
                    "markValue": null,
                    "orgLabel": null
                }
            ],
            "contractPeriod": "固定期限-1年",
            "signPeople": "张三",
            "signEntity_source": [
                {
                    "id": "xxxxxxxxxxxxxx",
                    "name": "esigntest测试企业PABY",
                    "status": "NORMAL",
                    "effectDate": null,
                    "order": null,
                    "code": null,
                    "orgName": null,
                    "value": "xxxxxxxxxxxxxx",
                    "label": "esigntest测试企业PABY"
                }
            ],
            "templateVersion": 20,
            "effectiveDate": "2025-04-19"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app91651.eapps.dingtalkcloud.com/hades/open/api/v1/salaryPackage/applicative/list' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corpId": "",
    "empId": "",
    "hrmData": {
        "basicInfo": {
            "employeeNumber": "13",
            "idType": "others",
            "idNumber": "54",
            "idName": "能文昊",
            "validPeriodOfId": "2020-11-11",
            "idAddress": "山西省 厦头市 解放区 衷侬67号 62号门牌",
            "dateOfBirth": "2025-06-22",
            "ethnicity": "han",
            "gender": "male",
            "nativeRegion": "commodo laboris mollit laborum",
            "currentResidentialAddress": "陕西省 长沙市 天峨县 索巷248号 46号院",
            "maritalStatus": "spinsterhood",
            "politicalStatus": "masses",
            "hukouType": "local_town",
            "hukouLocation": [
                "11",
                "1101"
            ],
            "dateEnteredWorkforce": "2024-11-12",
            "email": "pybsbt.g1x@hotmail.com",
            "personalEmail": "g6nmzi21@yahoo.com.cn",
            "socialSecurityAccount": "velit do non",
            "providentFundAccount": "40",
            "customizeData": {
                "field_emp_numb_011": 11,
                "field_emp_sele_020": "selection_64b704465fb64bdd84b36a7d34d4d6dc"
            }
        },
        "workInfo": {
            "mainDepartment": "1",
            "jobTitle": "670f8bc82e7ff16dc2800d85",
            "jobLevel": "64632f5703984a612b68e4a8",
            "manager": "emp_e2615c90cfd74fb79bd93194bedab3e4",
            "workLocation": "selection_f37eb133d7a44d3d92b006580908141e",
            "costCenter": "1",
            "customizeData": {
                "field_emp_stri_036": "1111",
                "field_emp_sele_024": "selection_14391b87df9e4d01bb3db07d3bc84eef"
            }
        },
        "workStatusInfo": {
            "employeeStatus": "probation",
            "employeeType": "regular",
            "probationDate": "2025-06-09",
            "probationPeriod": 2,
            "customizeData": {
                "field_emp_addr_008": [
                    "11",
                    "1101"
                ],
                "field_emp_date_011": "2024-10-1"
            }
        }
    },
    "contractInfoData": [
        {
            "gmtModified": "2025-04-29 02:00:24",
            "endDate": "2026-04-18",
            "contractType": "yy测试合同类型",
            "signStatus": "not_start",
            "templateId": "contract_template_xxxxxxxxxxxxxx",
            "delete": "normal",
            "signPeople_source": [
                {
                    "id": "emp_xxxxxxxxxxxxxx",
                    "name": "张三",
                    "status": "NORMAL",
                    "effectDate": "2024-08-06 00:00:00",
                    "order": null,
                    "code": null,
                    "orgName": null,
                    "value": "emp_xxxxxxxxxxxxxx",
                    "label": "张三"
                }
            ],
            "field_contract_stri_011": "34gbf",
            "signEntity": "esigntest测试企业PABY",
            "renewalsNumber": "第3次",
            "id": "xxxxxxxxxxxxxx",
            "templateObjectId_source": [
                {
                    "id": "xxxxxxxxxxxxxx",
                    "name": "yy测试劳动",
                    "status": "NORMAL",
                    "effectDate": null,
                    "order": null,
                    "code": null,
                    "orgName": null,
                    "value": "xxxxxxxxxxxxxx",
                    "label": "yy测试劳动"
                }
            ],
            "renewalsNumber_source": [
                {
                    "label": "第3次",
                    "value": "threeTimeSign",
                    "order": null,
                    "status": null,
                    "markValue": null,
                    "orgLabel": null
                }
            ],
            "templateObjectId": "yy测试劳动",
            "beforeContractId": "xxxxxxxxxxxxxx",
            "contractType_source": [
                {
                    "id": "contract_type_xxxxxxxx",
                    "name": "yy测试合同类型",
                    "status": "NORMAL",
                    "effectDate": null,
                    "order": null,
                    "code": null,
                    "orgName": null,
                    "value": "contract_type_xxxxxxxx",
                    "label": "yy测试合同类型"
                }
            ],
            "contractStatus": "waitApprove",
            "corpId": "",
            "contractApprovalStatus": "not_start",
            "gmtCreate": "2025-04-25 15:36:27",
            "contractPeriod_source": [
                {
                    "label": "固定期限-1年",
                    "value": "fixedTermOneYear",
                    "order": null,
                    "status": null,
                    "markValue": null,
                    "orgLabel": null
                }
            ],
            "contractPeriod": "固定期限-1年",
            "signPeople": "张三",
            "signEntity_source": [
                {
                    "id": "xxxxxxxxxxxxxx",
                    "name": "esigntest测试企业PABY",
                    "status": "NORMAL",
                    "effectDate": null,
                    "order": null,
                    "code": null,
                    "orgName": null,
                    "value": "xxxxxxxxxxxxxx",
                    "label": "esigntest测试企业PABY"
                }
            ],
            "templateVersion": 20,
            "effectiveDate": "2025-04-19"
        }
    ]
}'

返回响应

🟢200获取员工适用薪资包-Example

application/json

Bodyapplication/json

示例

{
    "data": [
        {
            "packageId": "", //薪资包id
            "packageName": "" //薪资包名称
        }
    ],
    "success": false,
    "errorCode": "",
    "errorMsg": "",
    "rid": "" //traceId
}

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数