【顺丰快递管家】通用接口文档


4.打印面单接口

<h3>功能描述</h3> <ul> <li>该接口用于: 1.客户系统向顺丰快递管家请求国际件订单面单;</li> </ul> <h3>接口定义</h3> <table> <thead> <tr> <th style="text-align: center;">服务名称</th> <th style="text-align: center;">批量交易</th> <th style="text-align: center;">接口类型</th> <th style="text-align: center;">接口uri</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">下订单</td> <td style="text-align: center;">不支持</td> <td style="text-align: center;">接入/POST</td> <td style="text-align: center;">/public/internationalOrder/v1/print</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求Body&gt;</strong></h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>companyId</td> <td>String(50)</td> <td>Y</td> <td>分配客户sendAppId</td> </tr> <tr> <td>3</td> <td>version</td> <td>String(10)</td> <td>N</td> <td>版本号(默认为空即可)</td> </tr> <tr> <td>4</td> <td>labelModeSize</td> <td>Integer</td> <td>N</td> <td>打印样式 0: 面单类100<em>210;发票类A4 1: 面单类100</em>150;发票类100<em>150 2: 面单类100</em>45(BBD合单包裹条形码) 7: 面单类100<em>45(BBD合单包裹二维码) 8: 面单类100</em>45(BBD预合单大包裹条形码)printType=1时默认值为1,printType=2时默认值为0</td> </tr> <tr> <td>5</td> <td>printType</td> <td>String(8)</td> <td>Y</td> <td>打印类型。1-运单 2-发票</td> </tr> <tr> <td>6</td> <td>printWaybillNoDtoList</td> <td>List<PrintWaybillNoDto></td> <td>Y</td> <td>支持批量打印 母单相同的子单(含母单)打印参数对象</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;**</strong>PrintWaybillNoDto**</h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>必填</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>sfWaybillNo</td> <td>String(32)</td> <td>是</td> <td>顺丰运单号</td> </tr> <tr> <td>3</td> <td>isPrintSubParent</td> <td>Integer</td> <td>否</td> <td>是否打印全部的子母单 0:否 1:是默认值:0</td> </tr> <tr> <td>4</td> <td>singlePrintWaybillNoList</td> <td>List<String></td> <td>否</td> <td>单独打印的运单号集合(含母单,子单);<strong>若isPrintSubParent 为0,则必填</strong></td> </tr> </tbody> </table> <h3>元素&lt;响应&gt;</h3> <table> <thead> <tr> <th style="text-align: center;">序号</th> <th style="text-align: center;">字段名</th> <th style="text-align: center;">类型(约束)</th> <th style="text-align: center;">必填</th> <th style="text-align: center;">字段说明</th> <th style="text-align: left;">描述</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">msg</td> <td style="text-align: center;">String (200)</td> <td style="text-align: center;">否</td> <td style="text-align: center;">信息</td> <td style="text-align: left;">提示信息</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">succ</td> <td style="text-align: center;">String (10)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">状态码</td> <td style="text-align: left;">返回成功或失败信息(ok/fail)</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">result</td> <td style="text-align: center;">String (/)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">数据</td> <td style="text-align: left;">数据</td> </tr> </tbody> </table> <h3><strong>元素&lt;请求&gt;result</strong></h3> <table> <thead> <tr> <th><strong>#</strong></th> <th><strong>属性名</strong></th> <th><strong>类型(约束)</strong></th> <th><strong>描述</strong></th> </tr> </thead> <tbody> <tr> <td>1</td> <td>url</td> <td>String</td> <td>打印的URL</td> </tr> <tr> <td>2</td> <td>sfWaybillNo</td> <td>String</td> <td>顺丰单号</td> </tr> <tr> <td>3</td> <td>customerOrderNo</td> <td>String</td> <td>用户订单号</td> </tr> </tbody> </table> <h3><strong>明文请求示例</strong></h3> <pre><code class="language-json">{ "companyId": "xxx", "labelModeSize": 0, "printType": "1", "printWaybillNoDtoList": [ { "isPrintSubParent": 1, "sfWaybillNo": "SF1020101040770" } ], "requestId": "1614077277245", "version": "1" }</code></pre> <h3><strong>明文响应示例</strong></h3> <pre><code class="language-json">{     "result": {         "customerOrderNo": "",         "sfWaybillNo": "",         "url": "https://iuop.sit.sf.global/iuop-iuop/api/print/printLabelByToken?token=031debedf0a54e4e88beb937d1ad0270"     },     "succ": "ok",     "msg": null }</code></pre>

页面列表

ITEM_HTML