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 meses

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:

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

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

TYPE

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:

  • Incoming

  • Outgoing

  • Trade

CATEGORY

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 Earning o Income, 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.

TRANSACTION DATE

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


OUT CURRENCY

Introduce el ticker del activo que enviaste.

Este campo es obligatorio para transacciones Outgoing y Trade.

Déjalo en blanco para transacciones Incoming.

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

OUT AMOUNT

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

Este campo es obligatorio para transacciones Outgoing y Trade.

Déjalo en blanco para transacciones Incoming.

⚠️ 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

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

Formato de línea correcto

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

OUT FIAT VALUE

Enter the total value of the assets you sent in your fiat currency.

This field is optional for Outgoing and Trade transactions.

Leave this field blank for Incoming transactions.

E.g., if you sold a crypto-asset worth €2.456,87 in total, enter 2456.87 or "2456,87".

IN CURRENCY

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

Este campo es obligatorio para transacciones Outgoing y Trade.

Déjalo en blanco para transacciones Incoming.

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

IN AMOUNT

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

Este campo es obligatorio para transacciones Incoming y Trade.
Déjalo en blanco para transacciones Outgoing.

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

IN FIAT VALUE

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

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

Déjalo en blanco para transacciones Outgoing.

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

FEE CURRENCY

Here enter the amount (or quantity) of the asset you used to pay the fees.

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.

FEE AMOUNT

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

NOTES

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.

ORIGINAL ID

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 Trade

Las columnas obligatorias para un Trade son:

  • TYPE

  • CATEGORY

  • TRANSACTION DATE

  • OUT CURRENCY

  • OUT AMOUNT

  • IN CURRENCY

  • IN AMOUNT

  • FEE CURRENCY (sólo si se pagó comisión)

  • FEE AMOUNT (sólo si se pagó comisión)

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:

Trade,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:

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

Si no quiero añadir una nota:

Trade,Trading,01-01-2025 13:34:56,ETH,,15.45,BTC,1,,EUR,2,This is a note,,

Cómo introducir una transacción Incoming

Las columnas obligatorias para un Incoming son:

  • TYPE

  • CATEGORY

  • TRANSACTION DATE

  • IN CURRENCY

  • IN AMOUNT

  • FEE CURRENCY (solo si se pagó comisión)

  • FEE AMOUNT (solo si se pagó comisión)

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:

Incoming,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:

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

Cómo introducir una transacción Outgoing

Las columnas obligatorias para un Outgoing son:

  • TYPE

  • CATEGORY

  • TRANSACTION DATE

  • OUT CURRENCY

  • OUT AMOUNT

  • FEE CURRENCY (solo si se pagó comisión)

  • FEE AMOUNT (solo si se pagó comisión)

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:

Outgoing,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:

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