闲管家开放平台
  1. 订单
闲管家开放平台
  • 接入说明
  • 代码示例
  • 用户
    • 授权商家账号(服务商)
      POST
    • 创建商家账号(服务商)-废弃
      POST
    • 删除商家账号(服务商)
      POST
    • 查询商家账号(服务商)
      POST
    • 授权闲鱼店铺(服务商)
      POST
    • 删除闲鱼店铺(服务商)
      POST
    • 查询闲鱼店铺
      POST
    • 查询商家地址
      POST
  • 商品
    • 查询商品类目
      POST
    • 查询商品属性
      POST
    • 查询商品列表
      POST
    • 查询商品详情
      POST
    • 查询商品规格
      POST
    • 创建商品(单个)
      POST
    • 创建商品(批量)
      POST
    • 上架商品
      POST
    • 下架商品
      POST
    • 编辑商品
      POST
    • 编辑库存
      POST
    • 删除商品
      POST
  • 订单
    • 查询订单列表
      POST
    • 查询订单详情
      POST
    • 订单卡密列表
      POST
    • 订单物流发货
      POST
    • 订单取消交易
      POST
  • 推送
    • 商品回调通知
    • 商品推送通知
    • 订单推送通知
  • 资金
    • 查询钱包账户余额(服务商)
    • 订购ERP专业版(服务商)
  • 其他
    • 查询快递公司
  • 严选
    • 获取品牌列表
    • 获取机型列表
    • 获取机型类目
    • 获取报告类目
  1. 订单

查询订单列表

POST
/api/open/order/list
ERP同步订单流程说明:
第一步:在开放平台的自研应用中填写订单推送地址
第二步:通过订单推送接口,接收订单信息
第三步:通过订单查询接口,获取订单详情

请求参数

Query 参数
appid
integer 
必需
开放平台的AppKey
默认值:
{{appid}}
timestamp
integer 
必需
当前时间戳(单位秒,5分钟内有效)
默认值:
{{timestamp}}
seller_id
integer 
可选
商家ID(仅商务对接传入,自研/第三方ERP对接忽略即可)
默认值:
{{seller_id}}
sign
string 
必需
签名MD5值(参考签名说明)
默认值:
{{sign}}
Body 参数application/json
order_status
enum<integer> <int32>
订单状态
可选
枚举值:
11 : 待付款
12 : 待发货
21 : 已发货
22 : 交易成功
23 : 已退款
24 : 交易关闭
枚举值:
111221222324
refund_status
enum<integer> <int32>
退款状态
可选
枚举值:
0 : 未申请退款(表示买家没有申请退款)
1 : 待商家处理(买家已经申请退款,等待卖家同意)
2 : 待买家退货(卖家已经同意退款,等待买家退货)
3 : 待商家收货(买家已经退货,等待卖家确认收货)
4 : 退款关闭(买家取消退款/超时未处理自动关闭)
5 : 退款成功(卖家同意退款/超时未处理自动退款)
6 : 已拒绝退款(卖家拒绝退款)
8 : 待确认退货地址(等待卖家确认退货地址)
枚举值:
01234568
默认值:
0
order_time
array[integer <int64>]
买家下单时间
可选
第一个元素值为开始时间戳,第二个元素值为结束时间戳
>= 2 items<= 2 items
pay_time
array[integer <int64>]
买家支付时间
可选
第一个元素值为开始时间戳,第二个元素值为结束时间戳
>= 2 items<= 2 items
consign_time
array[integer <int64>]
卖家发货时间
可选
第一个元素值为开始时间戳,第二个元素值为结束时间戳
>= 2 items<= 2 items
confirm_time
array[integer <int64>]
订单成交时间
可选
第一个元素值为开始时间戳,第二个元素值为结束时间戳
>= 2 items<= 2 items
refund_time
array[integer <int64>]
退款成功时间
可选
第一个元素值为开始时间戳,第二个元素值为结束时间戳
>= 2 items<= 2 items
update_time
array[integer <int64>]
订单更新时间
可选
第一个元素值为开始时间戳,第二个元素值为结束时间戳
>= 2 items<= 2 items
page_no
integer <int32>
页码
可选
>= 1<= 100
默认值:
1
page_size
integer <int32>
每页行数
可选
当翻页获取的条数(page_no*page_size)超过1万,接口将报错,请尽可能的细化搜索条件
>= 1<= 100
默认值:
50
示例
{
  "page_size": 10,
  "page_no": 1,
  "order_status": 22
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '/api/open/order/list?appid=&timestamp=&seller_id={{seller_id}}&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page_size": 10,
    "page_no": 1,
    "order_status": 22
}'

