---
title: "Excepciones"
url: https://docs.catalyst.zoho.com/es/sdk/android/v2/exceptions/
description: "Esta página de ayuda lista las excepciones comunes que pueden ocurrir en las ejecuciones de tu aplicación Catalyst Android"
last_updated: 2026-03-20T16:21:56Z
service: All Services
type: general
related_links:
  - name: "Developer Tools"
    url: /es/getting-started/set-up-a-catalyst-project/developer-tools
---

# Excepciones

Las excepciones son comportamientos defectuosos inesperados que ocurren durante la ejecución de la aplicación. Todos los errores y excepciones en las aplicaciones Catalyst Android son gestionados por enumeraciones llamadas `ZCatalystException`, definidas en el paquete Android SDK.

Si ocurre una excepción en tu aplicación, se devuelven las siguientes propiedades de la excepción:

* **`code`:** Identificador único del error
* **`errorMsg`:** Descripción general sobre el error
* **`errorDetails`:** Información adicional sobre el error
* **`originalException`:** La excepción real que fue lanzada

A continuación se muestra una lista de códigos de error comunes lanzados por Catalyst Android SDK y sus descripciones:

<table class="content-table">
<thead>
<tr>
<th class="w30p">Códigos de error</th>
<th class="w70p">Descripciones</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>INITIALIZATION_ERROR</strong></td>
<td>La inicialización del SDK falló</td>
</tr>
<tr>
<td><strong>LOGIN_ERROR</strong></td>
<td>El proceso de inicio de sesión falló para el usuario</td>
</tr>
<tr>
<td><strong>LOGOUT_FAILED</strong></td>
<td>El proceso de cierre de sesión falló para el usuario</td>
</tr>
<tr>
<td><strong>TOKEN_FETCH_ERROR</strong></td>
<td>No se pudo obtener el token de acceso</td>
</tr>
<tr>
<td><strong>RESPONSE_PARSE_ERROR</strong></td>
<td>La respuesta recibida no es analizable</td>
</tr>
<tr>
<td><strong>NO_NETWORK_AVAILABLE</strong></td>
<td>No hay conectividad de red disponible para realizar la llamada a la API</td>
</tr>
<tr>
<td><strong>API_FAILED</strong></td>
<td>La invocación de la API falló</td>
</tr>
<tr>
<td><strong>INVALID_DATA</strong></td>
<td>Los datos enviados no son de un tipo válido para el formato específico</td>
</tr>
<tr>
<td><strong>FILE_SIZE_EXCEEDED</strong></td>
<td>El tamaño del archivo subido excedió el límite de 100 MB</td>
</tr>
<tr>
<td><strong>FUNCTION_EXECUTION_ERROR</strong></td>
<td>No se pudo ejecutar la función</td>
</tr>
<tr>
<td><strong>JSON_EXCEPTION</strong></td>
<td>El cuerpo incluido en la solicitud no es un JSON válido</td>
</tr>
<tr>
<td><strong>INVALID_REQUEST</strong></td>
<td>La solicitud creada no es válida</td>
</tr>
<tr>
<td><strong>INVALID_FILE_INPUT</strong></td>
<td>El archivo enviado en la operación de carga no es válido</td>
</tr>
<tr>
<td><strong>INTERNAL_ERROR</strong></td>
<td>Ocurrió un error interno en el SDK</td>
</tr>
<tr>
<td><strong>INVALID_CONFIGURATION</strong></td>
<td>El SDK no se ha inicializado con la configuración requerida para el inicio de sesión. Reinicializa el SDK con la configuración apropiada para el inicio de sesión.</td>
</tr>
<tr>
<td><strong>CUSTOM_LOGIN_DISABLED</strong></td>
<td>No se pudieron encontrar los parámetros necesarios para la autenticación de terceros. Asegúrate de haber habilitado la autenticación de terceros para el proyecto o vuelve a descargar el archivo de propiedades.</td>
</tr>
</tbody>
</table>