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