ECJiaWiki:Api:admin/shopkeeper/crowdsource/express/task

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 掌柜查看平台配送任务列表

接口名称

 admin/shopkeeper/crowdsource/express/task

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 d122e3c72332c5af12a71d77c9f1462f5901d276 token
分页信息 pagination pagination字典 分页信息
└ 每页显示条数 count Int 每页显示条数
└ 当前页数 page Int 当前页数
└ 关键字搜索 keywords String 关键字搜索
└ 配送类型 express_type String type(wait_assign待指派,wait_pickup待取货,sending配送中,finished已完成)

举例如下

{
      "token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
      "keywords":"2016120917250732670",
      "express_type":"wait_pickup",
       "pagination" : {
    	   "count" : 10,
    	   "page" : 1
      },
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status Json {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data Array() 请求接口提供的返回信息
└ 配送单id express_id int 配送单id
└ 配送单号 express_sn String 配送单号
└ 订单编号 eorder_sn String 订单编号
└ 接单时间 format_receive_time String 接单时间
└ 配送员id staff_id int 配送员id
└ 配送员名称 express_user string 配送员名称
└ 配送员电话 express_mobile String 配送员电话
└ 配送状态 express_status String 配送状态(wait_assign待指派,wait_pickup待取货,sending配送中,finished已完成)
└ 配送状态(中文) label_express_status String 配送状态(待指派,待取货,配送中,已完成)
└ 取货地点(商家) express_from_address String 取货地点(商家)
└ 收货人地址 express_to_address String 收货人地址
└ 取货地点坐标 express_from_location express_from_location字典 取货地点坐标
   └ 经度 longitude string 经度
   └ 维度 latitude string 维度
└ 收货地点坐标 express_to_location express_to_location字典 收货地点坐标
   └ 经度 longitude string 经度
   └ 维度 latitude string 维度
└ 取送货2点间距离 distance string 取送货2点间距离
└ 配送费用 shipping_fee decimal 配送费用
└ 配送费用(格式化) format_shipping_fee String 配送费用
└ 期望送达时间(格式化) format_best_time String 期望送达时间
└ 下单时间(格式化) format_add_time String 下单时间
└ 分页信息 paginated paginated字典 分页信息
  └ 总数 total Int 总数
  └ 当前返回数组的总条数 count Int 当前返回数组的总条数
  └ 是否有下一页 more Int 是否有下一页

成功举例如下

{ 
      "data": [{
            "express_id":1,
            "express_sn" : "201612051333123456",
            "order_sn":"2016120982322",
            "format_receive_time" : "2016-12-05 15:00:00",
            "staff_id":1,
            "express_user":"平台1号配送员",
            "express_mobile":"18321567839",
            "express_status":"wait_pickup",
            "label_express_status" : "待取货",
            "express_from_address" : "生鲜水果超市普陀区中山北路伸大厦3553号",
            "express_to_address" : "杨浦区政立路同济欣苑821弄",
            "express_from_location": {
                "longitude": "121.49441",
                "latitude": "31.30831"
            },
            "express_to_location": {
                "longitude": "121.41641998291016",
                "latitude": "31.235450744628906"
            },
            "distance": 13510,
            "shipping_fee" : 5.00,
            "format_shipping_fee" :"¥5.00"
            "format_best_time":"2016-12-05 15:45:00",
            "format_add_time":"2016-12-05 15:45:00",
      }],
      "status": {
            "succeed": 1
      },
     "paginated": {
        "total": 38,
        "count": 38,
        "more": 0
    }
}

失败举例如下

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

注:错误编码