37Express下单接口(V2)

第2版


获取各派送商的报价

<h5>简要描述</h5> <ul> <li>获取各派送商的报价</li> </ul> <h5>请求URL</h5> <ul> <li><code>https://www.37-express.com/qyfr/api/parcel/v2/</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST</li> </ul> <h5>设置头部(HEADER)</h5> <ul> <li>Content-Type: application/json</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;"><strong>account</strong></td> <td style="text-align: left;">是</td> <td style="text-align: left;">object</td> <td>账号信息</td> </tr> <tr> <td style="text-align: left;">account/email</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>用户名</td> </tr> <tr> <td style="text-align: left;">account/password</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>密码</td> </tr> <tr> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td></td> </tr> <tr> <td style="text-align: left;"><strong>carriers</strong></td> <td style="text-align: left;">是</td> <td style="text-align: left;">object</td> <td>正文数据</td> </tr> <tr> <td style="text-align: left;">carriers/parcels</td> <td style="text-align: left;">是</td> <td style="text-align: left;">array</td> <td>包裹明细</td> </tr> <tr> <td style="text-align: left;">carriers/parcels/weight</td> <td style="text-align: left;">是</td> <td style="text-align: left;">float</td> <td>包裹重量,单位:kg</td> </tr> <tr> <td style="text-align: left;">carriers/parcels/length</td> <td style="text-align: left;">否</td> <td style="text-align: left;">float</td> <td>包裹长度,单位:cm</td> </tr> <tr> <td style="text-align: left;">carriers/parcels/width</td> <td style="text-align: left;">否</td> <td style="text-align: left;">float</td> <td>包裹宽度,单位:cm</td> </tr> <tr> <td style="text-align: left;">carriers/parcels/height</td> <td style="text-align: left;">否</td> <td style="text-align: left;">float</td> <td>包裹高度,单位:cm</td> </tr> <tr> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td></td> </tr> <tr> <td style="text-align: left;"><strong>carriers/senderAddress</strong></td> <td style="text-align: left;">是</td> <td style="text-align: left;">object</td> <td>寄件人地址</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/prefix</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>寄件人称呼</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/firstName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>寄件人名字</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/lastName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>寄件人姓氏</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/companyName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>寄件人公司,如果没有填写姓名,则公司必须填写</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/countryCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>寄件地址国家代码,例如:FR</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/region</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>寄件地址州/省</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/city</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>寄件地址城市</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/street</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>寄件街道地址</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/street2</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>寄件附加街道地址</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/postalCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>寄件地址邮编</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/phoneNumber</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>寄件人电话</td> </tr> <tr> <td style="text-align: left;">carriers/senderAddress/email</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>寄件人邮箱</td> </tr> <tr> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td style="text-align: left;"></td> <td></td> </tr> <tr> <td style="text-align: left;"><strong>carriers/receiverAddress</strong></td> <td style="text-align: left;">是</td> <td style="text-align: left;">object</td> <td>收件人地址</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/prefix</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>收件人称呼</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/firstName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>收件人名字</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/lastName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>收件人姓氏</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/companyName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>收件人公司,如果没有填写姓名,则公司必须填写</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/countryCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>收件地址国家代码,例如:US</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/region</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>收件地址州/省</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/city</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>收件地址城市</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/district</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>城市的区/县。如果是中国,这是必填的</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/street</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>收件街道地址</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/street2</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>收件附加街道地址</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/postalCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>收件地址邮编</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/phoneNumber</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>收件人电话</td> </tr> <tr> <td style="text-align: left;">carriers/receiverAddress/email</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>收件人邮箱</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{ &amp;quot;account&amp;quot;: { &amp;quot;email&amp;quot;: &amp;quot;test@test.com&amp;quot;, &amp;quot;password&amp;quot;: &amp;quot;test_test_test_test&amp;quot; }, &amp;quot;carriers&amp;quot;: { &amp;quot;parcels&amp;quot;: [ {&amp;quot;weight&amp;quot;: 2,&amp;quot;length&amp;quot;: 12,&amp;quot;width&amp;quot;: 32,&amp;quot;height&amp;quot;: 23}, {&amp;quot;weight&amp;quot;: 3,&amp;quot;length&amp;quot;: 11,&amp;quot;width&amp;quot;: 33,&amp;quot;height&amp;quot;: 88} ], &amp;quot;senderAddress&amp;quot;: { &amp;quot;firstName&amp;quot;: &amp;quot;Jessica&amp;quot;, &amp;quot;lastName&amp;quot;: &amp;quot;La plus belle&amp;quot;, &amp;quot;companyName&amp;quot;: &amp;quot;Cindy H&amp;quot;, &amp;quot;countryCode&amp;quot;: &amp;quot;FR&amp;quot;, &amp;quot;city&amp;quot;: &amp;quot;AUBERVILLIERS&amp;quot;, &amp;quot;street&amp;quot;: &amp;quot;8-10 RUE DE LA HAIE COQ&amp;quot;, &amp;quot;postalCode&amp;quot;: &amp;quot;93300&amp;quot;, &amp;quot;phoneNumber&amp;quot;: &amp;quot;0148340955&amp;quot;, &amp;quot;email&amp;quot;: &amp;quot;cindyhbyazalee@gmail.com&amp;quot; }, &amp;quot;receiverAddress&amp;quot;: { &amp;quot;firstName&amp;quot;: &amp;quot;yangyang&amp;quot;, &amp;quot;lastName&amp;quot;: &amp;quot;xiao&amp;quot;, &amp;quot;companyName&amp;quot;: &amp;quot;TEST COMPANY&amp;quot;, &amp;quot;countryCode&amp;quot;: &amp;quot;DK&amp;quot;, &amp;quot;city&amp;quot;: &amp;quot;COPENHAGEN&amp;quot;, &amp;quot;street&amp;quot;: &amp;quot;OSTERBROGAGE 114 2ND&amp;quot;, &amp;quot;postalCode&amp;quot;: &amp;quot;2100&amp;quot;, &amp;quot;phoneNumber&amp;quot;: &amp;quot;004531905171&amp;quot;, &amp;quot;email&amp;quot;: &amp;quot;xiaoyangyang@ftl-express.com&amp;quot; } } }</code></pre> <h5>返回示例</h5> <pre><code>{ &amp;quot;success&amp;quot;: true, &amp;quot;carriers&amp;quot;:[ { &amp;quot;id&amp;quot;: 39, &amp;quot;code&amp;quot;: &amp;quot;ups&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;UPS Multi-colis&amp;quot;, &amp;quot;logo&amp;quot;: &amp;quot;https://www.37-express.com/xxxxxx.jpg&amp;quot;, &amp;quot;timeLimit&amp;quot;: &amp;quot;2-6 Jours&amp;quot;, &amp;quot;amount&amp;quot;: 28.19, &amp;quot;amountInclTax&amp;quot;: 33.83, &amp;quot;amountCurrency&amp;quot;: &amp;quot;EUR&amp;quot; }, { &amp;quot;id&amp;quot;: 12, &amp;quot;code&amp;quot;: &amp;quot;gls&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;GLS&amp;quot;, &amp;quot;logo&amp;quot;: &amp;quot;https://www.37-express.com/yyyy.jpg&amp;quot;, &amp;quot;timeLimit&amp;quot;: &amp;quot;3 Jours&amp;quot;, &amp;quot;amount&amp;quot;: 37, &amp;quot;amountInclTax&amp;quot;: 44.4, &amp;quot;amountCurrency&amp;quot;: &amp;quot;EUR&amp;quot; }, { &amp;quot;id&amp;quot;: 6, &amp;quot;code&amp;quot;: &amp;quot;chronopost&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;Chrono 13&amp;quot;, &amp;quot;logo&amp;quot;: &amp;quot;https://www.37-express.com/zzzz.jpg&amp;quot;, &amp;quot;timeLimit&amp;quot;: &amp;quot;2-6 Jours&amp;quot;, &amp;quot;amount&amp;quot;: 36, &amp;quot;amountInclTax&amp;quot;: 43.2, &amp;quot;amountCurrency&amp;quot;: &amp;quot;EUR&amp;quot; } ] }</code></pre> <h5>返回参数说明</h5> <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;">id</td> <td style="text-align: left;">int</td> <td>派送商id</td> </tr> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">string</td> <td>派送商代码</td> </tr> <tr> <td style="text-align: left;">logo</td> <td style="text-align: left;">string</td> <td>派送商图片</td> </tr> <tr> <td style="text-align: left;">timeLimit</td> <td style="text-align: left;">string</td> <td>派送时效</td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">float</td> <td>运费</td> </tr> <tr> <td style="text-align: left;">amountInclTax</td> <td style="text-align: left;">float</td> <td>运费(含税)</td> </tr> <tr> <td style="text-align: left;">amountCurrency</td> <td style="text-align: left;">string</td> <td>运费的币种</td> </tr> </tbody> </table> <h5>出错返回示例</h5> <pre><code>{ &amp;quot;success&amp;quot;: false, &amp;quot;message&amp;quot;: &amp;quot;Invalid login or password.&amp;quot; }</code></pre>

页面列表

ITEM_HTML