Controla los errores de la API de eUICC

Las APIs de eUICC proporcionan códigos de error para ayudar a las apps y a los usuarios a solucionar problemas relacionados con la descarga, la habilitación, la inhabilitación y el borrado de perfiles de eSIM.

Cómo solucionar errores

Cuando se produce un error al llamar a la API de eUICC, se proporciona una devolución de llamada de intent pendiente y se usa EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE como clave para obtener el código de error detallado. A partir de Android 11, se incluyen las siguientes cuatro claves y valores en el intent resultante:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: Proporciona información sobre lo que salió mal. Por ejemplo, descargar o borrar un perfil de eSIM. Este campo nunca está vacío.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE: Información sobre por qué se produjo el error. Por ejemplo, se agotó el tiempo de espera de la solicitud o el dispositivo está bloqueado para un operador. Este campo no se completa en los siguientes casos:

  • El código de operación es OPERATION_SMDX_SUBJECT_REASON_CODE.
  • El error es de nivel bajo, como IOException o InterruptedException.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: Se usa con EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE, que, en conjunto, proporcionan SubjectCode[5.2.6.1] y ReasonCode[5.2.6.2] de GSMA (SGP.22 v2.2). Este campo solo se propaga cuando el código de operación es OPERATION_SMDX_SUBJECT_REASON_CODE.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: Se usa con EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE, que, en conjunto, proporcionan SubjectCode[5.2.6.1] y ReasonCode[5.2.6.2] de GSMA (SGP.22 v2.2). Este campo solo se propaga cuando el código de operación es OPERATION_SMDX_SUBJECT_REASON_CODE.

Estos cuatro valores permiten que el llamador de la API de eUICC controle errores específicos de forma individual. A continuación, se muestra un ejemplo de cómo controlar 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.
}

Combinaciones admitidas de códigos de operación y error

En la siguiente tabla, se describe la combinación admitida de códigos de operación y error que devuelve el asistente de perfil local (LPA).