Skip to main content

confirmShipment:确认发货

  1. 当发货单数量发生变化时,为了确保出入库明细的连续性,系统会先取消当前的出库单,随后生成一张新的出库单并完成发货操作。返回结果中的 new_ships_id 和 new_ships_num 分别为新生成出库单的编号。与此同时,系统会自动触发订单核准流程。
  2. 发货过程中,如未回传某商品明细,该商品将从对应的出库单中自动移除。
入参

名称

是否必须

类型

描述

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"// 发货数量发生变化返回,不发生变化返回为空
        }
    }
}