API文档中心
开发文档
API文档
店铺服务
订单管理
转单售后
消息服务
字典服务
接口说明
系统默认只检索查询店铺近30天内的订单信息，如有其它时间需求请联系我们
公共参数
请求地址(仅支持HTTP POST请求方式)
| 环境 | 请求地址 |
|---|---|
| 正式环境 | //api.zhuandan.com/v1/Orders/orderlist |
系统参数说明：
| 参数名 | 参数类型 | 参数描述 | 示例值 |
|---|---|---|---|
| app_key | String(32) | 应用的app key | adc7a8960911564e89ce69fd92546aaa |
| access_token | String(32) | 获取到的应用授权 | adc7a8960911564e89ce69fd92546aaa |
| timestamp | String(10) | 当前请求时间戳 | 1401935833（允许时差±5分钟，单位秒） |
| sig | String(32) | 接口请求签名 | adc7a8960911564e89ce69fd92546aaa |
API接口参数说明
| 参数名称 | 参数类型 | 是否必须 | 参数示例 | 参数描述 |
|---|---|---|---|---|
| statusCode | String | 必选 | WAIT_CONFIRM | 订单状态 WAIT_PAY 待支付，WAIT_CONFIRM 待接单，WAIT_DELIVERY 待配送，WAIT_SIGNED 配送中，WAIT_CHECKOUT 已送达，FINISHED 已结算， CANCELED 已取消， REFUND 已退款，RETURN_GOODS 已退货，EXCHANGE_GOODS 已换货 |
| q | String | 可选 | 13800138000 | 检索关键字，可检索收货人电话、姓名、转单宝订单编号。使用该字段时，statusCode 订单状态字段可为空 |
| out_order_sn | String | 可选 | 202121012012331123 | 商家业务系统的订单编号，编号组成：字母、数字、"-"、"_" |
| page | int | 可选 | 1 | 当前查询第几页，默认1 |
| page_size | int | 可选 | 10 | 每页检索多少条，默认10条，最大不超过30条 |
响应结构体
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| order_sn | long | 20170217113 | 转单单号 |
| out_order_sn | long | 1623643133 | 外部或商家自定义单号 |
| order_type | int | 0 | 派发方式 0 指定发单，1抢单模式 2报价竞单 |
| order_amount | float | 120.00 | 发单金额 |
| delivery_type | int | 2 | 配送方式：2 送货上门， 1 快递配送 |
| delivery_date | string | 2017-07-14 | 配送日期 |
| delivery_time | string | 下午送达(14:00-18:00) | 具体配送时间要求 |
| create_time | string | 1487318761 | 订单创建时间，单位秒 |
| sign_time | string | 1487318761 | 订单签收时间，单位秒 |
| order_status | string | WAIT_PAY | 订单状态：WAIT_PAY 待支付，WAIT_CONFIRM 待接单，WAIT_DELIVERY 待配送，WAIT_SIGNED 配送中，WAIT_CHECKOUT 已送达，FINISHED 已结算， CANCELED 已取消， REFUND 已退款，RETURN_GOODS 已退货，EXCHANGE_GOODS 已换货 |
| pay_status | int | 1 | 支付状态，0待支付 ，1 已支付 2 已结算 |
| order_items | array | 订单商品信息 | |
| express_sn | str | 2121732173721 | 快递面单单号 |
| express_name | str | 顺丰速递 | 快递公司名称 |
| is_refund | int | 0 | 退款状态，0 正常无需退款 ，-1 失败 ，1 已申请 2 已退款 |
| is_complain | str | N | 仲裁状态，N无需仲裁 ，Y 进入仲裁 |
| jiedan_dianpu_name | str | 某某鲜花店 | 接单店铺 |
响应示例
{
"code": 200,
"result": {
"total": 1,
"page": 1,
"page_size": 10,
"orderlists": [
{
"order_sn": "20170217113",
"out_order_sn": "1623643133",
"order_type": 0,
"source_sid": 1229313,
"receive_sid": 9132218,
"order_amount": 0.01,
"delivery_type": 2,
"delivery_date": "2017-02-24",
"delivery_time": "下午送达(14:00-18:00)",
"delivery_fee": 0,
"create_time": 1487318761,
"sign_time": null,
"order_status": "WAIT_PAY",
"pay_status": 0,
"order_items": [
{
"item_name": "发对方的身份我说的发生的",
"item_total": "1",
"item_remarks": "撒旦法士大夫首都师范地方所得税地方",
"item_img": [
"//img.zhuandan.com/attachment/orderFiles/shop_11405/201612/585e3149c7625.jpg@1200w_1200h_4e_90q.jpg",
"//img.zhuandan.com/attachment/orderFiles/shop_11405/201612/585e314c8c8f0.jpg@1200w_1200h_4e_90q.jpg",
"//img.zhuandan.com/attachment/orderFiles/shop_11405/201612/585e315220a36.jpg@1200w_1200h_4e_90q.jpg"
]
},
{
"item_sku_id": "1006191002",
"item_outer_sku_id": "3552",
"item_name": "创意保鲜花礼盒 永生玫瑰花 香皂花 红粉白蓝色妖姬 送女朋友生日礼物 浅蓝色保鲜花",
"item_total": "1",
"item_remarks": "多少撒大事啊撒是的",
"item_img": [
"http://img10.360buyimg.com/n0/g8/M03/00/08/rBEHZ1AvWH8IAAAAAAOT49Oi6nwAAADVwFTrKwAA5P7861.jpg",
"http://img10.360buyimg.com/n0/g7/M03/00/08/rBEHZlAvWGsIAAAAAAOvCmHgMHEAAADVwCJ3jAAA68i141.jpg",
"http://img10.360buyimg.com/n0/g8/M03/00/08/rBEHaFAvWGEIAAAAAAOgmsREK5MAAADVwCIg1EAA6Cy808.jpg"
]
}
],
"order_remarks": "士大夫时代发生的发多少发",
"areainfo": "山东|潍坊市|奎文区",
"create_type": 1,
"if_card": 1,
"consignee": "王彬",
"mobile": "15965788679",
"address": "山东潍坊市奎文区梨园街道虞河路268号天安保险",
"express_name": null,
"express_sn": null,
"express": null,
"is_refund": 0,
"is_complain": "N",
"order_status_remark": "待支付",
"jiedan_dianpu_name": "杭州市西湖区花艺人家"
}
]
},
"error": null
}