批量同步接口

  • 接口: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条数据"
  }
}

results matching ""

    No results matching ""