API文档中心
开发文档
API文档
店铺服务
订单管理
转单售后
消息服务
字典服务
接口说明
依据订单编号检索订单数据
公共参数
请求地址(仅支持HTTP POST请求方式)
| 环境 | 请求地址 |
|---|---|
| 正式环境 | //api.zhuandan.com/v1/Orders/mgetOrders |
系统参数说明：
| 参数名 | 参数类型 | 参数描述 | 示例值 |
|---|---|---|---|
| app_key | String(32) | 应用的app key | adc7a8960911564e89ce69fd92546aaa |
| access_token | String(32) | 获取到的应用授权 | adc7a8960911564e89ce69fd92546aaa |
| timestamp | String(10) | 当前请求时间戳 | 1401935833（允许时差±5分钟，单位秒） |
| sig | String(32) | 接口请求签名 | adc7a8960911564e89ce69fd92546aaa |
API接口参数说明
| 参数名称 | 参数类型 | 是否必须 | 参数示例 | 参数描述 |
|---|---|---|---|---|
| orderIds | List(String) | 必选 | ["20170217113","20170702131345"] | 订单编号的列表，最大支持100个订单编号查询 |
响应结构体
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| 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 | 某某鲜花店 | 接单店铺 |
| order_real_photo_info | array | 订单实物照信息，只有在订单处于处理中的订单才可能会有实物照 | |
| └ photo | array | 订单实物照信息 | |
| └ update_time | number | 订单实物照更新时间 |
响应示例
{
"code": 200,
"result": {
"total": 1,
"orderlists": [
{
"order_id": 7552153,
"order_sn": "20230920755215341",
"out_order_sn": "202308291640114051788",
"order_type": 0,
"source_sid": 1,
"source_shop_id": 1,
"receive_sid": 2,
"receive_shop_id": 2,
"order_amount": 10,
"delivery_type": 2,
"delivery_date": "2023-09-20",
"delivery_time": "17:31 - 18:31",
"delivery_fee": 0,
"create_time": 1695201968,
"sign_time": null,
"order_status": "WAIT_SIGNED",
"pay_status": 1,
"order_items": [
{
"item_sku_id": "",
"item_outer_sku_id": "",
"item_total": 1,
"item_name": "",
"item_remarks": "19枝粉雪山",
"item_img": [
"https://img.zhuandan.com/FCloud/order/202308/11405/64edc980ee50c.png"
]
}
],
"order_remarks": "请保证鲜花的新鲜",
"areainfo": "台湾|台北市|万华区",
"create_type": 1,
"if_card": 1,
"consignee": "李老师",
"mobile": "13800138000",
"address": "鲜纳肚(台北西门店)",
"express_name": null,
"express_sn": null,
"express": null,
"is_refund": 0,
"is_complain": "N",
"repeal_type": 0,
"jiedan_dianpu_id": 612295,
"jiedan_dianpu_name": "台湾测试门店",
"jiedan_dianpu_mobile": "13800138000",
"unpaid_auto_cancel_overtime": 0,
"order_status_remark": "待签收",
"order_state": 5,
"grab_order_bidding_num": 0
}
]
},
"error": ""
}