[关闭]
@zhuchao941 2017-07-12T12:40:59.000000Z 字数 14424 阅读 1291

点我达骑手加盟商版接口文档(新)

1. 点我达配送平台与终端接口定义

 接口为点我达配送客户端和平台之间的接口,客户端通过此接口获取用户和内容信息,并且完成用户操作数据的上传

2. 接口内容

2.1.接口定义约

2.2.消息体约

 请求消息和应答消息体采用JSON格式,字符编码采用UTF-8。
 请求消息如下:


{
  userId:1234,
  password:123456
}

应答消息体以JSON格式传送内容。如:


{
  status:1,
  data:{
    list:[
    {
      id:132,
      name:'张三'
      },
      {
        ......
      }
       ],
     sum:132
  },
  msg:""
}

status :1为成功 0为失败
data : 接口具体返回值 当响应值为-1则为未取到数据
msg:错误提示信息,如没有,则为空,类型:String

2.3. 接口定义


1. 检查应用版本及补丁接口(checkVersion)

接口描述
检查应用及补丁版本号,更新app或者下载补丁
接口消息定义
请求地址:/rider/check-app-update.json
请求方法: get
请求消息体:


{
  version:应用版本号,类型:String
  patchVersion:补丁版本号,类型:String
  source:手机厂商,类型:String
  client:系统版本,类型:String
}

响应消息


{
  status: 1,
  data:{
    updateType:app更新类型,0不需要升级 1正常升级 2强制升级 3下载补丁, 类型:int
    url:下载地址,类型:String
    latestVersion:版本号,类型:String
    tips:应用更新提示文案,类型:String
    md5:md5,类型:String
  }
  msg:""
}




2. 获取验证码接口(getCaptcha)

接口描述
登录时点击获取验证码按钮,下发验证码短信
接口消息定义
请求地址: /rider/get-captcha.json
请求方法: post
请求消息体:


{
   mobile:手机号,类型:String
   isVoice:语音验证码,类型:String
   1-语音,0-短信
}

响应消息


{
   status : 请求成功标志,1 成功 0 失败, 类型 : number
   data: 
   msg:错误提示信息,如没有,则为空,类型:String
}


3. 登录接口(login)

接口描述
 在登录界面,用户登录时必须经过手机及验证码验证
接口消息定义
请求地址:/ rider/login.json
请求方法: post
请求消息体:


{
   mobile:用户名,实际为手机号,类型:String
   captcha:验证码,类型:String
   version:应用版本号,类型:String
   imei:手机IMEI号,类型:String
   riderId:骑手ID,类型:String
   lat:骑手位置经纬度,类型:int
   lng:骑手位置经纬度,类型:int
   source:手机厂商,类型:String
   client:系统版本,类型:String
   phoneVersion:手机型号,类型:String
   clientId,个推ID,类型:String
   token, token,类型:String
}

响应消息:


{
  status : 请求成功标志,1 成功 0 失败, 类型 : number
  data: {
    updateType:0不需要升级 1正常升级 2强制升级 , 类型:int
    url:更新下载地址,类型:String
    latestVersion:最新版本号,类型:String
    riderId:用户id,类型:String,之后服务端和客户端交流的凭证
    tips:更新提示文案,类型:String
    riderName:骑手姓名,类型:String
    token:登录token,类型:String
  }
  msg:错误提示信息,如没有,则为空,类型:String
}


4. 上传经纬度(uploadPosition)

接口描述
每隔15秒上传一次骑手位置经纬度。
接口消息定义
请求地址: /rider/upload-position.json
请求方法: get
请求消息体:


{
  riderId:骑士Id,类型:String
  lat:经纬度,类型:int
  lng:经纬度,类型:int
  imei:设备号,类型:String
  version:版本号,类型:String
  token:token,类型:String
  locationType:定位类型,类型:int
  patchVersion:pacth版本号,类型:String
}

响应消息


