Ir al contenido principal

¿Por qué se ha rechazado mi archivo CSV?

⚪️ Guía de usuario

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:

  1. en el paso Comprobar resultado de la importación, busca tu archivo en la lista

  2. consulta las columnas Número de filas, Estado del archivo y el estado de la importación (consulta la tabla de abajo)

  3. 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

  4. 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.

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:

  1. 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

  2. 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

  3. 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

  4. 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.

¿Ha quedado contestada tu pregunta?