18.子单号申请
<h3>功能描述</h3>
<ul>
<li>该接口用于：客户在通过顺丰快递管家下订单接口提交订单后，可从此接口获取更多的子运单号。</li>
</ul>
<p><code>注：该接口只能在未揽收前生效；</code></p>
<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/order/v2/getSonNumberApply</td>
</tr>
</tbody>
</table>
<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;">必填</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;">companyId</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">分配客户sendAppId</td>
</tr>
<tr>
<td style="text-align: center;">2</td>
<td style="text-align: center;">orderId</td>
<td style="text-align: center;">String(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">客户订单号</td>
</tr>
<tr>
<td style="text-align: center;">3</td>
<td style="text-align: center;">parcelQuantity</td>
<td style="text-align: center;">String(5)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">新增加的包裹数，最大20</td>
</tr>
<tr>
<td style="text-align: center;">4</td>
<td style="text-align: center;">waybillNoInfoList</td>
<td style="text-align: center;">List<WaybillNoInfoJson></td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">顺丰运单号列表，参考目录中共用参数，不传运单号类型和运单号（附录-6.共用参数）</td>
</tr>
</tbody>
</table>
<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;">必填</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>
<tr>
<td style="text-align: center;">4</td>
<td style="text-align: center;">orderId</td>
<td style="text-align: center;">String(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">客户订单号</td>
</tr>
<tr>
<td style="text-align: center;">7</td>
<td style="text-align: center;">waybillNoInfoList</td>
<td style="text-align: center;">List<WaybillNoInfoJson></td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">顺丰运单号列表，参考目录中共用参数</td>
<td style="text-align: left;">附录-6.共用参数</td>
</tr>
</tbody>
</table>
<h3>报文范例</h3>
<ul>
<li>
<p><strong>请求报文</strong></p>
<pre><code>{
"companyId": xxx,
"orderId": "0df5afa0e7974151ab4a20c00b3097db",
"parcelQuantity": 2,
"waybillNoInfoList": [
{
"boxNo": "xianghao1",
"length": 1.1,
"width": 1.2,
"height": 1.3,
"weight": 1.4,
"volume": 1.5
},
{
"boxNo": "xianghao2",
"length": 2.1,
"width": 2.2,
"height": 2.3,
"weight": 2.4,
"volume": 2.5
}
]
}</code></pre>
</li>
<li><strong>响应报文</strong>
<ul>
<li>成功报文
<pre><code>{
"result": {
"waybillNoInfoList": "[{\"boxNo\":\"xianghao1\",\"height\":1.3,\"length\":1.1,\"volume\":1.5,\"waybillNo\":\"SF2080020583482\",\"waybillType\":2,\"weight\":1.4,\"width\":1.2},{\"boxNo\":\"xianghao2\",\"height\":2.3,\"length\":2.1,\"volume\":2.5,\"waybillNo\":\"SF2080020583490\",\"waybillType\":2,\"weight\":2.4,\"width\":2.2},{\"waybillNo\":\"SF1011812161092\",\"waybillType\":1}]",
"orderId": "0df5afa0e7974151ab4a20c00b3097db"
},
"succ": "ok",
"msg": null
}</code></pre></li>
<li>失败报文-范例1
<pre><code>{
"succ": "fail",
"msg":"无对应服务权限",
"result": null
}</code></pre></li>
</ul></li>
</ul>