Ir al contenido principal

Guía para Compilar el CSV de CryptoBooks

Sigue estas instrucciones para hacer que tu CSV sea compatible con nuestro formato.

Actualizado hace más de 2 semanas

En esta guía encontrarás todo lo que necesitas saber sobre cuándo usar el formato CSV de CryptoBooks y cómo introducir correctamente tus transacciones en él.


¿Qué es el CSV personalizado de CryptoBooks?

El CSV personalizado de CryptoBooks es un formato específico de hoja de cálculo que aceptamos para importar tus transacciones. Debes usar este formato si:

  • no ofrecemos conexión directa por API con tu plataforma,

  • no soportamos el formato de exportación nativo de la plataforma.

Nuestro CSV personalizado está diseñado para ser simple y directo, lo que facilita añadir tus transacciones y subirlas a CryptoBooks. Solo rellena los detalles de la transacción siguiendo nuestra plantilla y podrás importar tus datos incluso si tu plataforma no está directamente soportada.

ℹ️ Qué es un archivo CSV y cómo editarlo
Si no estás familiarizado con los archivos CSV o necesitas ayuda para editarlos y guardarlos, consulta esta guía. Alternativamente, puedes usar nuestro servicio de conversión de CSV para que nosotros nos encarguemos del formato (más información en esta guía).


El formato CSV

El formato CSV de CryptoBooks está compuesto por 13 columnas.
La primera fila contiene la cabecera del CSV con el título de cada columna, y cada una tiene una finalidad diferente.


Las columnas deben rellenarse siguiendo reglas específicas (explicadas en esta sección) y mantenerse siempre en el orden correcto.

Cabecera obligatoria:

TIPO,CATEGORÍA,FECHA DE TRANSACCIÓN,MONEDA DE SALIDA,CANTIDAD DE SALIDA,VALOR FIAT DE SALIDA,MONEDA DE ENTRADA,CANTIDAD DE ENTRADA,VALOR FIAT DE ENTRADA,MONEDA DE LA COMISIÓN,IMPORTE DE LA COMISIÓN,NOTAS,ID ORIGINAL 

Puedes dejar algunas columnas vacías si no aplican, pero todas las cabeceras deben estar incluidas.


Cada línea representa una transacción única y solo debe contener los datos relativos a esa transacción.

No necesitas crear el CSV desde cero: puedes descargar una plantilla con la cabecera ya rellenada haciendo clic aquí.

TIPO

Rellenar esta columna es siempre obligatorio. Esta columna se utiliza para explicar si en la transacción recibiste un activo, enviaste/pagaste un activo o intercambiaste un activo por otro. Los valores aceptados para este campo son:

  • Entrante

  • Saliente

  • Intercambio

CATEGORÍA

Rellenar esta columna es siempre obligatorio. Las categorías ayudan a organizar tu contabilidad y aseguran que el software trate cada transacción correctamente a efectos fiscales.

Por ejemplo, las recompensas que deben declararse como ingresos pueden clasificarse como Rendimiento u Otros Ingresos, de modo que se gestionan de acuerdo con la normativa fiscal local.

La categoría por defecto y la más utilizada es Trading. Para saber más sobre las categorías de transacciones y cómo usarlas, consulta este artículo.

FECHA DE TRANSACCIÓN

Rellenar esta columna es siempre obligatorio. Permite al software entender cuándo ocurrió una transacción. Aquí tienes la lista de formatos admitidos:

  • yyyy-MM-dd HH:mm:ss

  • yyyy-MM-dd HH:mm

  • dd/MM/yyyy HH:mm:ss

  • dd/MM/yyyy HH:mm

Donde yyyy es el año, MM el mes, dd el día, hh la hora, mm los minutos y ss los segundos.

Ejemplo: si una transacción ocurrió el 02 de enero de 2024 a las 9:45 pm, puede importarse como:

  • 2024-01-02 21:45:00

  • 2024-01-02 21:45

  • 02-01-2024 21:45:00

  • 02-01-2024 21:45


MONEDA DE SALIDA

Introduce el ticker del activo que enviaste.

Este campo es obligatorio para transacciones Salientes e Intercambios.

Déjalo en blanco para transacciones Entrantes.

Ejemplo: si vendiste 2,34 ETH, introduce ETH.

CANTIDAD DE SALIDA

Introduce aquí la cantidad (o número) del activo que enviaste.

Este campo es obligatorio para transacciones Salientes e Intercambios.

Déjalo en blanco para transacciones Entrantes.

⚠️ Recuerda usar comillas si hay comas en la cantidad.

Si utilizas coma como separador decimal, debes encerrar las cantidades y cabeceras entre comillas ("xxxx.xx").

Esta regla debe aplicarse a todos los campos donde introduzcas valores numéricos con coma decimal.

Ejemplo: necesitas importar una transacción entrante de 2.999,85 €.

Formato de línea incorrecto

Entrante,Trading,13/04/2022 19:04,EUR,2999,85,,,,,,,,

Formato de línea correcto

Entrante,Trading,13/04/2022 19:04,EUR,"2999,85",,,,,,,,

VALOR FIAT DE SALIDA

Introduce el valor total de los activos que enviaste en tu moneda fiat.

Este campo es opcional para transacciones Salientes e Intercambios.

Déjalo en blanco para transacciones Entrantes.

Ejemplo: si vendiste un criptoactivo por un valor total de 2.456,87 €, introduce 2456.87 o "2456,87".

MONEDA DE ENTRADA

