创建合作方订单

说明:58到家用户下单后,开放平台调用合作伙伴接口,创建合作方订单。(如果合作伙伴没有库存概念,则相当于库存不限量)。
请求方式:POST
接口访问路径:由合作伙伴提供

系统级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • nonce
  • String
  • 7F0C70A269E9BE381581117A5D1
  • 随机字符串
  • timestamp
  • String
  • 146318231283
  • 时间戳
  • daojiaJson
  • Object
  • 应用参数Json化后的字符串
  • funId
  • String
  • createOrder
  • 方法识别参数,对于每个接口,值固定,createOrder。

应用级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • orderId
  • Long
  • 31421593368511488
  • 58到家订单号
  • userMobile
  • String
  • 15888888888
  • 联系人手机号
  • cityId
  • Long
  • 1
  • 58到家城市ID
  • cityName
  • String
  • 北京
  • 58到家城市名称
  • lng
  • String
  • String
  • 116.4347631
  • 服务位置经度
  • lat
  • String
  • 40.0119560
  • 服务位置纬度
  • serviceAddress
  • String
  • 桑普大厦
  • 服务详细地址
  • serviceBeginTime
  • String
  • 2015-11-11 10:00:00
  • 预约开始服务时间
  • serviceEndTime
  • String
  • 2015-11-11 11:30:00
  • 预约结束服务时间
  • serviceDuration
  • Float
  • 1.5
  • 服务时长(小时)
  • totalPrice
  • BigDecimal
  • 0.0
  • 订单总价
  • remark
  • String
  • 订单的备注
  • 备注
  • serviceUserId
  • String
  • A007
  • 用户预约的服务人员ID
  • orderDetails
  • Array
  • goodsId
  • String
  • 合作伙伴商品ID
  • goodsNumber
  • Int
  • 商品数量
  • goodsPrice
  • BigDecimal
  • 商品价格

示例:

{
        "nonce":"xxxxxx",
        "timestamp":"12381268386",
        "daojiaSign":"XXXX",
        "funId":"createOrder",
        "daojiaJson":{
         "orderId":" 31421593368511488 ",
         "userMobile":"15888888888"
         "lat":" 1 ",
         "cityName":" 北京 ",
         "lng":" 116.4347631 ",
         "lat":" 40.0119560 ",
         "serviceAddress":" 桑普大厦 ",
         "serviceBeginTime":" 2015-11-11 10:00:00 ",
         "serviceEndTime":" 2015-11-11 11:30:00",
         "serviceDuration":" 1.6 ",
         "totalPrice":" 0.0 ",
         "remark":" 订单的备注 ",
         "serviceUserId":" A007 ",
         "orderDetails":" [
{"goodsId":"1","goodsNumber":1,"goodsPrice":6.6},
{"goodsId":"2","goodsNumber":2,"goodsPrice":8.8}]",
        }
}

返回参数

  • 参数名
  • 类型
  • 示例
  • 描述
  • message
  • String
  • 成功
  • 调用接口返回的信息
  • code
  • Int
  • 0
  • 调用接口结果代码,0成功,1失败
  • data
  • thirdOrderId
  • String
  • 123
  • 合作伙伴订单号
  • isNewUser
  • Int
  • 是否为合作伙伴的新用户,0否,1是。

示例:

{
        "code":"0",
        "message":"创建订单成功!",
        "data":{
        "thirdOrderId":" 123 ",
        "isNewUser":"1"
        }
}

查询合作方订单

说明:合作伙伴提供的查单接口,支持用58到家订单号进行批量查询。在订单未到达终态(终态:订单已完成、订单已取消)时,到家可以调用查询订单接口查询订单状态。批量查询的订单数的上限由合作伙伴根据接口情况提供。
请求方式:POST
接口访问路径:由合作伙伴提供

系统级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • nonce
  • String
  • 7F0C70A269E9BE381581117A5D1
  • 随机字符串
  • timestamp
  • String
  • 146318231283
  • 时间戳
  • daojiaJson
  • Object
  • 应用参数Json化后的字符串
  • funId
  • String
  • getOrders
  • 方法识别参数,对于每个接口,值固定,getOrders。

应用级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • orderIds
  • Array
  • ["31421593368511487","31421593368511488"]
  • 由orderId组成的数组进行json化后的字符串,采用58到家统一订单Id

示例:

{
        "nonce":"xxxxxx",
        "timestamp":"12381268386",
        "daojiaSign":"XXXX",
        "funId":"getOrders",
        "daojiaJson":{
         "orderIds":" [
{"31421593368511487","31421593368511488","31421593368511489"}]"
        }
}

返回参数

  • 参数名
  • 类型
  • 示例
  • 描述
  • message
  • String
  • 成功
  • 调用接口返回的信息
  • code
  • Int
  • 0
  • 调用接口结果代码,0成功,1失败
  • data
  • orderList
  • orderId
  • Long
  • 31421593368511488
  • 58到家订单号。
  • thirdOrderId
  • String
  • 123
  • 合作伙伴订单号
  • orderStatus
  • Int
  • 20
  • 订单状态 10:预约中 20:已接单 30:待支付 40:已支付 50:服务中 60:已完成 70:已取消
  • updateTime
  • String
  • 2015-11-27 16:03:12
  • 订单信息更新时间
  • serviceUserName
  • String
  • 张XX
  • 服务人员姓名
  • serviceUserPhone
  • String
  • 15888888888
  • 服务人员电话
  • deliveryUserName
  • String
  • 李XX
  • 物流人员姓名
  • deliveryUserPhone
  • String
  • 18511111111
  • 物流人员电话
  • serviceDuration
  • Float
  • 1.5
  • 服务时长(小时)
  • totalPrice
  • BigDecimal
  • 1.5
  • 订单总价
  • params
  • String
  • 扩展字段(json格式)
  • orderDetails
  • goodsId
  • String
  • 合作伙伴商品ID
  • goodsName
  • String
  • 商品名称
  • goodsNumber
  • Int
  • 商品数量
  • remark
  • String
  • 商品备注
  • goodsPrice
  • BigDecimal
  • 商品价格
  • goodsPic
  • String
  • 商品图片

示例:

{
"code": 0,
"message": "查询订单成功!",
"data": {
        "orderList":"[,
        {
                  "orderId":31421593368511488,
                  "thirdOrderId":"123",
                  "orderStatus":20,
                  "updateTime":"2015-11-27 16:03:12",
                  "serviceUserName":"张XX",
                  "serviceUserPhone":"15888888888",
                  "deliveryUserName":"李XX",
                  "deliveryUserPhone":"15888888888",
                  "serviceDuration":1.5,
                  "totalPrice":0.0,
                  "params":"全是帽子",
                  "orderDetails":[{
                  "goodsId":"123",
                  "goodsName":"商品名称",
                  "goodsNumber":2,
                  "remark":"商品备注",
                  "goodsPrice":0.0,
                  "goodsPic”:”http://***********/****/****/pic.jgp"
}]"
}]"
}
}

取消订单

说明:用户在开放平台取消订单后,调用合作伙伴接口通知订单取消。
请求方式:POST
接口访问路径:由合作伙伴提供

系统级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • nonce
  • String
  • 7F0C70A269E9BE381581117A5D1
  • 随机字符串
  • timestamp
  • String
  • 146318231283
  • 时间戳
  • daojiaJson
  • Object
  • 应用参数Json化后的字符串
  • funId
  • String
  • cancelOrder
  • 方法识别参数,对于每个接口,值固定,cancelOrder。

应用级别参数

  • 参数名
  • 类型
  • 是否必填
  • 示例
  • 描述
  • orderId
  • Long
  • 31421593368511488
  • 58到家订单号

示例:

{
        "nonce":"xxxxxx",
        "timestamp":"12381268386",
        "daojiaSign":"XXXX",
        "funId":"cancelOrder",
        "daojiaJson":{
         "orderId":" 31421593368511488 ",
        }
}

返回参数

  • 参数名
  • 类型
  • 示例
  • 描述
  • message
  • String
  • 成功
  • 调用接口返回的信息
  • code
  • Int
  • 0
  • 调用接口结果代码,0成功,1失败
  • data

示例:

{
        "code":"0",
        "message":"取消订单成功!",
        "data":{}
}


示例2--daojiaSign:
合作方通过校验daojiasign,来识别是否来自到家开放平台的请求。加密/校验流程如下:
1. 将Token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行MD5加密
3. 开发者获得加密后的字符串可与daojiasign对比,标识该请求来自到家开放平台。

感谢您完成信息认证,
现在可以直接去创建应用啦!

创建应用

©2015 Daojia.com 58到家版权所有 津ICP备15004920号