杭州女装网API


快速批量下单[推荐用这个]

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

页面列表

ITEM_HTML