Skip to main content

addConsignmentAndModifyOrders：发货并且根据发货信息修改订单

备注：只能一次性发货，不支持多次发货，不支持联营版；商品数量可以多发少发，可以删除商品，但是不能有新商品；如果客户支付金额 > 修改后的订单结算金额，退回多余的金额到客户余额；如果客户是预付方式，客户余额必须大于待支付金额；如果是以大单位或者中单位订购，发货数量必须能和换算关系整除

注意：

  1. 调用该接口后，需要同步原订单所有商品的所有仓库的库存信息，否则库存信息可能不正确；
  2. 该接口未处理促销活动的优惠，如果订单涉及到促销活动，则可能导致订单金额不正确；
  3. 订单如果使用在线支付，调用该接口，如果订单金额减少，则不会生成退款单，不能完成在线退款。
入参

名称

是否必须

类型

描述

sKey

Y

String

用户令牌

consignmentOrder

Y

String

订单号

consignmentNO

N

String

运单号/物流单号

consignmentName

N

String

物流公司名称 在订货宝已设置的合作物流公司

consignmentRemark

N

String

备注

consignmentDate

N

String

发货时间

forceDiscountTotal

N

Float

强制指定订单的结算金额，如果 订单总金额  != 指定的结算价 - 税费 - 运费 + 优惠金额，则会生成特批价修复订单价格差异

forceBodyUseCode

N

String

是否强制指定明细项使用规格商品编码（options_goods_num）匹配商品进行操作，传2强制使用，否则将使用guid、multiFirst、multiSecond进行匹配

forceStatus

N

String

强制指定发货单状态(shipped：待发货；receivedin：待收货；received：已收货)，允许指定的状态和默认值与系统设置->订单流程设置有关系；

订单流程设置里面不需要出库操作，不能指定状态为待发货(shipped)；

订单流程设置里面不需要确认收货，不能指定状态为待收货(receivedin)；

默认值：订单流程设置里面不需要确认收货时 = received，否则 = receivedin

body

Y

Object

发货单详细

body参数

名称

是否必须

类型

描述

options_goods_num

N

String

规格商品编码（sku），当forceBodyUseCode为2时此参数必传

guid

N

String

值为客户ERP系统中唯一值，用做关系对应，当forceBodyUseCode不为2时有效

num

Y

Float

发数数量 发货精度受管理端系统设置影响 必须大于0

multiFirst

N

String

规格1，当forceBodyUseCode不为2时有效

multiSecond

N

String

规格2，当forceBodyUseCode不为2时有效

stockGuid

N

String

仓库GUID 多仓库时有效

remark

N

String

出库商品备注

conType

N

String

商品类型 c：正常销售商品；g：赠品。默认c

promotionId

N

int

商品活动id，如果订单商品参加了活动，必传

batchNum

N

String

出库批次号，开启出库批次应用后此字段方可生效
参数示例
{

    "f":"addConsignmentAndModifyOrders",
    "v":{
        "sKey":"339e80a3d7eff174ff42274544e95f89",
        "consignmentOrder":"DH.20200509.0004",
        "consignmentNO":"45667881239",
        "consignmentName":"顺丰",
        "consignmentRemark":"发货单修改订单",
        "consignmentDate":"2020-05-09 17:55:52",
        "forceStatus":"shipped",
        "forceDiscountTotal":33.3,
        "body":[
            {
                "guid":"2020050901",
                "multiFirst":"35368",
                "multiSecond":"35371",
                "num":1,
                "remark":"test1"
            },
            {
                "guid":"2020050901",
                "multiFirst":"35368",
                "multiSecond":"35372",
                "num":1,
                "remark":"test2"
            },
            {
                "guid":"2020050901",
                "multiFirst":"35368",
                "multiSecond":"35373",
                "num":1,
                "remark":"test3"
            }
        ]
    }
}
返回参数

参数名称

类型

描述、 返回字段

rStatus

String

100：正常，其他：异常

message

String

信息描述

rData

String

具体数据
返参示例
{
    "rStatus": 100,
    "message": "发货并且修改订单完成",
    "rData": []
}
Back to top