闲管家开放平台
  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={{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失败
上一页
删除商品
下一页
查询订单详情
Built with