Ir al contenido principal

Integración - Resolver un error de API o de archivo

En este artículo, te explicamos qué significa el estado "En error" en tus cuentas de API o archivos y cómo solucionar el problema.

📝 Descripción

Descubre el significado del estado «En error» para tu cuenta API o tu archivo en Waltio, así como los pasos a seguir para solucionar el problema.

Este estado indica que Waltio ya no logra recuperar o leer correctamente los datos de la plataforma correspondiente. Tus datos ya importados no se eliminarán, pero las nuevas transacciones dejarán de sincronizarse hasta que se regularice la situación.


⚠️ Advertencias

  • Nunca compartas tu clave secreta o tu clave API completa fuera de nuestros canales oficiales: el equipo de Waltio te la solicitará únicamente a través del chat del sitio web o por correo electrónico a [email protected], mediante un medio seguro.

  • Eliminar tu cuenta API o archivo en error borrará todas tus transacciones, así como cualquier modificación que hayas realizado. Si has hecho un número considerable de modificaciones en tus transacciones, no lo elimines: contacta antes con el equipo de soporte para encontrar otra solución.

📂 Resolución de una cuenta API en error

Una conexión API puede entrar en error debido a una clave caducada, eliminada o modificada, un servidor remoto no disponible o un problema de sincronización. Para solucionar un fallo relacionado con una API:

  1. Ve a la página Cuentas en Waltio y consulta el mensaje de error que aparece en la cuenta afectada.

  2. Si el mensaje indica que la clave ha caducado o que sus permisos han cambiado, vuelve a conectarte a la plataforma correspondiente.

  3. Elimina o desactiva la clave API anterior en la plataforma si es necesario y, a continuación, crea una nueva clave API. ⚠️ Atención: esto eliminará todas las transacciones y las modificaciones que hayas realizado en ellas (como la adición de etiquetas, por ejemplo).

  4. Haz clic en Añadir una cuenta e introduce la nueva conexión API en Waltio.

  5. Si Waltio te solicita Forzar la sincronización, confirma la acción.

  6. Comprueba que el estado de la cuenta vuelve a la normalidad y que aparecen las últimas transacciones.

Si el error persiste, contacta con el soporte facilitando la siguiente información:

  • El nombre de la plataforma.

  • El mensaje de error exacto.

  • Una captura de pantalla de los permisos de tu clave API, si los hay.

  • La confirmación de la modificación o recreación de la clave API.

He cerrado una cuenta y ahora la API muestra un error. ¿Qué debo hacer?

  • ⚠️ No elimines la API; de lo contrario, te arriesgas a perder todo tu historial de transacciones sin posibilidad de recuperación.

  • Desde la página Cuentas, haz clic en el signo de exclamación junto al mensaje de error y, a continuación, en el botón Archivar.

  • Esto hará que desaparezca el error manteniendo tu historial.


📂 Resolución de un archivo en error

Un archivo es rechazado cuando su estructura no coincide con el formato esperado (exportación incorrecta, modificación del archivo, cambio de formato por parte de la plataforma o nuevo tipo de operación). Para solucionar un fallo relacionado con un archivo:

  1. Comprueba que has exportado todo el historial de transacciones.

  2. Consulta el tutorial de la plataforma en nuestro Centro de Ayuda para seleccionar el tipo de exportación adecuado.

  3. Descarga de nuevo el archivo original directamente desde la plataforma.

  4. Ve a Mis cuentas e importa el archivo original sin abrirlo ni modificar sus columnas o su contenido.

  5. Si la importación vuelve a fallar, intenta generar una nueva exportación que cubra el mismo periodo.

  6. Si el problema persiste, envía tu archivo original al soporte a través del chat.

💡 API o archivo: ¿qué método es mejor elegir?

La elección del método depende de tu situación:

  • Conexión API: permite sincronizar automáticamente tus nuevas transacciones.

  • Archivo CSV / Excel: recomendado si la conexión API no está disponible, si no cubre la totalidad del historial o debido a limitaciones técnicas.

Para identificar el método óptimo, consulta el tutorial dedicado a tu plataforma en el Centro de Ayuda.

💡 ¿Cuándo debes contactar con el soporte?

Contacta con el equipo de soporte en los siguientes casos:

  • Tu cuenta API sigue mostrando un error tras la creación de una nueva clave.

  • Has realizado un gran número de modificaciones en tus transacciones y no quieres perderlas.

  • Tu archivo conforme es rechazado en varias ocasiones.

  • Faltan operaciones tras una reimportación o una resincronización.

  • Tienes dudas sobre qué archivo exportar o qué permisos conceder.

Para agilizar la gestión, comunica siempre el nombre de la plataforma, el mensaje de error exacto y el método de importación utilizado (API o Archivo).

Nunca compartas tu clave secreta o tu clave API completa fuera de nuestros canales oficiales: el equipo de Waltio te la solicitará únicamente a través del chat del sitio web o por correo electrónico a [email protected], mediante un medio seguro.

¿Ha quedado contestada tu pregunta?