批量同步接口
- 接口:common/assets/v2/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.asset_name |
String |
资产名称 |
TRUE |
64 |
data.type_code |
String |
资产分类编码 |
TRUE |
64 |
data.asset_status |
String |
状态编码 |
TRUE |
64 |
data.owner_branch_code |
String |
所属公司 |
TRUE |
0 |
data.asset_number |
String |
资产号码 |
FALSE |
0 |
data.manage_department_code |
String |
管理部门 |
FALSE |
0 |
data.model |
String |
资产型号 |
FALSE |
64 |
data.description |
String |
资产描述 |
FALSE |
255 |
data.amount |
Integer |
数量 |
FALSE |
0 |
data.unit_code |
String |
单位 |
FALSE |
32 |
data.location_code |
String |
资产地点编码 |
FALSE |
64 |
data.manage_user_code |
String |
管理人 |
FALSE |
64 |
data.use_department_codes |
Array |
使用部门 |
FALSE |
0 |
data.use_user_codes |
Array |
使用人 |
FALSE |
0 |
data.attachment_vos |
Array |
附件 |
FALSE |
0 |
data.enabled_flag |
String |
用户启用标志(Y/N,默认为Y) |
FALSE |
1 |
data.expect_user_status_date |
Date |
开始使用时间(yyyy-MM-dd) |
FALSE |
0 |
data.cancel_date |
Date |
作废时间(yyyy-MM-dd) |
FALSE |
0 |
data.expect_use_life |
int |
预计使用寿命(月) |
FALSE |
0 |
data.original_value |
decimal |
原值(十五位,支持两位小数) |
FALSE |
0 |
data.expect_residual_value |
decimal |
预计残值(十五位,支持两位小数) |
FALSE |
0 |
data.column1-column100 |
String |
column字段信息 |
FALSE |
255 |
data.attribute1-attribute10 |
String |
attribute字段信息 |
FALSE |
255 |
返回参数
字段名称 |
字段类型 |
字段描述 |
bizId |
String |
当前次接口同步的唯一标识 |
resCode |
Integer |
响应状态码(见附录) |
resMsg |
String |
返回信息描述 |
created |
String |
创建成功的条数 |
updated |
String |
更新成功的条数 |
validatorErrors |
Array |
字段强校验不合格的数据 |
dbErrors |
Array |
数据持久化时出现错误的数据 |
warnings |
Array |
字段弱校验不合格的数据,任会做同步处理 |
示例:
请求数据
{
"timestamp": 1665976598000,
"bizId": "xxx",
"data": [
{
"code": "complute",
"asset_name": "电脑",
"model": "EIWJD-SOKD",
"description": "电脑描述",
"type_code": "code",
"asset_status": "Idle",
"amount": 1,
"unit_code": "02",
"location_code": "code",
"enabled_flag": "N",
"attachment_vos": [
{"attachment_url": "url", "file_name": "文件名","description": "description"},
{"attachment_url": "url", "file_name": "文件名","description": "description1"}
],
"owner_branch_code": "D1",
"manage_department_code": "C010103",
"manage_user_code": "yrhchD1007",
"use_department_codes": ["C2", "Y001"],
"use_user_codes": ["zly", "llk"],
"attribute1": "attribute1",
"attribute2": "attribute2",
"attribute3": "PL",
"attribute4": "attribute4",
"attribute5": "attribute5",
"attribute6": "attribute6",
"attribute7": "attribute7",
"attribute8": "attribute8",
"attribute9": "attribute9",
"attribute10": "attribute10",
"column1": "PL",
"column2": "column2",
"column3": "column3",
"column4": "column4",
"column5": "D1",
"column6": "column6",
"column7": "column7",
"column8": "column8",
"column9": "zly",
"column10": "column10",
"column11": "column11",
"column12": "column12",
"column13": "column13",
"column14": "column14",
"column15": "column15",
"column16": "column16",
"column17": "column17",
"column18": "column18",
"column19": "column19",
"column20": "column20",
"column21": "column21",
"column22": "column22",
"column23": "column23",
"column24": "column24",
"column25": "column25",
"column26": "column26",
"column27": "column27",
"column28": "column28",
"column29": "column29",
"column30": "column30",
"column31": "column31",
"column32": "column32",
"column33": "column33",
"column34": "column34",
"column35": "column35",
"column36": "column36",
"column37": "column37",
"column38": "column38",
"column39": "column39",
"column40": "column40",
"column41": "column41",
"column42": "column42",
"column43": "column43",
"column44": "column44",
"column45": "column45",
"column46": "column46",
"column47": "column47",
"column48": "column48",
"column49": "column49",
"column50": "column50",
"column51": "column51",
"column52": "column52",
"column53": "column53",
"column54": "column54",
"column55": "column55",
"column56": "column56",
"column57": "column57",
"column58": "column58",
"column59": "column59",
"column60": "column60",
"column61": "column61",
"column62": "column62",
"column63": "column63",
"column64": "column64",
"column65": "column65",
"column66": "column66",
"column67": "column67",
"column68": "column68",
"column69": "column69",
"column70": "column70",
"column71": "column71",
"column72": "column72",
"column73": "column73",
"column74": "column74",
"column75": "column75",
"column76": "column76",
"column77": "column77",
"column78": "column78",
"column79": "column79",
"column80": "column80",
"column81": "column81",
"column82": "column82",
"column83": "column83",
"column84": "column84",
"column85": "column85",
"column86": "column86",
"column87": "column87",
"column88": "column88",
"column89": "column89",
"column90": "column90",
"column91": "column91",
"column92": "column92",
"column93": "column93",
"column94": "column94",
"column95": "column95",
"column96": "column96",
"column97": "column97",
"column98": "column98",
"column99": "column99",
"column100": "column100"
}
]
}
返回数据
{
"resCode": 200000,
"resMsg": "success",
"bizId": "xxx",
"data": {
"validatorErrors": [],
"created": "此次请求新建成功了0条数据",
"warnings": [],
"dbErrors": [],
"updated": "此次请求更新成功了1条数据"
}
}