El APIs de eUICC proporcionar códigos de error para ayudar a las apps y los usuarios a solucionar problemas relacionados con descargar, habilitar, inhabilitar y borrar perfiles de eSIM
Cómo solucionar errores
Cuando se produce un error durante la llamada a la API de eUICC, se aplica una devolución de llamada de intent pendiente
proporcionadas y
EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE
se utiliza como la clave para obtener el código de error detallado. A partir de
En Android 11, las siguientes cuatro claves y valores son
en el intent resultante:
EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE
: Proporciona información sobre lo que salió mal. Por ejemplo, descargar o borrando un perfil de eSIM. Este campo nunca está vacío.EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE
: Información sobre el motivo del error. Por ejemplo, la solicitud cronometrada o que el dispositivo esté bloqueado por el operador. Este campo no se completa en la los siguientes casos:- El código de operación es
OPERATION_SMDX_SUBJECT_REASON_CODE
- Es un error de bajo nivel, como
IOException
oInterruptedException
- El código de operación es
EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE
: Se usa conEXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE
, que en conjunto proporcionar el SubjectCode[5.2.6.1] y el ReasonCode[5.2.6.2] de GSMA (SGP.22 v2.2). Este campo se completa solo cuando el código de operación esOPERATION_SMDX_SUBJECT_REASON_CODE
EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE
: Se usa conEXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE
, que en conjunto proporcionar el SubjectCode[5.2.6.1] y el ReasonCode[5.2.6.2] de GSMA (SGP.22 v2.2). Este campo se completa solo cuando el código de operación esOPERATION_SMDX_SUBJECT_REASON_CODE
Estos cuatro valores permiten que el llamador de la API de eUICC maneje errores específicos individualmente. El siguiente es un ejemplo de cómo manejar estos errores.
int operationCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
int errorCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
String smdxSubjectCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE)
String smdxReasonCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE)
if (operationCode == OPERATION_DOWNLOAD && errorCode == ERROR_CARRIER_LOCKED) {
// handle specific error i.e. tries to download but the device is carrier locked
} else if (operationCode == OPERATION_SMDX) {
// handle all SM-DP+/SM-DS errors
} else if (errorCode == ERROR_TIME_OUT) {
// handle all types of time out issues, regardless of operation.
} else if ("8.1".equals(smdxSubjectCode) && "3.1".equals(smdxReasonCode)) {
// handle specific subject code and reason code: 8.1 and 4.1 means insufficient memory.
}
Operación admitidas y combinaciones de códigos de error
En la siguiente tabla, se describe la combinación admitida de operación y los códigos de error que muestra el asistente de perfil local (LPA).
Combinaciones de código de operación y error | |||
---|---|---|---|
Código de operación | Código de error | Descripción | |
OPERATION_SYSTEM |
No aplicable | Se produjo un error interno. Por ejemplo, se interrumpió el subproceso o
Se produjo IOException error. |
|
OPERATION_SIM_SLOT |
No aplicable | Se produjo un error interno al realizar una operación de ranura de SIM. | |
ERROR_TIME_OUT |
Se agotó el tiempo de espera para realizar una operación de ranura de SIM. | ||
ERROR_EUICC_MISSING |
No hay ningún eUICC disponible ni activo en el dispositivo. | ||
OPERATION_EUICC_CARD |
No aplicable | Se produjo un error interno mientras se realizaba una operación eUICC. | |
ERROR_UNSUPPORTED_VERSION |
La versión de eUICC (chip) y la de EuiccCard (software) no compatibles. | ||
ERROR_EUICC_MISSING |
No hay ninguna tarjeta SIM disponible en el dispositivo. Por ejemplo, la LPA no puede detectar la tarjeta SIM. | ||
OPERATION_SMDX |
No aplicable | Se produjo un error interno al realizar una operación SM-DP+/SM-DS. | |
ERROR_ADDRESS_MISSING |
No hay una dirección SM-DP+ para descargar el perfil. | ||
ERROR_INVALID_CONFIRMATION_CODE |
Se produjo un error al analizar el código de activación (formato no válido). | ||
ERROR_CERTIFICATE_ERROR |
Error de almacén de claves o certificado cuando se usa en la conexión TLS para verificación. | ||
ERROR_NO_PROFILES_AVAILABLE |
No hay perfiles disponibles de SM-DP+. | ||
ERROR_CONNECTION_ERROR |
No se puede crear la conexión con el servidor. | ||
ERROR_INVALID_RESPONSE |
Respuesta no válida del servidor SM-DP+/SM-DS. | ||
OPERATION_SWITCH |
No aplicable | Se produjo un error interno al realizar la operación de cambio. | |
ERROR_CARRIER_LOCKED |
No se puede cambiar de perfil porque el dispositivo está bloqueado por operador (SIM) (bloqueada). | ||
OPERATION_DOWNLOAD |
No aplicable | Se produjo un error interno al realizar una operación de descarga. | |
ERROR_DISALLOWED_BY_PPR |
La Tabla de autorización de reglas del eUICC es nula o la descarga es no permitido por la regla de la política de perfil. | ||
ERROR_INVALID_ACTIVATION_CODE |
Se produjo un error al analizar el código de activación (formato no válido) o intentas realizar la descarga sin un código de activación. | ||
ERROR_CARRIER_LOCKED |
No se puede descargar porque el dispositivo está bloqueado por operador (SIM) (bloqueada). | ||
ERROR_INCOMPATIBLE_CARRIER |
El operador está en la lista negra y la LPA no puede descargar un perfil de SM-DP+/SM-DS | ||
ERROR_OPERATION_BUSY |
La descarga del perfil está en curso y no hay ninguna otra acción que pueda activar la tarjeta SIM se permiten los cambios de estado. | ||
OPERATION_METADATA |
No aplicable | Se produjo un error interno al realizar la operación de metadatos. | |
ERROR_INVALID_ACTIVATION_CODE |
Los metadatos de la suscripción están vacíos o el código de activación dentro los metadatos de la suscripción están vacíos o no son válidos. | ||
ERROR_INCOMPATIBLE_CARRIER |
El operador está en la lista negra y la LPA no puede descargar los servicios de SM-DP+/SM-DS. | ||
OPERATION_EUICC_GSMA |
No aplicable | Se produjo un error interno mientras se realizaba una operación GSMA eUICC. | |
ERROR_INSTALL_PROFILE |
Se produjo un error con eUICC mientras se intentaba instalar el perfil. Por ejemplo, el perfil ya existe o el ICCID no coincide. | ||
ERROR_EUICC_INSUFFICIENT_MEMORY |
Se produjo un error con eUICC mientras se intentaba instalar el perfil. No hay suficiente memoria en el eUICC. | ||
ERROR_DISALLOWED_BY_PPR |
Se produjo un error con eUICC mientras se intentaba instalar el perfil. No lo permite el regla de política de perfil. | ||
OPERATION_APDU |
No aplicable | Se produjo un error interno cuando se realizaba una operación de APDU. | |
OPERATION_HTTP |
1-999 |
El código de error es un valor de error de HTTP. | |
Código de operación | Código de asunto | Código del motivo | Descripción |
OPERATION_SMDX_SUBJECT_REASON_CODE |
La cadena contiene 3 dígitos separados por un punto, sin ceros a la izquierda. Para
por ejemplo, 8.1.1 . |
La cadena contiene 3 dígitos separados por un punto sin ceros a la izquierda. Para
por ejemplo, 3.8 . |
SubjectCode[5.2.6.1] y ReasonCode[5.2.6.2] de GSMA (SGP.22 v2.2). Para
ejemplo, un SubjectCode de 8.1.1 y un ReasonCode de
3.8 significa que el EID
está vinculado a otro dispositivo. |