Cuando subes un archivo CSV o Excel, Finbooks comprueba su formato y su contenido antes de importar nada. Si el archivo no coincide con lo que espera la conexión, se marca como Rechazado y no se importa ninguna transacción.
Este artículo explica cómo leer el resultado, las causas de rechazo más habituales y qué hacer a continuación.
Cómo comprobar qué ha fallado
Justo después de hacer clic en Subir CSV, Finbooks valida cada archivo y te lleva al paso Comprobar resultado de la importación. Sigue estos pasos para leer el resultado:
en el paso Comprobar resultado de la importación, busca tu archivo en la lista
consulta las columnas Número de filas, Estado del archivo y el estado de la importación (consulta la tabla de abajo)
si el archivo está Rechazado con un número de filas con errores, haz clic en Ver errores para abrir el panel de detalles de los errores, donde puedes ver el error concreto de cada fila
haz clic en Exportar errores para descargar la lista de errores como archivo CSV
Si el estado de la importación es Formato incorrecto, no hay ningún informe de errores disponible: la cabecera del archivo es incorrecta, así que no hay errores de fila que mostrar. Comprueba la cabecera con la guía de tu conexión.
Cuando la cabecera es incorrecta, la app muestra un botón Download template CSV. Es la solución más rápida: descarga la plantilla y copia en ella tus transacciones.
Resultado de la importación según el estado del archivo:
Estado del archivo | Número de filas | Estado de la importación | Qué significa |
Subido | Número de transacciones importadas | Importado o En curso | el formato es correcto y el archivo se ha aceptado |
Rechazado | 0 | Formato incorrecto | la cabecera del archivo es incorrecta, no se ha importado nada y no hay informe de errores disponible |
Rechazado | 0 | Número de filas con errores | el archivo tiene filas que no se pueden leer, por lo que se rechaza el archivo completo y no se ha importado nada |
⚠️ Los errores no se guardan
Los detalles de los errores solo están disponibles mientras estás en el paso Comprobar resultado de la importación. Si sales de la página o inicias una nueva carga, se pierden. Descarga el informe de errores con Exportar errores antes de salir, o vuelve a subir el archivo para ver los errores de nuevo.
Causas habituales de rechazo y cómo solucionarlas
Revisa las causas siguientes por orden. La mayoría de los rechazos se deben a las cuatro primeras.
El tipo de archivo no coincide con la conexión
Algunas conexiones solo aceptan archivos CSV y otras aceptan archivos Excel (.xlsx) nativos. Consulta la guía de conexión de tu plataforma para ver qué formato admite.
Si la guía pide el archivo exactamente como lo exporta la plataforma, súbelo sin convertirlo. Volver a guardar un archivo en otro formato puede cambiar su estructura.
El archivo se ha editado o se ha vuelto a guardar
Abrir un CSV en Excel y guardarlo de nuevo puede añadir cambios que no ves, por ejemplo comillas adicionales en la cabecera o en las primeras filas. Esto basta para que el archivo sea rechazado.
Si necesitas revisar un archivo, ábrelo con un editor de texto sin formato (Bloc de notas en Windows, TextEdit en Mac). Para saber más, lee Qué es un archivo CSV y cómo editarlo.
El archivo no es el que pide la guía de conexión
Cada guía de conexión indica qué informe descargar. Un informe distinto de la misma plataforma, o un archivo de otra plataforma, no coincidirá con la estructura esperada.
Comprueba que subes el archivo que pide la guía, que abarque todo tu historial, y a la conexión creada para esa plataforma.
La plataforma no es compatible con un archivo nativo
Si Finbooks no admite el archivo nativo de la plataforma, la exportación de la plataforma no se puede subir tal cual. Tienes que pasar tus transacciones al CSV personalizado de Finbooks y subirlo a una conexión personalizada.
cripto, sigue Guía para Compilar el CSV de Finbooks
finanzas tradicionales (acciones, bonos, ETF, derivados y similares), sigue Guía para Compilar el CSV de Tradfi
Para conocer todas tus opciones, lee Mi plataforma no es compatible: ¿cuáles son mis opciones?.
El CSV personalizado no sigue el formato de Finbooks
Si has compilado un CSV personalizado, el archivo se rechaza cuando su cabecera o sus columnas no coinciden con la plantilla:
la primera fila debe ser la cabecera y debe coincidir exactamente con una plantilla de Finbooks: mismos nombres de columna, mismo orden, sin columnas de más ni de menos
las 13 columnas deben estar presentes, aunque algunas estén vacías
cada fila es una única transacción
las columnas obligatorias siempre deben estar rellenas
En el CSV personalizado de cripto, la cabecera puede estar en inglés, italiano, francés, español o portugués, siempre que coincida exactamente con una plantilla de Finbooks. En el CSV personalizado de TradFi, la cabecera debe estar en inglés.
Como separador entre columnas puedes usar tanto la coma como el punto y coma.
La cabecera del CSV personalizado de cripto, en inglés, es:
` TYPE,CATEGORY,TRANSACTION DATE,OUT CURRENCY,OUT AMOUNT,OUT FIAT VALUE,IN CURRENCY,IN AMOUNT,IN FIAT VALUE,FEE CURRENCY,FEE AMOUNT,NOTES,ORIGINAL ID `
La cabecera del CSV personalizado de TradFi (solo en inglés) es:
` ASSET CLASS,TYPE,EXCHANGE CODE,CATEGORY,TRANSACTION DATE,OUTGOING ASSET,OUTGOING AMOUNT,INCOMING ASSET,INCOMING AMOUNT,FEE CURRENCY,FEE AMOUNT,POSITION ID,NOTES `
Puedes partir de la plantilla de cripto, que ya incluye la cabecera.
Si la cabecera es incorrecta, la app muestra un botón Download template CSV: descarga la plantilla y copia en ella tus transacciones. Para el CSV personalizado de TradFi no hay enlace a una plantilla, así que sigue la guía de TradFi.
ℹ️ Cripto y finanzas tradicionales son independientes
Usa el CSV personalizado de cripto para cripto y el CSV personalizado de TradFi para las inversiones tradicionales. Si en tu cuenta solo ves la sección de finanzas tradicionales, lee Cómo activar la sección de Cripto.
Las fechas no están en un formato admitido
La columna TRANSACTION DATE es obligatoria y debe usar uno de estos formatos:
yyyy-MM-dd HH:mm:ss
yyyy-MM-dd HH:mm
dd/MM/yyyy HH:mm:ss
dd/MM/yyyy HH:mm
Por ejemplo, una transacción del 02 de enero de 2024 a las 21:45 se puede escribir como 2024-01-02 21:45 o 02/01/2024 21:45.
La fecha y la hora también deben coincidir con tu zona horaria local. Finbooks no puede detectar la zona horaria que usa la plataforma, así que convierte las marcas de tiempo a tu hora local antes de subir el archivo.
Los números usan coma decimal
Si usas una coma como separador decimal, debes encerrar el número entre comillas; de lo contrario, la coma se lee como separador de columna y la fila se rompe. También puedes usar un punto como separador decimal.
Formato | Ejemplo | Resultado |
Coma decimal sin comillas | 2999,85 | incorrecto |
Coma decimal con comillas | "2999,85" | correcto |
Punto decimal | 2999.85 | correcto |
Faltan valores obligatorios
Lo que debes rellenar depende del tipo de transacción:
Incoming, el activo y la cantidad recibidos
Outgoing, el activo y la cantidad enviados
Trade, tanto el activo y la cantidad enviados como los recibidos
Cada fila también necesita su tipo, categoría y fecha. Para ver la lista completa de columnas, consulta la guía de cripto o de finanzas tradicionales.
La plataforma ha cambiado su formato de exportación
Las plataformas actualizan sus archivos de vez en cuando. Esto puede dar lugar a un formato no compatible, columnas que faltan, tipos de transacción no reconocidos o cabeceras que ya no coinciden.
Si crees que el archivo debería ser compatible, contacta con el Soporte de Finbooks. Los detalles están en la sección de abajo.
Mensajes de error habituales
Mensaje | Qué suele significar |
Some errors were found in the header: one or more column headers do not match our required format, and we are unable to suggest a valid correction. | la cabecera del archivo no coincide con la esperada: comprueba el tipo de archivo, comprueba si el archivo se ha editado y comprueba que la cabecera coincide exactamente con la guía de conexión o con la plantilla del CSV personalizado |
Unrecognised columns: no Finbooks CSV template matches this file | la cabecera no coincide con ninguna plantilla de Finbooks en ningún idioma admitido: compara la cabecera con la plantilla y corrige los nombres y el orden, o empieza de nuevo desde la plantilla con Download template CSV |
Unrecognized section | el archivo contiene una sección que el software no puede reconocer: sube exactamente el informe que pide la guía de conexión, sin editarlo |
Si ves un mensaje de error técnico inesperado, contacta con el Soporte de Finbooks y adjunta el archivo.
No existen las importaciones parciales
Finbooks importa un archivo todo o nada. Si una sola fila tiene un error, se rechaza el archivo completo y no se importa ninguna transacción de ese archivo.
Cuando el estado de la importación muestra un número de filas con errores, abre Ver errores para ver por qué ha fallado cada fila, corrige esas filas en el archivo de origen y vuelve a subir el archivo. Como no se importó nada del archivo rechazado, no crearás duplicados al subir el archivo corregido.
Qué hacer a continuación
Sigue estos pasos después de un rechazo:
si el estado de la importación muestra filas con errores, abre Ver errores y descarga la lista con Exportar errores. Si muestra Formato incorrecto, no hay informe de errores: comprueba la cabecera
compara el error con las causas anteriores y corrige el archivo. Si la cabecera es incorrecta, haz clic en Download template CSV y copia tus transacciones en la plantilla
vuelve a subir el archivo corregido:
en una conexión existente, haz clic en Conexiones en el menú lateral izquierdo, haz clic en los tres puntos al final de la línea de la conexión y selecciona Añadir nuevo CSV
desde el último paso del procedimiento de carga, haz clic en Importar nuevo CSV
comprueba el nuevo resultado en Comprobar resultado de la importación
Si no quieres compilar el archivo tú mismo, puedes usar el Servicio de cambio de formato de archivos CSV, que es de pago. El resultado depende de los datos que proporciones.
Cómo contactar con el Soporte
Si el archivo sigue siendo rechazado, contacta con el Soporte de Finbooks por chat o en customer.support@finbooks.com y envía:
el nombre del archivo y la plataforma de la que procede
el archivo original, exactamente como lo descargaste
el informe de errores descargado con Exportar errores
Nuestro equipo comprobará si el formato es compatible y te ayudará con el siguiente paso.
Para ver el procedimiento de carga completo, lee Subiendo el archivo CSV de Finbooks.
Respuestas rápidas
¿Puedo subir un archivo Excel?
Depende de la conexión. Algunas conexiones aceptan archivos Excel (.xlsx) nativos y otras solo CSV. Consulta la guía de conexión de tu plataforma.
¿Por qué mi archivo muestra Formato incorrecto?
Formato incorrecto significa que la cabecera del archivo es incorrecta, por lo que se rechazó el archivo completo y no se importó ninguna transacción. Comprueba que subes el archivo que pide la guía, sin editar, o que la cabecera de tu CSV personalizado coincide exactamente con una plantilla de Finbooks. La solución más rápida es el botón Download template CSV: descarga la plantilla y copia en ella tus transacciones.
¿Por qué Comprobar resultado de la importación no funciona después de salir de la página?
Los detalles de los errores no se guardan cuando sales del procedimiento de carga. Vuelve a subir el archivo y haz clic en Ver errores antes de salir de la página.
¿Se importa alguna transacción de un archivo rechazado?
No. Un archivo se importa todo o nada: si una fila tiene un error, se rechaza el archivo completo. En un archivo Rechazado, Número de filas muestra 0 porque no se importó ninguna transacción.
¿Puedo descargar un informe de errores de un archivo con Formato incorrecto?
No. Formato incorrecto significa que la cabecera del archivo es incorrecta, por lo que no hay informe de errores disponible. Comprueba la cabecera con la guía de conexión.
