title: 新增配送订单

新增配送订单进行配送

描述

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

接口说明

授权对象 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
预计送达时间	estimate_arrival_at	uint64	是	1697077522
预计取件时间	expect_time	uint64	是	1697077522
回调参数	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"
  }
}