批量同步限制接口
- 接口：common/budgets/v2/batchLimit
- Method：POST
- 数据格式：JSON
- 限流信息：3000次/小时
- 多语言环境：实现多语言环境方式是在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
- 接口说明：该接口用作预算的批量同步，在整批数据中如果只有几条数据因为其他原因失败，那么只有这几条数据不会被处理，其他数据仍会被正常处理
- 单次请求数据量不得超过200条，否则会直接报错500001
- 事务说明：该接口底层是对单条数据进行操作，因此事务也只针对单条记录。
- 并发说明：同一公司在一次批量操作未结束时再此请求该接口，第二次请求会被拒绝；不同公司并发请求该接口是允许的。
参数:
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
| bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
36 |
| timestamp |
long |
当前次接口同步对应的时间戳 |
TRUE |
13 |
| data |
Array |
当前次接口同步的数据集合 |
TRUE |
无 |
| data.code |
String |
预算编码 |
TRUE |
64 |
| data.fiscal_date |
String |
财年期间 |
TRUE |
64 |
| data.budget_amount |
String |
预算金额 |
TRUE |
65 |
| data.deleted_flag |
String |
是否删除(Y/N,非Y都不会删除) |
TRUE |
1 |
| data.budget_code |
String |
预算科目编码 |
FALSE |
64 |
| data.department_code |
String |
成本中心名称 |
FALSE |
64 |
| data.employee_number |
String |
员工编号 |
FALSE |
64 |
| data.project_code |
String |
项目编码 |
FALSE |
64 |
| data.supplier_code |
String |
供应商编码 |
FALSE |
64 |
| data.error_pct |
String |
错误pct |
FALSE |
64 |
| data.warning_pct |
String |
警告pct |
FALSE |
64 |
| data.validate_rule |
String |
校验规则 |
FALSE |
64 |
| column1-column5 |
String |
column字段信息 |
FALSE |
255 |
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| bizId |
String |
当前次接口同步的唯一标识 |
| resCode |
Integer |
响应状态码（见附录） |
| resMsg |
String |
返回信息描述 |
| created |
String |
创建成功的条数 |
| updated |
String |
更新成功的条数 |
| validatorErrors |
Array |
字段强校验不合格的数据 |
| dbErrors |
Array |
数据持久化时出现错误的数据 |
| warnings |
Array |
字段弱校验不合格的数据，任会做同步处理 |
示例：
请求数据
{
"timestamp": 1647324047000,
"bizId": "1647324047000",
"data": [
{
"code": "2022年2月性能",
"fiscal_date": "2022年-01--",
"department_code": "BM001",
"project_code": "XN002",
"budget_amount": 83.32,
"deleted_flag": "Y",
"supplier_code": "GY001"
},
{
"code": "2022年2月性能",
"fiscal_date": "2022年-01",
"department_code": "BM001--",
"project_code": "XN001",
"budget_amount": 83.31,
"deleted_flag": "Y",
"supplier_code": "GY001"
},
{
"code": "2022年2月性能",
"fiscal_date": "2022年-01",
"department_code": "BM001",
"project_code": "XN001",
"budget_amount": 83.31,
"deleted_flag": "N",
"supplier_code": "GY001"
}
]
}
返回数据
{
"resCode": 200000,
"resMsg": "SUCCESS",
"bizId": "1647324047000",
"data": {
"validatorErrors": [
{
"code": "2022年2月性能",
"messages": [
"[fiscal_date]:[2022年-01--]未找到,已经自动忽略"
]
}
],
"deleted": "此次请求删除成功了0条数据",
"created": "此次请求插入0条数据",
"warnings": [
{
"code": "2022年2月性能",
"messages": [
"预算编制为[2022年2月性能]的[部门编码][BM001--]未在主数据中维护过,已经自动忽略"
]
}
],
"dbErrors": [],
"updated": "此次请求更新了1条数据"
}
}