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

注:错误编码

取自“https://ecjia.com/wiki/index.php?title=ECJiaWiki:Api:admin/express/detail&oldid=25005”