> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/productos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/sdk-mobile/ios-sdk/manejo-de-errores-genericos.md).

# Manejo de Errores Genéricos

El lanzamiento del SDK siempre devuelve un resultado. El resultado puede ser negativo y contener un error.

El SDK iOS dispone de errores genéricos que aportan feedback al integrador sobre el motivo por el que se ha detenido el proceso.

#### Comunes - Básicos

Estados generales que no entran en una categoría funcional específica.

* `.NO_ERROR`: Estado por defecto; indica que la operación se completó sin incidencias.
* `.UNKNOWN_ERROR`: Se ha producido un error que no ha sido identificado o categorizado específicamente.
* `.OTHER(String)`: Error genérico para casos no contemplados. Incluye un mensaje personalizado mediante un `String`.

#### Comunes - Requisitos

Errores relacionados con la disponibilidad de datos, el ciclo de vida de los procesos o la conectividad.

* `.NO_DATA_ERROR`: El proceso necesita un valor de configuración que no ha sido informado correctamente o es nulo.
* `.OPERATION_NOT_CREATED`: La operación no pudo inicializarse correctamente.
* `.NETWORK_CONNECTION`: Error de comunicación; el dispositivo no tiene acceso a internet o el servidor no responde.

#### Comunes - Permisos

Se activan cuando el usuario o el sistema operativo deniegan el acceso a hardware o archivos.

* `CAMERA_PERMISSION_DENIED`: El acceso a la cámara del dispositivo fue bloqueado.
* `MIC_PERMISSION_DENIED`: El acceso al micrófono fue bloqueado.
* `LOCATION_PERMISSION_DENIED`: Los servicios de ubicación (GPS) no están autorizados.
* `STORAGE_PERMISSION_DENIED`: Se denegó el permiso de lectura/escritura en el almacenamiento local.

#### Comunes - Interacción del Usuario

Errores derivados del comportamiento del usuario o restricciones de la sesión.

* `CANCEL_BY_USER`: El proceso fue cancelado explícitamente por el usuario.
* `SDK_TIMEOUT`: El proceso de captura excedió el tiempo máximo de espera configurado a nivel de SDK. Los componentes Selphi y SelphID pueden devolver además `.SELPHI_TIMEOUT` o `.SELPHID_TIMEOUT` con información adicional; serializados como `SPI_TIMEOUT` o `SPD_TIMEOUT` mediante `toString(addComponentPrefix:)`.

#### Comunes - Errores de Licencia

Errores de validación relacionados con la clave de licencia o los componentes del SDK.

* `.LICENSE_CHECKER_ERROR(String)`: Error general durante la validación de la licencia con el servidor. El parámetro `String` indica el detalle de forma más explícita.
* `.MISSING_COMPONENT_LICENSE_DATA`: El componente que se está intentando lanzar necesita datos que no se han configurado correctamente en la licencia.
* `.COMPONENT_LICENSE_ERROR`: El componente que se intenta utilizar no está habilitado en la licencia.
* `.EMPTY_LICENSE`: El campo de la licencia está vacío.

**Además de los genéricos, cada módulo puede contener errores específicos que se verán detallados en sus respectivas páginas de la documentación.**