投递状态单条同步

接口：common/deliveries
Method：PUT
数据格式：JSON
接口说明：投递状态单条同步接口
- 在整批数据中若由于某些原因导致几条数据处理失败，失败数据不会被同步，其他数据仍正常同步
- 单次数据量过大（超过200条）时会全部转为异步处理，具体参考回调示例
- 接口描述
  - 若单据与纸单单张关联，同步纸单投递状态时会同步更新单据头上delivery_status字段
  - 若单据与多张纸单关联，当且仅当单据关联的其余全部纸单均为请求中纸单投递状态时，同步更新单据头上delivery_status字段，否则单据头上delivery_status字段为空
  - 若纸单转态被更新为 received, 则会根据配置生成索引号
  - 仅支持图中→指向状态改变，其余状态改变不被允许

请求参数

字段名称	字段类型	字段描述	是否必填	长度
bizId	String	当前接口同步的唯一标识	true	36
timestamp	Number	当前接口同步的对应时间戳	true	13
data	Object	当前接口同步的数据	true	/
data.code	String	投递纸单号	true	64
data.document_num	String	单据号	true	64
data.delivery_status	String	纸单投递状态 `delivered(已投递)`/`received(已收单)`/ `rejected(已退单)`	true	64

请求示例

{
  "bizId": "a63f3e76-71d0-4d8c-a265-74f6df5cb3cc",
  "timestamp": 1648792000657,
  "data": {
    "code": "EXP0000000001",
    "document_num": "EXP0000000001",
    "delivery_status": "received"
  }
}

返回参数

字段名称	字段类型	字段描述
resCode	Number	响应状态码（见附录）
resMsg	String	返回信息描述
bizId	String	当前接口同步的唯一标识
data	Object	当前接口同步的数据
data.updated	String	更新成功的条数
data.validatorErrors	Array	字段强校验不合格的数据
data.warnings	Array	字段弱校验不合格的数据，仍会做同步处理
data.dbErrors	Array	数据持久化时出现错误的数据

返回示例

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "a63f3e76-71d0-4d8c-a265-74f6df5cb3cc",
  "data": {
    "validatorErrors": [],
    "warnings": [],
    "dbErrors": [],
    "updated": "此次请求更新成功了1条数据"
  }
}

results matching ""

No results matching ""