快速批量下单[推荐用这个]
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>http://open.hznzcn.com/order/supplier/place</code></li>
</ul>
<p><strong>简要描述:</strong> </p>
<ul>
<li>货捕头/女装网 的订单是以 货源地为 维度下单的</li>
<li>
<p><strong>所以:调用该下单API,如果提交了多个货源地产品,会自动拆单</strong></p>
</li>
<li><span style="color:red">下单参数 支持自定义 ;</span> 如果设置过下单默认服务,该订单会自动使用这些参数!</li>
<li>可登陆 [www.hznzcn.com](<a href="http://www.hznzcn.com">http://www.hznzcn.com</a> "www.hznzcn.com") ,在PC站点的下单页设置 <span style="color:red">【默认下单服务】</span>(下面有图),如 "默认快递"、"默认包装袋"、"默认好评卡"等, </li>
<li>
<p>如果账户有优惠券,会自动使用,优先使用 “优惠力度最大”的优惠券</p>
</li>
<li>默认下单服务 图示
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/3489cd131aec45d5d31ae7521045f0bd" alt="" /></li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>http://open.hznzcn.com/order/supplier/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和用户有关,该项为必填项, 具体请查看 [[3]获取授权,token 文档][token]</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,具体参考 [[4]时间戳说明文档][时间戳说明]</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,具体参考 [[5]签名生成说明文档][签名生成说明文档]</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;">OuterOrderCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>外部单号;传其他平台自己的单号</td>
</tr>
<tr>
<td style="text-align: left;">PlaceOrderProductList</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>下单产品集合,一个Json字符串;<br/>1:多个产品时逗号隔开;<br/>2:一单最多100个不同的产品规格;<br/>3:同规格会合并数量<br/>4:如需要小礼品,也加到该参数里,小礼品会自动识别并做相应的处理;<br/>5:PlaceOrderProductList的格式请参考下面 的 <strong>PlaceOrderProductList的值数据说明</strong> ;</td>
</tr>
<tr>
<td style="text-align: left;">Receiver</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>收货人姓名,<br/><span style='color:red'>加密订单时,请传加密信息</span></td>
</tr>
<tr>
<td style="text-align: left;">Phone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>手机号码,,<br/><span style='color:red'>加密订单时,请传加密信息</span></td>
</tr>
<tr>
<td style="text-align: left;">Province</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>省编码或省名称(一级地址,优先匹配编码);<br/>【示例值:110000/北京】<br/><span style='color:red'>加密订单时,请传中文</span></td>
</tr>
<tr>
<td style="text-align: left;">City</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>市编码或市名称(二级地址,优先匹配编码);<br/> 【示例值:110100/北京市】<br/><span style='color:red'>加密订单时,请传中文</span></td>
</tr>
<tr>
<td style="text-align: left;">District</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区编码或区名称(三级地址,优先匹配编码);<br/>【示例值:110101/东城区】<br/><span style='color:red'>加密订单时,请传中文</span></td>
</tr>
<tr>
<td style="text-align: left;">Address</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>镇编码或街道\镇名称(四级地址,优先匹配编码);<br/><span style='color:red'>加密订单时,请传中文</span></td>
</tr>
<tr>
<td style="text-align: left;">AddressDetail</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>详细地址;<br/><span style='color:red'>加密订单时,请传加密信息</span></td>
</tr>
<tr>
<td style="text-align: left;">Remark</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单备注</td>
</tr>
<tr>
<td style="text-align: left;">IsAutoPay</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>是否自动支付;<br/>1=自动支付;<br/>0=不自动支付;<br/></td>
</tr>
<tr>
<td style="text-align: left;">PayPassword</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>加密后的支付密码【参考授权时的密码加密,经过MD5加密的密文,UTF-8编码,32位大写】,没有则不需要。</td>
</tr>
<tr>
<td style="text-align: left;">IsEncryptOrder</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int?</td>
<td><span style='color:green'>新增参数;</span><br/>是否加密订单,<br/>Null=不是;<br/>0=不是 ;<br/>1=是;<br/><span style='color:red'>加密订单时,需要额外提交其他参数</span>;;<br/><span style='color:red'>注:下面有“加密订单时的请求参数示例”</span></td>
</tr>
<tr>
<td style="text-align: left;">RealOrderRrom</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td><span style='color:green'>新增参数;</span><br/>加密订单的真实平台,<br/>固定值:<br/>淘宝;<br/>阿里;<br/>拼多多;<br/>抖店;<br/>抖音小店;<br/><span style='color:red'>加密订单时,必填</span></td>
</tr>
<tr>
<td style="text-align: left;">RealOrderNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td><span style='color:green'>新增参数;</span><br/>加密订单的真实平台单号,<br/>如:抖店单号;<br/><span style='color:red'>加密订单时,必填</span></td>
</tr>
<tr>
<td style="text-align: left;">SellerId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td><span style='color:green'>新增参数;</span><br/>加密订单的平台卖家ID,<br/><span style='color:red'>加密订单时,必填</span></td>
</tr>
<tr>
<td style="text-align: left;">Oaid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td><span style='color:green'>新增参数;</span><br/>淘宝系的加密Oaid;<br/><span style='color:red'>淘系的加密订单时,必填</span></td>
</tr>
</tbody>
</table>
<p><strong>PlaceOrderProductList的值数据说明</strong></p>
<ul>
<li>PlaceOrderProductList参数的数据结构示例值如下 <strong>【一个json字符串】</strong></li>
</ul>
<p>数据结构如下:</p>
<pre><code class="language-json">[
{
&quot;ProId&quot;: 701443,
&quot;ProSpecifications&quot;: &quot;黑色,M&quot;,
&quot;ProNum&quot;: 10
},
{
&quot;ProId&quot;: 637270,
&quot;ProSpecifications&quot;: &quot;红色,M&quot;,
&quot;ProNum&quot;: 10
}
]</code></pre>
<p>Json数据结构说明: </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;">ProId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>产品id</td>
</tr>
<tr>
<td style="text-align: left;">ProSpecifications</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>产品规格,示例值:“黑色,XL”</td>
</tr>
<tr>
<td style="text-align: left;">ProNum</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>数量</td>
</tr>
</tbody>
</table>
<p><strong>赋值给PlaceOrderProductList参数时,注意两点:</strong></p>
<ul>
<li><strong>PlaceOrderProductList的值 是string,一个json格式的 string,并非是 json对象</strong></li>
<li><strong>注意单双引号问题</strong></li>
</ul>
<p>下面是把josn弄成了字符串,赋值的示例【C#代码】</p>
<pre><code class="language-csharp"> string PlaceOrderProductList=&#039;[{&quot;ProId&quot;: 701443,&quot;ProSpecifications&quot;: &quot;黑色,M&quot;,&quot;ProNum&quot;: 10},{&quot;ProId&quot;: 637270,&quot;ProSpecifications&quot;: &quot;红色,M&quot;,&quot;ProNum&quot;: 10}]&#039;;</code></pre>
<p><span style='color:red'><strong>加密订单时的请求参数示例</strong></span></p>
<pre><code class="language-json">{
&quot;OuterOrderCode&quot;: &quot;Test000000001&quot;,
&quot;Receiver&quot;: &quot;##SPpdr6riXsNBVE8ww9fY1lDWBMD9BRt11Vfu5gT8abKT6HkUAYFnR3y72jpb9bWy86VeW5/uXfaUfVhL8yPskDS7D+73y8gUjbYi8udAAMzb*CgYIASAHKAESPgo8kZeHikMXXXC/uIOxC/MCHroPCtIVpoEFZ8My8k+sgDP3hnuTs7zDJuUOHP4fDoDyckakJGgA=#1##&quot;,
&quot;Phone&quot;: &quot;$$NVPL7sWNtVTVoFoQMMmZe9FQC8Vl6T3AJiqhT6H9+aMdmoxUGbGVldfc0TwyT8fKwsy7o9B/ylsp7DFiwXXXnISbAJt0ZcQKffvPYB4Y=*CgYIASAHKAESPgo850vq6TivMog/dTDoptdiAFzCZm7nxfWHFMmbno+SvySxPg+vEOoWggR05eu713ePooO5FJTyexWrkHMZGgA=$1$$&quot;,
&quot;Province&quot;: &quot;江苏省&quot;,
&quot;City&quot;: &quot;泰州市&quot;,
&quot;District&quot;: &quot;兴化市&quot;,
&quot;Address&quot;: &quot;临城街道&quot;,
&quot;AddressDetail&quot;: &quot;##F9JzWlNKPcJv0G3iP3ir71eMXQj5F7uYpVBqJhiJGPAU9X08ykAXpPcsNb6JXmqBxBeX/cXuYVKama+9VUvMmsWR+s4Lp7lDk6jjql6dO9/xyaAp5CrWj21R2j8JKHsFNtE7LurE7HXXXHKAESPgo8ZYPKvCBbaHdLIZoKbKRANKocMKeGIjuIVMY1cFHxRRs3TgiU6LWlXvYjb6tZYP+K9bdsxHnAQ8+xzY0IGgA=#1##&quot;,
&quot;Remark&quot;: &quot;&quot;,
&quot;IsAutoPay&quot;: 0,
&quot;PayPassword&quot;: &quot;&quot;,
&quot;IsNeedTicketing&quot;: 0,
&quot;IsEncryptOrder&quot;: 1,
&quot;RealOrderRrom&quot;: &quot;抖店&quot;,
&quot;RealOrderNo&quot;: &quot;6939439395821327523A&quot;,
&quot;Oaid&quot;: &quot;&quot;,
&quot;SellerId&quot;: &quot;177882805&quot;,
&quot;PlaceOrderProductList&quot;: &quot;[{\&quot;ProId\&quot;: 5220682,\&quot;ProSpecifications\&quot;: \&quot;黑色,M\&quot;,\&quot;ProNum\&quot;: 10}]&quot;
}</code></pre>
<p><strong>返回示例</strong></p>
<p><span style="color:red"><strong>基础信息错误 </strong></span>示例</p>
<ul>
<li>
<p>不会生成订单,直接报错</p>
<pre><code class="language-json">{
&quot;Data&quot;: null,
&quot;OrderList&quot;: null,
&quot;Code&quot;: &quot;-9&quot;,
&quot;CodeDescription&quot;: null,
&quot;Msg&quot;: &quot;提交订单出错:ERROR_CONSIGNEE_ADDRESS_DETAIL_LEN&quot;,
&quot;ExceptionDescription&quot;: null
}</code></pre>
<p><span style="color:blue"><strong>自动支付时,下单成功,但支付失败示例</strong></span></p>
</li>
<li>
<p>生成订单,支付失败</p>
<pre><code class="language-json">{
&quot;Data&quot;: &quot;2485,2486&quot;,
&quot;OrderList&quot;: [
{
&quot;OrderId&quot;: 2485,
&quot;OrderCode&quot;: &quot;2021102821373705&quot;,
&quot;OrderFrom&quot;: &quot;其他&quot;,
&quot;OuterOrderCode&quot;: &quot;QT2021102819463903&quot;,
&quot;IsPaySuccess&quot;: 0,
&quot;PayResutMsg&quot;: &quot;预存款余额不足,未自动支付&quot;
},
{
&quot;OrderId&quot;: 2486,
&quot;OrderCode&quot;: &quot;2021102821373706&quot;,
&quot;OrderFrom&quot;: &quot;其他&quot;,
&quot;OuterOrderCode&quot;: &quot;QT2021102819463903&quot;,
&quot;IsPaySuccess&quot;:0,
&quot;PayResutMsg&quot;: &quot;支付密码错误&quot;
}
],
&quot;Code&quot;: &quot;0&quot;,
&quot;CodeDescription&quot;: null,
&quot;Msg&quot;: &quot;下单成功!订单id为:2485,2486&quot;,
&quot;ExceptionDescription&quot;: null
}</code></pre>
<p><span style="color:green"><strong>非自动支付时 下单成功示例</strong></span></p>
</li>
<li>
<p>生成订单,不支付</p>
<pre><code class="language-json">{
&quot;Data&quot;: &quot;2485,2486&quot;,
&quot;OrderList&quot;: [
{
&quot;OrderId&quot;: 2485,
&quot;OrderCode&quot;: &quot;2021102821373705&quot;,
&quot;OrderFrom&quot;: &quot;其他&quot;,
&quot;OuterOrderCode&quot;: &quot;QT2021102819463903&quot;,
&quot;IsPaySuccess&quot;: 0,
&quot;PayResutMsg&quot;: &quot;未自动支付&quot;
},
{
&quot;OrderId&quot;: 2486,
&quot;OrderCode&quot;: &quot;2021102821373706&quot;,
&quot;OrderFrom&quot;: &quot;其他&quot;,
&quot;OuterOrderCode&quot;: &quot;QT2021102819463903&quot;,
&quot;IsPaySuccess&quot;: 0,
&quot;PayResutMsg&quot;: &quot;未自动支付&quot;
}
],
&quot;Code&quot;: &quot;0&quot;,
&quot;CodeDescription&quot;: null,
&quot;Msg&quot;: &quot;下单成功!订单id为:2485,2486&quot;,
&quot;ExceptionDescription&quot;: null
}</code></pre>
<p><span style="color:green"><strong>自动支付时,并支付成功示例</strong></span></p>
</li>
<li>
<p>生成订单,并支付成功</p>
<pre><code class="language-json">{
&quot;Data&quot;: &quot;2485,2486&quot;,
&quot;OrderList&quot;: [
{
&quot;OrderId&quot;: 2485,
&quot;OrderCode&quot;: &quot;2021102821373705&quot;,
&quot;OrderFrom&quot;: &quot;其他&quot;,
&quot;OuterOrderCode&quot;: &quot;QT2021102819463903&quot;,
&quot;IsPaySuccess&quot;: 1,
&quot;PayResutMsg&quot;: &quot;支付成功&quot;
},
{
&quot;OrderId&quot;: 2486,
&quot;OrderCode&quot;: &quot;2021102821373706&quot;,
&quot;OrderFrom&quot;: &quot;其他&quot;,
&quot;OuterOrderCode&quot;: &quot;QT2021102819463903&quot;,
&quot;IsPaySuccess&quot;:1,
&quot;PayResutMsg&quot;: &quot;支付成功&quot;
}
],
&quot;Code&quot;: &quot;0&quot;,
&quot;CodeDescription&quot;: null,
&quot;Msg&quot;: &quot;下单成功!订单id为:2485,2486&quot;,
&quot;ExceptionDescription&quot;: null
}</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列表,请参考 下面的 <strong>OrderList对象说明</strong></td>
</tr>
<tr>
<td style="text-align: left;">Code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">请求状态码 ,具体参考 [[6]ResponseCode文档][ResponseCode]</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/>其他相关的下单错误码,请参考 [[2]单货源地产品下单API][单货源地产品下单API] 的 <strong>订单错误码说明</strong></td>
</tr>
</tbody>
</table>
</li>
</ul>
<p><strong>OrderList对象说明</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;">OrderId</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">女装网/货捕头 的 订单ID</td>
</tr>
<tr>
<td style="text-align: left;">OrderCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">女装网/货捕头 的 订单编号</td>
</tr>
<tr>
<td style="text-align: left;">OrderFrom</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单来源</td>
</tr>
<tr>
<td style="text-align: left;">OuterOrderCode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">外部单号 ,你们自己的平台单号</td>
</tr>
<tr>
<td style="text-align: left;">IsPaySuccess</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是否已经支付成功【1=支付成功,0=支付失败、未支付】</td>
</tr>
<tr>
<td style="text-align: left;">PayResutMsg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">支付结果信息【如:"支付成功"、"未自动支付"、"支付密码错误"。。。】</td>
</tr>
</tbody>
</table>
<h1>下面 是 供应商快速下单对应的快递列表</h1>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>http://open.hznzcn.com/base/supplier/deliver/list</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和用户有关,该项为必填项, 具体请查看 [[3]获取授权,token 文档][token]</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,具体参考 [[4]时间戳说明文档][时间戳说明]</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,具体参考 [[5]签名生成说明文档][签名生成说明文档]</td>
</tr>
</tbody>
</table>
<p><strong>API请求参数:<span style="color:red">和快速下单的参数基本一样【这里少一些】</span></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;">PlaceOrderProductList</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>下单产品集合,一个Json字符串;<br/>1:多个产品时逗号隔开;<br/>2:一单最多100个不同的产品规格;<br/>3:同规格会合并数量<br/>4:如需要小礼品,也加到该参数里,小礼品会自动识别并做相应的处理;<br/>5:PlaceOrderProductList的格式请参考下面 的 <strong>PlaceOrderProductList的值数据说明</strong> ;</td>
</tr>
<tr>
<td style="text-align: left;">Province</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>省编码或省名称(一级地址,优先匹配编码);<br/>【示例值:110000/北京】</td>
</tr>
<tr>
<td style="text-align: left;">City</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>市编码或市名称(二级地址,优先匹配编码);<br/> 【示例值:110100/北京市】</td>
</tr>
<tr>
<td style="text-align: left;">District</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区编码或区名称(三级地址,优先匹配编码);<br/>【示例值:110101/东城区】</td>
</tr>
<tr>
<td style="text-align: left;">Address</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>镇编码或街道\镇名称(四级地址,优先匹配编码) 【暂不启用,可不填】;</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<p><span style="color:red"><strong>基础信息错误 </strong></span>示例</p>
<ul>
<li>
<p>如:产品数据异常</p>
<pre><code class="language-json">{
&quot;Data&quot;: null,
&quot;Code&quot;: &quot;-99&quot;,
&quot;CodeDescription&quot;: &quot;请求失败&quot;,
&quot;Msg&quot;: &quot;ERROR_PRODUCT_DATA&quot;,
&quot;ExceptionDescription&quot;: null
}</code></pre>
<p><span style="color:red"><strong>无数据响应 </strong></span>示例</p>
</li>
<li>
<p>如:省市区不对,找不到任何快递</p>
<pre><code class="language-json">{
&quot;Data&quot;: [],
&quot;Code&quot;: &quot;0&quot;,
&quot;CodeDescription&quot;: &quot;请求成功&quot;,
&quot;Msg&quot;: null,
&quot;ExceptionDescription&quot;: null
}</code></pre>
<p><span style="color:red"><strong>成功响应 </strong></span>示例</p>
</li>
<li>
<p>如:多货源地</p>
<pre><code class="language-json">{
&quot;Data&quot;: [
{
&quot;ThShopId&quot;: 1,
&quot;ThShopName&quot;: &quot;杭州&quot;,
&quot;TheShopType&quot;: 0,
&quot;TheShopTypeName&quot;: &quot;真实货源地&quot;,
&quot;DefaultDeliver&quot;: {
&quot;DistributionName&quot;: &quot;韵达(菜鸟)&quot;,
&quot;Distributiondescription&quot;: &quot;韵达快运&quot;,
&quot;DeliveryFee&quot;: 4.8,
&quot;ShipperCode&quot;: &quot;YD&quot;
}
},
{
&quot;ThShopId&quot;: 187,
&quot;ThShopName&quot;: &quot;零五七一&quot;,
&quot;TheShopType&quot;: 1,
&quot;TheShopTypeName&quot;: &quot;直发商家货源地&quot;,
&quot;DefaultDeliver&quot;: {
&quot;DistributionName&quot;: &quot;快递&quot;,
&quot;Distributiondescription&quot;: &quot;快递&quot;,
&quot;DeliveryFee&quot;: 0,
&quot;ShipperCode&quot;: &quot;&quot;
}
}
],
&quot;Code&quot;: &quot;0&quot;,
&quot;CodeDescription&quot;: &quot;请求成功&quot;,
&quot;Msg&quot;: null,
&quot;ExceptionDescription&quot;: null
}</code></pre>
<p><strong>快递的实体类</strong> </p>
<ul>
<li>每个货源地,都有自己快递</li>
</ul>
<pre><code class="language-csharp">
/// &lt;summary&gt;
/// 供应商使用的货源地对应的快递信息对象
/// &lt;/summary&gt;
public class TheShopDeliverInfo_Supplier
{
/// &lt;summary&gt;
/// 货源地Id
/// &lt;/summary&gt;
public int ThShopId { get; set; }
/// &lt;summary&gt;
/// 货源地名称
/// &lt;/summary&gt;
public string ThShopName { get; set; }
/// &lt;summary&gt;
/// 货源地类型
/// 0=真实货源地
/// 1=商家直发【品牌自己发货】
/// &lt;/summary&gt;
public int TheShopType { get; set; }
/// &lt;summary&gt;
/// 货源地类型名称
/// &lt;/summary&gt;
public string TheShopTypeName { get; set; }
/// &lt;summary&gt;
/// 货源地对应的默认快递信息对象
/// DefaultDeliver 可为NULL,为NULL则没找到快递, 对应的是实体类,下面已提供
/// &lt;/summary&gt;
public DeliverInfo_Supplier DefaultDeliver { get; set; }
}
/// &lt;summary&gt;
/// 供应商使用的快递信息对象
/// &lt;/summary&gt;
public class DeliverInfo_Supplier
{
/// &lt;summary&gt;
/// 配送名称
/// &lt;/summary&gt;
public string DistributionName
{
get;
set;
}
/// &lt;summary&gt;
/// 配送描述
/// &lt;/summary&gt;
public string Distributiondescription
{
get;
set;
}
/// &lt;summary&gt;
/// 快递费用,如果为0,是包邮
/// &lt;/summary&gt;
public decimal DeliveryFee
{
get;
set;
}
/// &lt;summary&gt;
/// 快递公司编码/托运方编码(对应的是DeliverPo对象的KDNiaoCode字段,快递鸟物流公司代码)
/// &lt;/summary&gt;
public string ShipperCode { set; get; }
}</code></pre>
</li>
</ul>
<pre><code>
**备注**
[token]: https://www.showdoc.cc/230407611622153?page_id=1313862750462126 &quot;点击查看 获取授权,token 文档&quot;
[时间戳说明]: https://www.showdoc.cc/230407611622153?page_id=1313894411972991 &quot;点击查看时间戳的说明文档&quot;
[签名生成说明文档]: https://www.showdoc.cc/230407611622153?page_id=1313915454654841 &quot;点击查看签名生成说明文档&quot;
[ResponseCode]: https://www.showdoc.cc/230407611622153?page_id=1314533986849160 &quot;点击查看请求状态码【ResponseCode】文档&quot;
[下单汇总信息API]: https://www.showdoc.cc/230407611622153?page_id=1341667324456177 &quot;点击查看下单汇总信息API文档&quot;
[单货源地产品下单API]: https://www.showdoc.cc/230407611622153?page_id=1351233682086061 &quot;点击查看单货源地产品下单API文档&quot;</code></pre>