Saltar a contenido

Generic CSV

El importador CSV genérico lee un archivo CSV que tú mismo preparas. Nombra tus columnas como en la referencia de columnas — date y type al menos — y LibreFolio las reconoce por sus nombres: no hay nada que asignar manualmente.

🎯 Cuándo usarlo

  • Tu bróker no está en la lista de compatibles.
  • Tu bróker cambió su exportación y su importador aún no la lee.
  • Tú mantienes tu propia hoja de cálculo, o un script escribe el CSV por ti.

⚙️ Cómo importarlo

  1. Prepara el archivo. Guárdalo como .csv (desde Excel, guarda una copia como CSV). Su primera fila nombra las columnas, como en la referencia de columnas; las demás columnas se ignoran.
  2. Súbelo en el Asistente de importación y asígnalo a tu bróker.
  3. Comprueba el plugin en Seleccionar: si CSV genérico no está ya elegido, selecciónalo en la columna Plugin del archivo.
  4. Analiza y revisa. Cada fila se convierte en una transacción.

Un archivo por bróker — no un archivo por divisa

Cada fila de un archivo se importa al bróker que asignes a ese archivo, así que nunca mezcles dos brókeres en un mismo CSV. Las filas en distintas divisas pueden compartir el mismo archivo, ya que cada fila lleva su propia currency; también puedes dividir el historial de un bróker en varios archivos, uno por año por ejemplo, e importarlos juntos.

🧯 Si algo sale mal

  • "required column 'date' not found" (o type): la primera fila carece de esa columna, o la nombra de forma diferente. Agrégala, o cambia el nombre de la columna a un nombre aceptado, y vuelve a subir el archivo.
  • Falta una fila: las filas que LibreFolio no puede leer — un tipo desconocido, una fecha en un formato desconocido, una currency vacía — se omiten y se listan entre las advertencias del paso Analizar; las filas con un signo incorrecto aparecen como problemas de validación. Corrígelas en el archivo y vuelve a subirlo.
  • El espacio de trabajo masivo pide un coste en una fila ADJUSTMENT: introduce el coste de una unidad, no el valor total de la posición.

🔄 Convertir un informe personalizado

Si tus datos provienen de otra herramienta, un script corto puede convertirlos en un CSV genérico. La especificación técnica de CSV genérico describe el formato completo — signos, qué tipo usar en cada caso, ejemplos resueltos. Puedes pegarla en un asistente de IA (ChatGPT, Claude, Gemini…) con algunas filas de muestra de tu archivo y pedirle el script.

📋 Referencia de columnas

Estas son las columnas que LibreFolio reconoce en un archivo CSV genérico. Los nombres de las columnas no distinguen entre mayúsculas y minúsculas, y los espacios que los rodean se ignoran.

Columna ¿Obligatoria? Alias aceptados Descripción
date ✅ Siempre data, settlement_date, value_date, trade_date, fecha, datum, transaction_date, exec_date Fecha de la transacción
type ✅ Siempre tipo, transaction_type, operation, operazione, action, azione, trans_type, op_type Tipo de transacción — véanse los valores a continuación
quantity Obligatoria para BUY/SELL/ADJUSTMENT quantità, qty, shares, azioni, units, unità, amount_shares, num_shares Número de unidades. Negativo para SELL, positivo para BUY.
amount Obligatoria para la mayoría de los tipos importo, value, cash, cash_amount, total, totale, net_amount, gross_amount, price Impacto en efectivo. Negativo cuando el efectivo sale, positivo cuando el efectivo entra. Vacía para ADJUSTMENT.
currency Opcional (por defecto EUR) valuta, ccy, curr, currency_code, divisa, währung Código de divisa ISO 4217. EUR se aplica solo cuando el archivo no tiene columna de divisa: si la tiene, rellénala en cada fila con un amount, o esa fila se omitirá.
asset Obligatoria para BUY/SELL/DIVIDEND/ADJUSTMENT symbol, ticker, isin, asset_id, instrument, strumento, security, titolo, name, nome Ticker, ISIN, o un nombre coherente y constante para activos no cotizados
description Opcional descrizione, notes, memo, note, details, dettagli, comment, commento Notas de texto libre

🏷️ Valores válidos de type

BUY · SELL · DIVIDEND · INTEREST · DEPOSIT · WITHDRAWAL · FEE · TAX · ADJUSTMENT

No soportado: TRANSFER, FX_CONVERSION, CASH_TRANSFER

Estos tipos necesitan dos filas vinculadas, lo que un CSV no puede expresar: esas filas se omiten con una advertencia. Introdúcelas a mano desde la página de Transacciones, o utiliza el importador propio de tu bróker.

🔗 Relacionado