1. 薪资档案
睿人事OpenAPI
  • 睿人事开放接口
    • OAuth2
      • 获取token
    • 花名册
      • 查询待入职员工列表
      • 查询待入职员工详情
      • 添加待入职员工(简单数据版)
      • 添加待入职员工(完整数据通用版)
      • 待入职员工取消入职
      • 获取待入职记录元数据
      • 获取企业员工列表
      • 获取企业员工详情
      • 修改员工基本信息
      • 查询单个工作信息
      • 新增人员入职花名册
      • 新增工作信息
      • 修改指定工作信息
      • 删除指定工作信息
      • 新增离职工作信息
      • 获取花名册元数据
      • 根据证件号码获取empId
      • 员工搜索
      • 批量获取员工详情
      • 批量查询任职信息
      • 根据证件号批量查询 empId
      • 新增转正工作信息
    • 组织
      • 批量获取指定的组织
      • 获取指定的组织
      • 查询下级组织的组织数据
      • 根据部门获取部门关联的职位
      • 根据部门获取编制信息
      • 搜索组织节点
      • 获取组织节点字段定义
      • 单个创建组织
      • 停用指定的组织节点
      • 获取指定组织的历史记录列表(时间轴)
      • 在指定组织上添加新的历史记录
      • 删除指定的组织历史记录
      • 更新指定的组织历史记录
      • 设置组织关联钉钉通讯录部门
      • 取消组织关联钉钉通讯录部门
    • 成本中心
      • 查询下级成本中心数据 (一级一级给)
      • 创建成本中心
      • 获取成本中心详情
      • 更新成本中心
      • 停用成本中心
    • 生态对接
      • 使用userId置换绑定的empId
      • 使用deptId置换绑定的orgId
      • 使用empId置换绑定的userId
      • 使用orgId置换绑定的deptId
      • 同步员工的生态对接信息
    • 合同
      • 合同列表查询
    • 岗职体系
      • 查询职位详情
      • 查询职位
      • 查询序列
      • 查询职级类别
      • 查询职级
      • 查询职等
      • 查询职务
    • 兼岗
      • 查询员工兼岗信息
      • 批量获取员工兼岗记录 ID
      • 批量新增员工兼岗记录
      • 批量修改员工兼岗记录
      • 批量删除员工兼岗记录
      • 批量查询员工兼岗信息
    • 薪酬
      • 发薪活动
        • 发薪活动列表
        • 获取发薪活动详情
        • 发薪活动 - 添加算薪人员
        • 发薪活动 - 移除算薪人员
        • 获取人员范围
        • 解锁/锁定发薪活动
        • 批量创建发薪活动
        • 批量删除发薪活动
      • 薪资项
        • 获取企业薪资项
      • 薪资数据
        • 获取算薪数据
      • 薪资档案
        • 获取企业薪资档案字段
          POST
        • 获取员工适用薪资包
          POST
        • 获取薪资包详情
          POST
      • 核算组
        • 创建核算组
        • 核算组列表
      • 算薪结果
        • 算薪结果
        • 分段算薪结果
        • 提交智能校验
        • 查询智能校验结果
      • 算税
        • 生成算税人员
        • 查询算税人员生成结果
        • 批量报送算税人员
        • 查询批量报送算税人员结果
        • 更新算税人员信息
        • 查询算税人员信息
        • 提交算薪算税
        • 获得算薪算税反馈
        • 获取扣缴义务人列表
        • 获取6万减除费用人员列表
      • 薪资方案列表
        POST
    • 社保
      • 获取参保公司
      • 获取参保方案
      • 获取参保方案详情
    • datart
      • 通过仪表盘获取视图id
      • 通过仪表图表id获取数据定义&数据
    • 人员子集
      • 查询人员子集字段信息
      • 查询人员子集数据
      • 创建人员子集数据
      • 修改人员子集数据
      • 删除人员子集数据
    • 字段选项
      • 查询花名册选项类型字段中的选项值
      • 增加花名册选项类型字段中的选项
      • 启用/停用花名册选项类型字段中的选项
      • 修改花名册选项类型字段中的选项值
    • 表单平台
      • 查询表单id和名称
      • 查询表单字段信息
      • 数据查询接口
      • 新增数据
      • 更新数据
      • 删除数据
    • 审批
      • 获取审批实例ID列表
      • 获取单个审批实例详情的数据值
      • 查询审批记录(已经审批和当前审批节点)
      • 提交审批评论
      • 获取审批表单详情
      • 发起审批流程实例
    • 黑名单
      • 获取黑名单列表
    • 合同公司
      • 合同公司列表
    • 审批角色
      • 获取审批角色分组列表
      • 创建审批角色分组
      • 更新审批角色分组
      • 删除审批角色分组
      • 获取审批角色列表
      • 获取审批角色详情
      • 创建审批角色
      • 更新审批角色
      • 删除审批角色
      • 添加角色成员
      • 更新角色成员
      • 批量移除角色成员
      • 获取审批管理员列表
    • 其他模块接口
      • 绩效模块开放接口
      • 培训模块开放接口
      • 招聘模块开放接口
  • 需客户开放接口
    • 事件消息通知
  1. 薪资档案

