ECJiaWiki:Api:admin/express/detail

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 配送订单信息详情

接口名称

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

注:错误编码