【星巴克】订单提交
<table>
<thead>
<tr>
<th style="text-align: left;">头部</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">identification</td>
<td style="text-align: left;">String</td>
<td>access_token</td>
</tr>
</tbody>
</table>
<h5>简要描述</h5>
<ul>
<li>星巴克提交订单
<blockquote>
<p>注意：当前星巴克生态条件下，仅支持单杯出餐，即一次出一杯饮品；当开发者平台一个订单中提交了多杯饮品时，彩豚云星爸爸代下服务会将多杯饮品拆分成多个订单，分开出单，以回调通知的方式通知开发者服务器；所以，推荐开发者提交订单时，使用out_trade_no来唯一标记订单和订单中的饮品项目</p>
</blockquote></li>
</ul>
<h5>同步提交接口</h5>
<ul>
<li><code>https://v3.qiangrenwl.com/v3.0/api/order/starbucks/commit/sync</code></li>
</ul>
<h4>请求类型：</h4>
<ul>
<li>application/json;charset=utf-8</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>电话号码</td>
</tr>
<tr>
<td style="text-align: left;">store_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>店铺ID</td>
</tr>
<tr>
<td style="text-align: left;">note</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>备注，除开配置的其他说明</td>
</tr>
<tr>
<td style="text-align: left;">out_trade_no</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开发者平台订单id（唯一）</td>
</tr>
<tr>
<td style="text-align: left;">items</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>购买的商品列表，一个订单中可包含多个商品</td>
</tr>
</tbody>
</table>
<h5>items参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">goods_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>饮品ID</td>
</tr>
<tr>
<td style="text-align: left;">out_trade_no</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单项目的开发者外联id</td>
</tr>
<tr>
<td style="text-align: left;">conf_list</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Object</td>
<td>配置对象</td>
</tr>
</tbody>
</table>
<h5>conf_list参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Cupsize_key</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>杯型+温度参数，取值方式在饮品详情中查看（Tip: Cupsize_key首字母大写）</td>
</tr>
<tr>
<td style="text-align: left;">extra_list</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>杯型温度选项中的extra_list选中的对象，开发者可直接将客户选中的对象提交</td>
</tr>
</tbody>
</table>
<h5>参数提交请求示例</h5>
<pre><code class="language-json">{
"store_id": "1137", // 下单店铺id
"phone": "18888888888",
"note": "订单备注",
"out_trade_no": "xxxxxxxxx", // 必须 订单提交的唯一订单号
"items": [
{
"goods_id": "135262877075374652", // 必须 商品id
"out_trade_no": "xxxxxxxxxxx", // 必须 开发者平台的自定义订单号，需要唯一
"conf": { // 饮品配置
"Cupsize_key": "Tall_Hot", // 规则：杯型选中项的attribute+_+温度选中项的attribute
"extra_list": [ // 详细查看商品详情中获取的配置，标有必须的是必须填的
{
"code": "6200007", // 必须
"conf_key": "Temperature", // 必须
"repurchase": 0,
"is_default": 0,
"type": "extra",
"sequence": 9,
"hide": 0,
"price": 3800, // 单位：分
"name": "特别热", // 必须
"must": 0,
"attribute": "Hot", // 必须
"id": "135262880973980178", // 必须
"status": 2
},
{
"code": "Tall", // 必须
"conf_key": "Cupsize", // 必须
"description": "355ml",
"is_default": 0,
"type": "basic",
"pic_name": "tall.png",
"sequence": 1,
"pic_name_selected": "tall_selected.png",
"price": 0,
"name": "中杯",
"attribute": "Tall", // 必须
"id": "",
"pic_url": "",
"status": 2
}
]
}
}
]
}</code></pre>
<h5>返回示例</h5>
<pre><code class="language-json">{
"msg": "订单提交成功",
"code": 200,
"data": {
"note": "订单备注",
"createTime": "2022-02-25 15:22:06",
"price": 30.0,
"payPrice": 25.6, // 扣款金额
"outTradeNo": "xxxxxxxx", // 订单号
"id": "1645773726172577934219837442",
"storeId": "1137",
"items": [
{
"shop": {
"end_working_time": "21:00:00",
"address": "浙江省海宁市长安镇农发区启潮路199号",
"lng": "120.383884",
"city": "嘉兴市",
"cover": "",
"province": "浙江省嘉兴市",
"isBusiness": true,
"pretime": "结束营业",
"intro": "",
"name": "浙江奥特莱斯店",
"tel": "",
"id": "1137",
"start_working_time": "09:00:00",
"postal_code": "310000",
"lat": "30.345662"
},
"Cupsize_key": "Tall_Hot",
"originalPrice": "30.00",
"goodsId": "135262877075374652",
"num": 1, // 数量
"shopName": "浙江奥特莱斯店",
"updateTime": "2022-02-25 15:22:05",
"conf": { // 配置
"original_price": 30.0,
"spec_sku": "1112102",
"Cupsize_key": "Tall_Hot",
"add_extra": [
{
"extra_sku": "6200007",
"qty": 1,
"name": "特别热",
"id": "135262880973980178"
}
],
"spec_id": "135262877076423231",
"price": 25.6,
"spec_text": [
"特别热",
"中杯"
],
"qty": 1,
"id": "135262877075374652"
},
"specSku": "1112102",
"shopAddress": "浙江省海宁市长安镇农发区启潮路199号",
"cover": "https://pcmd.starbucks.com.cn/MopPics/202012/51-MOPCatalog-0-342x324-zh.png?resize=p_4,w_273&image_process=image/resize,w_273",
"phone": "18888888888", // 下单手机
"createTime": "2022-02-25 15:22:06",
"price": 30.0,
"payPrice": 25.6,
"outTradeNo": "xxxxxxxx",
"statusText": "待支付",
"goodsTitle": "卡布奇诺",
"id": "6172577935981608960",// 彩豚云订单项目id
"shopId": "1137",
"specText": "[\"特别热\",\"中杯\"]",
"status": 1
}
]
}
}</code></pre>
<h5>异步提交接口</h5>
<ul>
<li><code>https://v3.qiangrenwl.com/v3.0/api/order/starbucks/commit</code></li>
</ul>
<blockquote>
<p>此接口为异步的提交订单接口，优势是处理极快，提交参数与同步提交接口一致；提交订单不立即返回提交结果，而是通过开发者配置的回调地址通知订单处理结果</p>
</blockquote>