智能薪酬开放平台接口文档
一、简介
账号
联系对接人进入钉钉群查看账号获取方式。
验证身份
在请求头里附带2个参数
名称
描述
app-id
应用id
signature
请求加密签名
﻿
签名算法
官方提供Java、C#、PHP、Python调用示例，其他语言可参照示例自己编写，也可以找我们技术同学进行支持。
调用示例
参照官方demo
二、接口明细
1. 查询公司部门ID
接口说明
调用该接口可以获取企业所有部门的部门ID。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/dept/list 
方式：POST
请求入参：无
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
msg
错误描述
﻿
﻿
detail
描述详情
﻿
﻿
data
部门信息
数组
[{"name": "测试企业","value": "1","ext": "null"},{"name": "研发部","value": "93639012","ext": "-1"},{"name": "设计部","value": "93639055","ext": "-1"}]
ㄴ name
部门名
字符串
"研发部"
ㄴ value
部门id
字符串
"93639012
"
ㄴ ext
父部门id
字符串
"-1"
示例：
22
{
    "code": "200",
    "data": [
        {
            "name": "测试企业",
            "value": "-1",
            "ext": "null"
        },
        {
            "name": "研发部",
            "value": "93639012",
            "ext": "-1"
        },
        {
            "name": "设计部",
            "value": "93639055",
            "ext": "-1"
        }
    ],
    "success": true
}
2. 按部门导出当月薪资报表
接口说明
调用该接口可以根据部门id导出当月薪资报表。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/statistics/dept
方式：POST
请求入参
参数
描述
备注
示例
statisticsMonth
薪资月
必填，格式为"yyyy-MM"
"2019-02"
deptId
部门id
必填，数值
93639012
示例：
5
{
  "statisticsMonth": "2019-02",
  "deptId": 93639012
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
msg
错误描述
﻿
﻿
detail
描述详情
﻿
﻿
data
部门信息
数组
[{"name": "实发工资","value": "0"},{"name": "绩效奖金","value": "0"},{"name": "企业社保","value": "0"},{"name": "固定工资","value": "0"},{"name": "企业公积金","value": "0"},{"name": "总人数","value": "6"},{"name": "业绩提成","value": "0"},{"name": "人力成本","value": "0"},{"name": "加班工资","value": "0"},{"name": "应发工资","value": "0"}]
ㄴ name
报表项
字符串
"实发工资"
ㄴ value
报表数据
字符串
"500000"
示例：
47
{
    "code": "200",
    "data": [
        {
            "name": "实发工资",
            "value": "0"
        },
        {
            "name": "绩效奖金",
            "value": "0"
        },
        {
            "name": "企业社保",
            "value": "0"
        },
        {
            "name": "固定工资",
            "value": "0"
        },
        {
            "name": "企业公积金",
            "value": "0"
        },
        {
            "name": "总人数",
            "value": "6"
        },
        {
            "name": "业绩提成",
            "value": "0"
        },
        {
            "name": "人力成本",
            "value": "0"
        },
        {
            "name": "加班工资",
            "value": "0"
        },
        {
            "name": "应发工资",
            "value": "0"
        }
    ],
    "success": true
}
3. 导入浮动薪资项
接口说明
调用该接口可以导入企业该月薪资组浮动薪资项
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/floatData/import
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupName
薪资组名
必填
﻿
calBizId
薪资计算月份id
必填
"201901M"
header
浮动薪资表头
必填，数组，必须包含匹配项
["姓名", "浮动工资", "迟到天数", "社保扣除"]
data
浮动薪资数据
必填，数组，长度不大于3000
[["张三", "8000", "3", "1000"], ["李四", "8000", "3", "1000"], ["王五", "8000", "3", "1000"]]
matchItem
匹配项
必填，字符串，取自header
"姓名"
matchType
匹配类型
必填，按姓名/userId/工号匹配（name/userId/jobNumber）
"name"
示例：
9
{
	"salaryGroupName": "研发部",
	"calBizId": "201901M",
  "header": ["姓名", "浮动工资", "迟到天数", "社保扣除"],
  "data": [["张三", "8000", "3", "1000"], ["李四", "8000", "3", "1000"], ["王五", "8000", "3", "1000"]],
  "matchItem": "姓名",
  "matchType": "name"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
浮动薪资项
数组
["浮动工资","个人社保","备注"]
示例：
5
{
	"code": "200",
	"success": true
}
﻿
4. 查询薪资组浮动薪资项
接口说明
调用该接口可以获取企业该月薪资组浮动薪资项
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/floatData/items
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupName
薪资组名
必填
﻿
calBizId
薪资计算月份id
必填
"201901M"
示例：
5
{
	"salaryGroupName": "研发部",
	"calBizId": "201901M"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
浮动薪资项
数组
["浮动工资","个人社保","备注"]
示例：
6
{
	"code": "200",
	"data": ["浮动工资","个人社保","备注"],
	"success": true
}
﻿
5. 获取员工工资条数据
接口说明
调用该接口可以获取企业该月发送的员工工资条数据，每次最多返回200个员工数据。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/bill/list
方式：POST
请求入参
参数
描述
备注
示例
billMonth
工资条月份
必填，"yyyy-MM"
"2018-09"
page
页数
必填，分页，从1开始
1
示例：
5
{
  "billMonth": "2018-12",
  "page": 1
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
hasMore
是否还有数据
﻿
﻿
true/false
data
返回结果
数组
[
  {
    "userId": "15382746423383",
    "userName": "张三",
    "dataList": [
      {
        "name": "实发工资",
        "value": "8000"
      },
      {
        "name": "绩效奖金",
        "value": "1000"
      }
    ]
  },
  {
    "userId": "15382742164383",
    "userName": "李四",
    "dataList": [
      {
        "name": "实发工资",
        "value": "8000"
      },
      {
        "name": "绩效奖金",
        "value": "1000"
      }
    ]
  }
]
ㄴ userId
员工ID
﻿
15369783916424133
ㄴ userName
员工姓名
﻿
张三
ㄴ dataList
工资条数据
数组
[{ "name": "实发工资", "value": "8000" },{ "name": "绩效奖金", "value": "1000" }]
ㄴ name
工资条标题
﻿
实发工资
ㄴvalue
工资条数据
﻿
8000
示例：
24
{
  "code": 200,
  "success": true,
  "hasMore": true,
  "data": [
    {
      "userId": "15369783916424133",
      "userName": "张三",
      "dataList": [
        { "name": "实发工资", "value": "8000" },
        { "name": "绩效奖金", "value": "1000" }
      ]
    },
    {
      "userId": "15369783916424123",
      "userName": "李四",
      "dataList": [
        { "name": "实发工资", "value": "8000" },
        { "name": "绩效奖金", "value": "1000" }
      ]
    }
  ]
}
6. 发送工资条
接口说明
调用该接口可以发送上传的工资条。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/bill/send
方式：POST
请求入参
参数
描述
备注
示例
userId
管理员userId
选填，为空则自动获取一个具有工资条权限的子管理员userId
﻿
billFormId
工资条Id
必填，导入工资条接口返回值
﻿
示例：
5
{
  "userId": "15369783916424177",
  "billFormId": "55116e60bb5b4044a0f815ed4e1599c6"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
msg
错误描述
﻿
﻿
detail
描述详情
﻿
﻿
示例：
5
{
  "code": 200,
  "success": true
}
7
{
  "success": false,
  "code": 30901,
  "msg": "工资条参数设置有误",
  "detail": "【userId】无工资条权限"
}
7. 导入工资条数据
接口说明
调用该接口可以批量上传工资条数据，上传完数据后薪资管理员只需要在发送工资条页面进行设置即可进行发送。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/bill/import
方式：POST
请求入参
参数
描述
备注
示例
userId
管理员userId
选填，为空则自动获取一个具有工资条权限的子管理员userId
﻿
billFormName
工资条标题
必填
"2018年11月工资"
billMonth
工资条月份
必填，yyyy-MM
"2018-11"
header
工资条表头
必填，数组，必须包含姓名、实发工资和匹配项
["姓名", "实发工资", "基本工资", "奖金", "绩效"]
data
工资条数据
必填，数组，长度不大于3000
[["张三", "8000", "7000", "1000", ""], ["李四", "8000", "7000", "1000", ""], ["王五", "8000", "7000", "1000", "200"]]
nameItem
姓名项
选填，取自header，默认值"姓名"
"姓名"
matchItem
匹配项
必填，字符串，取自header
"姓名"
paySalaryItem
实发工资项
必填，字符串，取自header
"实发工资"
matchType
匹配类型
必填，按姓名/userId/工号匹配（name/userId/jobNumber）
"name"
excludeItems
不显示的薪资项
选填，取自header
["姓名", "基本工资"]
hideEmptyItems
为空自动隐藏的薪资项
选填，取自header
["奖金", "绩效"]
pendMove
阅后即焚时间
选填，格式为“数字+d/h/m”，d/h/m对应天/小时/分钟
10h
示例：
15
{
  "userId": "15369783916424177",
  "billFormName": "2018年10月工资",
  "billMonth": "2018-10",
  "header": ["姓名", "实发工资", "基本工资", "奖金", "绩效"],
  "data": [["张三", "8000", "7000", "1000", ""], ["李四", "8000", "7000", "1000", ""], ["王五", "8000", "7000", "1000", "200"]],
  "matchItem": "姓名",
  "nameItem": "姓名",
  "paySalaryItem": "实发工资",
  "matchType": "name",
  "excludeItems": ["姓名", "基本工资"],
  "hideEmptyItems": ["奖金", "绩效"],
  "pendMove": "10h"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
导入工资条生成的billFormId
发送工资条入参
"55116e60bb5b4044a0f815ed4e1599c6"
msg
错误描述
﻿
﻿
detail
描述详情
﻿
﻿
示例：
1.code为200且detail为空，表示全部导入成功`json{"code": 200,"success": true,"data": "55116e60bb5b4044a0f815ed4e1599c6""detail": "花名册在职员工中无【姓名】为xxx的员工,花名册在职员工中无【姓名】为yyy的员工"}`﻿
2.导入报错`json{"success": false,"code": 30902,"msg": "导入工资条人次超过限制","detail": "工资条单次只允许导入3000条"}`﻿
8. 查询薪资组薪资数据
接口说明
调用该接口可以获取企业该月薪资组里的所有薪资数据
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/v2/salary/groupData/list 
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupName
薪资组名
必填
﻿
calBizId
薪资计算月份id
必填
"201901M"
page
页数
必填，从1开始
﻿
示例：
6
{
	"salaryGroupName": "研发部",
	"calBizId": "201901M",
  "page": 1
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
hasMore
是否还有数据
true:下一页还有数据false: 数据获取完毕
true/false
status
薪资组状态
未计算：init
未审批：noApproval
审批中：approving
审批通过：agree
审批拒绝：refuse
审批撤销: terminate
"status":"noApproval"
data
返回结果
数组
[
  {
    "userId": "15382746423383",
    "userName": "张三",
    "dataList": [
      {
        "name": "基本工资",
        "value": "8000"
      },
      {
        "name": "实发工资",
        "value": "1000"
      }
    ]
  },
  {
    "userId": "15382742164383",
    "userName": "李四",
    "dataList": [
      {
        "name": "基本工资",
        "value": "8000"
      },
      {
        "name": "实发工资",
        "value": "1000"
      }
    ]
  }
]
ㄴ userId
员工ID
﻿
15369783916424133
ㄴ userName
员工姓名
﻿
张三
ㄴ dataList
薪资数据
数组
[ { "name": "基本工资", "value": "8000" },{ "name": "实发工资", "value": "1000" } ]
ㄴ name
薪资项名称
﻿
基本工资
ㄴvalue
薪资项数据
﻿
8000
示例：
25
{
  "code": 200,
  "success": true,
  "hasMore": true,
  "status":"noApproval",
  "data": [
    {
      "userId": "15369783916424133",
      "userName": "张三",
      "dataList": [
        { "name": "基本工资", "value": "8000" },
        { "name": "实发工资", "value": "1000" }
      ]
    },
    {
      "userId": "15369783916424123",
      "userName": "李四",
      "dataList": [
        { "name": "基本工资", "value": "8000" },
        { "name": "实发工资", "value": "1000" }
      ]
    }
  ]
}
9.查询所有薪资组列表
接口说明
调用该接口可以获取企业所有的薪资组列表
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/v2/salary/group/list 
方式：POST
请求入参
无
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
数组
["salaryGroupId":"b3bcc3bcbe104a998196ed1624a1691a","salaryGroupName":"薪资组1","groupStatus":"启用"},{"salaryGroupId":"ce0a927f19414659b3b1a9cd688e2363","salaryGroupName":"薪资组2","groupStatus":"停用" } ]
ㄴsalaryGroupId
薪资组ID
﻿
ce0a927f19414659b3b1a9cd688e2363
ㄴsalaryGroupName
薪资组名称
﻿
薪资组1
ㄴgroupStatus
薪资组状态
启用、停用
启用
示例：
17
{
	"code":"200",
	"data":[
		{
			"groupStatus":"启用",
			"salaryGroupId":"7d01469b3a684aeaa5e645fe6c3bae8c",
			"salaryGroupName":"薪资组1"
		},
		{
			"groupStatus":"停用",
			"salaryGroupId":"5cb1245eaf40404287908306b1e5f7cf",
			"salaryGroupName":"薪资组2"
		}
	],
	"success":true
}
﻿
10. 获取薪资档案数据
接口说明
调用该接口可以分页获取企业的薪资档案数据
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/v2/salary/base/list 
方式：POST
请求入参
参数
描述
备注
示例
onJob
是否在职
必填。0:全部，1:在职，2:离职
1
settingType
是否已定薪
非必填。-1:全部, 1:已定薪, 0:未定薪
﻿
page
页数
必填，从1开始
﻿
pageSize
每页数据
非必填，默认20
﻿
示例：
7
{
    "page":1,
    "pageSize":1,
    "onJob":1,
    "settingType":1
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
﻿
{
  "data": [
    {
      "dataMap": {
"BASEPAY6a28ed3913174528bea8c270b137b13a": "20000"
      },
      "deptName": "销售一组",
      "employeeStatus": 2,
      "employeeType": 1,
      "entryDate": "2020-01-01",
      "lastAdjustDate": "2021-04-14",
      "userId": "manager9131",
      "userName": "静静"
    }
  ],
  "headerMapList": [
    {
      "basePayId": "basePayCostCenterId",
      "basePayName": "成本中心",
      "valueType": "选项"
    },
    {
      "basePayId": "BASEPAY6a28ed3913174528bea8c270b137b13a",
      "basePayName": "基本工资2",
      "valueType": "数字"
    },
    {
      "basePayId": "BASEPAY3c9a4bc849284c93945553e03b4bba0f",
      "basePayName": "欧阳哒哒",
      "optionContent": [
        "啊",
        "哦",
        "噫",
        "哼",
        "哈"
      ],
      "valueType": "文本选项"
    }
  ],
  "totalCount": 45
}
ㄴ totalCount
总的数据条数
﻿
100
ㄴ headerMapList
表头映射列表
数组
﻿
ㄴㄴ basePayId
薪资项ID
﻿
BASEPAY6a28ed3913174528bea8c270b137b13a
ㄴㄴ basePayName
薪资项名称
﻿
基本工资2
ㄴㄴ valueType
薪资项类型
取值：数字、文本、选项、数字选项、文本选项
文本选项
ㄴ data
薪资档案数据列表
数组
﻿
ㄴㄴ userId
员工UserID
﻿
manager9131
ㄴㄴ userName
姓名
﻿
静静
ㄴㄴ deptName
部门名称
﻿
销售一组
ㄴㄴ employeeStatus
员工状态
-1：无状态，1：待入职，2：使用，3：正式，4：已离职，5：待离职，10：在职
3
ㄴㄴ employeeType
员工类型
0：无类型，1：全职，2：兼职，3：实习，4：劳务派遣，5：退休返聘，6：劳务外包
1
ㄴㄴ entryDate
入职日期
﻿
2020-01-01
ㄴㄴ lastAdjustDate
最近调薪日
﻿
2021-04-14
示例：
46
{
    "code": "200",
    "data": {
        "data": [
            {
                "dataMap": {
                    "BASEPAY6a28ed3913174528bea8c270b137b13a": "20000"
                },
                "deptName": "销售一组",
                "employeeStatus": 2,
                "employeeType": 1,
                "entryDate": "2020-01-01",
                "lastAdjustDate": "2021-04-14",
                "userId": "manager9131",
                "userName": "静静"
            }
        ],
        "headerMapList": [
            {
                "basePayId": "basePayCostCenterId",
                "basePayName": "成本中心",
                "valueType": "选项"
            },
            {
                "basePayId": "BASEPAY6a28ed3913174528bea8c270b137b13a",
                "basePayName": "基本工资2",
                "valueType": "数字"
            },
            {
                "basePayId": "BASEPAY3c9a4bc849284c93945553e03b4bba0f",
                "basePayName": "欧阳哒哒",
                "optionContent": [
                    "啊",
                    "哦",
                    "噫",
                    "哼",
                    "哈"
                ],
                "valueType": "文本选项"
            }
        ],
        "totalCount": 45
    },
    "success": true
}
11. 创建薪资档案字段
接口说明
调用该接口可以创建薪资档案字段
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/basepay/field/create 
方式：POST
请求入参
参数
描述
备注
示例
config
字段配置
﻿
[
  {
    "basePayName ": "测试字段 ",
    "type": "文本",
    "optionContent": ""
  },
  {
    "basePayName ": "测试字段 ",
    "type": "文本选项",
    "optionContent": [
      "选项一",
      "选项二",
      "选项三"
    ]
  }
]
ㄴbasePayName
字段名称
必填。字段名称
﻿
ㄴtype
字段类型
必填。数字、文本、选项、数字选项、文本选项
文本
ㄴoptionContent
选项内容
非必填。如果type选择了文本选项或者数字选项，该字段需要上传选项内容
﻿
示例：
18
{
	"config": [{
			"basePayName ": "测试字段 ",
			"type": "文本",
			"optionContent": ""
		},
		{
			"basePayName ": "测试字段 ",
			"type": "文本选项",
			"optionContent": [
				"选项一",
				"选项二",
				"选项三"
			]
		}
	]
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
示例：
5
{
    "code": "200",
    "success": true
}
12. 获取薪资档案字段
接口说明
调用该接口可以获取薪资档案字段列表
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/basepay/field/list 
方式：POST
请求入参
无
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
字段列表
返回值是一个map，key是薪资档案字段，value是字段名称
﻿
示例：
15
{
	"code":"200",
	"data":{
		"BASEPAY512029986a0d421493fb26df2c3cca6f":"erqingtest",
		"BASEPAY06a7431017ac48e8b13def7154b7f890":"erqingtest6663",
		"BASEPAY4866c31a8ff4455e8c702282016fbddc":"02071",
		"BASEPAYed47c6c7d78c4ef0b9c75b096cf3e248":"02072接口",
		"BASEPAY006e9540ca5e48a08fc0147fae308166":"02073文本选项",
		"BASEPAY033025c6c0a7418ca63158e38b51cefd":"02074文本选项接口",
		"BASEPAY824c5dfd467d4f0cbb95f130753d156a":"02075文本选项接口",
		"BASEPAYde7955e0499c4a509d359eb486084b6a":"021011接口"
	},
	"success":true
}
13. 薪资档案定薪/调薪/编辑
接口说明
调用该接口可以进行定薪、调薪、调薪历史编辑
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/basepay/data/upload 
方式：POST
请求入参
参数
描述
备注
示例
userId
定薪的员工钉钉userId
必填。
﻿
effectiveDate
定薪/调薪生效日期
必填
2022-01-10
remark
备注
非必填
﻿
headerWithValue
定薪/调薪数据，值为map，key表示字段ID，value表示值
必填
{"BASEPAYde7955e0499c4a509d359eb486084b6a","2999"}
editorOrChangeType
操作类型：空代表定薪，1代表调薪，2代表编辑
非必填
﻿
ㄴoptionContent
选项内容
非必填。如果type选择了文本选项或者数字选项，该字段需要上传选项内容
﻿
示例：
10
{
	"userId": "16279824982747793",
	"effectiveDate": "2021-08-22",
	"remark": "xxx",
	"headerWithValue": {
		"BASEPAYde7955e0499c4a509d359eb486084b6a": "9999"
	},
	"editorOrChangeType": 1
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
示例：
5
{
    "code": "200",
    "success": true
}
注意：
编辑薪资档案时，如果传入的生效日期没有数据，则会报错：该生效日期【2021-08-11】无生效的薪资档案数据
7
{
	"code":"30001",
	"detail":"该生效日期【2021-08-11】无生效的薪资档案数据",
	"msg":"参数错误",
	"success":false
}
14. 获取人力成本字段
接口说明
调用该接口可以分页获取企业的人力成本字段
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/statistic/field/list 
方式：POST
请求入参 - 无
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
﻿
﻿
ㄴ itemId
成本项字段id
﻿
totalCost
ㄴ itemName
成本项名称
﻿
人力成本
ㄴitemDesc
成本项描述
﻿
公司所承担的全部员工薪资成本，一般包含员工应发工资加社保公积金企业部分
ㄴvalueType
成本项类型 取值 int或string
﻿
int
示例：
98
{
	"code": "200",
	"data": [{
			"itemDesc": "公司所承担的全部员工薪资成本，一般包含员工应发工资加社保公积金企业部分",
			"itemId": "totalCost",
			"itemName": "人力成本",
			"valueType": "int"
		},
		{
			"itemDesc": "员工工资合计，包含固定工资、奖金、社保公积金个人部分等项目",
			"itemId": "totalGrossPay",
			"itemName": "应发工资",
			"valueType": "int"
		},
		{
			"itemDesc": "员工实际到手工资",
			"itemId": "totalNetPay",
			"itemName": "实发工资",
			"valueType": "int"
		},
		{
			"itemDesc": "",
			"itemId": "totalFixedPay",
			"itemName": "固定工资",
			"valueType": "int"
		},
		{
			"itemDesc": "业务部门根据公司指标完成情况获得的提成",
			"itemId": "totalCommission",
			"itemName": "业绩提成",
			"valueType": "int"
		},
		{
			"itemId": "STAT8277def3a800563341a77e8c64040ce0",
			"itemName": "业绩奖金",
			"valueType": "int"
		},
		{
			"itemId": "totalSocialInsurance",
			"itemName": "企业社保",
			"valueType": "int"
		},
		{
			"itemId": "totalHousingRefund",
			"itemName": "企业公积金",
			"valueType": "int"
		},
		{
			"itemId": "STATef05059cbd6489995cc3e7b1798af436",
			"itemName": "个人社保",
			"valueType": "int"
		},
		{
			"itemId": "STAT5939fd48e19813d8f8a0fa0b17748204",
			"itemName": "个人公积金",
			"valueType": "int"
		},
		{
			"itemId": "STATa50cf476ec8ecf53be32a36e823f5e99",
			"itemName": "人力成本2",
			"valueType": "int"
		},
		{
			"itemDesc": "222",
			"itemId": "STATbb4b2059d279bde3ce433e85aec54aeb",
			"itemName": "人力成本3人力成本3",
			"valueType": "int"
		},
		{
			"itemId": "STATe807f1fcf82d132f9bb018ca6738a19f",
			"itemName": "1234567890",
			"valueType": "int"
		},
		{
			"itemId": "STATff355b66871bd317b2f571017b4b6664",
			"itemName": "季松测试",
			"valueType": "string"
		},
		{
			"itemDesc": "实时",
			"itemId": "STAT76e3ca3d5a232328f64169290d37bb74",
			"itemName": "欧特克测试文本",
			"valueType": "string"
		},
		{
			"itemId": "STATcb2730e2131682230be9e503f220bff0",
			"itemName": "稀饭测试",
			"valueType": "string"
		},
		{
			"itemId": "STATb84bbe9e63ef2d425ea40ba263fac89d",
			"itemName": "稀饭测试2",
			"valueType": "int"
		}
	],
	"success": true
}
15. 获取人力成本报表
接口说明
调用该接口可以分页获取企业的人力成本报表数据
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/statistic/report/data 
方式：POST
请求入参
参数
描述
备注
示例
calBizId
薪资月
非必填，为空时默认为当前月份
202109M
示例：
4
{
	"calBizId":"202109M"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
﻿
﻿
ㄴ calBizId
薪资月
﻿
202109M
ㄴ sumStatisticsData
人力成本报表数据
﻿
﻿
ㄴㄴ  itemId
成本项字段id
﻿
totalCost
ㄴㄴ  itemName
成本项名称
﻿
人力成本
ㄴㄴ  itemDesc
成本项描述
﻿
公司所承担的全部员工薪资成本，一般包含员工应发工资加社保公积金企业部分
ㄴㄴ  unit
单位
﻿
﻿
ㄴㄴ  sValue
值
﻿
13,424.00
ㄴㄴ  value
值
﻿
13424
示例：
83
{
	"code":"200",
	"data":{
		"calBizId":"202109M",
		"sumStatisticsData":[
			{
				"itemDesc":"",
				"itemId":"totalPeople",
				"itemName":"算薪人数",
				"sValue":"83",
				"unit":"",
				"value":83
			},
			{
				"itemDesc":"公司所承担的全部员工薪资成本，一般包含员工应发工资加社保公积金企业部分",
				"itemId":"totalCost",
				"itemName":"人力成本",
				"sValue":"13,424.00",
				"value":13424
			},
			{
				"itemDesc":"员工工资合计，包含固定工资、奖金、社保公积金个人部分等项目",
				"itemId":"totalGrossPay",
				"itemName":"应发工资",
				"sValue":"13,424.00",
				"value":13424
			},
			{
				"itemDesc":"员工实际到手工资",
				"itemId":"totalNetPay",
				"itemName":"实发工资",
				"sValue":"0.00",
				"value":0.00
			},
			{
				"itemDesc":"",
				"itemId":"totalFixedPay",
				"itemName":"固定工资",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemDesc":"业务部门根据公司指标完成情况获得的提成",
				"itemId":"totalCommission",
				"itemName":"业绩提成",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"STAT8277def3a800563341a77e8c64040ce0",
				"itemName":"业绩奖金",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"totalSocialInsurance",
				"itemName":"企业社保",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"totalHousingRefund",
				"itemName":"企业公积金",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"STATef05059cbd6489995cc3e7b1798af436",
				"itemName":"个人社保",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"STAT5939fd48e19813d8f8a0fa0b17748204",
				"itemName":"个人公积金",
				"sValue":"0.00",
				"value":0
			}
		]
	},
	"success":true
}
16. 按薪资组获取人力成本报表
接口说明
调用该接口可以获取指定薪资组、指定月份的人力成本统计报表数据
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/statistic/report/groupData
方式：POST
请求入参
参数
描述
备注
示例
calBizId
薪资月
非必填，为空时默认为当前月份
202109M
salaryGroupName
薪资组名
必填
销售部薪资组
示例：
5
{
	"calBizId":"202109M",
    "salaryGroupName": "销售部薪资组"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
﻿
﻿
ㄴ calBizId
薪资月
﻿
202109M
ㄴ sumStatisticsData
人力成本报表数据
﻿
﻿
ㄴㄴ  itemId
成本项字段id
﻿
totalCost
ㄴㄴ  itemName
成本项名称
﻿
人力成本
ㄴㄴ  itemDesc
成本项描述
﻿
公司所承担的全部员工薪资成本，一般包含员工应发工资加社保公积金企业部分
ㄴㄴ  unit
单位
﻿
﻿
ㄴㄴ  sValue
值
﻿
13,424.00
ㄴㄴ  value
值
﻿
13424
示例：
83
{
	"code":"200",
	"data":{
		"calBizId":"202109M",
		"sumStatisticsData":[
			{
				"itemDesc":"",
				"itemId":"totalPeople",
				"itemName":"算薪人数",
				"sValue":"83",
				"unit":"",
				"value":83
			},
			{
				"itemDesc":"公司所承担的全部员工薪资成本，一般包含员工应发工资加社保公积金企业部分",
				"itemId":"totalCost",
				"itemName":"人力成本",
				"sValue":"13,424.00",
				"value":13424
			},
			{
				"itemDesc":"员工工资合计，包含固定工资、奖金、社保公积金个人部分等项目",
				"itemId":"totalGrossPay",
				"itemName":"应发工资",
				"sValue":"13,424.00",
				"value":13424
			},
			{
				"itemDesc":"员工实际到手工资",
				"itemId":"totalNetPay",
				"itemName":"实发工资",
				"sValue":"0.00",
				"value":0.00
			},
			{
				"itemDesc":"",
				"itemId":"totalFixedPay",
				"itemName":"固定工资",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemDesc":"业务部门根据公司指标完成情况获得的提成",
				"itemId":"totalCommission",
				"itemName":"业绩提成",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"STAT8277def3a800563341a77e8c64040ce0",
				"itemName":"业绩奖金",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"totalSocialInsurance",
				"itemName":"企业社保",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"totalHousingRefund",
				"itemName":"企业公积金",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"STATef05059cbd6489995cc3e7b1798af436",
				"itemName":"个人社保",
				"sValue":"0.00",
				"value":0
			},
			{
				"itemId":"STAT5939fd48e19813d8f8a0fa0b17748204",
				"itemName":"个人公积金",
				"sValue":"0.00",
				"value":0
			}
		]
	},
	"success":true
}
17. 获取单个员工薪资档案数据
接口说明
调用该接口可以通过userId和activeTime(档案生效时间)获取企业单个员工的薪资档案数据
请求详情
https://salary.eapps.dingtalkcloud.com/oapi/salary/basepay/data/list/byuserid
方式：POST
请求入参
参数
描述
备注
示例
userId
用户ID
必填
1
activeTime
档案生效时间
非必填。不填的话取最近生效时间的记录
﻿
示例：
5
{
    "userId":"2509098098",
    "activeTime":"2022-07-01"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
﻿
示例如下
ㄴuserId
员工UserID
﻿
manager9131
ㄴuserName
姓名
﻿
静静
ㄴdeptName
部门名称
﻿
销售一组
ㄴemployeeStatus
员工状态
-1：无状态，1：待入职，2：使用，3：正式，4：已离职，5：待离职，10：在职
3
ㄴemployeeType
员工类型
0：无类型，1：全职，2：兼职，3：实习，4：劳务派遣，5：退休返聘，6：劳务外包
1
ㄴentryDate
入职日期
﻿
2020-01-01
ㄴ lastAdjustDate
最近调薪日
﻿
2021-04-14
ㄴ xxx
薪资档案字段名称
所有薪资档案字段都会平铺列出来
工龄标准、交通补贴、岗位补贴，等等
示例：
23
{
	"code":"200",
	"data":{
		"deptName":"新零售方案演示",
		"entryDate":"2018-09-02",
		"deptId":-1,
		"lastAdjustDate":"2021-08-18",
		"交通补贴":"888",
		"userName":"张二青",
		"工龄标准":"988",
		"userId":"manager7188",
		"employeeStatus":3,
		"个人社保":"666",
		"固定工资":"9999",
		"employeeType":1,
		"岗位补贴":"888",
		"通讯补贴":"888",
		"午餐补贴":"888",
		"基本工资":"600033"
	},
	"success":true
}
18. 获取薪资组明细数据
接口说明
调用该接口可以获取薪资组明细数据，该接口和接口8的区别在于返回更多信息，包括薪资组的状态，薪资月起始和结束日期等等。
请求详情
https://salary.eapps.dingtalkcloud.com/oapi/salary/group/data/list
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupName
薪资组名称
必填
综合管理部
calBizId
薪资月
必填，格式必须是“年月M”，参考示例
202207M
page
分页参数
必填，必须是正整数
1
示例：
6
{
    "salaryGroupName": "综合管理部",
    "calBizId": "202207M",
    "page": 1,
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
﻿
示例如下
ㄴstatus
薪资组状态
init：初始化，doing：计算中，fail：计算失败，noApproval：未审批，approving：审批中，agree：审批通过，refuse：审批拒绝
init/doing/fail/noApproval/approving/agree/refuse
ㄴcalStatus
薪资组计算状态
init: 初始化doing：计算中，fail：计算失败，done：计算完成
done
ㄴcalVersion
当前计算版本号
﻿
1
ㄴhasMore
是否有下一页数据
﻿
true/false
ㄴstartDate
算薪起始日期
﻿
2022-03-01
ㄴendDate
算薪结束日期
﻿
2022-03-31
ㄴdata
薪资明细数据
list
[]
ㄴㄴuserId
钉钉userId
﻿
﻿
ㄴㄴuserName
钉钉userName
﻿
﻿
ㄴㄴdataList
薪资项相关明细数据
list
[]
ㄴㄴㄴname
薪资项名称
﻿
﻿
ㄴㄴㄴvalue
薪资项值
﻿
﻿
示例：
140
{
	"code": "200",
	"success": true,
	"data": {
		"data": [{
				"dataList": [{
						"name": "岗位补贴",
						"value": "0"
					},
					{
						"name": "姓名",
						"value": "稀饭"
					},
					{
						"name": "实出勤天数",
						"value": "0"
					},
					{
						"name": "部门",
						"value": "高浪报表测试部门"
					},
					{
						"name": "应出勤天数",
						"value": "0"
					},
					{
						"name": "职级（老）",
						"value": "高级"
					},
					{
						"name": "职级新",
						"value": "高级"
					},
					{
						"name": "职位",
						"value": "老板"
					},
					{
						"name": "职位（老）",
						"value": "老板"
					},
					{
						"name": "职位新",
						"value": "老板"
					},
					{
						"name": "职务新",
						"value": "职务2"
					},
					{
						"name": "病假",
						"value": "0"
					},
					{
						"name": "基本工资",
						"value": "1111.00"
					},
					{
						"name": "本期专项扣除",
						"value": "333.00"
					}
				],
				"userId": "16179357830115895",
				"userName": "稀饭"
			},
			{
				"dataList": [{
						"name": "岗位补贴",
						"value": "0"
					},
					{
						"name": "姓名",
						"value": "张二青"
					},
					{
						"name": "实出勤天数",
						"value": "0"
					},
					{
						"name": "部门",
						"value": "新零售方案演示"
					},
					{
						"name": "应出勤天数",
						"value": "0"
					},
					{
						"name": "职级（老）",
						"value": "中级"
					},
					{
						"name": "职级新",
						"value": "中级"
					},
					{
						"name": "职位",
						"value": "店员"
					},
					{
						"name": "职位（老）",
						"value": "店员"
					},
					{
						"name": "职位新",
						"value": "店员"
					},
					{
						"name": "职务新",
						"value": "职务4"
					},
					{
						"name": "工号",
						"value": "016"
					},
					{
						"name": "病假",
						"value": "0"
					},
					{
						"name": "基本工资",
						"value": "1111.00"
					},
					{
						"name": "本期专项扣除",
						"value": "333.00"
					}
				],
				"userId": "manager7188",
				"userName": "张二青"
			}
		],
		"endDate": "2022-03-31",
		"hasMore": false,
		"startDate": "2022-03-01",
		"status": "agree",
        "calStatus": "done",
        "calVersion": 1
	}
}
19. 查询薪资组浮动薪资项（新）
接口说明
调用该接口可以获取企业该月薪资组浮动薪资项，该接口和接口4的区别在于返回值新增了薪资组的基本信息，如算薪开始日期和结束日期。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/float/items/list
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupName
薪资组名
必填
﻿
calBizId
薪资计算月份id
必填
"201901M"
示例：
5
{
	"salaryGroupName": "研发部",
	"calBizId": "201901M"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
﻿
﻿
﻿
ㄴdata
浮动薪资项
数组
["浮动工资","个人社保","备注"]
ㄴstartDate
算薪开始日期
﻿
﻿
ㄴendDate
算薪结束日期
﻿
﻿
示例：
16
{
	"code":"200",
	"data":{
		"data":[
			"岗位补贴",
			"病假",
			"应出勤天数",
			"实出勤天数",
			"备注"
		],
		"endDate":"2022-10-31",
		"startDate":"2022-10-01"
	},
	"success":true
}
20. 查询所有启用的薪资组（2022年12月新增）
接口说明
调用该接口可以获取企业所有启用的薪资组，注意：这里没有区分薪资组权限。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/list
方式：POST
请求入参
无
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
﻿
﻿
﻿
ㄴdata
薪资组列表
数组
﻿
ㄴgroupId
薪资组id
﻿
﻿
ㄴgroupName
薪资组名称
﻿
﻿
示例：
19
{
	"code":"200",
	"data":[
		{
			"groupId":"d409644aca484782872533d32972bb83",
			"groupName":"测试薪资组1"
		},
		{
			"groupId":"cf299f4ca855468dafec75ff889ded18",
			"groupName":"测试薪资组2"
		},
		{
			"groupId":"680fd1637c064561b4342a204baf06cf",
			"groupName":"测试薪资组3"
		}
	],
	"success":true
}
21. 导入薪资组关联人员（2022年12月新增）
接口说明
调用该接口可以写入薪资组关联人员。
限制条件：   
   1.薪资组月份只能写入当前时间对应的薪资月，以及前3个薪资月，后一个薪资月的数据。譬如当前2022年12月，calBizId只能传入202212M（当前月）,202211M,202210M,202209M,202301M(后一个月)   
   2.单次传入的userIdList，最多5000条，每个薪资组每个薪资月总共只能写入5000条  
   3.userId必须已经存在钉钉通讯录。如果传入多个userid，其中某个userid在钉钉通讯录不存在，会直接返回失败。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/user/add
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupId
薪资组ID
必填
可以从api19中拿到薪资组id
calBizId
薪资计算月份id
必填
"201901M"
userIdList
人员id
必填
单次最多5000条
override
是否覆盖当前薪资组，薪资月的人员
非必填，默认false
如果为true，则会删除之前薪资组薪资月的人员，全部新增进去如果为false，历史数据会保留，通过新增当前加入的人员
7
{
	"calBizId": "202209M",
	"override": true,
	"salaryGroupId": "cf299f4ca855468dafec75ff889ded18",
	"userIdList": ["15915999008099699","556432343"]
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
﻿
﻿
﻿
ㄴdata
新增结果
﻿
﻿
ㄴerrorCount
失败人员数量
﻿
﻿
ㄴsuccessCount
成功新增人员数量
﻿
﻿
示例：
9
{
	"code":"200",
	"data":{
		"errorCount":0,
		"successCount":2
	},
	"success":true
}
22. 根据薪资组ID获取薪资项
接口说明
调用该接口可以根据薪资组ID，获取薪资组最新版本的薪资项信息。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/salaryItem
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupId
薪资组ID
必填
可以从api19中拿到薪资组id
4
{
	"salaryGroupId": "cf299f4ca855468dafec75ff889ded18"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
﻿
[
  {
    "itemId": "ITEM976a23291d0f44079db90ee1cf9bd4c2",
    "itemName": "基本工资"
  },
  {
    "itemId": "ITEM682394202ae447a28d9af8589f650e0a",
    "itemName": "岗位补贴"
  },
  {
    "itemId": "ITEMc745ad66940547a69d0337cfe793ad71",
    "itemName": "绩效奖金"
  }
]
ㄴitemId
薪资项ID
﻿
﻿
ㄴitemName
薪资项名称
﻿
﻿
示例：
19
{
	"code":"200",
	"data":[
		{
			"itemId":"ITEM976a23291d0f44079db90ee1cf9bd4c2",
			"itemName":"基本工资"
		},
		{
			"itemId":"ITEM682394202ae447a28d9af8589f650e0a",
			"itemName":"岗位补贴"
		},
		{
			"itemId":"ITEMc745ad66940547a69d0337cfe793ad71",
			"itemName":"绩效奖金"
		}
	],
	"success":true
}
23. 锁定薪资组算薪结果
接口说明
调用该接口可以根据薪资组ID、算薪月份，锁定已经算薪完成的薪资结果。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/lockCalResult
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupId
薪资组ID
必填
可以从api19中拿到薪资组id
calBizId
薪资计算月份id
必填
"201901M"
5
{
	"salaryGroupId": "cf299f4ca855468dafec75ff889ded18",
  "calBizId": "201901M"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
示例：
5
{
	"code":"200",
	"success":true
}
24. 解锁薪资组算薪结果
接口说明
调用该接口可以根据薪资组ID、算薪月份，解锁已经锁定的薪资结果。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/unLockCalResult
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupId
薪资组ID
必填
可以从api19中拿到薪资组id
calBizId
薪资计算月份id
必填
"201901M"
5
{
	"salaryGroupId": "cf299f4ca855468dafec75ff889ded18",
  "calBizId": "201901M"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
示例：
5
{
	"code":"200",
	"success":true
}
25、薪资组ID查询薪资组
接口说明
调用该接口可以根据薪资组ID，获取薪资组的薪资信息。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/data/byId/list
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupId
薪资组ID
必填
ANTCODE000_BHJCODE120
calBizId
薪资月
必填，格式必须是“年月M”，参考示例
202302M
page
分页参数
必填，必须是正整数
1
示例：
6
{
	"salaryGroupId": "ANTCODE000_BHJCODE120",
  "calBizId": "202302M",
    "page": 1
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
﻿
示例如下
ㄴstatus
薪资组状态
init：初始化，
doing：计算中，
fail：计算失败，
noApproval：未审批，
approving：审批中，
agree：审批通过，
refuse：审批拒绝
init/doing/fail/noApproval/approving/agree/refuse
ㄴcalStatus
薪资组计算状态
init: 初始化
doing：计算中
fail：计算失败
done：计算完成
done
ㄴcalVersion
当前计算版本号
﻿
1
ㄴhasMore
是否有下一页数据
﻿
true/false
ㄴstartDate
算薪起始日期
﻿
2023-03-01
ㄴendDate
算薪结束日期
﻿
2023-03-31
ㄴdata
薪资明细数据
list
[]
ㄴㄴuserId
钉钉userId
﻿
﻿
ㄴㄴuserName
钉钉userName
﻿
﻿
ㄴㄴdataList
薪资项相关明细数据
list
[]
ㄴㄴㄴname
薪资项名称
﻿
﻿
ㄴㄴㄴvalue
薪资项值
﻿
﻿
示例：
141
{
	"code": "200",
	"success": true,
	"data": {
		"data": [{
				"dataList": [{
						"name": "岗位补贴",
						"value": "0"
					},
					{
						"name": "姓名",
						"value": "稀饭"
					},
					{
						"name": "实出勤天数",
						"value": "0"
					},
					{
						"name": "部门",
						"value": "高浪报表测试部门"
					},
					{
						"name": "应出勤天数",
						"value": "0"
					},
					{
						"name": "职级（老）",
						"value": "高级"
					},
					{
						"name": "职级新",
						"value": "高级"
					},
					{
						"name": "职位",
						"value": "老板"
					},
					{
						"name": "职位（老）",
						"value": "老板"
					},
					{
						"name": "职位新",
						"value": "老板"
					},
					{
						"name": "职务新",
						"value": "职务2"
					},
					{
						"name": "病假",
						"value": "0"
					},
					{
						"name": "基本工资",
						"value": "1111.00"
					},
					{
						"name": "本期专项扣除",
						"value": "333.00"
					}
				],
				"userId": "16179357830115895",
				"userName": "稀饭"
			},
			{
				"dataList": [{
						"name": "岗位补贴",
						"value": "0"
					},
					{
						"name": "姓名",
						"value": "张二青"
					},
					{
						"name": "实出勤天数",
						"value": "0"
					},
					{
						"name": "部门",
						"value": "新零售方案演示"
					},
					{
						"name": "应出勤天数",
						"value": "0"
					},
					{
						"name": "职级（老）",
						"value": "中级"
					},
					{
						"name": "职级新",
						"value": "中级"
					},
					{
						"name": "职位",
						"value": "店员"
					},
					{
						"name": "职位（老）",
						"value": "店员"
					},
					{
						"name": "职位新",
						"value": "店员"
					},
					{
						"name": "职务新",
						"value": "职务4"
					},
					{
						"name": "工号",
						"value": "016"
					},
					{
						"name": "病假",
						"value": "0"
					},
					{
						"name": "基本工资",
						"value": "1111.00"
					},
					{
						"name": "本期专项扣除",
						"value": "333.00"
					}
				],
				"userId": "manager7188",
				"userName": "张二青"
			}
		],
		"endDate": "2023-03-31",
		"hasMore": false,
		"startDate": "2023-03-01",
		"status": "agree",
        "calStatus": "done",
        "calVersion": 1

	}
}
26、停用薪资组
接口说明
调用该接口可以根据薪资组ID，启用薪资组。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/groupStop
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupId
薪资组ID
必填
ANTCODE000_BHJCODE120
示例：
4
{
	"salaryGroupId": "ANTCODE000_BHJCODE120"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
示例：
5
{
	"code":"200",
	"success":true
}
27、启用薪资组
接口说明
调用该接口可以根据薪资组ID，停用薪资组。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/groupStart
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupId
薪资组ID
必填
ANTCODE000_BHJCODE120
示例：
4
{
	"salaryGroupId": "ANTCODE000_BHJCODE120"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
示例：
5
{
	"code":"200",
	"success":true
}
28、校验薪资组是否存在
接口说明
调用该接口可以根据薪资组ID判断薪资组是否存在。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/exist
方式：POST
请求入参
参数
描述
备注
示例
salaryGroupId
薪资组ID
必填
ANTCODE000_BHJCODE120
示例：
4
{
	"salaryGroupId": "ANTCODE000_BHJCODE120"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
true：薪资组已存在；false：薪资组不存在
true/false
示例：
6
{
	"code":"200",
	"success":true,
  "data": false
}
29、查询法定节假日
接口说明
调用该接口可以判断某个范围内的日期是否是法定节假日、调休日、休息日、工作日。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/date/type
方式：POST
请求入参
参数
描述
备注
示例
startTime
查询开始日期
必填，日期格式：yyyy-MM-dd
2023-06-21
endTime
查询结束日期
必填，日期格式：yyyy-MM-dd
2023-06-25
示例：
5
{
	"startTime": "2023-06-21",
  "endTime": "2023-06-25"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
返回结果
﻿
[
  {
    "date": "2023-06-21",
    "dateType": 0
  },
  {
    "date": "2023-06-22",
    "dateType": 1
  },
  {
    "date": "2023-06-23",
    "dateType": 2
  },
  {
    "date": "2023-06-24",
    "dateType": 2
  },
  {
    "date": "2023-06-25",
    "dateType": 3
  }
]
ㄴdate
日期
格式：yyyy-MM-dd
2023-06-25
ㄴdateType
日期类型
0：工作日
1：法定节假日：由国家法律、法规统一规定的用以开展纪念、庆祝活动的休息时间，也是劳动者休息时间的一种。
2：休息日：又称公休假日，是劳动者满一个工作周后的休息时间。
3：调休日（上班）：因为假期调整，导致休息日需要上班。
2
示例：
27
{
	"code":"200",
	"success":true,
  "data": [
      {
        "date": "2023-06-21",
        "dateType": 0
      }
      {
        "date": "2023-06-22",
        "dateType": 1
      }
      {
        "date": "2023-06-23",
        "dateType": 2
      }
      {
        "date": "2023-06-24",
        "dateType": 2
      }
      {
        "date": "2023-06-25",
        "dateType": 3
      }
    ]
}
30、表单平台-查询表单字段信息
接口说明
调用该接口可以在查询创建的表单字段信息，表单字段id都是系统生成的，需要用到表单字段id来给表单增加/修改数据。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/datacenter/form/fieldList
方式：POST
请求入参
参数
描述
备注
示例
dstId
表单id
必填
dst6abqit0ahphma0k
示例：
4
{
    "dstId":"dst6abqit0ahphma0k"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
JSONArray
﻿
﻿
ㄴitemId
字段id
﻿
fld_textxbaygsuxn9
ㄴitemName
字段名
﻿
姓名
ㄴitemType
字段类型
﻿
Input/InputNumber/Select/SelectCheckbox/DatePicker
示例：
32
{
    "code": "200",
    "data": [
        {
            "itemId": "fld_textxbaygsuxn9",
            "itemName": "姓名",
            "itemType": "Input"
        },
        {
            "itemId": "fld_number0wnw6fq8ik",
            "itemName": "年龄",
            "itemType": "InputNumber"
        },
        {
            "itemId": "fld_selectk8favx19ww",
            "itemName": "选择",
            "itemType": "Select"
        },
        {
            "itemId": "fld_select1jbww056yw",
            "itemName": "多选择",
            "itemType": "SelectCheckbox"
        },
        {
            "itemId": "fld_datezfa38az68l",
            "itemName": "时间",
            "itemType": "DatePicker"
        }
    ],
    "success": true
}
31、表单平台-批量新增数据
接口说明
调用该接口可以给表单批量新增数据。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/datacenter/data/create
方式：POST
请求入参
参数
描述
备注
示例
dstId
表单id
必填
dst6abqit0ahphma0k
dataList
数据集合
必填，格式是：List<Map<String, Object>> dataList
﻿
ㄴ recId
数据唯一的id
非必填，用来标识这条数据的唯一id，可以用业务字段拼接
不填时会为这条数据生成一条唯一的recId
﻿
ㄴ 字段id1
﻿
﻿
﻿
ㄴ字段id2
﻿
﻿
﻿
ㄴ字段id3
﻿
﻿
﻿
ㄴ ......
﻿
﻿
﻿
对于数值类型和日期类型有如下的格式要求：
数值类型：数值范围必须在-9007199254740991 ～ 9007199254740991之间；
日期类型：日期类型仅支持yyyy﻿yyyy-MM﻿yyyy-MM-dd yyyy-MM-dd HH:mm﻿yyyy-MM-dd HH:mm:ss5种格式，且日期必须在当前时间（调用接口的时间）的前后100年之间。
示例：
22
{
    "dstId": "dst6abqit0ahphma0k",
    "dataList": [
        {
            "recId": "test00001",
            "fld_textxbaygsuxn9": "大沛",
            "fld_number0wnw6fq8ik": 19,
            "fld_selectk8favx19ww": {"label": "西瓜", "value": "1", "key": "1"},
            "fld_select1jbww056yw":[{"label": "锤子", "value": "2"}],
            "fld_datezfa38az68l":"2023-12-22"
        },
        {
            "recId": "test00002",
            "fld_textxbaygsuxn9": "李杰",
            "fld_number0wnw6fq8ik": 20,
            "fld_selectk8favx19ww": {"label": "锤子", "value": "2", "key": "2"},
            "fld_select1jbww056yw":[{"label": "西瓜", "value": "1"},{"label": "锤子", "value": "2"}],
            "fld_datezfa38az68l":"2023-12-23"
        }
    ]
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
示例：
5
{
    "code": "200",
    "success": true
}
注意：调用此接口新增数据的前提是，字段均已在智能薪酬-表单平台中创建（即字段id是已经创建好的id），否则数据插入后，在表单平台页面中无法显示此数据，但可以调用本文档接口34（数据中心-数据查询）查询到数据。
32、表单平台-批量修改数据
接口说明
调用该接口可以修改表单数据。根据每条数据唯一的id来做更新
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/datacenter/data/update
方式：POST
请求入参
参数
描述
备注
示例
dstId
表单id
必填
dst6abqit0ahphma0k
dataList
数据集合
必填，格式是：List<Map<String, Object>> dataList
﻿
ㄴ recId
数据唯一的id
必填，用来标识这条数据的唯一id，可以用业务字段拼接
﻿
ㄴ 字段id1
﻿
﻿
﻿
ㄴ字段id2
﻿
﻿
﻿
ㄴ字段id3
﻿
﻿
﻿
ㄴ ......
﻿
﻿
﻿
对于数值类型和日期类型有如下的格式要求：
数值类型：数值范围必须在-9007199254740991 ～ 9007199254740991之间；
日期类型：日期类型仅支持yyyy﻿yyyy-MM﻿yyyy-MM-dd yyyy-MM-dd HH:mm﻿yyyy-MM-dd HH:mm:ss5种格式，且日期必须在当前时间（调用接口的时间）的前后100年之间。
示例：
22
{
    "dstId": "dst6abqit0ahphma0k",
    "dataList": [
        {
            "recId": "test00001",
            "fld_textxbaygsuxn9": "大沛",
            "fld_number0wnw6fq8ik": 19,
            "fld_selectk8favx19ww": {"label": "西瓜", "value": "1", "key": "1"},
            "fld_select1jbww056yw":[{"label": "锤子", "value": "2"}],
            "fld_datezfa38az68l":"2023-12-22"
        },
        {
            "recId": "test00002",
            "fld_textxbaygsuxn9": "李杰",
            "fld_number0wnw6fq8ik": 20,
            "fld_selectk8favx19ww": {"label": "锤子", "value": "2", "key": "2"},
            "fld_select1jbww056yw":[{"label": "西瓜", "value": "1"},{"label": "锤子", "value": "2"}],
            "fld_datezfa38az68l":"2023-12-23"
        }
    ]
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
示例：
5
{
    "code": "200",
    "success": true
}
33、表单平台-批量删除数据
接口说明
调用该接口可以删除表单数据。根据每条数据唯一的id来做删除。
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/datacenter/data/delete
方式：POST
请求入参
参数
描述
备注
示例
dstId
表单id
必填
dst6abqit0ahphma0k
recordIds
数据id集合
必填，格式是：List<String> recordIds
﻿
示例：
8
{
    "dstId": "dst6abqit0ahphma0k",
    "recordIds": [
        "test00001",
        "test00002"
    ]
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
示例：
5
{
    "code": "200",
    "success": true
}
﻿
34、表单平台-数据查询
接口说明
调用该接口可以查询新增或者修改后的数据
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/datacenter/record/list
方式：POST
请求入参
参数
描述
备注
示例
dstId
表单id
必填
dst6abqit0ahphma0k
search
查询条件集合
格式是：List<Condition> search
﻿
‒fieldId
‒value
‒express
‒selections
搜索的字段id
搜索的值
表达式
选项，数组
fieldId：参考接口30查询表单字段信息 [itemId]
value：当字段的类型是文本，数值，日期时，搜索的值
express：当字段id的类型是单选或者多选 填写[incl]
‒字段为文本：match
‒字段为单选或多选：incl
‒字段为数值：≠，≥，>，=，≤，<
‒字段为日期：≥，≤
selections：当字段的类型是单选或者多选，搜索的值
﻿
示例：
14
{
    "page": 1,
    "pageSize": 30,
    "search": [
        {
            "fieldId": "fld_textuqkjttzjs6",
            "selections": [],
            "value": "刘",
            "express": "match"
        }
    ],
    "dstId": "dsteb4l1147qvuw53i"
}
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
数据结果集
﻿
﻿
‒字段id1
‒字段id2
‒......
﻿
﻿
﻿
示例：
14
{
	"code":"200",
	"data":[
		{
			"fld_numbermcu7dtbdu0":40.0,
			"fld_textit1al0akzo":"四川",
			"fld_textuqkjttzjs6":"刘备",
			"dstId":"dsteb4l1147qvuw53i",
			"recId":"recivmytee3eiz1w3vtcmyg2cg6"
		}
	],
	"success":true
}
﻿
35、查询计薪规则操作日志
接口说明
调用该接口可以查询计薪规则操作日志
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/group/calRuleLog
方式：POST
请求入参
参数
描述
备注
示例
startTime
开始时间
必填， 格式：yyyy-MM-dd
2022-10-10
endTime
结束时间
选填， 格式：yyyy-MM-dd，默认为今天
2022-10-11
salaryGroupId
薪资组id
选填，当薪资组名称也有的时候，优先使用薪资组id
﻿
salaryGroupName
薪资组名称
选填
﻿
page
查询页
从第1页开始
1
pageSize
每页查询量
最大50
50
请求参数示例
7
{
  "startTime": "2024-09-01",
  "salaryGroupName": "陈祥豪0924新建测试",
  "page": 3,
  "pageSize":50
}
﻿
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
hasMore
是否还有下一页数据
﻿
true/false
data
数据结果集
﻿
﻿
‒code
‒id
‒opDescribe
‒opTime
‒salaryGroupId
‒salaryGroupName
‒userId
‒userName
‒日志码
‒日志id
‒日志描述
‒日志操作日时间
‒薪资组id
‒薪资组名称
‒操作人id
‒操作人名称
﻿
﻿
请求返回示例
41
{
	"code": "200",
	"data": [
		{
			"code": "88e4131d8ece49a5b3d4f4f05882e812",
			"id": 526675,
			"opDescribe": "薪资组【陈祥豪0924新建测试】，薪资项【岗位补贴】从【固定工资】分组移动到【考勤】分组。",
			"opTime": "2024-10-09 14:11",
			"opType": "修改计薪规则",
			"salaryGroupId": "a72cf41a352e492b8647aced512dd2f1",
			"salaryGroupName": "陈祥豪0924新建测试",
			"userId": "17180734769294512",
			"userName": "毛新焕"
		},
		{
			"code": "a29a5d7cc9854ea4b4f78f7b2c3af81f",
			"id": 526674,
			"opDescribe": "薪资组【陈祥豪0924新建测试】，修改了薪资项【岗位补贴】公式规则，从【1+#税前补差# +21】修改为【1+#税前补差# 】",
			"opTime": "2024-10-09 14:11",
			"opType": "修改计薪规则",
			"salaryGroupId": "a72cf41a352e492b8647aced512dd2f1",
			"salaryGroupName": "陈祥豪0924新建测试",
			"userId": "17180734769294512",
			"userName": "毛新焕"
		},
		{
			"code": "90fc3681274f4cc19ff22d32e5c9d30d",
			"id": 526673,
			"opDescribe": "薪资组【陈祥豪0924新建测试】，修改了薪资项【岗位补贴】计薪规则，从【每月手动导入】修改为【自定义公式计算】",
			"opTime": "2024-10-09 13:40",
			"opType": "修改计薪规则",
			"salaryGroupId": "a72cf41a352e492b8647aced512dd2f1",
			"salaryGroupName": "陈祥豪0924新建测试",
			"userId": "17180734769294512",
			"userName": "毛新焕"
		}
	],
	"hasMore": true,
	"success": true
}
﻿
36、表单平台-查询表单名称和id
接口说明
调用该接口可以查询表单平台中表单的名称和id
请求详情
链接：https://salary.eapps.dingtalkcloud.com/oapi/salary/datacenter/form/list
方式：POST
﻿
请求入参
参数
描述
备注
示例
name
表单名称模糊查询
选填
测试名称
请求参数示例
4
{
  "name": "测试"
}
﻿
请求出参
参数
描述
备注
示例
code
返回码
﻿
200
success
是否成功
﻿
true/false
data
数据结果集
﻿
﻿
‒dstId
‒dstName
‒表单id
‒表单名称
﻿
﻿
请求返回示例
19
{
    "code": "200",
    "data": [
        {
            "dstId": "dst134vcs2d2666ruk",
            "dstName": "zhy_test"
        },
        {
            "dstId": "dst1j5no1i7udhz9vb",
            "dstName": "部门绩效"
        },
        {
            "dstId": "dst1nrw7kt41d9pucx",
            "dstName": "蚂蚁测试"
        }
    ],
    "success": true
}
﻿
﻿
统一错误信息
参数
参数名
备注
示例
code
错误码
"30001"
msg
错误信息
"参数错误"
detail
问题详情
"billMonth不能为空"
requestId
请求唯一ID，用于后期问题排查与跟踪
"7AD052CB-EE8B-4DFD-BBAF-EFB340E0A5AF"
示例
7
{
  "code": "30001",
  "msg": "参数错误",
  "detail": "billMonth不能为空",
  "requestId": "7AD052CB-EE8B-4DFD-BBAF-EFB340E0A5AF"
}
错误码
code
msg
detail
500
服务器内部错误
﻿
30001
参数错误
例如，"billMonth不能为空"
30002
权限错误
例如，"appKey无访问权限"
30901
工资条错误
例如，"未查询到有效的导入记录"
30902
薪资表错误
例如，"薪资组不存在"
30903
导入数据人次超过限制
例如，"工资条单次最多只允许导入3000条"
30904
薪资组未初始化
﻿
30905
薪资组不存在
﻿
30906
未匹配到有效的人员信息
﻿
403
签名无效
﻿
调用示例
Java
172
package com.renlijia.gaea.service;

import com.alibaba.fastjson.JSON;
import com.google.common.collect.Maps;
import org.apache.commons.codec.binary.Base64;
import org.apache.commons.io.IOUtils;
import org.apache.commons.lang3.StringUtils;
import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ByteArrayEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.TreeMap;

/**
 * @author erqing.zhang
 * @date 2021/4/08 上午9:53
 */
public class Demo {

    public static final String host = "https://salary.eapps.dingtalkcloud.com";
    public static final String appId = "8130749";
    public static final String appSecret = "TpBDhWjYPnjn4OcbKeiopkq4ou7hmQpc";

    public static void main(String[] args) throws Exception {
        // 获取该月薪资组浮动薪资项
        String uri = "/oapi/salary/floatData/items";

        // 构建参数
        Map<String, String> paramsMap = new HashMap<>();
        paramsMap.put("salaryGroupName", "测试薪资组");
        paramsMap.put("calBizId", "202102M");

        // json序列化
        String paramsData = JSON.toJSONString(paramsMap);

        // 获取签名
        String serviceSign = serviceSign(uri, "POST", Maps.newHashMap(), paramsData.getBytes());

        // 请求地址
        String url = host + uri;

        // 发起请求
        CloseableHttpClient httpClient = HttpClients.createDefault();
        HttpPost httpPost = new HttpPost(url);
        httpPost.setHeader("Content-Type", "application/json");
        httpPost.setHeader("signature", serviceSign);
        httpPost.setHeader("app-id", appId);

        httpPost.setEntity(new ByteArrayEntity(paramsData.getBytes()));
        CloseableHttpResponse response = httpClient.execute(httpPost);

        // 解析结构
        HttpEntity entity = response.getEntity();
        String responseContent = EntityUtils.toString(entity, "UTF-8");
        System.out.println(responseContent);
        response.close();
        httpClient.close();
    }

    public static String serviceSign(String uri, String httpMethod, Map<String, Object> paramsMap, byte[] body) throws Exception {
        String hmacSHA256 = "HmacSHA256";
        String encoding = "UTF-8";
        String bodyMd5 = buildBodyMd5(httpMethod, body);
        String resourceToSign = buildResource(uri, paramsMap);
        String stringToSign = buildStringToSign(resourceToSign, httpMethod, bodyMd5);

        Mac hmacSha256 = Mac.getInstance(hmacSHA256);
        byte[] keyBytes = appSecret.getBytes(encoding);
        hmacSha256.init(new SecretKeySpec(keyBytes, 0, keyBytes.length, hmacSHA256));
        return new String(Base64.encodeBase64(hmacSha256.doFinal(stringToSign.getBytes(encoding))), encoding);
    }

    public static String buildBodyMd5(String httpMethod, byte[] body) throws IOException {
        String methodPost = "post";
        String methodPut = "put";
        if (body == null) {
            return null;
        }
        if (!httpMethod.equalsIgnoreCase(methodPost) && !httpMethod.equalsIgnoreCase(methodPut)) {
            return null;
        }
        InputStream inputStream = new ByteArrayInputStream(body);
        byte[] bodyBytes = IOUtils.toByteArray(inputStream);
        if (bodyBytes != null && bodyBytes.length > 0) {
            return base64AndMD5(bodyBytes).trim();
        }
        return null;
    }

    public static String base64AndMD5(byte[] bytes) {
        try {
            final MessageDigest md = MessageDigest.getInstance("MD5");
            md.reset();
            md.update(bytes);
            final Base64 base64 = new Base64();
            return new String(base64.encode(md.digest()));
        } catch (final NoSuchAlgorithmException e) {
            throw new IllegalArgumentException("unknown algorithm MD5");
        }
    }

    public static String buildResource(String uri, Map<String, Object> paramsMap) {
        StringBuilder builder = new StringBuilder();
        builder.append(uri);
        TreeMap<String, Object> sortMap = new TreeMap<>();
        sortMap.putAll(paramsMap);
        if (sortMap.size() > 0) {
            builder.append('?');
            builder.append(buildMapToSign(sortMap));
        }
        return builder.toString();
    }

    public static String buildStringToSign(String resourceToSign, String method, String bodyMd5) {
        char LF = '\n';
        StringBuilder sb = new StringBuilder();
        sb.append(method).append(LF);
        if (StringUtils.isNotBlank(bodyMd5)) {
            sb.append(bodyMd5);
        }
        sb.append(LF);
        sb.append(resourceToSign);

        return sb.toString();
    }

    public static String buildMapToSign(Map<String, Object> paramMap) {
        StringBuilder builder = new StringBuilder();

        for (Map.Entry<String, Object> e : paramMap.entrySet()) {
            if (builder.length() > 0) {
                builder.append('&');
            }
            String key = e.getKey();
            Object value = e.getValue();
            if (value != null) {
                if (value instanceof List) {
                    List list = (List) value;
                    if (list.size() == 0) {
                        builder.append(key);
                    } else {
                        builder.append(key).append("=").append(String.valueOf(list.get(0)));
                    }
                } else if (value instanceof Object[]) {
                    Object[] objs = (Object[]) value;
                    if (objs.length == 0) {
                        builder.append(key);
                    } else {
                        builder.append(key).append("=").append(String.valueOf(objs[0]));
                    }
                } else {
                    builder.append(key).append("=").append(String.valueOf(value));
                }
            }
        }
        return builder.toString();
    }
}
PHP
39
<?php 
    echo "Hello Friends<br>"; 
    main();
    function main() {
        $curr_mon = date('n',strtotime('-1 month'));
        $data = array();
        $appId = '8130749';
        $appSecret = 'TpBDhWjYPnjn4OcbKeiopkq4ou7hmQpc';
        $data['salaryGroupName'] = '测试薪资组';
        $data['calBizId'] = '202102M';

        $uri = "/oapi/salary/floatData/items";
        $url = "https://salary.eapps.dingtalkcloud.com".$uri;
        $postdata = base64_encode(md5(json_encode($data),true));
        $method ="POST";
        $f =  $method."\n".$postdata."\n".$uri;
        $singe = base64_encode(hash_hmac('sha256', $f, $appSecret ,true));
        $res =  postData($url,$data,$appId,$singe);
        print_r($res);
    }

    function postData($url,$data,$appid,$signature) {
        $data  = json_encode($data);
        $headerArray =array("Content-type:application/json;","Accept:application/json"
        ,"app-id:".$appid,"signature:".$signature);
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL, $url);
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
        curl_setopt($curl, CURLOPT_POST, 1);
        curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
        curl_setopt($curl,CURLOPT_HTTPHEADER,$headerArray);
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
        $output = curl_exec($curl);
        curl_close($curl);
        return json_decode($output,true);
    }
?>
C#
123
using System;
using System.Buffers.Text;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Reflection.Metadata;
using System.Security.Cryptography;
using System.Text;
using Newtonsoft.Json;

namespace Demo
{
    class Demo
    {
        static readonly string host = "https://salary.eapps.dingtalkcloud.com";
        static readonly string method = "POST";
        static readonly string appId = "8130749";
        static readonly string appSecret = "TpBDhWjYPnjn4OcbKeiopkq4ou7hmQpc";

        static void Main(string[] args)
        {
            Console.WriteLine("start");
            // 获取该月薪资组浮动薪资项
            string uri = "/oapi/salary/floatData/items";

            // 构建参数
            Dictionary<String, String> paramsMap = new Dictionary<String, String>();
            paramsMap.Add("salaryGroupName", "测试薪资组");
            paramsMap.Add("calBizId", "202102M");

            // 序列化成字符串&转化成字节数组
            string Contentjson = JsonConvert.SerializeObject(paramsMap);
            byte[] byteStr = Encoding.UTF8.GetBytes(Contentjson);

            string serviceSign = GetSign(uri, method, new Dictionary<String, String>(), byteStr);

            // 请求地址
            string url = host + uri;

            // 创建Web访问对象
            HttpWebRequest myRequest = (HttpWebRequest)WebRequest.Create(url);

            myRequest.Method = "POST";
            myRequest.ContentType = "application/json";

            // 设置授权信息
            myRequest.Headers.Add("signature", serviceSign);
            myRequest.Headers.Add("app-id", appId);

            // 发送请求
            Stream stream = myRequest.GetRequestStream();
            stream.Write(byteStr, 0, byteStr.Length);
            stream.Close();

            // 获取接口返回值
            HttpWebResponse myResponse = (HttpWebResponse)myRequest.GetResponse();
            StreamReader reader = new StreamReader(myResponse.GetResponseStream(), Encoding.UTF8);
            string responseContent = reader.ReadToEnd();
            Console.WriteLine(responseContent);
            Console.WriteLine("end");
            reader.Close();
            myResponse.Close();
        }


        static String GetSign(String uri, String httpMethod, Dictionary<String, String> paramsMap, byte[] body)
        {
            MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider();
            String bodyMd5 = Convert.ToBase64String(MD5.Create().ComputeHash(body));
            String resourceToSign = BuildResource(uri, paramsMap);
            String stringToSign = BuildStringToSign(resourceToSign, httpMethod, bodyMd5);
            byte[] secretByteStr = System.Text.Encoding.UTF8.GetBytes(appSecret);
            byte[] byteStr = System.Text.Encoding.UTF8.GetBytes(stringToSign);
            var hmacsha256 = new HMACSHA256(secretByteStr);
            byte[] hashmessage = hmacsha256.ComputeHash(byteStr);
            return Convert.ToBase64String(hashmessage);

        }

        static String BuildResource(String uri, Dictionary<String, String> paramsMap)
        {
            StringBuilder builder = new StringBuilder();
            builder.Append(uri);
            SortedDictionary<String, String> sortMap = new SortedDictionary<String, String>();
            foreach(var item in paramsMap)
            {
                sortMap.Add(item.Key,item.Value);
            }
            if (sortMap.Count > 0)
            {
                builder.Append('?');
                builder.Append(BuildMapToSign(sortMap));
            }
            return builder.ToString();
        }

        static String BuildMapToSign(SortedDictionary<String, String> sortMap)
        {
            StringBuilder builder = new StringBuilder();
            foreach (var item in sortMap)
            {
                if (builder.Length > 0)
                {
                    builder.Append('&');
                }
                builder.Append(item.Key).Append("=").Append(item.Value);
            }
            return builder.ToString();
        }

        static String BuildStringToSign(String resourceToSign, String method, String bodyMd5)
        {
            StringBuilder sb = new StringBuilder();
            char LF = '\n';
            sb.Append(method).Append(LF);
            sb.Append(bodyMd5);
            sb.Append(LF);
            sb.Append(resourceToSign);
            return sb.ToString();
        }
    }
}
Python
52
# -*- coding: utf-8 -*-
import requests
import json
from hashlib import md5
import base64
import hmac
from hashlib import sha256

host = "https://salary.eapps.dingtalkcloud.com"
appId = "8130749"
appSecret = "TpBDhWjYPnjn4OcbKeiopkq4ou7hmQpc"


def main():
    uri = "/oapi/salary/floatData/items"
    url = host + uri

    params = {
        'salaryGroupName': '测试薪资组',
        'calBizId': '202102M'
    }

    params_json = json.dumps(params, ensure_ascii=False, separators=(',', ':'))

    params_encoding = bytes(params_json, encoding='utf-8')

    # md5
    f = md5()
    f.update(params_encoding)

    param_base64 = base64.b64encode(f.digest())
    method = "POST"
    sign_content = method + "\n" + str(param_base64, 'utf-8') + "\n" + uri

    secret_encode = appSecret.encode(encoding="utf-8")
    sign_content_encode = sign_content.encode(encoding="utf-8")
    hash_content = hmac.new(secret_encode, sign_content_encode, digestmod=sha256).digest()
    signature_encode = base64.encodebytes(hash_content)
    signature = str(signature_encode, 'utf-8').replace("\n", "")

    headers = {
        'content-type': "application/json",
        'app-id': appId,
        'signature': signature
    }

    rsp = requests.post(url, data=params_encoding, headers=headers)
    print(rsp.text)


main()
Go
83
package main

import (
	"crypto/md5"
   "crypto/hmac"
	"crypto/sha256"
	"encoding/base64"
	"fmt"
	"io/ioutil"
	"encoding/json"
	"net/http"
	"strings"
)

func main() {

   // 加密密钥, 请妥善保管
   secret := "TpBDhWjYPnjn4OcbKeiopkq4ou7hmQpc"

   host := "https://salary.renlijia.com"
   uri := "/oapi/salary/group/float/items/list"
   url := host + uri
   method := "POST"

   type Params struct {
	   SalaryGroupName string `json:"salaryGroupName"`
	   CalBizId  string  `json:"calBizId"`
   }

   // 参数转化为jsonstring
   param := Params{SalaryGroupName: "二青审批测试【勿动】", CalBizId: "202201M"}
   jsonParam, _ := json.Marshal(param)
   jsonStringParam := string(jsonParam)

   // 进行md5加密
   var paramByte []byte = []byte(jsonStringParam) 
   m := md5.Sum(paramByte)
   c := m[:]
   bodyMd5 := base64.StdEncoding.EncodeToString(c)

   // 构造签名内容
   sign_content := method + "\n" + bodyMd5 + "\n" + uri

   // 通过hmac进行签名 
   var keyBytes = []byte(secret)
   hash := hmac.New(sha256.New, keyBytes)
	hash.Write([]byte(sign_content))
   result := hash.Sum(nil)
   sig := string(base64.StdEncoding.EncodeToString(result))

   // http请求入参
   payload := strings.NewReader(string(jsonParam))

   client := &http.Client {
   }
   req, err := http.NewRequest(method, url, payload)

   if err != nil {
      fmt.Println(err)
      return
   }

   // 构造header
   req.Header.Add("Content-Type", "application/json")
   req.Header.Add("signature", sig)
   req.Header.Add("app-id", "8130749")

   // 发起请求
   res, err := client.Do(req)
   if err != nil {
      fmt.Println(err)
      return
   }
   defer res.Body.Close()

   body, err := ioutil.ReadAll(res.Body)
   if err != nil {
      fmt.Println(err)
      return
   }
   fmt.Println(string(body))
}
Node
40
var base64 = require("crypto-js/enc-base64");
var md5 = require("crypto-js/md5");
var hmacSha256 = require("crypto-js/hmac-sha256");
var axios = require("axios");
// 接口入参
const params = {};

var appId = "8130749";
var secret = "TpBDhWjYPnjn4OcbKeiopkq4ou7hmQpc";
var uri = "/oapi/salary/dept/list";
var url = "https://salary.eapps.dingtalkcloud.com" + uri;
var method = "POST";

// 入参加密
var paramsJson = JSON.stringify(params);
var paramsJsonMd5 = md5(paramsJson);
var paramsJsonMd5Base64 = base64.stringify(paramsJsonMd5);

// 构造签名内容
var sign_content = method + "\n" + paramsJsonMd5Base64 + "\n" + uri;

console.log(paramsJsonMd5Base64);

// 通过hmac进行签名
var secretHmacSha256 = hmacSha256(sign_content, secret);
var secretHmacSha256Base64 = base64.stringify(secretHmacSha256);

axios({
  url,
  method: "post",
  data: params,
  headers: {
    "Content-Type": "application/json",
    signature: secretHmacSha256Base64,
    "app-id": appId,
  },
}).then(function (res) {
  console.log(res.data);
});
﻿