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" : "参数无效",
      }
}

注:错误编码