{
  status:1,
  data:{ 
    isSelf: 是否是自己登录 1 正常登录 0 非自己登录,类型:int
    notSelfText: 别人登陆后的通知,类型:String
    orderNotifyList:[
      {
        orderId:订单ID,类型:String
        type:通知类型,1 新订单 2 系统取消单 3商家取消单,类型:int
        orderTip:订单提示信息,类型:String
      }
      ],
    updateType:0不需要升级 1正常升级 2强制升级,类型:int
    url:更新下载地址,类型:String
    latestVersion:最新版本号,类型:String
    tips:提示信息,类型:String
    patchUpdateNotify:补丁下发通知,类型:int
    forbiddenNotify:禁用 启用通知,格式:1|提示信息,1 禁用 2启用,类型:String
    lostConnectionNotify:强行休息的通知,类型:String
    serviceTimeStamp:服务器上的时间戳,用于校验接口,类型:long
  },
  msg:提示信息,类型:String 状态值为1的时候此字段为空
  errorCode:错误码,类型:int
}


5. 接收通知反馈接口(receiveNotify)

接口描述
接收通知反馈
接口消息定义
请求地址:/rider/receive-notify.json
请求方法: get
请求消息体:


{
   riderId:用户名,骑士Id,类型:String
   receiveOrderNotify:订单通知,类型:int
   receiveKickImeiNotify:退出登录通知,类型:int
   1-收到
   receiveLostConnectionNotify:掉线通知,类型:int
   receiveForbiddenNotify:禁用及启用通知,类型:int
   receiveOrderIds:接收订单通知ID,类型:String
}

响应消息


{
  status: 1,
  data:””
  msg:“”
}


6. 获取个人中心信息接口(getRiderInfo)

接口描述
获取个人信息。
接口消息定义
请求地址: /rider/get-rider-info
请求方法: post
请求消息体:


{
  riderId:骑士Id
}

响应消息


{
  status: 1,
  data:{
    riderStatus:骑手状态,类型:int
        0:休息中 5:工作中 99:禁用
    forbiddenReason:禁用原因,类型:String
    todayIncome:今日收入,类型:String
    finishedOrderNumber:本月完成订单数,类型:String
    riderName:姓名,身份认证填写的姓名,类型:String
    riderMobile:手机号,类型:String
    },
  msg:“”
}


7. 抢单订单列表(robOrderList)

接口描述
抢单列表
接口消息定义
请求地址:/rider/rob-order-list.json
请求方法: get/post
请求消息体:


{
  riderId:骑士Id,类型:int 
  currentPage:当前页,类型:int
  keyWord:搜索关键字,若为空则显示全部,类型:String
  lat:经纬度,类型:int
  lng:经纬度,类型:int
}

响应消息


{
  status: 1,
  data:{
     currentPage:当前页码,类型:int
     pageCount:总页数,类型:int
     riderStatus:骑手状态,类型:int
                0:休息中 5:工作中 99:禁用
     tips:提示文本,类型:String
     btnText:按钮文本,类型:String
        orderList:[{
           id:订单id,类型:String
           income:收入,类型:String
           platformId:渠道ID,类型:number
           platformText:渠道名称,类型:string
           requireTm:要求送达时间,类型:String
           shopName:商家名称,类型:string
           shopAddr:商家地址,类型:string
           shopLat:商家地址纬度,类型:number
           shopLng:商家地址经度,类型:number
           distanceToShop:距你距离,类型:String
           serialId:流水号,类型:String
           customerAddr:客户地址,类型:String
           customerLat:客户地址纬度,类型;int 
           customerLng:客户地址经度,类型:int
           distanceToCustomer:距离,类型:String
           advance:垫付,类型:String
           fetchRequireTm:应取货时间,类型:string
           priceText:餐品金额,类型:String
        }]
  },
  msg:""
}


8. 抢单(grabOrder)

接口描述
口碑订单选择订单页抢单
接口消息定义
请求地址:/rider/grab-order.json
请求方法: get
请求消息体:


{
  riderId:骑士Id,类型:String
  orderId:订单Id,类型:String
  lat:经纬度,类型:int
  lng:经纬度,类型:int
}

响应消息


{
  status: 1,
  data:{
    successText:提示信息,类型:String
  },
  msg:“”
  errorCode:错误码,9002:账号禁用,类型:int
}