Introduce el valor total de los activos que enviaste en tu moneda fiat.

Este campo es obligatorio para transacciones Entrantes e Intercambios.

Déjalo en blanco para transacciones Salientes.

Ejemplo: si compraste 0,23 BTC, introduce BTC.

CANTIDAD DE ENTRADA

Introduce aquí la cantidad (o número) del activo que recibiste.

Este campo es obligatorio para transacciones Entrantes e Intercambios.
Déjalo en blanco para transacciones Salientes.

Ejemplo: si compraste 0,23 BTC, introduce 0.23 o "0.23".

VALOR FIAT DE ENTRADA

Introduce el valor total de los activos que recibiste en tu moneda fiat.

Este campo es opcional para transacciones Entrantes e Intercambios. Si lo dejas vacío, usaremos el valor de mercado en ese momento (si está disponible).

Déjalo en blanco para transacciones Salientes.

Ejemplo: si vendiste un criptoactivo por valor total de 2.000,34 €, introduce 2000.34 o "2000,34".

MONEDA DE LA COMISIÓN

Aquí introduce el importe (o la cantidad) del activo que utilizaste para pagar las comisiones.

Introduce el ticker del activo con el que pagaste las comisiones.

Este campo es opcional para todas las transacciones, solo rellénalo si pagaste comisiones.

Ejemplo: si pagaste 0.0034 ETH, introduce ETH.

IMPORTE DE LA COMISIÓN

Introduce aquí la cantidad (o número) del activo que usaste para pagar las comisiones.

Este campo es opcional para todas las transacciones, solo rellénalo si pagaste comisiones.

Ejemplo: si pagaste 0.0034 ETH, introduce 0.0034 o "0,0034".

NOTAS

Este campo puede usarse para añadir notas sobre una transacción.
Los comentarios introducidos aquí se mostrarán en los detalles de la transacción una vez importada en CryptoBooks.

Este campo es siempre opcional y puede tener una longitud máxima de 200 caracteres.

ID ORIGINAL

Este campo puede usarse para introducir el ID único de la transacción proporcionado por el exchange o blockchain (por ejemplo, el hash de transacción).
Esto puede ayudar a relacionar la transacción en CryptoBooks con su origen. Una vez importado, se mostrará en los detalles de la transacción.
Este campo es siempre opcional.


Cómo introducir una transacción de Intercambio

Las columnas obligatorias para un Intercambio son:

  • TIPO

  • CATEGORÍA

  • FECHA DE TRANSACCIÓN

  • MONEDA DE SALIDA

  • CANTIDAD DE SALIDA

  • MONEDA DE ENTRADA

  • CANTIDAD DE ENTRADA

  • MONEDA DE LA COMISIÓN (si aplica)

  • IMPORTE DE LA COMISIÓN (si aplica)

Ejemplo: el 01/01/2025 a las 13:34:56 intercambié 15.45 ETH por 1 BTC, que en ese momento valía 30.000,00 €, pagando una comisión de 2,00 €.

Si uso coma como separador decimal:

Intercambio,Trading,01-01-2025 13:34:56,ETH,"15,45",30000,BTC,1,30000,EUR,2,,,

Recuerda que también la cabecera de ese campo debe ir entre comillas, ej.: "IN AMOUNT".

Si no quiero especificar el valor y usar el precio de mercado en ese momento:

Intercambio,Trading,01-01-2025 13:34:56,ETH,,15.45,BTC,1,,EUR,2,,,

Si no quiero añadir una nota:

Intercambio,Trading,01-01-2025 13:34:56,ETH,,15.45,BTC,1,,EUR,2,Esto es una nota,,

Cómo introducir una transacción Entrante

Las columnas obligatorias para un Entrante son:

  • TIPO

  • CATEGORÍA

  • FECHA DE TRANSACCIÓN

  • MONEDA DE ENTRADA

  • CANTIDAD DE ENTRADA

  • MONEDA DE LA COMISIÓN (si aplica)

  • IMPORTE DE LA COMISIÓN (si aplica)

Ejemplo: el 26/12/2025 a las 14:41:01 compré con mi tarjeta 3 BTC, que en ese momento valían en total 120.000,00 €, pagando una comisión de 0.05 BTC.

Si quiero especificar el valor fiat:

Entrante,Trading,26-12-2025 14:41:01,BTC,3,120000,,,,,BTC,0.05,,,

Si no quiero especificar el valor y usar el precio de mercado en ese momento:

Entrante,Trading,26-12-2025 14:41:01,BTC,3,,,,,,BTC,0.05,,, 

Cómo introducir una transacción Saliente

Las columnas obligatorias para una Saliente son:

  • TIPO

  • CATEGORÍA

  • FECHA DE TRANSACCIÓN

  • MONEDA DE SALIDA

  • CANTIDAD DE SALIDA

  • MONEDA DE LA COMISIÓN (si aplica)

  • IMPORTE DE LA COMISIÓN (si aplica)

Ejemplo: el 13/05/2025 a las 10:12 envié 2.500,00 USDT, que en ese momento valían en total 2.200,00 €, pagando una comisión de 1,55 USD.

Si quiero especificar el valor fiat:

Saliente,Trading,13-05-2025 10:12,USDT,2500,2200,,,,USD,1.55,,,

Si no quiero especificar el valor y usar el precio de mercado en ese momento:

Saliente,Trading,13-05-2025 10:12,USDT,2500,,,USD,1.55,,,
¿Ha quedado contestada tu pregunta?