返回响应

🟢200成功
application/json
Body
code
integer <int32>
必需
默认值:
0
msg
string 
必需
默认值:
OK
data
object 
必需
list
array[object (订单详情) {36}] 
必需
count
integer <int32>
查询总数
必需
page_no
integer <int32>
页码
必需
page_size
integer <int32>
每页行数
必需
示例
{
  "code": 0,
  "msg": "OK",
  "data": {
    "list": [
      {
        "order_no": "3364202298717566229",
        "order_status": 22,
        "order_time": 1685087039,
        "total_amount": 8000,
        "pay_amount": 1,
        "pay_no": "2023052622001114731441899001",
        "pay_time": 1685087067,
        "refund_status": 0,
        "refund_time": 0,
        "receiver_mobile": "15889106633",
        "receiver_name": "萧祁锐",
        "prov_name": "广东省",
        "city_name": "深圳市",
        "area_name": "南山区",
        "town_name": "粤海街道",
        "address": "桂庙新村",
        "waybill_no": "JT3032658260816",
        "express_code": "other",
        "express_name": "",
        "express_fee": 0,
        "consign_type": 1,
        "consign_time": 1685087379,
        "confirm_time": 1685951386,
        "cancel_reason": "",
        "cancel_time": 0,
        "create_time": 1685087040,
        "update_time": 1685951390,
        "buyer_eid": "6R97619OKz5WmtZ/cgibMA==",
        "buyer_nick": "蓝兔子与精灵",
        "seller_eid": "6R97619OKz5WmtZ/cgibMA==",
        "seller_name": "逗逼猴子321123",
        "seller_remark": "",
        "goods": {
          "quantity": 1,
          "price": 8000,
          "product_id": 421611860404485,
          "item_id": 709548670377,
          "outer_id": "1111",
          "sku_id": 0,
          "sku_outer_id": "",
          "sku_text": "",
          "title": "佳韵宝哺乳枕  买完后闺蜜又送了一个  标签都还没拆  便宜",
          "images": [
            "http://img.alicdn.com/bao/uploaded/i4/O1CN01VciDtc1gFLShhFzH9_!!53-fleamarket.heic"
          ],
          "service_support": ""
        }
      },
      {
        "order_no": "3364342266781566229",
        "order_status": 22,
        "order_time": 1685088183,
        "total_amount": 4350,
        "pay_amount": 1,
        "pay_no": "2023052622001114731441822171",
        "pay_time": 1685088230,
        "refund_status": 0,
        "refund_time": 0,
        "receiver_mobile": "15889106633",
        "receiver_name": "萧祁锐",
        "prov_name": "广东省",
        "city_name": "深圳市",
        "area_name": "南山区",
        "town_name": "粤海街道",
        "address": "桂庙新村",
        "waybill_no": "",
        "express_code": "",
        "express_name": "",
        "express_fee": 0,
        "consign_type": 2,
        "consign_time": 1686821376,
        "confirm_time": 1687685382,
        "cancel_reason": "",
        "cancel_time": 0,
        "create_time": 1685088185,
        "update_time": 1687685386,
        "buyer_eid": "6R97619OKz5WmtZ/cgibMA==",
        "buyer_nick": "蓝兔子与精灵",
        "seller_eid": "6R97619OKz5WmtZ/cgibMA==",
        "seller_name": "逗逼猴子321123",
        "seller_remark": "订单卖家备注",
        "goods": {
          "quantity": 1,
          "price": 4350,
          "product_id": 421611860506885,
          "item_id": 708245707949,
          "outer_id": "",
          "sku_id": 5146011339969,
          "sku_outer_id": "",
          "sku_text": "【款式】:充电款",
          "title": "小黄鸭宝宝洗澡花洒戏水玩具小孩电动喷水婴儿沐浴儿童男孩女孩",
          "images": [
            "http://img.alicdn.com/bao/uploaded/i4/O1CN01iuNpnP1gFLRZFghNL_!!53-fleamarket.heic"
          ],
          "service_support": ""
        }
      }
    ]
  }
}
🟢200失败
修改于 2024-04-17 06:29:26
上一页
删除商品
下一页
查询订单详情
Built with