更新订单信息

开发者对订单信息进行更新，如订单状态改变等；接口说明如下：

接口调用基本信息说明
协议https
http请求方式POST
请求URLhttps://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。

请求数据样例

  1. {
  2.   "order_list": [
  3.     {
  4.       "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
  5.       "trans_id": "4200000144201807116521229xxx",
  6.       "status": 4,
  7.       "desc": "xx微主页",
  8.       "ext_info": {
  9.         "express_info": {
  10.           "name": "测试用户",
  11.           "phone": "158xxxxxx",
  12.           "address": "广东省广州市tit创意园品牌街腾讯微信总部",
  13.           "price": 0,
  14.           "national_code": "440105",
  15.           "country": "中国",
  16.           "province": "广东省",
  17.           "city": "广州市",
  18.           "district": "海珠区",
  19.           "express_package_info_list": [
  20.             {
  21.               "express_company_id": 2001,
  22.               "express_company_name": "圆通",
  23.               "express_code": "88627337387xxx",
  24.               "ship_time": 1517713509,
  25.               "express_page": {
  26.                 "path": "/libs/xxxxx/portal/express-detail/xxxxx"
  27.               },
  28.               "express_goods_info_list": [
  29.                 {
  30.                   "item_code": "00003563372839_00000010001xxx",
  31.                   "sku_id": "00003563372839_10000010014xxx"
  32.                 }
  33.               ]
  34.             }
  35.           ]
  36.         },
  37.         "invoice_info": {
  38.           "type": 0,
  39.           "title": "xxxxxx",
  40.           "tax_number": "xxxxxx",
  41.           "company_address": "xxxxxx",
  42.           "telephone": "020-xxxxxx",
  43.           "bank_name": "招商银行",
  44.           "bank_account": "xxxxxxxx",
  45.           "invoice_detail_page": {
  46.             "path": "/libs/xxxxx/portal/invoice-detail/xxxxx"
  47.           }
  48.         },
  49.         "user_open_id": "xxxxxxx",
  50.         "order_detail_page": {
  51.           "path": "/libs/xxxxx/portal/order-detail/xxxxx"
  52.         }
  53.       }
  54.     }
  55.   ]
  56. }

请求数据字段说明

订单基本字段必填字段类型说明
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快递公司id
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是stringh5快递详情页跳转链接
express_goods_info_list字段必填字段类型说明
item_code是string物品ID（SPU ID），要求appid下全局唯一
sku_id是stringsku_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是stringh5发票详情页跳转链接
order_detail_page字段（以下二选一）必填字段类型说明
path是string小程序订单详情页跳转链接
src_h5_path是stringh5订单详情页跳转链接
快递公司信息

目前支持的快递公司及其对应的编号如下：

快递公司编号字段快速公司名字字段
2000EMS
2001圆通
2002DHL
2004中通
2005韵达
2006畅灵
2008百世汇通
2009德邦
2010申通
2011顺丰速运
2012顺兴
2014如风达
2015优速
9999其他快递公司名字（例如：京东物流）

回包数据样例

接口调用成功回包
  1. {
  2.     "errcode":0,
  3.     "errmsg":"success"
  4. }
接口调用失败回包
  1. {
  2.   "errcode": 9019102,
  3.   "errmsg": "部分订单更新失败",
  4.   "fail_order_list": [
  5.     {
  6.       "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
  7.       "error_code": 10001,
  8.       "msg": "订单不存在，无法更新"
  9.     }
  10.   ]
  11. }
回包字段类型说明
errcodeint32错误码
errmsgstring错误信息
fail_order_listobject失败订单信息
fail_order_list字段类型说明
order_idstring失败订单id
error_codeint32订单错误码
msgstring错误提示

接口错误码

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