API文档中心

开发文档

概念术语 获取access_token 计算签名 响应与限制 示例与SDK

API文档

店铺服务
获取店铺基本信息 获取账户余额
订单管理
订单列表查询 订单检索 发布转单 转单支付 撤销转单 修改抢单 获取报价信息 确认竞价 获取取消转单原因 发布转单简化版 查询配送日志 导入网单
订单售后
售后原因 售后申请 修改售后 取消售后 售后仲裁申请 售后凭证文件上传
消息服务
消息回调
字典服务
配送时间字典 获取城市字典

常见问题

常见错误代码 更新日志

接口说明

系统默认只检索查询店铺进三个月内的订单信息,如有其它时间需求请联系我们

公共参数

请求地址(仅支持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 订单状态字段可为空
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": [
                            "http://imt.zhuandan.com/attachment/orderFiles/shop_11405/201612/585e3149c7625.jpg@1200w_1200h_4e_90q.jpg",
                            "http://imt.zhuandan.com/attachment/orderFiles/shop_11405/201612/585e314c8c8f0.jpg@1200w_1200h_4e_90q.jpg",
                            "http://imt.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
}

 

新手指南
咨询建议
在线客服