---
title: "Excepciones"
url: https://docs.catalyst.zoho.com/es/sdk/flutter/v2/exceptions/
description: "Esta página de ayuda lista las excepciones comunes que pueden ocurrir en las ejecuciones de tu aplicación Catalyst Android e iOS construida con Flutter SDK."
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 aplicaciones Android o iOS construidas con Flutter SDK son manejados por enumeraciones llamadas `ZCatalystException`, definidas en el paquete del Android SDK.

Si ocurre una excepción en tu aplicación móvil, se devuelven las siguientes propiedades Dart 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 el Catalyst Flutter 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>La conectividad de red no está disponible para realizar la llamada 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 cargado excedió el límite de tamaño de archivo 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 ha sido 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 requeridos 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>

### Excepciones en aplicaciones iOS

Si ocurre un error en tu aplicación iOS, se devuelven las siguientes propiedades del error:

* `code`: Identificador único del error
* `message`: Descripción general sobre el error
* `details`: Información adicional sobre el error

A continuación se muestra una lista de códigos de error comunes lanzados por el Catalyst iOS 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>INVALID_DATA</strong></td>
<td>Los datos están en un formato inválido</td>
</tr>
<tr>
<td><strong>INTERNAL_ERROR</strong></td>
<td>El error ocurrió debido a problemas internos, servidores u otra causa</td>
</tr>
<tr>
<td><strong>RESPONSE_NIL</strong></td>
<td>No se devolvió respuesta del servidor</td>
</tr>
<tr>
<td><strong>TOKEN_FETCH_ERROR</strong></td>
<td>No se pudo obtener el token de acceso</td>
</tr>
<tr>
<td><strong>OAUTH_FETCH_ERROR</strong></td>
<td>Ocurrió un error al obtener el token OAUTH</td>
</tr>
<tr>
<td><strong>UNABLE_TO_CONSTRUCT_URL</strong></td>
<td>Ocurrió un error al construir la URL</td>
</tr>
<tr>
<td><strong>PROCESSING_ERROR</strong></td>
<td>Ocurrió un error al procesar los datos</td>
</tr>
<tr>
<td><strong>TYPECAST_ERROR</strong></td>
<td>Ocurrió un error al realizar la conversión de tipo de los datos</td>
</tr>
<tr>
<td><strong>NO_INTERNET_CONNECTION</strong></td>
<td>El dispositivo no está conectado a internet</td>
</tr>
<tr>
<td><strong>REQUEST_TIMEOUT</strong></td>
<td>La respuesta del servidor no llegó a tiempo</td>
</tr>
<tr>
<td><strong>NETWORK_CONNECTION_LOST</strong></td>
<td>El dispositivo ha perdido su conexión con Internet</td>
</tr>
<tr>
<td><strong>INITIALIZATION_ERROR</strong></td>
<td>Ocurrió un error al inicializar el SDK</td>
</tr>
<tr>
<td><strong>FUNCTION_EXECUTION_ERROR</strong></td>
<td>Ocurrió un error al ejecutar una función</td>
</tr>
<tr>
<td><strong>JSON_EXCEPTION</strong></td>
<td>Ocurrió un error al analizar el JSON</td>
</tr>
</tbody>
</table>