ECJiaWiki:Api:admin/express/express/list(o2o)

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 配送列表  //原来admin/express/list接口升级,之前使用admin/express/list的地方在1.17版本全部更改使用admin/express/express/list

接口名称

 admin/express/express/list    //原来admin/express/list接口升级,之前使用admin/express/list的地方在1.17版本全部更改使用admin/express/express/list

请求参数

字段名 变量名 必填 类型 示例值 描述
session登录凭证 token String session登录凭证
配送状态 express_type String 配送状态(wait_pickup:待取货,wait_shipping:配送中,finished:已完成)
类型 type String assign:系统派单,grab自己抢单
订单号 order_sn String
分页信息 pagination pagination字典 分页信息
└ 每页显示条数 count Int 每页显示条数
└ 当前页数 page Int 当前页数

举例如下

{
      "token" : "",
      "express_type" : "wait_pickup",
      "type" : "assign",
      "order_sn" : "589sdfdsfsd888",
      "pagination" : {
            "count" : 10,
            "page"  : 1,
      }
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status Array() {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data Array() 请求接口提供的返回信息
配送id express_id Int 配送id
配送编号 express_sn String 配送编号
配送类型 express_type String 配送类型(assign:派单,grab:抢单)
配送类型 label_express_type String 配送类型(派单,抢单)
订单编号 order_sn String 订单编号
支付方式 payment_name String 支付方式
店铺名称 store_name String 到家1.17.0新增 店铺名称
店铺电话 shop_kf_mobile String 到家1.17.0新增 店铺电话
取货地点(商家) 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 下单时间
付款时间 pay_time String 付款时间(没有付款时间返回空字符串)
期望送货时间 best_time String 期望送货时间(没有返回空字符串)
配送费用 shipping_fee String 配送费用
应收金额 order_amount String 应收金额
分页信息 paginated paginated字典 分页信息
└ 总数 total Int 总数
└ 总数 count Int 总数
└ 是否有下一页 more Int 是否有下一页

成功举例如下

{ 
      "data": [{
            "express_id" : 1, 
            "express_sn" : "201612051333123456",
            "express_type" : "grab",
            "label_express_type" : "抢单",
            "order_sn" : "20161205123456"
            "payment_name" : "支付宝",
            "store_name":"天天果园",
            "shop_kf_mobile":"13468678174",
            "express_from_address" : "生鲜水果超市",
            "express_from_location" : {
                 "longitude" : "",
                 "latitude"  : "",
            },
            "express_to_address" : "中山北路3553号301室"
            "express_to_location" : {
                 "longitude" : "",
                 "latitude"  : "",
            },
            "distance" : 100,
            "consignee" : "陈",
            "mobile" : "13512345678",
            "receive_time" : "2016-12-05 15:00:00",
            "order_time" : "2016-12-05",
            "pay_time" : "2016-12-05",
            "best_time" : "2016-12-05 15:00:00",
            "shipping_fee" : "5.00",
            "order_amount" : 0,
      }],
      "status": {
            "succeed": 1
      },
      "paginated": {
            "total": 398,
            "count": 398,
            "more": 1
      }
}

失败举例如下

{
      "status" : {
            "succeed" : 0,
            "error_code" : "invalid_parameter",
            "error_desc" : "参数无效",
      }
}

注:错误编码