Ir al contenido principal

Guía para Compilar el CSV de Tradfi

🟣 Guía de finanzas tradicionales

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


¿Qué es el CSV personalizado de TradFi de Finbooks?

El CSV personalizado de TradFi de Finbooks es un formato específico de hoja de cálculo que aceptamos para importar tus transacciones de finanzas tradicionales.

Debes utilizar este formato si:

  • estás intentando importar transacciones que incluyen instrumentos financieros tradicionales como acciones, bonos, ETF, derivados y similares

  • no ofrecemos una conexión directa mediante API con tu plataforma

  • no admitimos el formato de exportación nativo de la plataforma

Nuestro CSV personalizado está diseñado para ser sencillo y fácil de utilizar. Solo tienes que rellenar los datos de tus transacciones siguiendo nuestra plantilla y podrás importar tus datos de TradFi incluso si tu plataforma no es compatible directamente.

ℹ️ 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. Como alternativa, puedes dejar que nuestro Servicio CSV se encargue del formato por ti. Obtén más información en esta guía.


El encabezado del CSV

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

Las columnas deben rellenarse de acuerdo con unas reglas específicas (explicadas en esta sección) y deben mantenerse en el orden correcto.

Este será siempre el encabezado requerido:

ASSET CLASS,TYPE,EXCHANGE CODE,CATEGORY,TRANSACTION DATE,OUTGOING ASSET,OUTGOING AMOUNT,INCOMING ASSET,INCOMING AMOUNT,FEE CURRENCY,FEE AMOUNT,POSITION ID,NOTES

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


Explicación de cada columna

Aquí encontrarás una explicación sobre cómo debe utilizarse cada columna del CSV y qué valores se aceptan. También proporcionamos información sobre cuándo debe rellenarse una columna, cuándo no y cuándo es opcional en función del tipo de transacción que quieras representar.

ASSET CLASS

Rellenar esta columna es siempre obligatorio. Este campo es necesario para identificar el tipo de instrumento financiero involucrado en la transacción y determinar qué normas contables y fiscales se aplican.

Si la transacción incluye tanto moneda fiat como otra clase de activo, por ejemplo al comprar o vender una acción, este campo debe rellenarse siempre con la clase de activo del instrumento financiero distinto de fiat.

Por ejemplo:

  • al comprar una acción utilizando USD, Asset Class debe ser STOCK

  • al vender un ETF por EUR, Asset Class debe ser ETF

Asset Class solo debe establecerse como Fiat Currency cuando la transacción incluya exclusivamente monedas fiat, como:

  • un trade de USD a EUR

  • recibir intereses pagados en fiat

Los valores aceptados son:

  • Stock

  • ETF

  • Mutual Funds

  • Bond

  • Fiat Currency

  • CFD

  • Future

  • Option

  • Certificate

  • Warrants

TYPE

Rellenar esta columna es siempre obligatorio. Esta columna se utiliza para indicar si en la transacción recibiste un activo, pagaste o enviaste un activo, o intercambiaste un activo por otro.

Los valores aceptados son:

  • Incoming

  • Outgoing

  • Trade

EXCHANGE CODE

Este campo es necesario para encontrar el precio de mercado correcto relacionado con el activo.

Es siempre obligatorio, excepto cuando el campo Asset Class de la transacción sea CFD.

El formato aceptado es el código oficial del mercado o centro de negociación en el que se realizó el trade.

⚠️ Ten en cuenta

Si el código del mercado no está presente o es incorrecto, es posible que el software no pueda obtener el precio de mercado correcto del activo.

CATEGORY

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

Los valores aceptados son:

  • Trading

  • Interest

  • Dividend

  • Fee

  • Tax

  • Deposit

  • Withdraw

  • PNL

  • Split

  • Reverse splits

TRANSACTION DATE

Rellenar esta columna es siempre obligatorio. Permite al software saber cuándo se produjo una transacción. A continuación encontrarás la lista de formatos compatibles:

  • 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 es el mes, dd es el día, hh es la hora, mm son los minutos y ss son los segundos.

Por ejemplo, si una transacción se produjo el 02 de enero de 2024 a las 21:45, 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

OUTGOING ASSET

Introduce el ticker del activo que enviaste. Este campo es obligatorio para las transacciones Outgoing y Trade. Deja este campo en blanco para las transacciones Incoming.

ℹ️ Cómo crear el ticker de una opción

Para registrar correctamente tus transacciones de opciones, debes utilizar el símbolo de opción OCC. Este consta de cuatro partes:

  1. Símbolo raíz de la acción subyacente o ETF, completado con espacios hasta alcanzar 6 caracteres

  2. Fecha de vencimiento, 6 dígitos en formato yymmdd

  3. Tipo de opción, P o C, para put o call

  4. Precio de ejercicio, expresado como el precio x 1000 (dólares ajustados y milésimas de dólar o mills), completado por delante con ceros hasta alcanzar 8 dígitos

ℹ️ Cómo crear el ticker de un futuro

Para registrar correctamente tus transacciones de futuros, debes utilizar el símbolo estándar del contrato de futuros. Puedes consultar esta guía para saber cómo funciona.

