企业店铺订单列表查询
企业可通过接口查询自有店铺的订单列表
请求方式: 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」接口转换得到; 关联员工可作为订单的业绩归属和订单数据权限隔离依据,在订单详情页会展示此关联员工 |