Lingxing
切换旧版

编辑/更新自发货订单

POST/pb/mp/order/v2/updateOrder

批量编辑更新【订单管理】模块“待审核”状态订单

API Path请求协议请求方式令牌桶容量
/pb/mp/order/v2/updateOrderHTTPSPOST10

请求参数

order_listarray<object>必填
订单列表
隐藏子属性
address_infoobject
收货信息
隐藏子属性
address_line1string
详细地址1
address_line2string
详细地址2
address_line3string
详细地址3
citystring
城市
districtstring
区/县
doorplate_nostring
门牌号
postal_codestring
邮编
receiver_company_namestring
公司名
receiver_country_codestring
国家/地区二字码
receiver_mobilestring
手机
receiver_namestring
收件人
receiver_telstring
电话
state_or_regionstring
省/州
global_order_nointeger
全局系统单号
logisticsobject
物流信息
隐藏子属性
cod_typestring
是否COD订单(是 or 否)
sender_tax_nostring
税号
sender_tax_typestring
税号类型(VAT/CPF/IOSS/EORI/收件人税号)
order_item_listarray<object>必填
商品信息
备注:【可以传空列表】,不传空列表时order_list>>order_item_list>>type必传
隐藏子属性
markstring
商品备注
mskustring
msku
priceinteger
单价
quantityinteger
数量
skustring
sku
typeinteger
编辑类型:
1 新增
2 删除
3 覆盖
idstring
系统订单商品ID
platformOrderNostring
平台单号,该字段在type=1 新增时生效

请求示例

{
    "order_list": [
        {
            "address_info": {
                "address_line1": "",
                "city": "",
                "receiver_country_code": "",
                "receiver_mobile": "",
                "receiver_name": ""
            },
            "global_order_no": 1032790274616770561,
            "order_item_list": [
                {
                    "quantity": 1,
                    "price": 1,
                    "sku": "wjc10_sku",
                    "type": 3
                }
            ]
        }
    ]
}

返回结果

Json Object

codeinteger必填
10002:订单更新成功
10000:订单更新失败
10001:订单更新部分成功
示例 10001
messagestring必填
消息提示
示例 订单更新部分成功
dataarray<object>必填
响应数据
隐藏子属性
error_detailsarray<object>必填
错误信息
示例 [{global_order_no:xx,error_message:xxx},..]
隐藏子属性
global_order_nostring
系统单号
error_messagestring
失败原因
request_idstring必填
请求链路id
示例 ad9c1a8625c74f3ea0525e216374e31a1676514819613
response_timestring必填
响应时间
示例 2023-02-16 10:33:40

返回成功示例

{
    "code": 10001,
    "message": "订单更新部分成功",
    "request_id": "d8e36903-8679-4372-8d09-21d80934d87a.1689907710574"
    "response_time": "2023-07-21 10:48:30",
    "data": {
        "error_details": [
            {
                "global_order_no": "1032790274616770561",
                "error_message": "系统不存在单号1032790274616770561"
            }
        ]
    }
}

附加说明

  1. 编辑订单信息
    文档包含字段均支持编辑。处商品信息外,请求体body中包含的字段名传入的,都将覆盖对应字段系统数据,不传字段名的将保留原订单数据。
    即需要修改则传字段名,不需要修改则不传。
  2. 给订单中未配对的MSKU写入配对本地SKU
    在order_item_list,传msku字段用于匹配订单中的msku,传需配对的sku,type=3覆盖。线上商品(一般有MSKU的)不支持修改数量和单价
  3. 给订单中已有配对本地SKU的MSKU更换SKU
    在order_item_list中,传msku字段用于匹配订单中的msku,传新的sku,tpye=3覆盖。线上商品不支持修改数量和单价。
  4. 给订单新增一个本地sku
    在order_item_list中,传sku、quantity、type=1新增,无需传msku。需指定新增的sku的数量。
    仅手工订单类型的订单才能修改sku单价,线上单新增的sku视为单价为0的赠品。
  5. order_list>>order_item_list>>price字段,实际业务含义=接口请求值*1000000