Excepciones

# 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 {{%badge%}}{{%bold%}}ZCatalystException{{%/bold%}}{{%/badge%}}, 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:

* {{%bold%}}{{%badge%}}code{{%/badge%}}:{{%/bold%}} Identificador único del error
* {{%bold%}}{{%badge%}}errorMsg{{%/badge%}}:{{%/bold%}} Descripción general sobre el error
* {{%bold%}}{{%badge%}}errorDetails{{%/badge%}}:{{%/bold%}} Información adicional sobre el error
* {{%bold%}}{{%badge%}}originalException{{%/badge%}}:{{%/bold%}} 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>INITIALIZATION_ERROR</td>
<td>La inicialización del SDK falló</td>
</tr>
<tr>
<td>LOGIN_ERROR</td>
<td>El proceso de inicio de sesión falló para el usuario</td>
</tr>
<tr>
<td>LOGOUT_FAILED</td>
<td>El proceso de cierre de sesión falló para el usuario</td>
</tr>
<tr>
<td>TOKEN_FETCH_ERROR</td>
<td>No se pudo obtener el token de acceso</td>
</tr>
<tr>
<td>RESPONSE_PARSE_ERROR</td>
<td>La respuesta recibida no es analizable</td>
</tr>
<tr>
<td>NO_NETWORK_AVAILABLE</td>
<td>La conectividad de red no está disponible para realizar la llamada API</td>
</tr>
<tr>
<td>API_FAILED</td>
<td>La invocación de la API falló</td>
</tr>
<tr>
<td>INVALID_DATA</td>
<td>Los datos enviados no son de un tipo válido para el formato específico</td>
</tr>
<tr>
<td>FILE_SIZE_EXCEEDED</td>
<td>El tamaño del archivo cargado excedió el límite de tamaño de archivo de 100 MB</td>
</tr>
<tr>
<td>FUNCTION_EXECUTION_ERROR</td>
<td>No se pudo ejecutar la función</td>
</tr>
<tr>
<td>JSON_EXCEPTION</td>
<td>El cuerpo incluido en la solicitud no es un JSON válido</td>
</tr>
<tr>
<td>INVALID_REQUEST</td>
<td>La solicitud creada no es válida</td>
</tr>
<tr>
<td>INVALID_FILE_INPUT</td>
<td>El archivo enviado en la operación de carga no es válido</td>
</tr>
<tr>
<td>INTERNAL_ERROR</td>
<td>Ocurrió un error interno en el SDK</td>
</tr>
<tr>
<td>INVALID_CONFIGURATION</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>CUSTOM_LOGIN_DISABLED</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:

* {{%badge%}}**code**{{%/badge%}}: Identificador único del error
* {{%badge%}}**message**{{%/badge%}}: Descripción general sobre el error
* {{%badge%}}**details**{{%/badge%}}: 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>INVALID_DATA</td>
<td>Los datos están en un formato inválido</td>
</tr>
<tr>
<td>INTERNAL_ERROR</td>
<td>El error ocurrió debido a problemas internos, servidores u otra causa</td>
</tr>
<tr>
<td>RESPONSE_NIL</td>
<td>No se devolvió respuesta del servidor</td>
</tr>
<tr>
<td>TOKEN_FETCH_ERROR</td>
<td>No se pudo obtener el token de acceso</td>
</tr>
<tr>
<td>OAUTH_FETCH_ERROR</td>
<td>Ocurrió un error al obtener el token OAUTH</td>
</tr>
<tr>
<td>UNABLE_TO_CONSTRUCT_URL</td>
<td>Ocurrió un error al construir la URL</td>
</tr>
<tr>
<td>PROCESSING_ERROR</td>
<td>Ocurrió un error al procesar los datos</td>
</tr>
<tr>
<td>TYPECAST_ERROR</td>
<td>Ocurrió un error al realizar la conversión de tipo de los datos</td>
</tr>
<tr>
<td>NO_INTERNET_CONNECTION</td>
<td>El dispositivo no está conectado a internet</td>
</tr>
<tr>
<td>REQUEST_TIMEOUT</td>
<td>La respuesta del servidor no llegó a tiempo</td>
</tr>
<tr>
<td>NETWORK_CONNECTION_LOST</td>
<td>El dispositivo ha perdido su conexión con Internet</td>
</tr>
<tr>
<td>INITIALIZATION_ERROR</td>
<td>Ocurrió un error al inicializar el SDK</td>
</tr>
<tr>
<td>FUNCTION_EXECUTION_ERROR</td>
<td>Ocurrió un error al ejecutar una función</td>
</tr>
<tr>
<td>JSON_EXCEPTION</td>
<td>Ocurrió un error al analizar el JSON</td>
</tr>
</tbody>
</table>

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:

Códigos de error	Descripciones
INITIALIZATION_ERROR	La inicialización del SDK falló
LOGIN_ERROR	El proceso de inicio de sesión falló para el usuario
LOGOUT_FAILED	El proceso de cierre de sesión falló para el usuario
TOKEN_FETCH_ERROR	No se pudo obtener el token de acceso
RESPONSE_PARSE_ERROR	La respuesta recibida no es analizable
NO_NETWORK_AVAILABLE	La conectividad de red no está disponible para realizar la llamada API
API_FAILED	La invocación de la API falló
INVALID_DATA	Los datos enviados no son de un tipo válido para el formato específico
FILE_SIZE_EXCEEDED	El tamaño del archivo cargado excedió el límite de tamaño de archivo de 100 MB
FUNCTION_EXECUTION_ERROR	No se pudo ejecutar la función
JSON_EXCEPTION	El cuerpo incluido en la solicitud no es un JSON válido
INVALID_REQUEST	La solicitud creada no es válida
INVALID_FILE_INPUT	El archivo enviado en la operación de carga no es válido
INTERNAL_ERROR	Ocurrió un error interno en el SDK
INVALID_CONFIGURATION	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.
CUSTOM_LOGIN_DISABLED	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.

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:

Códigos de error	Descripciones
INVALID_DATA	Los datos están en un formato inválido
INTERNAL_ERROR	El error ocurrió debido a problemas internos, servidores u otra causa
RESPONSE_NIL	No se devolvió respuesta del servidor
TOKEN_FETCH_ERROR	No se pudo obtener el token de acceso
OAUTH_FETCH_ERROR	Ocurrió un error al obtener el token OAUTH
UNABLE_TO_CONSTRUCT_URL	Ocurrió un error al construir la URL
PROCESSING_ERROR	Ocurrió un error al procesar los datos
TYPECAST_ERROR	Ocurrió un error al realizar la conversión de tipo de los datos
NO_INTERNET_CONNECTION	El dispositivo no está conectado a internet
REQUEST_TIMEOUT	La respuesta del servidor no llegó a tiempo
NETWORK_CONNECTION_LOST	El dispositivo ha perdido su conexión con Internet
INITIALIZATION_ERROR	Ocurrió un error al inicializar el SDK
FUNCTION_EXECUTION_ERROR	Ocurrió un error al ejecutar una función
JSON_EXCEPTION	Ocurrió un error al analizar el JSON

Última actualización 2026-03-20 21:51:56 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Developer Tools