9. 未完成订单列表接口(getOrderList

接口描述
通过code获取未完成订单列表信息。
接口消息定义
请求地址: /rider/view-order-list.json
请求方法: post
请求消息体:


{
   riderId: 骑士Id
   lat:经纬度,类型:int
   lng:经纬度,类型:int
}

响应消息


{
  status:1,
  data:{ 
    { 
      riderStatus:骑手状态,类型:int
           0:休息中 5:工作中 99:禁用
      statusText:骑手状态文案,类型:String
      tips:提示文本,类型:String
      btnText:按钮文本,类型:String
      unTerminativeOrderNum:总订单数量,类型:number
      orderList:[
        {
          id:订单id,类型:String
          waybillId:运单号,类型:String
          income:收入,类型:String
          platformId:订单渠道编号,类型:int
          platformText:渠道名称,类型:String
          shopId:商家id,类型:String
          shopName:商家名称,类型:String
          shopAddr:商家发货地址,类型:String
          shopLat:商家地址纬度,类型:number
          shopLng:商家地址经度,类型:number
          serialId:流水号,类型:String
          customerName:客户名,类型:String
          customerMobile:客户手机号,类型:String 
          customerAddr:客户地址,类型:String
          customerLat:客户地址纬度,类型;int 
          customerLng:客户地址经度,类型:int
          distanceToShop:到商家的距离,类型:String
          distanceToCustomer:距离,类型:String
          requireTm:要求送达时间,标签显示,类型:String
          requireTmExt:应完成时间详细(根据订单状态取应到店、应送达),类型:String,格式:2017-05-25 18:00:00
          serviceTm:服务器当前时间,类型:String
          fetchRequireTm:要求取货时间,类型:String
          btnValue:按钮状态, 5:我已到店 10:录入新订单 15:还有订单未拍小票 20:离店配送 25:配送中 11:选择订单,类型:int
          btnText:按钮状态文案,类型:String
          status:订单状态,5:已派单 10:到店 15:已取单 98:异常 99:已取消 100:已完成,类型:int
          cancelBtnValue:取消订单按钮状态,0-无配置,1-取消订单,2-无法配送,类型:int
    cancelBtnText:取消订单按钮显示字样,类型:String
    payStatusLabel:线下支付标签文案,类型:String
    remainDeliveryTime:应送达时间倒计时,类型:int
    remainFetchTime:要求取货时间倒计时,类型:int
        }
      ] 
    }
  },
  msg:提示信息,类型:String 状态值为1的时候此字段为空
  errorCode:错误码,9002:账号禁用,类型:int
}


10. 开始接单(startWork)

接口描述
开始接单
接口消息定义
请求地址: /rider/come-to-work.json
请求方法: post
请求消息体:


{
  riderId: 骑士Id
  lat:经纬度,类型:int
  lng:经纬度,类型:int
}

响应消息


{
  status : 请求成功标志,1 成功 0 失败, 类型 : number
  data: {
    statusText:工作状态文案,类型:String
  }
  msg:错误提示信息,如没有,则为空,类型:String
  errorCode:错误码, 9002:账号禁用 类型:int
}


11. 停止接单(goOffWork)

接口描述
停止接单,下班
接口消息定义
请求地址: /rider/come-off-work.json
请求方法: post
请求消息体:


{
  riderId: 骑士Id
  lat:经纬度,类型:int
  lng:经纬度,类型:int
}

响应消息


{
   status : 请求成功标志,1 成功 0 失败, 类型 : number
   data:提示信息
   msg:错误提示信息,如没有,则为空,类型:String
}


12. 订单详细信息获取接口(viewOrderDetail)

接口描述
通过订单id获取订单详细信息。
接口消息定义
请求地址: /rider/view-order-detail.json
请求方法: post
请求消息体:


{
  riderId:骑士Id
  orderId:订单号 类型:String
  waybillId:运单号(可选),类型:String
  lat:当前骑手所在位置的纬度,类型:int
  lng:当前骑手所在位置的经度,类型:int
}

响应消息


{
  status: 1,
  data:{
    id:订单ID ,类型:String
    shopId:商家id,类型:number
    shopName:发货用户名,类型:String
    platformId:渠道ID,类型:int
    platformName:渠道名称,类型:String
    shopAddr:发货地址,类型:String
    shopLat:商家纬度,类型:int
    shopLng:商家经度,类型:int
    distanceToShop:骑手到商家的距离,类型:String
    customerAddr:收货地址,类型:String
    customerLat:用户纬度,类型:int
    customerLng:用户经度,类型:int
    distanceToCustomer:商家到客人的距离,类型:String
    requireTm:应送达时间,类型:String
    fetchRequireTm:应取货时间,类型:String
    advance:垫付,类型:String
    collection:代收,类型:String
    goodsMoney:餐品金额,类型:string
    weight:重量,类型:String
    remark:备注,类型:String
    predictIncome:预计收入,类型:String
    shopTel: 发货电话,类型:String
    customerTel:收货人联系方式,类型:String
    dispatchTm:派单时间,类型:String
    arriveTm:到店时间,类型:String
    fetchTm:取货时间,类型String
    leaveTm:离店时间,类型:String
    finishTm:完成时间,类型:String
    cancelTm:取消时间,类型:String
    incomeInfo:{
      incomeMsg:收入提示文案,类型:String
      totalIncome:收入总计,类型:String
      incomeList:[{
        name:收入名称,类型:String
        income:收入金额,类型:String
        incomeDetailList:[{
          name:名称,类型:String
          income:收入金额,类型:String
          incomeText:收入名称,类型:String
        }]
      }]
    }
    status: 订单状态 5:已派单 10:到店 15:已取单 98:异常 99:已取消 100:已完成,类型:int
    btnText:按钮显示字样,类型:String
    btnValue:按钮状态, 5:我已到店 10:录入新订单 15:还有订单未拍小票 20:离店配送 25:配送中 11:选择订单,类型:int
    cancelBtnValue:取消订单按钮状态,0-无配置,1-取消订单,2-无法配送,类型:int
    cancelBtnText:取消订单按钮显示字样,类型:String
    distanceToDestination:骑手到目的地的距离文案,类型:String
    hasArrived:是否已经到店,类型:boolean
    timeout:是否超时,1 已超时 类型:int
    arriveTmTips:到店是否超时提示,类型String
    deliveryTmTips:送达是否超时提示,类型String
  },
  msg:“”
}


13. 到店接口(arriveShop)

接口描述
我已到店
接口消息定义
请求地址:/rider/arrive-shop.json
请求方法: get
请求消息体:


{
  riderId:骑士Id,类型:String
  shopId:商家ID,类型:String
  orderId: 订单号id 类型:String
  lat:经纬度,类型:int
  lng:经纬度,类型:int
}

响应消息


{
  status: 1,
  data:{
    successText:提示文案,类型:String
    successId:到店成功ID,类型:String
  }
  msg:“”
}

14. 取餐离店接口(obtainGood)

接口描述
取得餐品调用该接口。
接口消息定义
请求地址: /rider/obtain-good.json
请求方法: post
请求消息体:


{
  riderId:骑士ID
  lat:经纬度,类型:int
  lng:经纬度,类型:int
  shopId:商家ID,类型:String
  orderId: 订单号id 类型:String
}

响应消息


{
  status: 1,
  data:{
    successText:提示信息,类型:String
    successId:离店成功订单id,类型:string
  },
  msg:””
}


15. 完成订单接口(finishOrder)

接口描述
完成订单调用该接口。
接口消息定义
请求地址: /rider/finish-order
请求方法: post
请求消息体:


{
  riderId:骑士Id,类型:String   
  orderId: 订单号id 类型:String
  lat:骑手位置纬度,类型:int
  lng:骑手位置经度,类型:int
}

响应消息


{
  status: 1,
  data:{
    successText:提示信息,类型:String
  },
  msg: ""
}


16. 历史订单列表接口(getOrderHisList)

接口描述
通过code获取未完成订单列表信息。
接口消息定义
请求地址: /rider/view-orderhis-list.json
请求方法: post
请求消息体:


{
  riderId:骑士Id,类型:String
  currentPage:当前页,类型:int
  today:订单类型,0 今日订单 1历史订单,类型:int
}

响应消息


{
  status:1,
  data:{ 
    todayTotal:今日订单数量,类型:int
    historyTotal:历史订单数量,类型:int
    pagination:{
      currentPage:当前页码,类型:int
      pageCount,总页数,类型:int
      list:[
        {
          id:订单id,类型:String
          income:收入,类型:String
          customerAddr:客户地址,类型:String
          distanceToCustomer:距离,类型:String
          status:订单状态,类型:String
          shopName:商家名,类型:String
          shopAddr:商家地址:类型:String
          platformLabel:渠道标签,类型:String
          waybillId:运单号,类型:String
        }
        ]
    },
  },
  msg:提示信息,类型:String 状态值为1的时候此字段为空
}


17. 查询骑手账户详情接口(queryTotalDetail)

接口描述
查询骑手账户中心
接口消息定义
请求地址:/rider/view-account-center.json
请求方法: post
请求消息体:


{
  riderId:骑士Id,类型:String
}

响应消息


{
  status: 1,
  data:{
    monthlyIncome:当月收入(元),类型:double
    incomeList:[
    {
        name:费用名称(配送费),类型:String
        income:费用金额(元),类型:double
    }
    ]
    monthlyExpense:本月支出(元),类型:double
    expenseList:[
    {
        name:费用名称(超时扣款,取消扣款),类型:String
        income:费用金额(元),类型:double
    }
    ]
  },
  msg:“”
}


18. 交易列表接口(getTradeList)

接口描述
获取交易明细接口。
接口消息定义
请求地址: /rider/get-balance-log.json
请求方法: post
请求消息体:


{
  riderId:骑士Id
  currentPage:当前页,类型:number
}

响应消息


{
  status: 1,
  data:{
    currentPage:当前页码,类型:int
    pageCount,总页数,类型:int
    list:[
      {
        tradeId:交易Id,类型:String
        tradeMoney:交易金额,类型:String
        tradeType:交易类型,类型:String 1收入 -1支出
        tradeName:交易名称,类型:String
        tradeTime:交易时间,类型:String
        tradeNumber:订单编号,类型:String
        tradeDate:交易日期,“今日\r\n13:00”,类型:String
       },
        ]
  },
  msg:””
}


19. 交易详情(queryTradeDetail)

接口描述
交易详情
接口消息定义
请求地址:/rider/get-balance-detail.json
请求方法: get
请求消息体:


{
  riderId:骑士Id,类型:String
  tradeId:交易Id,类型:String
}

响应消息


{
  status: 1,
  data:{
    cost:金额("+20"或者“-40”),类型:String 
    desc:交易名(如 取消订单扣款),类型:String
    orderId:订单号,类型:String
    shopName:商家名,类型:String
    applyTime:时间,类型:String
    waybillId:运单号,类型:String
  },
  msg:“”
}


20. 取消订单扣罚查询接口(getCancelOrderPunish)

接口描述
订单取消前,查询扣罚金额
接口消息定义
请求地址:/rider/get-cancel-order-punish.json
请求方法: get
请求消息体:


{
  riderId:骑士Id,类型:String
  orderId:订单ID,类型:String
  lat:经纬度,类型:int
  lng:经纬度,类型:int
}

响应消息


{
  status: 1,
  data:{
    penaltyAmount:处罚金额(元),类型:double
    penaltyTip:处罚提示文案,类型:String
  }
  msg:“”
}


21. 取消订单接口(cancelOrder)

接口描述
取消订单
接口消息定义
请求地址:/rider/cancel-order.json
请求方法: get
请求消息体:


{
  riderId:骑士Id,类型:String
  orderId:订单ID,类型:String
  lat:经纬度,类型:int
  lng:经纬度,类型:int
  cancelReason:取消类型, (49 取消订单 50 客人拒收 51 联系不到客人),类型:int
  penaltyAmount:罚金,类型:double
}

响应消息


{
  status: 1,
  data:{
    successText:提示文案,类型:String
  }
  msg:“”
}


22. 退出登录(logout)

接口描述
退出登录
接口消息定义
请求地址:/rider/logout.json
请求方法: get
请求消息体:


{
  riderId:骑士Id,类型:String 
  lat:纬度,类型:int
  lng:经度,类型:int
  imei:设备号,类型:String
  version:应用版本号,类型:String
  phoneVersion:手机版本,类型:String
}

响应消息


{
  status: 1,
  data:{
    successText:提示信息,类型:String
  },
  msg:“”
}

----------

23 线路经纬度获取接口(getRoute)

接口描述
获取所有订单经纬度。

接口消息定义
请求地址: /rider/get-route.json
请求方法: post
请求消息体:


{
  riderId:骑士Id,类型:String
}

响应消息


{
  status: 1,
  data:{
    route: [
      { 
        lat:纬度,类型:String 
        lng:经度,类型:String
        type: 用户点10,商家点5,类型:int
        name:商家名或者客人名称,类型:String
        address:地址,类型:String
        isGot:是否已取 0 未取 1 已取,类型:int
        orderId:订单ID,类型:String
      },
    ] 
  },
  msg:” ”
}


加盟商第四期接口修改

####7. 抢单订单列表(robOrderList)
接口描述
抢单列表
抢单列表接口新增备注字段 remarks
接口消息定义
请求地址:/rider/rob-order-list.json
请求方法: get/post
请求消息体:


{
  riderId:骑士Id,类型:int 
  currentPage:当前页,类型:int
  keyWord:搜索关键字,若为空则显示全部,类型:String
  lat:经纬度,类型:int
  lng:经纬度,类型:int
}

响应消息


{
  status: 1,
  data:{
     currentPage:当前页码,类型:int
     pageCount:总页数,类型:int
     riderStatus:骑手状态,类型:int
                0:休息中 5:工作中 99:禁用
     tips:提示文本,类型:String
     btnText:按钮文本,类型:String
        orderList:[{
           id:订单id,类型:String
           income:收入,类型:String
           platformId:渠道ID,类型:number
           platformText:渠道名称,类型:string
           requireTm:要求送达时间,类型:String
           shopName:商家名称,类型:string
           shopAddr:商家地址,类型:string
           shopLat:商家地址纬度,类型:number
           shopLng:商家地址经度,类型:number
           distanceToShop:距你距离,类型:String
           serialId:流水号,类型:String
           customerAddr:客户地址,类型:String
           customerLat:客户地址纬度,类型;int 
           customerLng:客户地址经度,类型:int
           distanceToCustomer:距离,类型:String
           advance:垫付,类型:String
           fetchRequireTm:应取货时间,类型:string
           priceText:餐品金额,类型:String
           remarks:备注,类型:String
        }]
  },
  msg:""
}

9. 未完成订单列表接口(getOrderList

接口描述
通过code获取未完成订单列表信息。
未完成订单列表接口新增备注字段 remarks
接口消息定义
请求地址: /rider/view-order-list.json
请求方法: post
请求消息体:


{
   riderId: 骑士Id
   lat:经纬度,类型:int
   lng:经纬度,类型:int
}

响应消息


{
  status:1,
  data:{ 
    { 
      riderStatus:骑手状态,类型:int
           0:休息中 5:工作中 99:禁用
      statusText:骑手状态文案,类型:String
      tips:提示文本,类型:String
      btnText:按钮文本,类型:String
      unTerminativeOrderNum:总订单数量,类型:number
      orderList:[
        {
          id:订单id,类型:String
          waybillId:运单号,类型:String
          income:收入,类型:String
          platformId:订单渠道编号,类型:int
          platformText:渠道名称,类型:String
          shopId:商家id,类型:String
          shopName:商家名称,类型:String
          shopAddr:商家发货地址,类型:String
          shopLat:商家地址纬度,类型:number
          shopLng:商家地址经度,类型:number
          serialId:流水号,类型:String
          customerName:客户名,类型:String
          customerMobile:客户手机号,类型:String 
          customerAddr:客户地址,类型:String
          customerLat:客户地址纬度,类型;int 
          customerLng:客户地址经度,类型:int
          distanceToShop:到商家的距离,类型:String
          distanceToCustomer:距离,类型:String
          requireTm:要求送达时间,标签显示,类型:String
         requireTmExt:应完成时间详细(根据订单状态取应到店、应送达),类型:String,格式:2017-05-25 18:00:00
          serviceTm:服务器当前时间,类型:String
          fetchRequireTm:要求取货时间,类型:String
          btnValue:按钮状态, 5:我已到店 10:录入新订单 15:还有订单未拍小票 20:离店配送 25:配送中 11:选择订单,类型:int
          btnText:按钮状态文案,类型:String
          status:订单状态,5:已派单 10:到店 15:已取单 98:异常 99:已取消 100:已完成,类型:int
          cancelBtnValue:取消订单按钮状态,0-无配置,1-取消订单,2-无法配送,类型:int
    cancelBtnText:取消订单按钮显示字样,类型:String
    payStatusLabel:线下支付标签文案,类型:String
    remainDeliveryTime:应送达时间倒计时,类型:int
    remainFetchTime:要求取货时间倒计时,类型:int
    remarks:备注,类型String 
        }
      ] 
    }
  },
  msg:提示信息,类型:String 状态值为1的时候此字段为空
  errorCode:错误码,9002:账号禁用,类型:int
}

12. 订单详细信息获取接口(viewOrderDetail)

接口描述
通过订单id获取订单详细信息。
订单详情新增流水号字段 serialId
订单备注字段修改 remark->remarks
接口消息定义
请求地址: /rider/view-order-detail.json
请求方法: post
请求消息体:


{
  riderId:骑士Id
  orderId:订单号 类型:String
  waybillId:运单号(可选),类型:String
  lat:当前骑手所在位置的纬度,类型:int
  lng:当前骑手所在位置的经度,类型:int
}

响应消息


{
  status: 1,
  data:{
    id:订单ID ,类型:String
    shopId:商家id,类型:number
    shopName:发货用户名,类型:String
    platformId:渠道ID,类型:int
    platformName:渠道名称,类型:String
    shopAddr:发货地址,类型:String
    shopLat:商家纬度,类型:int
    shopLng:商家经度,类型:int
    serialId: 流水号,类型:String
    distanceToShop:骑手到商家的距离,类型:String
    customerAddr:收货地址,类型:String
    customerLat:用户纬度,类型:int
    customerLng:用户经度,类型:int
    distanceToCustomer:商家到客人的距离,类型:String
    requireTm:应送达时间,类型:String
    fetchRequireTm:应取货时间,类型:String
    advance:垫付,类型:String
    collection:代收,类型:String
    goodsMoney:餐品金额,类型:string
    weight:重量,类型:String
    remarks:备注,类型:String
    predictIncome:预计收入,类型:String
    shopTel: 发货电话,类型:String
    customerTel:收货人联系方式,类型:String
    dispatchTm:派单时间,类型:String
    arriveTm:到店时间,类型:String
    fetchTm:取货时间,类型String
    leaveTm:离店时间,类型:String
    finishTm:完成时间,类型:String
    cancelTm:取消时间,类型:String
    incomeInfo:{
      incomeMsg:收入提示文案,类型:String
      totalIncome:收入总计,类型:String
      incomeList:[{
        name:收入名称,类型:String
        income:收入金额,类型:String
        incomeDetailList:[{
          name:名称,类型:String
          income:收入金额,类型:String
          incomeText:收入名称,类型:String
        }]
      }]
    }
    status: 订单状态 5:已派单 10:到店 15:已取单 98:异常 99:已取消 100:已完成,类型:int
    btnText:按钮显示字样,类型:String
    btnValue:按钮状态, 5:我已到店 10:录入新订单 15:还有订单未拍小票 20:离店配送 25:配送中 11:选择订单,类型:int
    cancelBtnValue:取消订单按钮状态,0-无配置,1-取消订单,2-无法配送,类型:int
    cancelBtnText:取消订单按钮显示字样,类型:String
    distanceToDestination:骑手到目的地的距离文案,类型:String
    hasArrived:是否已经到店,类型:boolean
    timeout:是否超时,1 已超时 类型:int
    arriveTmTips:到店是否超时提示,类型String
    deliveryTmTips:送达是否超时提示,类型String
  },
  msg:“”
}

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注