多货源地批量下单
<p><strong>简要描述：</strong> </p>
<ul>
<li><strong>注意：提交该API的参数，必须同货源地的数据为一组，归类好！</strong>
-调用该下单API，请确保提交的OrderDetailAddRequestJson参数中的 OrderDetailAddRequest的数据都已经根据货源地归类好了，不然会报 <strong>ERROR_PRODUCT_MUTIL_AREA</strong> 错误，错误含义为 订单含多货源地商品！请检查参数【OrderDetailList或ShoppingCartIds】，可能提交了多个货源地产品,下单的其他错误，请参考<strong>订单错误码说明</strong>：</li>
<li>下单前，<strong>推荐</strong> 先 访问 <a href="https://www.showdoc.cc/230407611622153?page_id=1341667324456177" title="点击查看下单汇总信息API文档">[1]下单汇总信息API</a>， 拿到根据 产品货源地 归类后的下单信息；并且相应的货源地汇总下单信息只能用于该货源地产品，比如 杭州的下单参数只能给杭州的产品用，若杭州的下单参数给广州的产品用，会报错；</li>
<li>一个货源地就一个OrderDetailAddRequest</li>
<li>OrderDetailAddRequest 其实就是一个 完整的 <a href="https://www.showdoc.cc/230407611622153?page_id=1351233682086061" title="点击查看单货源地产品下单API文档">[2]单货源地产品下单API</a> 的提交参数
<strong>请求URL：</strong> </li>
<li><code>http://open.hznzcn.com/order/batch/place</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
<li>x-www-form-urlencoded</li>
</ul>
<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>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">app_key</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>App应用标识，女装网提供</td>
</tr>
<tr>
<td style="text-align: left;">access_token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>授权成功的Token，若访问的API和用户有关，该项为必填项， 具体请查看 <a href="https://www.showdoc.cc/230407611622153?page_id=1313862750462126" title="点击查看 获取授权，token 文档">[3]获取授权，token 文档</a></td>
</tr>
<tr>
<td style="text-align: left;">stamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳，有效期为 <strong>3</strong> 分钟，示例值：636806795462062641，具体参考 <a href="https://www.showdoc.cc/230407611622153?page_id=1313894411972991" title="点击查看时间戳的说明文档">[4]时间戳说明文档</a></td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名，将除了sign以为的的所有请求参数进行签名加密处理后的字符串，示例值：0895AB9BCE9AA031D4EE3CC38C3E0702，具体参考 <a href="https://www.showdoc.cc/230407611622153?page_id=1313915454654841" title="点击查看签名生成说明文档">[5]签名生成说明文档</a></td>
</tr>
</tbody>
</table>
<p><strong>API请求参数：</strong> </p>
<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;">OrderDetailAddRequestJson</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>是 OrderDetailAddRequest请求参数对象集合 的Json数组字符串;<br/>一个货源地就一个OrderDetailAddRequest ；<br/> OrderDetailAddRequest 其实就是一个 完整的 <a href="https://www.showdoc.cc/230407611622153?page_id=1351233682086061" title="点击查看单货源地产品下单API文档">[2]单货源地产品下单API</a>的提交参数 ；<br/> OrderDetailAddRequest的具体格式，请参考<a href="https://www.showdoc.cc/230407611622153?page_id=1351233682086061" title="点击查看单货源地产品下单API文档">[2]单货源地产品下单API</a>的请求参数</td>
</tr>
</tbody>
</table>
<p><strong>OrderDetailAddRequestJson处理代码示例</strong></p>
<ul>
<li>注意单双引号的引起的问题</li>
</ul>
<p><strong>C#代码示例</strong></p>
<pre><code class="language-csharp"> IList<OrderDetailAddRequest> OrderDetailAddRequestList= new List<OrderDetailAddRequest>();//所有货源地下单参数对象列表
OrderDetailAddRequest oneOrderDetailAddRequest = new OrderDetailAddRequest();//单个货源地下单参数对象
oneOrderDetailAddRequest.OrderFrom = 99;
oneOrderDetailAddRequest.OrderDetailList = "[{ \"ProId\": 631644, \"ProSpecifications\": \"黑色,M\", \"ProNum\": 2 },{ \"ProId\": 618918, \"ProSpecifications\": \"白色,L\", \"ProNum\": 2 }]";
oneOrderDetailAddRequest.ShoppingCartIds = null;
oneOrderDetailAddRequest.ConsigneeAddress = "{\"Receiver\": \"张汉卿\",\"Phone\": \"18003971236\",\"Tel\": \"010-1234567\",\"Province\": \"浙江省\",\"City\": \"杭州市\",\"District\": \"萧山区\",\"AddressDetail\": \"萧山区鸿兴城\",\"Zip\": \"000000\",\"IsCollect\": 0}";
oneOrderDetailAddRequest.DeliveryAreaID = 227;
oneOrderDetailAddRequest.Remark = "代发";
oneOrderDetailAddRequest.PackageType = 0;
oneOrderDetailAddRequest.InnerPackageType = 0;
oneOrderDetailAddRequest.PackNum = 0;
oneOrderDetailAddRequest.FavourCommonCard = 0;
oneOrderDetailAddRequest.SendMode = 0;
oneOrderDetailAddRequest.NeedSeniorQc = 0;
oneOrderDetailAddRequest.NeedTicket = 0;
OrderDetailAddRequestList.Add(oneOrderDetailAddRequest);//加入到全部里面
OrderDetailAddRequestList.Add(oneOrderDetailAddRequest);// 示例代码的缘故，我重复加2次，表示两个货源地的提交数据
string OrderDetailAddRequestJson = JsonConvert.SerializeObject(OrderDetailAddRequestList);//列表序列化成Json字符串，具体生成的值，看下面说明</code></pre>
<p><strong>上面的 OrderDetailAddRequestJson 最后得到的值如下</strong></p>
<ul>
<li>注意，如果用json工具类生成的，那么里面的引号都转义好了不需要太关注单双引号问题</li>
<li>
<p>如果自己拼接，注意 单双引号问题</p>
<pre><code class="language-csharp">string OrderDetailAddRequestJson="[{\"OrderFrom\":99,\"OuterOrderCode\":null,\"OrderDetailList\":\"[{ \\\"ProId\\\": 631644, \\\"ProSpecifications\\\": \\\"黑色,M\\\", \\\"ProNum\\\": 2 },{ \\\"ProId\\\": 618918, \\\"ProSpecifications\\\": \\\"白色,L\\\", \\\"ProNum\\\": 2 }]\",\"ShoppingCartIds\":null,\"ConsigneeAddress\":\"{\\\"Receiver\\\": \\\"张汉卿\\\",\\\"Phone\\\": \\\"18003971236\\\",\\\"Tel\\\": \\\"010-1234567\\\",\\\"Province\\\": \\\"浙江省\\\",\\\"City\\\": \\\"杭州市\\\",\\\"District\\\": \\\"萧山区\\\",\\\"AddressDetail\\\": \\\"萧山区鸿兴城\\\",\\\"Zip\\\": \\\"000000\\\",\\\"IsCollect\\\": 0}\",\"DeliveryAreaID\":227,\"LcCode\":null,\"LcMoney\":0.0,\"Remark\":\"代发\",\"PackageType\":0,\"InnerPackageType\":0,\"PackNum\":0,\"FavourCommonCard\":0,\"CouponCode\":null,\"SendMode\":0,\"NeedSeniorQc\":0,\"NeedTicket\":0},{\"OrderFrom\":99,\"OuterOrderCode\":null,\"OrderDetailList\":\"[{ \\\"ProId\\\": 631644, \\\"ProSpecifications\\\": \\\"黑色,M\\\", \\\"ProNum\\\": 2 },{ \\\"ProId\\\": 618918, \\\"ProSpecifications\\\": \\\"白色,L\\\", \\\"ProNum\\\": 2 }]\",\"ShoppingCartIds\":null,\"ConsigneeAddress\":\"{\\\"Receiver\\\": \\\"张汉卿\\\",\\\"Phone\\\": \\\"18003971236\\\",\\\"Tel\\\": \\\"010-1234567\\\",\\\"Province\\\": \\\"浙江省\\\",\\\"City\\\": \\\"杭州市\\\",\\\"District\\\": \\\"萧山区\\\",\\\"AddressDetail\\\": \\\"萧山区鸿兴城\\\",\\\"Zip\\\": \\\"000000\\\",\\\"IsCollect\\\": 0}\",\"DeliveryAreaID\":227,\"LcCode\":null,\"LcMoney\":0.0,\"Remark\":\"代发\",\"PackageType\":0,\"InnerPackageType\":0,\"PackNum\":0,\"FavourCommonCard\":0,\"CouponCode\":null,\"SendMode\":0,\"NeedSeniorQc\":0,\"NeedTicket\":0}]"；</code></pre>
<p><strong>返回示例</strong></p>
<ul>
<li>分成功和失败两种情况，我都提供了示例</li>
</ul>
</li>
</ul>
<p>成功时的示例</p>
<pre><code>{
"Data": "13172762,13172763",
"Code": "0",
"Msg": "下单成功！订单id为：13172762,13172763",
"OrderList": [
{
"OrderId": 13172762,
"OrderCode": "2021062316030301",
"OrderFrom": "其他",
"OuterOrderCode": "1335732601767967681"
},
{
"OrderId": 13172763,
"OrderCode": "2021062316030302",
"OrderFrom": "其他",
"OuterOrderCode": "1335732601767967681,1335732601769967681"
}
]
}
</code></pre>
<p>提交失败的示例</p>
<pre><code>{
"Data": null,
"Code": "-9",
"Msg": "下订单出错:ERROR_ORDER_NO_PRODUCT"
}
</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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Data</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">成功时，返回 订单id；多个货源地就多个订单id；<br/>返回的订单id字符串, 格式如 “<strong>13172762,13172763</strong>” ,每个订单ID，用<strong>英文半角逗号分割</strong><br/>失败时，返回<strong>null </strong></td>
</tr>
<tr>
<td style="text-align: left;">OrderList</td>
<td style="text-align: left;">list</td>
<td style="text-align: left;">成功时，返回 下单成功的 订单id和code列表</td>
</tr>
<tr>
<td style="text-align: left;">Code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">请求状态码 ，具体参考 <a href="https://www.showdoc.cc/230407611622153?page_id=1314533986849160" title="点击查看请求状态码【ResponseCode】文档">[6]ResponseCode文档</a></td>
</tr>
<tr>
<td style="text-align: left;">Msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">请求相关信息 ，失败时会返回 格式为 “<strong>下订单出错:错误码</strong>” 的错误信息，示例：“下订单出错:ERROR_ORDER_NO_PRODUCT”；<br/>其他相关的下单错误码，请参考 <a href="https://www.showdoc.cc/230407611622153?page_id=1351233682086061" title="点击查看单货源地产品下单API文档">[2]单货源地产品下单API</a> 的 <strong>订单错误码说明</strong></td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>