---
title: Manejo de errores
canonical: https://developer.unico.io/es/dual-api/developers/sdks-and-tools/web/web-sdk/error-handling
locale: es
generated_by: markdown-export
---

Todo el manejo de errores del Web SDK está centralizado en esta sección. El callback `error` recibe un objeto `ErrorBio` que expone `getCode()` y `getDescription()`.

## prepareCamera errors

| Código | Descripción |
|---|---|
| `73000` | Error desconocido e inesperado durante el uso normal de las APIs del SDK |
| `73001` | `<property>` es obligatorio |
| `73002` | `<property>` debe ser una instancia de `<class>` |
| `73003` | `<class>` con nombre `<name>` no está disponible para inyección |
| `73004` | El tipo de clase debe ser una función o una clase |
| `73005` | No se pudo encontrar la configuración regional `<locale>` |
| `73006` | No se pudo encontrar el texto: `<text>` |
| `73100` | No se puede conectar a internet |
| `73200` | No se pudo encontrar el archivo JSON del SDK de Unico |
| `73201` | No se pudo cargar el archivo JSON del SDK de Unico |
| `73202` | El archivo JSON del SDK de Unico no es válido |
| `73204` | No se puede inicializar el SDK — configure el entorno mediante `setEnvironment` en la compilación |
| `73300` | No se pudo autenticar esta aplicación |
| `73301` | No se pudo autenticar esta aplicación |
| `73302` | No se encontró el token de autenticación |
| `73303` | El host actual no está registrado |
| `73400` | No se pudo inicializar la cámara |
| `73401` | No se pudieron cargar los modelos de ML para esta cámara |
| `73402` | La clave no pudo verificarse debido a problemas de conectividad en el dispositivo del usuario |
| `73403` | Esta combinación de dispositivo/plataforma/navegador/versión no es compatible con el SDK |
| `73404` | El dispositivo está en orientación horizontal. El SDK solo puede usarse en modo vertical |
| `73405` | Dispositivo bloqueado debido a múltiples intentos fallidos |
| `73406` | La inicialización de la cámara fue bloqueada — el SDK se abrió en un iFrame durante `prepareCamera` |
| `73407` | El SDK no se cargó completamente |
| `73500` | No se pudo obtener la sesión |
| `73501` | No se pudo obtener la sesión |
| `73502` | No se encontró el token de sesión |
| `73600` | No se pudo encontrar el recurso de cámara |
| `73601` | No se pudo iniciar la cámara en modo de producción |
| `74000` | Hexadecimal no válido |
| `74001` | El objeto no es un `UnicoTheme` |

## openCamera errors

| Código | Descripción |
|---|---|
| `73700` | No se pudo analizar la respuesta de la cámara |
| `73704` | El usuario presionó el botón de cancelar y no completó la sesión |
| `73706` | Acceso a la cámara denegado — el usuario denegó explícitamente el permiso o la política del dispositivo lo bloquea |
| `73707` | La sesión fue cancelada porque la aplicación fue terminada, entró en reposo, recibió una notificación del SO o pasó a segundo plano |
| `73708` | La sesión fue cancelada porque el dispositivo está en modo horizontal |
| `73710` | La sesión fue cancelada porque el usuario no pudo completarla dentro del tiempo límite asignado |
| `73715` | La sesión fue cancelada porque no todas las imágenes de guía fueron configuradas |
| `73716` | La sesión fue cancelada porque el SDK no pudo iniciar la cámara en este dispositivo |
| `73717` | La sesión fue cancelada porque el usuario estaba en estado bloqueado |
| `73718` | Error desconocido e inesperado durante el uso normal de las APIs del SDK |
| `73720` | El desarrollador canceló programáticamente la sesión mediante la API de cancelación |
| `73721` | La sesión fue cancelada debido a un cambio de orientación del dispositivo durante la sesión |
| `73722` | La sesión fue cancelada porque el documento no está listo |
| `73723` | La sesión fue cancelada porque había otra sesión en curso |
| `73724` | La sesión activa fue cancelada porque la sesión de cámara se inició dentro de un iFrame |
| `73728` | Error de conexión — utilice HTTPS para conectarse |
| `73729` | Navegador no compatible — ábralo en otro navegador |
| `73730` | No se puede inicializar una sesión de liveness activo — error de licencia desconocido |
| `73731` | No se puede inicializar una sesión de liveness activo — licencia vencida |
| `73732` | No se puede inicializar una sesión de liveness activo — el origen no está permitido |
| `73750` | La captura falló porque los ojos del usuario estaban cerrados |
| `73760` | La captura falló por la iluminación del entorno (demasiado oscuro, demasiado claro o irregular) |
| `73761` | La captura falló por la distancia entre el rostro del usuario y la pantalla (demasiado cerca o demasiado lejos) |
| `73762` | La captura falló porque lentes o accesorios cubren el rostro del usuario |
| `73763` | La captura falló porque el rostro del usuario no estaba firme ni alineado |
| `73764` | La captura falló por el encuadre del rostro (rostro descentrado, más de un rostro o fondo cargado) |
| `73800` | No se pudo cifrar la respuesta |
| `73900` | No se pudo obtener información del sistema |

:::secondary[Catálogo oficial de errores]
Los códigos anteriores reflejan el catálogo del Web SDK. El catálogo oficial de códigos de error multiplataforma está disponible en [Referencia de API > Códigos de error](/dual-api/developers/api-reference/error-codes).
:::

## Manejo del callback

```javascript
const callback = {
  on: {
    success: (obj) => {
      console.log(obj.base64);
      console.log(obj.encrypted);
    },
    error: (error) => {
      const code = error.getCode();
      const description = error.getDescription();
      // handle error
    }
  }
};
```

:::danger[Callback obligatorio]
El objeto `callback` es obligatorio. Si no está correctamente implementado (cubriendo tanto los eventos `success` como `error`), el SDK lanza una excepción que, si no se maneja, se muestra en la consola del usuario.
:::