获取薪资包详情

生产环境
https://app91651.eapps.dingtalkcloud.com
生产环境
https://app91651.eapps.dingtalkcloud.com
POST
https://app91651.eapps.dingtalkcloud.com
/hades/open/api/v1/salaryPackage/detail
获取薪资包详情
scope:hades:salarypackage:detail

获取薪资包详情#

接口作用#

获取指定薪资包的详细配置信息,包括薪资标准、映射维度、薪级薪等配置、字段固定值和带宽配置、构成字段列表等完整信息。

接口信息#

属性值
URL/open/api/v1/salaryPackage/detail
MethodPOST
Content-Typeapplication/json
权限标识hades:salarypackage:detail

请求参数#

参数名类型必填说明
corpIdString是企业ID
packageIdString是薪资包ID
operatorEmpIdString是操作人员工ID(用于权限校验)
hrmDataMap<String, Object>是花名册数据,用于薪资包匹配
请求示例:
{
  "corpId": "corp_123456",
  "packageId": "pkg_001",
  "operatorEmpId": "emp_admin_001",
  "hrmData": {
    "department": "技术部",
    "position": "高级工程师"
  }
}

返回参数#

参数名类型说明
codeInteger状态码,0表示成功
msgString返回消息
dataSalaryPackageDetailResponse薪资包详情
SalaryPackageDetailResponse 字段说明:
参数名类型说明
packageIdString薪资包ID
packageNameString薪资包名称
relatedSalaryStandardBoolean是否关联薪资标准
salaryStandardSalaryStandard薪资标准信息(relatedSalaryStandard=true时有值)
enableMappingDimensionBoolean是否启用映射维度
mappingDimensionFieldList<String>映射维度字段(enableMappingDimension=true时有值)
enableSalaryLevelGradeBoolean是否启用薪级薪等
salaryLevelGradeString薪级薪等类型:salaryLevel-仅薪级,levelAndGrade-薪级和薪等
salaryLevelGradeChainList<SalaryLevelGradeChain>薪级薪等依赖关系链
fixedAndBandwidthConfigList<FixedAndBandwidthConfig>各字段固定值和带宽配置
salaryArchiveFieldsList<SalaryArchiveField>薪资包构成字段列表
SalaryStandard 字段说明:
参数名类型说明
salaryStandardIdString薪资标准ID
salaryStandardNameString薪资标准名称
statusInteger状态:0-停用,1-启用
SalaryLevelGradeChain 字段说明:
参数名类型说明
labelString薪级名称
valueString薪级值(同label)
childrenList<Children>对应的薪等选项列表
Children 字段说明:
参数名类型说明
labelString薪等名称
valueString薪等值(同label)
FixedAndBandwidthConfig 字段说明:
参数名类型说明
salaryGradeString薪等
salaryLevelString薪级
standardConfigList<StandardConfig>薪资标准配置列表
StandardConfig 字段说明:
参数名类型说明
salaryArchiveIdString薪资档案字段ID
fixedValueString固定值
upperLimitString带宽上限
lowerLimitString带宽下限
SalaryArchiveField 字段说明:
参数名类型说明
salaryArchiveFiledSalaryArchiveFiled薪资档案字段信息
maintenanceWayString维护方式:manual-手动录入,formula-公式
bandwidthControlWayInteger带宽管控方式:0-允许超限,1-强管控
probationRatioInteger试用期折算比例,单位%,有值时进行折算
formulaFormula公式配置(maintenanceWay=formula时有值)
controlStandardString薪资管控标准:fixedValue-固定值,bandwidth-带宽
SalaryArchiveFiled 字段说明:
参数名类型说明
salaryArchiveIdString薪资档案字段ID
salaryArchiveNameString薪资档案字段名称
valueTypeString数据类型:文本/数字/选项
statusInteger状态:0-停用,1-启用
Formula 字段说明:
参数名类型说明
decimalDigitInteger小数位数
decimalMethodString小数处理方式
originalFormulaTextString原始公式文本
返回示例:
{
  "code": 0,
  "msg": "success",
  "data": {
    "packageId": "pkg_001",
    "packageName": "技术岗位薪资包",
    "relatedSalaryStandard": true,
    "salaryStandard": {
      "salaryStandardId": "std_001",
      "salaryStandardName": "2024年度薪资标准",
      "status": 1
    },
    "enableMappingDimension": false,
    "mappingDimensionField": null,
    "enableSalaryLevelGrade": true,
    "salaryLevelGrade": "levelAndGrade",
    "salaryLevelGradeChain": [
      {
        "label": "P6",
        "value": "P6",
        "children": [
          {"label": "A", "value": "A"},
          {"label": "B", "value": "B"},
          {"label": "C", "value": "C"}
        ]
      },
      {
        "label": "P7",
        "value": "P7",
        "children": [
          {"label": "A", "value": "A"},
          {"label": "B", "value": "B"}
        ]
      }
    ],
    "fixedAndBandwidthConfig": [
      {
        "salaryGrade": "A",
        "salaryLevel": "P6",
        "standardConfig": [
          {
            "salaryArchiveId": "field_001",
            "fixedValue": "15000",
            "upperLimit": null,
            "lowerLimit": null
          }
        ]
      }
    ],
    "salaryArchiveFields": [
      {
        "salaryArchiveFiled": {
          "salaryArchiveId": "field_001",
          "salaryArchiveName": "基本工资",
          "valueType": "number",
          "status": 1
        },
        "maintenanceWay": "manual",
        "bandwidthControlWay": 1,
        "probationRatio": 80,
        "formula": null,
        "controlStandard": "fixedValue"
      }
    ]
  }
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数

Body 参数application/json

示例
{
  "corpId": "",
  "packageId": "",
  "operatorEmpId": "",
  "hrmData": {
    "employeeStatus":"formal", // 必填,涉及试用期打折相关
    "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"
      }
    }
  }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://app91651.eapps.dingtalkcloud.com/hades/open/api/v1/salaryPackage/detail' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "corpId": "",
  "packageId": "",
  "operatorEmpId": "",
  "hrmData": {
    "employeeStatus":"formal", // 必填,涉及试用期打折相关
    "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"
      }
    }
  }
}'

返回响应

🟢200获取薪资包详情-Example
application/json
Bodyapplication/json

示例
{
    "data": {
        "packageId": "", //薪资包id
        "packageName": "", //薪资包名称
        "relatedSalaryStandard": false, //是否关联薪资标准
        "salaryArchiveFields": [ //薪资包构成字段列表
            {
                "salaryArchiveFiled": { //薪资档案字段信息
                    "salaryArchiveId": "", //薪资档案字段id
                    "salaryArchiveName": "", //薪资档案字段名称
                    "valueType": "", //数据类型:文本/数字/选项
                    "status": 0 //状态: 0-停用 1-启用
                },
                "maintenanceWay": "", //维护方式:manual-手动录入 formula-公式
                "formula": { //公式配置,maintenanceWay=formula时有值
                    "decimalDigit": 0, //小数位数
                    "decimalMethod": "", //小数处理方式
                    "originalFormulaText": "" //原始公式文本
                }
            }
        ]
    },
    "success": false,
    "errorCode": "",
    "errorMsg": "",
    "rid": "" //traceId
}
修改于 2026-03-19 02:54:29
上一页
获取员工适用薪资包
下一页
创建核算组
Built with