13. 批量发货
发货权限仅对商家维度进行校验, 不再关注用户可操作的商家维度.
批量发货限制一次可操作最大150个包裹, 超过会被拦截. 超时时间可适当延迟,建议150个包裹超时时间限制在30秒左右.
1. 接口
/mtop/aftersale/openapi/delivery/batch
2. 接口参数
公共参数
请求参数
Delivery 说明:
字段 | 类型 | 是否必填 | 备注 |
---|---|---|---|
requestList | List<Delivery> |
是 | 单次发货的数组形式, 具体请看单次发货 |
3. 请求示例
data内容.
{
"requestList": [
{
"orderId": 4191016389753901,
"expressSn": "JDV00121155113",
"bizCode": "jd",
"userId": 1504203445,
"itemList": [
{
"skuId": 3012708,
"count": 1,
"pid": 22214
}
]
},
{
"orderId": 4191016389753901,
"expressSn": "JDV00121155114",
"bizCode": "jd",
"userId": 1504203445,
"itemList": [
{
"skuId": 3012708,
"count": 1,
"pid": 22214
},
{
"skuId": 3012709,
"count": 2,
"pid": 22214
},
{
"skuId": 3012710,
"count": 2,
"pid": 22215
}
]
}
]
}
4. 返回结果
字段 | 类型 | 备注 |
---|---|---|
result | Map<Long, List<ExpressInfo>> |
键为订单号, 值为发货结果描述, 如果失败会有对应的快递单信息 |
ExpressInfo
信息:
字段 | 类型 | 备注 |
---|---|---|
expressSn | String | 快递单号 |
content | String | 操作结果描述, 成功恒为 ok |
返回快递单的用途是如果失败可以继续对该快递单进行重试发货.
5. 返回示例
批量发货不返回失败信息, 仅对试单的操作结果进行描述, 返回成功:
{
"code": 0,
"message": "ok",
"data": {
"result": {
"4190923623601297": [
{
"expressSn": "3831480903894",
"content": "order not found"
},
{
"expressSn": "3831480900152",
"content": "order not found"
}
],
"4190923623601298": [
{
"expressSn": "3831480900152",
"content": "order not found"
},
{
"expressSn": "3831480903894",
"content": "order not found"
}
]
}
}
}