OUTGOING AMOUNT

Introduce aquí la cantidad del activo que enviaste. Este campo es obligatorio para las transacciones Outgoing y Trade. Deja este campo en blanco para las transacciones Incoming.

⚠️ Recuerda utilizar comillas si hay comas dentro de la cantidad

Si utilizas una coma como separador decimal, debes incluir las cantidades entre comillas ("xxxx.xx").

Esta regla debe aplicarse a todos los campos en los que introduzcas valores numéricos que utilicen una coma para indicar decimales.

Por ejemplo, necesitas importar una transacción de entrada de 2.999,85 €.

Formato de línea incorrecto

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

Formatos de línea correctos

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

INCOMING ASSET

Introduce el identificador del activo que recibiste. Este campo es obligatorio para las transacciones Incoming y Trade. Deja este campo en blanco para las transacciones Outgoing.

Los formatos aceptados son los mismos que para Outgoing Asset.

INCOMING AMOUNT

Introduce aquí la cantidad del activo que recibiste. Este campo es obligatorio para las transacciones Incoming y Trade. Deja este campo en blanco para las transacciones Outgoing.

⚠️ Recuerda utilizar comillas si hay comas dentro de la cantidad

Se aplica la misma regla descrita para Outgoing Amount.

FEE CURRENCY

Introduce aquí el ticker de la moneda que utilizaste para pagar las comisiones. Este campo es opcional para todas las transacciones y solo debes rellenarlo si pagaste comisiones.

FEE AMOUNT

Introduce aquí el importe de la comisión que pagaste. Este campo es opcional, pero pasa a ser obligatorio si se rellena Fee Currency.

POSITION ID

Este campo es opcional, pero debe utilizarse siempre que una transacción deba vincularse explícitamente a un activo subyacente específico. Position ID permite al sistema asociar correctamente los movimientos que están económicamente relacionados con el mismo instrumento financiero.

En concreto, debe utilizarse para:

  • vincular las comisiones con el activo al que corresponden

  • asociar cupones, dividendos y distribuciones con la acción, bono o ETF correspondiente

  • realizar el seguimiento de las posiciones de CFD durante todo su ciclo de vida, incluidas las transacciones de apertura, ajustes y cierre

Por ejemplo, si recibes un dividendo en USD de Apple, debes incluir un identificador estructurado en Position ID para que la cantidad de fiat recibida se vincule correctamente con la acción subyacente.

En estos casos, Position ID debe seguir este formato: Ticker, Asset Class, Market.

Por ejemplo: AAPL, Stock, US

El uso de esta combinación estructurada garantiza que las transacciones relacionadas se identifiquen claramente, se agrupen de forma coherente y se procesen de acuerdo con las normas contables correctas.

NOTES

Este campo puede utilizarse para introducir notas sobre una transacción. Los comentarios introducidos aquí se mostrarán en los detalles de la transacción una vez importada en Finbooks.

Este campo es siempre opcional.


Cómo insertar una transacción Trade

Las columnas que debes rellenar para una transacción Trade son:

  • asset class

  • type

  • exchange code

  • category

  • transaction date

  • outgoing asset

  • outgoing amount

  • incoming asset

  • incoming amount

  • fee currency, solo si se pagó una comisión

  • fee amount, solo si se pagó una comisión

Por ejemplo, el 01/01/2025 a las 13:34:56 compraste 10 AAPL pagando 1500 USD y pagaste una comisión de 5 USD:

STOCK,Trade,XNAS,Trading,01/01/2025 13:34:56,USD,1500,AAPL,10,USD,5,,

Si utilizas una coma como separador decimal:

STOCK,Trade,XNAS,Trading,01/01/2025 13:34:56,USD,"1500,00",AAPL,10,USD,"5,00",,

Cómo insertar una transacción Incoming

Las columnas que debes rellenar para una transacción Incoming son:

  • asset class

  • type

  • exchange code

  • category

  • transaction date

  • incoming asset

  • incoming amount

  • fee currency, solo si se pagó una comisión

  • fee amount, solo si se pagó una comisión

Por ejemplo, el 26/12/2025 a las 14:41:01 recibiste un dividendo de 50 USD.

STOCK,Incoming,XNAS,Dividend,26/12/2025 14:41:01,,,USD,50,,,"RACE, Stock, MI",

Cómo insertar una transacción Outgoing

Las columnas que debes rellenar para una transacción Outgoing son:

  • asset class

  • type

  • exchange code

  • category

  • transaction date

  • outgoing asset

  • outgoing amount

  • fee currency, solo si se pagó una comisión

  • fee amount, solo si se pagó una comisión

Por ejemplo, el 13/05/2025 a las 10:12 pagaste una comisión de 1,55 USD.

Fiat Currency,Outgoing,XNAS,Fee,13/05/2025 10:12,USD,1.55,,,,,AAPL, Stock, US,

Si utilizas una coma como separador decimal:

Fiat Currency,Outgoing,XNAS,Fee,13/05/2025 10:12,USD,"1,55",,,,,AAPL, Stock, US,
¿Ha quedado contestada tu pregunta?