更新订单信息
开发者对订单信息进行更新,如订单状态改变等;接口说明如下:
请求数据样例
{
"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 | 订单字段冲突 |