confirmShipment:确认发货
- 当发货单数量发生变化时,为了确保出入库明细的连续性,系统会先取消当前的出库单,随后生成一张新的出库单并完成发货操作。返回结果中的 new_ships_id 和 new_ships_num 分别为新生成出库单的编号。与此同时,系统会自动触发订单核准流程。
- 发货过程中,如未回传某商品明细,该商品将从对应的出库单中自动移除。
入参
名称 |
是否必须 |
类型 |
描述 |
sKey |
Y |
String |
用户令牌 |
shipsNum |
Y |
String |
出库单号 |
consignmentNO |
N |
String |
运单号/物流单号 |
consignmentName |
N |
String |
物流公司名称 在订货宝已设置的合作物流公司 |
consignmentRemark |
N |
String |
备注 |
consignmentDate |
N |
String |
发货时间 |
body |
Y |
Object |
发货单详细 |
body:
名称 |
是否必须 |
类型 |
描述 |
options_goods_num |
N |
String |
规格商品编码(sku) |
num |
Y |
Float |
发数数量 发货精度受管理端系统设置影响(大于0表示修改发货数量,0表示删除该商品,效果与不传该条记录一样) |
remark |
N |
String |
出库商品备注 |
conType |
N |
String |
商品类型 c:正常销售商品;g:赠品。默认c |
promotionId |
N |
int |
商品活动id,如果订单商品参加了活动,必传 |
参数示例
{
"f":"confirmShipment",
"v":{
"sKey":"339e80a3d7eff174ff42274544e95f89",
"shipsNum":"FH-20240709-00037",
"consignmentNO":"45667881239",
"consignmentName":"顺丰",
"consignmentRemark":"发货单修改订单",
"consignmentDate":"2020-05-09 17:55:52",
"body":[
{
"options_goods_num":"2020050901",
"num":1,
"remark":"test1"
},
{
"options_goods_num":"2020050901",
"num":1,
"remark":"test2"
}
]
}
}
返参
参数名称 |
类型 |
描述、 返回字段 |
rStatus |
String |
100:正常,其他:异常 |
message |
String |
信息描述 |
rData |
String |
具体数据 |
返参示例
{
"rStatus": 100,
"message": "发货并且修改出库单完成",
"rData": {
"code": 200,
"message": "成功",
"data": {
"ships_id": "17544",
"ships_num": "FH.20240801.0074",
"new_ships_id": "17545", // 发货数量发生变化返回,不发生变化返回为0
"new_ships_num": "FH.20240801.0075"// 发货数量发生变化返回,不发生变化返回为空
}
}
}