ECJiaWiki:Api:admin/express/detail
跳到导航
跳到搜索
应用场景
配送订单信息详情
接口名称
admin/express/detail
Header请求参数
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 | since | deprecated |
---|---|---|---|---|---|---|---|
设备唯一ID | device-udid | 是 | String | a46d663d675d4858ea7d0a21c2de06e9 | 设备的唯一编号 | 1.3.0 | |
设备客户端类型 | device-client | 是 | String | android,iphone,h5,weapp | 设备类型的描述 | 1.3.0 | |
产品编号 | device-code | 是 | String | 6015 | 产品编号 | 1.3.0 | |
API版本 | api-version | 是 | String | 1.6 | API接口版本号 | 1.3.0 |
举例如下
{
"device-udid" : "a46d663d675d4858ea7d0a21c2de06e9",
"device-client" : "weapp",
"device-code " : "6015",
"api-version" : "1.6",
}
请求参数
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
token请求凭证 | token | 是 | String | 79218f8e710fc755a222de45f43c3fd969b87972 | 调用接口凭证 |
配送id | express_id | 否 | Int | 配送id |
举例如下
{
"token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
"express_id" : 1,
}
返回参数
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
成功状态 | status | 是 | status字典 | 返回接口请求成功状态 | |
└ 是否成功 | succeed | 是 | Int | 是否成功(1、代表成功,2、代表错误) | |
返回信息 | data | 是 | 字典 | 返回信息 | |
└ 配送id | express_id | 是 | Int | 配送id | |
└ 配送编号 | express_sn | 是 | String | 配送编号 | |
└ 配送类型 | express_type | 是 | String | 配送类型(assign:派单,grab:抢单) | |
└ 配送类型 | label_express_type | 是 | String | 配送类型(派单,抢单) | |
└ 订单编号 | order_sn | 是 | String | 订单编号 | |
└ 配送员id | staff_id | 是 | int | 商家配送员时新增 | 配送员id |
└ 配送员名称 | express_user | 是 | String | 商家配送员时新增 | 配送员名称 |
└ 配送员电话 | express_mobile | 是 | String | 商家配送员时新增 | 配送员电话 |
└ 配送员头像 | express_avatar | 是 | String | 商家配送员时新增 | 配送员头像 |
└ 配送状态 | express_status | 是 | String | 商家配送员时新增 | 配送状态(wait_assign待指派,wait_pickup待取货,sending配送中,finished已完成) |
└ 配送状态(中文) | label_express_status | 是 | String | 商家配送员时新增 | 配送状态(待指派,待取货,配送中,已完成) |
└ 买家留言 | buyer_message | 是 | String | 商家配送员时新增 | 买家留言 |
└ 支付方式 | payment_name | 是 | String | 支付方式 | |
└ 取货地点(商家) | express_from_address | 是 | String | 取货地点(商家) | |
└ 取货地点经纬度 | express_from_location | 是 | 字典 | 取货地点经纬度 | |
└ 纬度 | longitude | 是 | String | 纬度 | |
└ 经度 | latitude | 是 | String | 经度 | |
└ 收货人地址 | express_to_address | 是 | String | 收货人地址 | |
└ 收货人地址经纬度 | express_to_location | 是 | 字典 | 收货人地址经纬度 | |
└ 纬度 | longitude | 是 | String | 纬度 | |
└ 经度 | latitude | 是 | String | 经度 | |
└ 距离 | distance | 是 | double | 店铺距离收货地址的距离(单位/米) | |
└ 收货人名称 | consignee | 是 | String | 收货人名称 | |
└ 收货人联系方式 | mobile | 是 | String | 收货人联系方式 | |
└ 接单时间 | receive_time | 是 | String | 接单时间 | |
└ 下单时间 | order_time | 是 | String | 下单时间 | |
└ 签收时间(完成时间) | signed_time | 是 | String | 商家配送员时新增 | 签收时间 |
└ 付款时间 | pay_time | 是 | String | 付款时间(没有付款时间返回空字符串) | |
└ 最佳送货时间 | best_time | 是 | String | 最佳送货时间(没有返回空字符串) | |
└ 配送费用 | shipping_fee | 是 | String | 配送费用 | |
└ 应收金额 | order_amount | 是 | String | 应收金额 | |
└ 商品信息 | goods_items | 是 | Array() | 商品信息 | |
└ 商品id | goods_id | 是 | Int | 商品id | |
└ 商品名 | name | 是 | String | 商品名 | |
└ 商品数量 | goods_number | 是 | int | 商品数量 | |
└ 商品属性 | goods_attr | 是 | String | 商家配送员时新增 | 商品属性 |
└ 总费用(格式化) | subtotal | 是 | String | ¥369.00 | 总费用(格式化) |
└ 图片信息 | img | 是 | img字典 | 图片信息 | |
└ 小图 | small | 是 | String | 小图 | |
└ 小图 | thumb | 是 | String | 缩略图 | |
└ 原图 | url | 是 | String | 原图 |
成功举例如下
{
"data": {
"express_id" : 1,
"express_sn" : "201612051333123456",
"express_type" : "grab",
"label_express_type" : "抢单",
"order_sn" : "20161205123456",
"staff_id":"12",
"express_user":"1号配送员",
"express_mobile":"132456987456",
"express_avatar":"http://www.yinuopai.com/content/apps/express/statics/images/touxiang.png",
"express_status":"sending",
"label_express_status":"配送中",
"payment_name" : "支付宝",
"express_from_address" : "生鲜水果超市",
"express_from_location" : {
"longitude" : "121.50925767475",
"latitude" : "31.150467662541",
},
"express_to_address" : "中山北路3553号301室"
"express_to_location" : {
"longitude" : "121.40966",
"latitude" : "31.22928",
},
"distance" : 100,
"consignee" : "陈",
"mobile" : "13512345678",
"receive_time" : "2016-12-05 13:00:00",
"order_time" : "2016-12-05",
"signed_time":"2016-12-05 13:50:00",
"pay_time" : "2016-12-05",
"best_time" : "2016-12-05 15:00:00",
"shipping_fee" : "5.00",
"order_amount" : 0,
"distance" : 100,
"goods_items" [{
"goods_id": "496",
"name": "阳光鼠2015春新款童装女童连衣裙夏女宝宝纯棉印花背心公主裙子 粉玖红印花",
"goods_number": "1",
"goods_attr":"属性:275g/进口",
"formatted_shop_price" : "¥10.00",
"img": {
"small": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201509/thumb_img/496_thumb_G_1441648759859.png",
"thumb": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201509/goods_img/496_G_1441648759272.png",
"url": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201509/source_img/496_G_1441648759880.png"
},
}]
}
"status": {
"succeed": 1
},
}
失败举例如下
{
"status" : {
"succeed" : 0,
"error_code" : "invalid_parameter",
"error_desc" : "参数无效",
}
}
注:错误编码