投递状态批量同步
- 接口：common/deliveries/batch
- Method：POST
- 数据格式：JSON
- 接口说明：投递状态批量同步接口
- 在整批数据中若由于某些原因导致几条数据处理失败，失败数据不会被同步，其他数据仍正常同步
- 单次数据量过大（超过200条）时会全部转为异步处理，具体参考回调示例
- 接口描述
- 若单据与纸单单张关联，同步纸单投递状态时会同步更新单据头上
delivery_status字段
- 若单据与多张纸单关联，当且仅当单据关联的其余全部纸单均为请求中纸单投递状态时，同步更新单据头上
delivery_status字段，否则单据头上delivery_status字段为空
- 若纸单转态被更新为
received, 则会根据配置生成索引号
- 仅支持图中→指向状态改变，其余状态改变不被允许
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
| bizId |
String |
当前接口同步的唯一标识 |
true |
36 |
| timestamp |
Number |
当前接口同步的对应时间戳 |
true |
13 |
| data |
Array |
当前接口同步的数据集合 |
true |
/ |
| data.code |
String |
投递纸单号 |
true |
64 |
| data.document_num |
String |
单据号 |
true |
64 |
| data.delivery_status |
String |
纸单投递状态
delivered(已投递)/received(已收单)/
rejected(已退单) |
true |
64 |
请求示例
{
"bizId": "b9f3e747-d195-42bf-bb41-465dc31750b4",
"timestamp": 1645424551399,
"data": [
{
"code": "EXP0000000001",
"document_num": "EXP0000000001",
"delivery_status": "received"
},
{
"code": "EXP0000000002",
"document_num": "EXP0000000002",
"delivery_status": "delivered"
}
]
}
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| 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": "b9f3e747-d195-42bf-bb41-465dc31750b4",
"data": {
"validatorErrors": [
{
"code": "EXP0000000002",
"messages": [
"此纸单需要进行更新的投递状态不被允许，请检查纸单当前状态"
]
}
],
"warnings": [],
"dbErrors": [],
"updated": "此次请求更新成功了1条数据"
}
}