激活（异步）

适用场景

当SIM卡服务合约有效期内，且有未启用套餐时，立即启用一个未启用的套餐

必要条件

仅支持对所用API key归属企业下的卡片进行操作。

SIM需同时满足非OTA卡、有未启用的套餐、服务合约未到期三个条件时适用。

注意事项

激活操作的处理为异步，接口同步响应成功代表领科系统接收请求成功。

获取操作异步处理结果的方式：

使用接口响应中的request_id通过 查询异步处理结果 进行处理结果查询。

通过notification api回调获取结果 pending

当激活操作异步处理结束前，卡片处于锁定状态，此时禁止对同一SIM进行激活、停机、复机、重置等操作。

异步处理过程通常可在几秒内结束，若运营商系统发生网络拥塞等异常，处理时长可达几十分甚至更长。

业务规则

激活处理成功后，SIM卡添加的套餐状态将进行如下变更：

激活前SIM卡没有使用中状态的套餐，将添加时间最早的未启用套餐A状态变更为使用中。

激活前SIM卡有使用中状态的套餐A，将添加时间最早的未启用套餐B状态变更为使用中，同时将原使用中的套餐A变更为暂停。

激活操作的异步处理结果可能会失败，当结果为失败时，用户可再次发起激活操作。

状态码

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

cede	message	solution
CB-01-0001	该SIM卡信息不存在	请检测ICCID是否为领科提供，或该ICCID归属企业是否与调用API使用的KeyID归属企业是否一致
CB-01-0204	废弃/停机保合约到期时间已过期卡片无法进行该操作	请联系领科确认SIM卡状态并人工处理
CB-01-0004	支持OTA的SIM卡无法进行此操作	暂不支持此类型卡片操作，请联系领科
CB-01-0007	多IMSI的SIM卡无法进行此操作	暂不支持此类型卡片操作，请联系领科
CB-01-0111	该SIM卡有请求处理中，不允许同时操作	等待同类型处理完成后再次操作
CB-02-0200	该SIM卡无有效的套餐，请先绑定套餐	请通过添加套餐接口绑定套餐
CB-01-0123	SIM卡已激活。	SIM卡状态正常为已激活，无需重复操作
CB-99-9500	系统繁忙，请稍后重试	请稍后再次重试

SDK API 调用方式

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v1().service().activateAsync(new ActivateAsync(1, "89314404000894487785"));
client.v2().service().activateAsync(new ActivateAsync(1, "89314404000894487785"));

适用场景

必要条件

注意事项

业务规则

状态码

SDK API 调用方式

请求参数

请求示例代码

返回响应

激活（异步）

适用场景#

必要条件#

注意事项#

业务规则#

状态码#

SDK API 调用方式#

请求参数

请求示例代码

返回响应

适用场景

必要条件

注意事项

业务规则

状态码

SDK API 调用方式