更新订单信息

开发者对订单信息进行更新,如订单状态改变等;接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/importorder?action=update-order&is_history=0/1&access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 更新订单数据
接口调用时机 商户发货、用户退款完成、订单已完成
其他说明 如果为历史订单,请求URL的is_history参数值为1。

请求数据样例

{
  "order_list": [
    {
      "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
      "trans_id": "4200000144201807116521229xxx",
      "status": 4,
      "desc": "xx微主页",
      "ext_info": {
        "express_info": {
          "name": "测试用户",
          "phone": "158xxxxxx",
          "address": "广东省广州市tit创意园品牌街腾讯微信总部",
          "price": 0,
          "national_code": "440105",
          "country": "中国",
          "province": "广东省",
          "city": "广州市",
          "district": "海珠区",
          "express_package_info_list": [
            {
              "express_company_id": 2001,
              "express_company_name": "圆通",
              "express_code": "88627337387xxx",
              "ship_time": 1517713509,
              "express_page": {
                "path": "/libs/xxxxx/portal/express-detail/xxxxx"
              },
              "express_goods_info_list": [
                {
                  "item_code": "00003563372839_00000010001xxx",
                  "sku_id": "00003563372839_10000010014xxx"
                }
              ]
            }
          ]
        },
        "invoice_info": {
          "type": 0,
          "title": "xxxxxx",
          "tax_number": "xxxxxx",
          "company_address": "xxxxxx",
          "telephone": "020-xxxxxx",
          "bank_name": "招商银行",
          "bank_account": "xxxxxxxx",
          "invoice_detail_page": {
            "path": "/libs/xxxxx/portal/invoice-detail/xxxxx"
          }
        },
        "user_open_id": "xxxxxxx",
        "order_detail_page": {
          "path": "/libs/xxxxx/portal/order-detail/xxxxx"
        }
      }
    }
  ]
}

请求数据字段说明

订单基本字段 必填 字段类型 说明
order_list array 单次请求订单数量不可超过10单
order_list字段 必填 字段类型 说明
order_id string 订单ID,需要保证唯一性
trans_id string 微信支付订单ID,对于使用微信支付的订单,该字段必填
status uint32 订单状态,4:已发货 5:已退款 12:已取消 100: 已完成
desc string 订单备注
ext_info object 订单扩展信息
ext_info字段 必填 字段类型 说明
express_info object 快递信息,对于已发货订单,该字段必填
invoice_info object 发票信息,对于已开发票订单,该字段必填
user_open_id string 用户的openid,参见openid说明
order_detail_page object 订单详情页(小程序页面)
total_fee uint32 订单物品合计金额(优惠前金额,不填写的话,平台默认用物品的total fee累加)
express_info字段 必填 字段类型 说明
name string 收件人姓名
phone string 收件人联系电话
address string 收件人地址
price uint32 运费,单位:分
national_code string 行政区划代码
country string 国家
province string 省份
city string 城市
district string
express_package_info_list array 包裹信息
express_package_info_list字段 必填 字段类型 说明
express_company_id uint32 快递公司编号,参见快递公司信息
express_company_name string 快递公司名
express_code string 快递单号
ship_time uint32 发货时间,unix时间戳
express_page object 快递详情页(小程序)
express_goods_info_list array 包裹中的物品信息
express_page字段(以下二选一) 必填 字段类型 说明
path string 小程序快递详情页跳转链接
src_h5_path string h5快递详情页跳转链接
express_goods_info_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
sku_id string sku_id
invoice_info字段 必填 字段类型 说明
type uint32 抬头类型,0:单位,1:个人
title string 发票抬头
tax_number string 发票税号
company_address string 单位地址
telephone string 手机号码
bank_name string 银行名称
bank_account string 银行账号
invoice_detail_page object 发票详情页(小程序页面)
invoice_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序发票详情页跳转链接
src_h5_path string h5发票详情页跳转链接
order_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序订单详情页跳转链接
src_h5_path string h5订单详情页跳转链接

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success"
}
接口调用失败回包
{
  "errcode": 9019102,
  "errmsg": "部分订单更新失败",
  "fail_order_list": [
    {
      "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
      "error_code": 10001,
      "msg": "订单不存在,无法更新"
    }
  ]
}
回包字段 类型 说明
errcode int32 错误码
errmsg string 错误信息
fail_order_list object 失败订单信息
fail_order_list字段 类型 说明
order_id string 失败订单id
error_code int32 订单错误码
msg string 错误提示

接口错误码

回包错误码 说明
0 成功
9009099 系统错误
9009098 请求参数错误,详细错误提示请参考json回包中的errmsg字段。
9009300 订单数量超过限制
9009301 部分订单更新失败
其他常见错误码 点击查看
订单错误码 说明
-1 系统错误
-2 订单参数错误
10001 订单不存在,无法更新
10002 订单字段冲突