导入号卡接口
<h3>API接口文档:导入号卡信息</h3>
<h4><strong>请求方式</strong></h4>
<p><code>POST</code></p>
<h4><strong>请求URL</strong></h4>
<pre><code>/cbn/tenantBizAreaSimLog/sim/change/import</code></pre>
<hr />
<h4><strong>请求参数(Body 类型 : multipart/form-data)</strong></h4>
<p><code>10 按号段指定号卡业务区域</code></p>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必填</th>
<th>描述</th>
<th>示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>file</code></td>
<td>file</td>
<td>是</td>
<td>文件</td>
<td><code>1042渠道商指定区域号卡数据.xlsx</code></td>
</tr>
</tbody>
</table>
<hr />
<h4><strong>响应参数</strong></h4>
<h5>整体结构</h5>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>code</code></td>
<td>Integer</td>
<td>状态码(0=成功)</td>
</tr>
<tr>
<td><code>msg</code></td>
<td>String</td>
<td>状态描述</td>
</tr>
<tr>
<td><code>data</code></td>
<td>Object</td>
<td>导入成功响应的KEY</td>
</tr>
</tbody>
</table>
<h5>变更状态枚举(<code>changeStatus</code>)</h5>
<table>
<thead>
<tr>
<th>值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>10</td>
<td>成功</td>
</tr>
<tr>
<td>20</td>
<td>失败</td>
</tr>
<tr>
<td>30</td>
<td>号卡归属渠道商不一致</td>
</tr>
<tr>
<td>40</td>
<td>号卡已激活</td>
</tr>
<tr>
<td>50</td>
<td>号卡已指定业务区域</td>
</tr>
</tbody>
</table>
<hr />
<h4><strong>请求示例</strong></h4>
<p><code>10 按号段指定号卡业务区域</code></p>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;rqtid&quot;: &quot;310026uvmqto&quot;,
&quot;versionCode&quot;: &quot;2.0&quot;,
&quot;data&quot;: &quot;1914f39b18a542fc9b01415ca70f42c2&quot;,
&quot;model&quot;: {
&quot;dict&quot;: {}
}
}</code></pre>
<p><code>20 按ICCID集合指定号卡业务区域</code></p>
<pre><code class="language-json">{
&quot;changeAreaType&quot;: &quot;20&quot;,
&quot;changeMsisdnList&quot;: [
{
&quot;iccid&quot;: &quot;89861500192441123001&quot;
},
{
&quot;iccid&quot;: &quot;89861500192441123002&quot;
},
{
&quot;iccid&quot;: &quot;89861500192441123003&quot;
}
],
&quot;tenantCode&quot;: &quot;1042&quot;,
&quot;tenantBizAreaId&quot;: 1
}</code></pre>
<p><code>30 按号卡数量指定号卡业务区域</code></p>
<pre><code class="language-json">{
&quot;changeAreaType&quot;: 10,
&quot;changeCount&quot;:50,
&quot;tenantBizAreaId&quot;: 1,
&quot;tenantCode&quot;: &quot;1042&quot;
}</code></pre>
<h4><strong>响应示例(成功)</strong></h4>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;data&quot;: {
&quot;success&quot;: false,
&quot;data&quot;: [
{
&quot;tenantCode&quot;: &quot;1051&quot;,
&quot;msisdn&quot;: &quot;19277552720&quot;,
&quot;iccid&quot;: &quot;89861500192441123001&quot;,
&quot;changeStatus&quot;: 30,
&quot;failMsg&quot;: &quot;号卡归属渠道商与当前渠道商不一致&quot;
},
{
&quot;tenantCode&quot;: &quot;1042&quot;,
&quot;msisdn&quot;: &quot;19277552721&quot;,
&quot;iccid&quot;: &quot;89861500192441123002&quot;,
&quot;changeStatus&quot;: 50,
&quot;failMsg&quot;: &quot;号卡已指定业务区域,并且非当前指定渠道商业务区域报备&quot;
}
],
&quot;changeCount&quot;: 600,
&quot;successCount&quot;: 227,
&quot;exceptionCount&quot;: 373,
&quot;message&quot;: &quot;目前号段包含有373张卡已指定区域,是否将它改为目前指定区域?&quot;,
&quot;requestId&quot;: &quot;dee1e253fb5b416e901834b6d5486b8b&quot;
}
}</code></pre>
<h4><strong>响应示例(失败)</strong></h4>
<pre><code class="language-json">{
&quot;code&quot;: 500,
&quot;msg&quot;: &quot;号卡指定区域所属配置不能为空&quot;
}</code></pre>
<hr />
<h4><strong>注意事项</strong></h4>
<ol>
<li><strong>参数依赖规则</strong>:
<ul>
<li><code>changeAreaType=10</code>(按号段)时,<code>iccidHead</code>、<code>iccidBegin</code>、<code>iccidEnd</code>必填。</li>
<li><code>changeAreaType=20</code>(按卡号)时,<code>iccidList</code>必填。</li>
<li><code>changeAreaType=30</code>(按数量)时,<code>changeCount</code>必填。</li>
</ul></li>
<li><strong>业务校验规则</strong>:
<ul>
<li>若号卡已激活(<code>changeStatus=40</code>)或归属渠道商不一致(<code>changeStatus=30</code>),则无法变更。</li>
<li>若号卡已指定业务区域(<code>changeStatus=50</code>),需根据<code>message</code>提示用户确认是否覆盖。</li>
</ul></li>
<li><strong>错误处理</strong>:
<ul>
<li>若<code>bizAreaCode</code>或<code>bizAreaName</code>为空,返回<code>500</code>错误("号卡指定区域不能为空")。</li>
<li>若<code>tenantBizAreaId</code>未关联有效配置,返回<code>500</code>错误("号卡指定区域所属配置不能为空")。</li>
</ul></li>
</ol>