批量删除一次性支付记录
传入一次性支付记录ID,删除ID对应的一次性支付记录
Tip: 一次性支付记录被删除后,通过查询一次性支付授予明细接口或者查询一次性支付授予记录接口将查不到该数据
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/compensation/v1/lump_sum_payment/batch_remove |
| HTTP Method | POST |
| 接口频率限制 | 10 次/秒 |
| 支持的应用类型 | custom |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 | corehr:compensation.lump_sum_payment:write 一次性支付写权限 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
record_ids | string\[\] | 否 | 要删除的一次性支付记录id(通过【查询一次性支付记录】 接口进行查询) 示例值:["7337149697626801708"] 数据校验规则: - 长度范围: 0 ~ 500 |
reason | string | 否 | 因重复提交删除 示例值:"删除原因实例" |
请求体示例
json
{
"record_ids": [
"7337149697626801708"
],
"reason": "删除原因实例"
}响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
└ operate_results | lump_sum_payment_operate_result\[\] | 每条记录的操作结果。对于创建成功的记录,会返回创建后的一次性支付记录id |
└ id | string | 操作的记录的 id |
└ unique_id | string | 操作的记录的 unique_id |
└ code | int | 操作结果状态码 可选值有: - 0: "Success" 操作成功 - 21270201: "The bonus to be changed does not exist" 要更改的奖金不存在 - 21270202: "Idempotent ID conflict" 幂等id冲突 - 21270203: "The total amount format is incorrect" 总金额格式不正确 - 21270205: "Only use the number of decimal places specified in the bonus item rules" 仅限使用奖金项规则中规定的小数位数 - 21270206: "The sum of the bonus details does not equal the total amount" 奖金明细金额之和不等于总金额 - 21270207: "issuance frequency not equal to size of details" 奖金明细总数不等于发放次数 - 21270208: "The number of issuances is less than or equal to 0" 发放次数小于等于0 - 21270209: "The currency is empty or does not exist" 币种为空或不存在 - 21270210: "Notes are too long" 备注超长 - 21270211: "The bonus details amount format is incorrect" 奖金明细金额格式不正 - 21270213: "The bonus details payment time format is incorrect" 奖金明细的发放时间格式不正确 - 21270214: "The bonus details are issued in an illegal manner" 奖金明细的发放方式不合法 - 21270215: "The bonus details are not in a valid payment status" 奖金明细的发放状态不合法 - 21270217: "Employees are not covered by the bonus rules" 员工不在奖金项规则适用范围之内 - 21270218: "The method of awarding bonus details is not covered by the bonus item rules" 奖金明细的发放方式不在奖金项规则适用范围之内 - 21270219: "Bonus item rules do not support configuration of binding period" 奖金项规则不支持配置绑定期 - 21270220: "The bonus details payment status is "paid", and cannot be modified" 奖金明细发放状态为「已发放」,不支持修改 - 21270221: "The bonus item rules already include the currency, and other currencies cannot be specified" 奖金项规则已包含币种,不支持指定其他币种 - 21270222: "The salary item does not exist" 薪酬项不存在 - 21270223: "Employee does not exist" 员工不存在 - 21270224: "The bonus details payment status is "paid", and deletion is not supported" 奖金明细发放状态为「已发放」,不支持删除 - 21270225: "Bonus rules do not allow multiple awards" 奖金项规则不允许多次发放 - 21270226: "No data permission" 无数据权限 - 21270227: "Only positive integers are allowed for the binding period" 绑定期只允许正整数 - 21270228: "This bonus does not currently support custom binding periods. Please configure and write according to the rules for the binding period of the salary item" 该奖金暂不支持自定义绑定期,请按照薪酬项绑定期规则配置写入 - 21270229: "The application issuance date must not be later than the issuance date" 申请发放日期不得晚于发放日期 - 21270230: "The application payment date format of the bonus details is incorrect" 奖金明细的申请发放日期格式不正确 |
└ message | string | 操作结果描述 |
响应体示例
json
{
"code": 0,
"msg": "success",
"data": {
"operate_results": [
{
"id": "7390583861280556588",
"unique_id": "7390583861280556588",
"code": 21270202,
"message": "uqniue id conflict"
}
]
}
}错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 2290001 | param is invalid | 参数异常,请检查入参 |
| 500 | 2290002 | server error | 服务端异常,请稍后重试 |
