企业店铺订单列表查询
企业可通过接口查询自有店铺的订单列表
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/mall/external/order/list?access_token=x
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"shop_id": "",
"buyer_id": "",
"current_index": 1,
"page_size": 10
}
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| shop_id | string | 是 | 店铺id |
| buyer_id | string | 否 | 购买人id,以企业微信客户externalUserId数据为准 |
| current_index | int | 否 | 页码。默认值为1 |
| page_size | int | 否 | 列表返回长度。默认值为20,最大值为100 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"total": 100,
"records": [
{
"order_code": "fake_data",
"parent_order_code": "fake_data",
"shop_id": 88,
"order_type_name": "fake_data",
"order_view_status": "fake_data",
"delivery_type": 77,
"buyer_id": "fake_data",
"total_quantity": 61,
"order_total_amount": 25.63,
"shipping_amount": 14.31,
"order_discount_amount": 13,
"order_actual_pay": 32.32,
"order_time": 35,
"buyer_remark": "fake_data",
"seller_remark": "fake_data",
"ext": {"tmp_ke****y": "tmp_value"}
},
{
"order_code": "fake_data",
"parent_order_code": "fake_data",
"shop_id": 88,
"order_type_name": "fake_data",
"order_view_status": "fake_data",
"delivery_type": 77,
"buyer_id": "fake_data",
"total_quantity": 61,
"order_total_amount": 25.63,
"shipping_amount": 14.31,
"order_discount_amount": 13,
"order_actual_pay": 32.32,
"order_time": 35,
"buyer_remark": "fake_data",
"seller_remark": "fake_data",
"ext": {"tmp_key": "tmp_value"},
"user_id": "abc"
}
]
}
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 返回码 |
| msg | string | 对返回码的文本描述内容 |
| data | page | 分页对象 |
| total | int | 总条数 |
| records | orderInfo[] | 数据列表 |
| order_code | string | 订单号,唯一值,该字段作为更新订单信息唯一条件 |
| parent_order_code | string | 父订单号 |
| shop_id | long | 店铺id |
| order_type_name | string | 订单类型名称(类似:秒杀,拼团) |
| order_view_status | string | 订单展示状态 (用于页面展示,例如:已完成,未完成等等) |
| delivery_type | int | 配送类型 0:无需配送 1:线下自提 2:线上配送 |
| buyer_id | string | 购买人id,对应企业微信客户externalUserId数据 |
| total_quantity | int | 商品总数量 |
| shipping_amount | double | 运费,单位:元 |
| order_discount_amount | double | 订单总优惠金额,单位:元 |
| order_total_amount | double | 订单总价,单位:元 |
| order_actual_pay | double | 订单总实付金额,单位:元 |
| order_time | long | 下单时间(yyyy-MM-dd HH:mm:ss),时间戳,精度:秒 |
| seller_remark | string | 商家备注 |
| buyer_remark | string | 买家留言 |
| ext | object | 扩展信息以key value的形式 key不能超过20 value不能操作200 |
| user_id | string | 关联员工id,员工在本三方应用的密文用户id,可通过「获取成员列表」接口获取或通过「自建应用用户id批量转三方应用用户id」接口转换得到; 关联员工可作为订单的业绩归属和订单数据权限隔离依据,在订单详情页会展示此关联员工 |