提交订单接口
<p><strong>简要描述：</strong></p>
<ul>
<li>提交订单共有4种方式：快递配送、门店自提、商家自配送、相同配规合并下单，详细请见order_data参数示例</li>
</ul>
<p><strong>请求URL：</strong></p>
<ul>
<li><code>/dsapi/order/submit_order</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST【multipart/form-data】</li>
</ul>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=8f7d96e6f1c5079b0a034bb3e03d3833&amp;file=file.png" alt="" /></p>
<p><strong>order_data参数示例1 快递配送</strong></p>
<pre><code>{
&quot;out_order_no&quot;:&quot;20022610311234561&quot;,
&quot;addr&quot;:{
&quot;id&quot;:&quot;839296&quot;,
&quot;name&quot;:&quot;张生&quot;,
&quot;phone&quot;:&quot;180322*****&quot;,
&quot;detail&quot;:&quot;广东省深圳市南山区大冲&quot;
},
&quot;rule_ids&quot;:&quot;4437&quot;,
&quot;spec_ids&quot;:&quot;9509&quot;,
&quot;quantitys&quot;:&quot;3&quot;,
&quot;tastes_name&quot;:&quot;冰淇淋&quot; (此为商品有口味时候的附加传参,非必传)
&quot;group&quot;:{
&quot;4437&quot;:{
&quot;ship_type&quot;:&quot;same&quot;,
&quot;ship_date&quot;:false,
&quot;ship_time_text&quot;:&quot;下单后24小时发货，请耐心等候&quot;
}
},
&quot;pay_type&quot;:&quot;channel_no的值&quot;,
&quot;buyer_phone&quot;:&quot;180322*****&quot;,
&quot;user_id&quot;:&quot;8290532&quot;,
&quot;city_id&quot;:&quot;112&quot;,
&quot;buyer_msg&quot;:&quot;请尽快送达&quot;
}</code></pre>
<p><strong>order_data参数示例2 门店自提</strong></p>
<pre><code>{
&quot;out_order_no&quot;:&quot;20022610311234561&quot;,
&quot;addr&quot;:{
&quot;id&quot;:&quot;839296&quot;,
&quot;name&quot;:&quot;张生&quot;,
&quot;phone&quot;:&quot;180322*****&quot;,
&quot;detail&quot;:&quot;广东省深圳市南山区大冲&quot;
},
&quot;rule_ids&quot;:&quot;4796&quot;,
&quot;spec_ids&quot;:&quot;140933&quot;,
&quot;quantitys&quot;:&quot;2&quot;,
&quot;charge_ids&quot;:&quot;5983-5984&quot;,
&quot;cquantitys&quot;:&quot;1-1&quot;,
&quot;group&quot;:{
&quot;4796&quot;:{
&quot;ship_type&quot;:&quot;shop&quot;,
&quot;ship_date&quot;:&quot;2020-11-04&quot;,
&quot;ship_time_text&quot;:&quot;11:00-12:00&quot;,
&quot;shop&quot;:{
&quot;id&quot;:&quot;1119523&quot;,
&quot;name&quot;:&quot;太平门店&quot;,
&quot;detail&quot;:&quot;南京市太平门街10号2幢（太平花园旁）&quot;
}
}
},
&quot;pay_type&quot;:&quot;channel_no的值&quot;,
&quot;buyer_phone&quot;:&quot;180322*****&quot;,
&quot;user_id&quot;:&quot;8290532&quot;,
&quot;city_id&quot;:&quot;112&quot;,
&quot;buyer_msg&quot;:&quot;请尽快送达&quot;
}
</code></pre>
<p><strong>order_data参数示例3 商家自配送</strong></p>
<pre><code>{
&quot;out_order_no&quot;:&quot;20022610311234561&quot;,
&quot;addr&quot;:{
&quot;id&quot;:&quot;839296&quot;,
&quot;name&quot;:&quot;张生&quot;,
&quot;phone&quot;:&quot;180322*****&quot;,
&quot;detail&quot;:&quot;广东省深圳市南山区大冲&quot;
},
&quot;rule_ids&quot;:&quot;4129&quot;,
&quot;spec_ids&quot;:&quot;9509&quot;,
&quot;quantitys&quot;:&quot;3&quot;,
&quot;charge_ids&quot;:&quot;5983-5984&quot;,
&quot;cquantitys&quot;:&quot;1-1&quot;,
&quot;group&quot;:{
&quot;4129&quot;:{
&quot;ship_type&quot;:&quot;delivery&quot;,
&quot;ship_date&quot;:&quot;2020-11-01&quot;,
&quot;ship_time_text&quot;:&quot;10:00-14:00&quot;
}
},
&quot;pay_type&quot;:&quot;channel_no的值&quot;,
&quot;buyer_phone&quot;:&quot;180322*****&quot;,
&quot;user_id&quot;:&quot;8290532&quot;,
&quot;city_id&quot;:&quot;112&quot;,
&quot;buyer_msg&quot;:&quot;请尽快送达&quot;
}</code></pre>
<p><strong>order_data参数示例4 当有多个配规相同的商品一块提交(仅限配规(rule_id)相同的商品)</strong></p>
<pre><code>{
&quot;out_order_no&quot;:&quot;20022610311234561&quot;,
&quot;addr&quot;:{
&quot;id&quot;:&quot;839296&quot;,
&quot;name&quot;:&quot;张生&quot;,
&quot;phone&quot;:&quot;180322*****&quot;,
&quot;detail&quot;:&quot;广东省深圳市南山区大冲&quot;
},
&quot;rule_ids&quot;:&quot;3306,3306,3306&quot;,
&quot;spec_ids&quot;:&quot;1154504,1175912,1175880&quot;,
&quot;quantitys&quot;:&quot;1,1,1&quot;,
&quot;charge_ids&quot;:&quot;5983-5984,5789-5687,4578-9897&quot;,
&quot;cquantitys&quot;:&quot;1-1,2-1,1-1&quot;,
&quot;tastes_name&quot;:&quot;冰淇淋,巧克力,香草&quot; (此为商品有口味时候的附加传参,非必传)
&quot;group&quot;:{
&quot;3306&quot;:{
&quot;ship_type&quot;:&quot;same&quot;,
&quot;ship_date&quot;:&quot;0000-00-00&quot;,
&quot;ship_time_text&quot;:&quot;&quot;
}
},
&quot;pay_type&quot;:&quot;channel_no的值&quot;,
&quot;buyer_phone&quot;:&quot;180322*****&quot;,
&quot;user_id&quot;:&quot;4016095&quot;,
&quot;city_id&quot;:&quot;2&quot;,
&quot;buyer_msg&quot;:&quot;&quot;
}
</code></pre>
<p><strong>参数：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">示例值</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">order_data</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">{}</td>
<td style="text-align: left;">提交数据</td>
</tr>
<tr>
<td style="text-align: left;">order_data[addr]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">{}</td>
<td style="text-align: left;">地址信息</td>
</tr>
<tr>
<td style="text-align: left;">order_data[addr][id]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">736561</td>
<td style="text-align: left;">地址id</td>
</tr>
<tr>
<td style="text-align: left;">order_data[addr][name]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">张三</td>
<td style="text-align: left;">收货人姓名</td>
</tr>
<tr>
<td style="text-align: left;">order_data[addr][phone]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">18909878765</td>
<td style="text-align: left;">收货人手机号</td>
</tr>
<tr>
<td style="text-align: left;">order_data[addr][detail]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">736561</td>
<td style="text-align: left;">收货地址详情</td>
</tr>
<tr>
<td style="text-align: left;">order_data[group]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">{}</td>
<td style="text-align: left;">配送信息</td>
</tr>
<tr>
<td style="text-align: left;">order_data[group][key]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">3783</td>
<td style="text-align: left;">配送规则id</td>
</tr>
<tr>
<td style="text-align: left;">order_data[group][key][ship_type]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">delivery</td>
<td style="text-align: left;">配送类型：delivery-商家配送(可选择配送时间)，shop-门店自提(可选择配送时间),same-快递(配送规则接口没返回可选配送时间,正常上架状态的商品)</td>
</tr>
<tr>
<td style="text-align: left;">order_data[group][key][ship_date]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">2020-01-11</td>
<td style="text-align: left;">配送日期</td>
</tr>
<tr>
<td style="text-align: left;">order_data[group][key][ship_time_text]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">18:00-20:00</td>
<td style="text-align: left;">配送时间 ,如果没有ship_time_text，请填写配规接口返回的delivery_text的值</td>
</tr>
<tr>
<td style="text-align: left;">order_data[group][key][shop][id]</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">1117019</td>
<td style="text-align: left;">自提门店id</td>
</tr>
<tr>
<td style="text-align: left;">order_data[group][key][shop][name]</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">北京双井店</td>
<td style="text-align: left;">自提门店名称</td>
</tr>
<tr>
<td style="text-align: left;">order_data[group][key][shop][detail]</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">双井富力城小区三期10-08号</td>
<td style="text-align: left;">自提门店地址</td>
</tr>
<tr>
<td style="text-align: left;">order_data[rule_ids]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">3783</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">配送规则id：对应商品详情的distribution_rule_id，优先product数组中取值，若为空，再从brand数组中取值</td>
</tr>
<tr>
<td style="text-align: left;">order_data[spec_ids]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">4553783</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">商品规格id</td>
</tr>
<tr>
<td style="text-align: left;">order_data[quantitys]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">3</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">商品数量</td>
</tr>
<tr>
<td style="text-align: left;">order_data[charge_ids]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">5983</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">附件id</td>
</tr>
<tr>
<td style="text-align: left;">order_data[cquantitys]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">1</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">附件数量</td>
</tr>
<tr>
<td style="text-align: left;">order_data[tastes_name]</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">香草</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">口味名称(口味需和商品规格所在列对应)</td>
</tr>
<tr>
<td style="text-align: left;">order_data[pay_type]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">channel_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">支付方式(固定传参,请传渠道号的值)</td>
</tr>
<tr>
<td style="text-align: left;">order_data[buyer_phone]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">18909878765</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">下单人手机号</td>
</tr>
<tr>
<td style="text-align: left;">order_data[user_id]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">3783</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">蛋叔用户id</td>
</tr>
<tr>
<td style="text-align: left;">order_data[city_id]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">2</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">城市id</td>
</tr>
<tr>
<td style="text-align: left;">order_data[user_money_paid]</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">12.00</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">余额支付</td>
</tr>
<tr>
<td style="text-align: left;">order_data[out_order_no]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">20050234242</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">渠道订单号，防止重复提交</td>
</tr>
<tr>
<td style="text-align: left;">order_data[buyer_msg]</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">尽快配送，谢谢！</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户备注</td>
</tr>
</tbody>
</table>
<p>注解：
只有相同配规ID的商品才可以多个进行提交,rule_id,spec_id和quantity需一一对应。 配规ID不同时,请遍历提交订单信息
配送方式：delivery 商户配送，shop门店自提，same 快递配送
<strong>返回示例</strong></p>
<pre><code>{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;success&quot;,
&quot;data&quot;: {
&quot;cart_id&quot;: 12315,
&quot;order&quot;: {
&quot;id&quot;: 1331585,
&quot;order_no&quot;: &quot;1901435325798&quot;,
&quot;final_amount&quot;: 188,
&quot;ship_amount&quot;: 18,
&quot;order_type&quot;: &quot;1&quot;,
&quot;pay_status&quot;: 0
},
&quot;cart_order_no&quot;: &quot;1901435326431&quot;,
&quot;ship_amount&quot;: 18,
&quot;pay_status&quot;: 0,
&quot;clearing_info&quot;:[
{
&quot;spec_id&quot;:1192780,
&quot;clearing_price&quot;:108.42,
&quot;fee_charge&quot;:4.17,
&quot;fee_charge_floor&quot;:104.25
}
]
}
}</code></pre>
<p>code编码说明：200是代表返回成功；3001代表是商品已下架；3005代表是配送范围超区</p>
<p><strong>返回参数说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">示例值</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">cart_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">164589</td>
<td style="text-align: left;">购物车id</td>
</tr>
<tr>
<td style="text-align: left;">cart_order_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">1901435326431</td>
<td style="text-align: left;">购物车单号</td>
</tr>
<tr>
<td style="text-align: left;">order_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">1901435325798</td>
<td style="text-align: left;">订单号</td>
</tr>
<tr>
<td style="text-align: left;">ship_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">18</td>
<td style="text-align: left;">订单运费金额</td>
</tr>
<tr>
<td style="text-align: left;">pay_status</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">0</td>
<td style="text-align: left;">支付状态：0-待支付，1-已支付</td>
</tr>
<tr>
<td style="text-align: left;">order</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">{}</td>
<td style="text-align: left;">订单信息</td>
</tr>
<tr>
<td style="text-align: left;">order[id]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">1331585</td>
<td style="text-align: left;">订单id</td>
</tr>
<tr>
<td style="text-align: left;">order[order_no]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">1901435325798</td>
<td style="text-align: left;">订单号</td>
</tr>
<tr>
<td style="text-align: left;">order[final_amount]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">188</td>
<td style="text-align: left;">订单支付金额</td>
</tr>
<tr>
<td style="text-align: left;">order[ship_amount]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">18</td>
<td style="text-align: left;">订单运费金额</td>
</tr>
<tr>
<td style="text-align: left;">order[order_type]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">1</td>
<td style="text-align: left;">订单类型：1-蛋糕/其他，2-面包</td>
</tr>
<tr>
<td style="text-align: left;">order[pay_status]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">0</td>
<td style="text-align: left;">支付状态：0-待支付，1-已支付</td>
</tr>
<tr>
<td style="text-align: left;">clearing_info[][spec_id]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">1192780</td>
<td style="text-align: left;">规格id</td>
</tr>
<tr>
<td style="text-align: left;">clearing_info[][clearing_price]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">108.42</td>
<td style="text-align: left;">订单结算价</td>
</tr>
<tr>
<td style="text-align: left;">clearing_info[][fee_charge]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">4.17</td>
<td style="text-align: left;">服务费</td>
</tr>
<tr>
<td style="text-align: left;">clearing_info[][fee_charge_floor]</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">104.25</td>
<td style="text-align: left;">结算低价</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong></p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>