新增配送订单进行配送 #

描述 #

使用此接口新增配送订单进行配送。

接口说明 #

授权对象 APP

请求地址 POST /open/order/order

请求规则 请查阅开发必读

请求参数 #

参数名称 变量名称 参数类型[长度限制] 是否必填 描述
商品列表 goods []object body
商户信息 merchant object body
收件人 receive object body
平台商户ID merchant_id uint32 body在系统后台获取。

示例值:1

对接订单号 order_number string[1,64] body即对接平台的订单号,用于唯一标识订单。

示例值:2022082812341234

取货码 code string[1,64] body即对接平台的取货码不传不显示给配送员。

示例值:2022082812341234

期望送达时间 scheduled_time int64 body时间戳

示例值:1660134369

期望取餐时间 expect_time int64 body时间戳

示例值:1660134369

是否预约单 is_reserve int8 body0:即时单,1:预约单。

示例值:1

重量 weight uint32 body单位:克

示例值:600

数量 quantity uint32 body商品数量。

示例值:1

本地短订单号 day_num uint32 body商户订单号,一般为当日订单号。会显示为#1。

示例值:1

来源描述 source_desc string[1,64] body平台名称,可自定义。

示例值:美团

取货码 code uint32 body骑手可通过取货码查询订单。

示例值:100001

备注 remark string[1,256] body订单备注

示例值:十万火急

回调链接 callback_url string[1,256] body

示例值:https://api.boolc.cn/notify/open/delivery

回调参数 callback_scene string[1,256] body回传参数,传什么内容皆会在回调时返回同样的数据。

商品列表 goods #

参数名称 变量名称 参数类型[长度限制] 是否必填 描述
商品名称 title string[1, 64]

示例值:包子

数量 num uint32

示例值:1

重量 weight uint32 单位:克

示例值:100

价格 price double

示例值:5.1

商户信息 merchant #

参数名称 变量名称 参数类型[长度限制] 是否必填 描述
店铺名称 title string[1,64]

示例值:BOOL商店

联系方式 mobile int64

示例值:18866668888

店铺地址 address string[1,256]

示例值:贵州省贵安新区数字经济产业园

经度 lng double 精确到后6位

示例值:109.110275

纬度 lat double 精确到后6位

示例值:21.443884

收件人信息 receive #

参数名称 变量名称 参数类型[长度限制] 是否必填 描述
收件人 username string[1,64]

示例值:BOOL

联系方式 mobile int64

示例值:18888888888

收件地址 address string[1,256]

示例值:贵州省花溪区贵州大学东校区10栋

经度 lng double 精确到后6位

示例值:109.110275

纬度 lat double 精确到后6位

示例值:21.443884

请求示例 #

{
  "duration": 60,
  "goods": [
    {
      "title": "包子",
      "num": 1,
      "price": 5.1,
      "weight": 100
    }
  ],
  "order_detail": {
    "total_price": 6,
    "delivery_money": 1
  },
  "receive": {
    "username": "BOOL",
    "mobile": "18888888888",
    "lng": 109.110275,
    "lat": 21.443884,
    "address": "贵州省花溪区贵州大学东校区10栋"
  },
  "merchant": {
    "title": "BOOL商店",
    "mobile": "18866668888",
    "lng": 109.110275,
    "lat": 21.443884,
    "address": "贵州省贵安新区数字经济产业园"
  },
  "expect_time": 1660134369,
  "order_number": "2022082812341234",
  "day_num": 1,
  "scheduled_time": 1660134999,
  "is_reserve": 2,
  "weight": 100,
  "quantity": 1,
  "merchant_id": 1,
  "source_desc": "美团",
  "code": "100001",
  "remark": "十万火急"
}

响应结果 #

参数名称 变量名称 参数类型[长度限制] 是否必填 描述
配送费 fee double
对接订单号 order_number string[1,64]
平台订单号 transaction_id string[1,64] 配送订单号,平台内唯一标识此配送订单。

响应示例 #

> 200 Response
{
  "code": 20000,
  "msg": "success",
  "data": {
    "fee": 5.1,
    "order_number": "2022082812341234",
    "transaction_id": "2022082818035691363043"
  }
}
上次更新: 8/14/2023, 2:33:46 PM