非OTA更换套餐

适用场景

• SIM卡当前绑定的套餐不符合使用需求，需要更换为特定套餐并立即启用新套餐。

  必要条件

1. 仅支持对所用API key归属企业下的卡片进行操作。
2. 仅非OTA（包括多IMSI)卡片均支持操作。
3. SIM卡状态必须为Active-live/23（有使用中的副号套餐）。更多关于 SIM生命周期
4. SIM卡当前没有补充套餐。
5. SIM卡不在任一流量池中。
6. 仅支持对基础套餐进行更换。

   注意事项

7. 更换套餐操作为异步处理，接口同步响应成功代表领科系统接收请求成功。
8. 获取操作异步处理结果的方式：
9. 使用接口响应中的request_id通过GET/sims/async_result/{request_id}进行处理结果查询。
10. 通过notification api回调获取结果 pending
11. 异步处理结束完成前，卡片处于锁定状态，此时禁止对同一SIM进行激活、停机、复机、重置等操作。同理，因其他操作被锁定时，卡片将无法更换套餐，请稍后重试。
12. 异步处理过程通常可在几秒内结束，若运营商系统发生网络拥塞等异常，处理时长可达几十分甚至更长。
13. 异步处理结果可能会失败，当结果为失败时，用户可再次发起更换套餐的操作。

    业务规则

14. 若更换的新套餐与原套餐一致，则不执行更换。
15. 更换的新套餐周期类型可与原套餐周期类型不一致。
16. 更换的新套餐支持设置独立的订购周期数，可与原套餐不一致。
17. 更换套餐成功后，SIM卡原使用中套餐将被提前结束，新更换的套餐立即启用。

返回码

主要描述本接口中data.code中的返回码及对应的错位原因

SDK API 调用方式

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v2().service().switchBundle(new SwitchBundle(1, "89852121501108202924", "LP20230816004116", 1));