批量同步接口
- 接口:common/budgets/v2/glBudgetRuleJson/batch
- Method:POST
- 数据格式:JSON
- 限流信息:150次每天和50次每小时
- 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
- 接口说明:该接口用作会计规则的批量同步(根据code是否存在判断新增/更新),在整批数据中如果只有几条数据因为其他原因失败,那么只有这几条数据不会被处理,其他数据仍会被正常处理
- 其他补充信息:该接口用作会计规则的批量同步(根据code是否存在判断新增/更新),在整批数据中如果只有几条数据因为其他原因失败,那么只有这几条数据不会被处理,其他数据仍会被正常处理
参数:
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
36 |
timestamp |
long |
当前次接口同步对应的时间戳 |
TRUE |
13 |
data |
Array |
当前次接口同步的数据集合 |
TRUE |
无 |
data.code |
String |
规则编码 |
TRUE |
64 |
data.priority |
Integer |
优先级 |
TRUE |
4 |
data.budget_code |
String |
预算科目编码 |
TRUE |
64 |
data.rule_condition |
json |
规则条件 |
TRUE |
64 |
data.branch_code |
String |
分公司编码 |
FALSE |
64 |
data.budget_event |
String |
预算事件 |
FALSE |
64 |
data.deleted_flag |
String |
删除标识(传Y或N, 默认是N-不删除) |
FALSE |
1 |
rule_condition参数介绍
1. rule_condition的字段接受来自单据头,单据行,部门,项目和一些固定的栏位配置
2. 单据头栏位的参数名称一般是 header_字段名称,例如column1,拼接成header_column1
单据行栏位的参数名称一般是 字段名称, 例如column1,拼接成column1
部门栏位的参数名称一般是 charge_department_字段名称, 例如column1,拼接成charge_department_column1
项目栏位的参数名称一般是 project_字段名称, 例如column1,拼接成project_column1
注:目前支持同步的数据,与页面保持一致
rule_condition示例
页面展示 |
rule_condition参数 |
栏位名称(type_id(费用类型) 值(房租物业费(T026))) |
"rule_condition" : {"type_id": "T026"} |
返回参数
字段名称 |
字段类型 |
字段描述 |
bizId |
String |
当前次接口同步的唯一标识 |
resCode |
Integer |
响应状态码(见附录) |
resMsg |
String |
返回信息描述 |
created |
String |
创建成功的条数 |
updated |
String |
更新成功的条数 |
validatorErrors |
Array |
字段强校验不合格的数据 |
dbErrors |
Array |
数据持久化时出现错误的数据 |
warnings |
Array |
字段弱校验不合格的数据,任会做同步处理 |
示例:
请求数据
{
"bizId": "dbe1c496-0d51-415e-87a5-ed104dea597f",
"timestamp": 1636600092809,
"data": [
{
"code": "test",
"branch_code": "D1",
"budget_code": "66000",
"budget_event": "CEM",
"deleted_flag": "Y",
"rule_condition_json": {
"charge_department": "D1",
"header_column22": "claim",
"accumulation_type_id": "1"
},
"priority": 1
}
]
}
返回数据
{
"resCode": 200000,
"resMsg": "success",
"bizId": "dbe1c496-0d51-415e-87a5-ed104dea597f",
"data": {
"validatorErrors": [],
"created": "此次请求新建成功了1条数据",
"warnings": [],
"dbErrors": [],
"updated": "此次请求更新成功了0条数据"
}
}