Importación CSV del diario: exportaciones del bróker, mapeo de columnas y deduplicación
«Importar operaciones desde CSV» lee una exportación del bróker, detecta el delimitador y las columnas de forma automática, muestra una vista previa de las operaciones interpretadas y las escribe en el diario. Volver a importar el mismo archivo actualiza las filas existentes en lugar de duplicarlas.
Senzoukria · Documentación · Actualizado en septiembre de 2026
Dónde encontrarlo
- Dónde
- Diario → Operaciones → botón «Importar CSV»
- Fuentes
- Apex Trader Funding (por defecto), Rithmic Trader, NinjaTrader, TradingView, Otro CSV
- Delimitador
- Coma, punto y coma o tabulador, deducido de la primera línea
- Clave de deduplicación
- La columna de id de operación cuando existe; si no, «{fuente}-row-{n}»
Qué hace
El diálogo dice: «Exporta desde el panel de tu bróker y suelta el archivo aquí. Las reimportaciones se deduplican solas.» Elige la fuente del bróker y después suelta el archivo o usa «Examinar archivo» (.csv o texto). El analizador quita la marca de orden de bytes UTF-8, gestiona campos entrecomillados con comas, comillas y saltos de línea dentro, y elige el delimitador que más aparece en la línea de cabecera.
La vista previa muestra el nombre del archivo, el número de filas interpretadas y omitidas, el número de columnas, una lista plegable «Mapeo automático de columnas» y las 8 primeras operaciones (Hora, Símbolo, Lado, Cant., Entrada, Salida, P&L). El botón dice «Importar N operaciones». El panel de resultado imprime «+N nuevas · N actualizadas» y el número de filas fallidas si las hay, con «Importar otro» y «Hecho».
Mapeo de columnas
| Campo | Cabeceras aceptadas | Obligatorio |
|---|---|---|
| symbol | symbol, instrument, contract, ticker | sí |
| side | side, buy/sell, b/s, direction, type | sí |
| entryPrice | entry price, open price, buy price, avg entry price, fill price | sí |
| exitPrice | exit price, close price, sell price, avg exit price | no |
| quantity | qty, quantity, size, contracts, shares, lots | no (por defecto 1) |
| pnl | pnl, p/l, p&l, profit, net pnl, realized pnl, pl | no |
| entryTime | entry time, open time, buy time, time, datetime, trade time, fill time | no (por defecto, la hora actual) |
| exitTime | exit time, close time, sell time | no |
| commission | commission(s), fee(s) | no |
| accountId | account, account id, account number | no |
| externalId | trade id, order id, ticket id, execution id, id, fill id | no |
| notes | notes, comment, memo, tag | no |
Interpretación de los valores
- Lado: B, BUY, LONG, L pasan a LONG; S, SELL, SHORT, SH pasan a SHORT. Cualquier otro valor omite la fila.
- Números: se quitan los símbolos de dólar, los espacios y los separadores de miles; un valor entre paréntesis se lee como negativo.
- La cantidad se redondea a un entero.
- Fechas: todo lo que acepte el analizador Date de JavaScript (ISO, MM/DD/AAAA…), más la forma compacta AAAAMMDD HH:MM[:SS], leída como UTC. La salida es ISO 8601 UTC.
- Una fila sin símbolo, lado o precio de entrada se cuenta como omitida; las filas vacías se ignoran.
Cómo usarlo
Exporta la lista de operaciones desde el panel del bróker o de la prop firm, conserva la línea de cabecera y suelta el archivo. Revisa la lista del mapeo automático: un campo asignado a «—» no se encontró, y las operaciones resultantes tendrán ese campo vacío. Las columnas de hora y de cuenta son las que más importan: las operaciones importadas sin número de cuenta caen en el grupo «Sin cuenta registrada» del selector de cuenta.
Las importaciones son upserts con clave en la fuente y el id externo. Volver a importar una exportación actualizada refresca las filas coincidentes y las informa como «actualizadas» en vez de crear duplicados. Cuando el archivo no tiene columna de id se usa el número de fila, así que reordenar las filas entre dos exportaciones cambia qué operación se actualiza.
Límites y trampas
- Las operaciones importadas conservan el P&L del archivo; nada se recalcula a partir de los precios y los valores del punto.
- El marco temporal, el setup, la valoración, la emoción y las capturas no se leen del CSV; añádelos después desde el formulario de la operación.
- Solo un archivo cada vez. La elección de la fuente afecta al prefijo del id de reserva, no al mapeo de columnas.
- Las fechas sin zona horaria las interpreta el analizador Date con la zona local de la máquina; la forma compacta se trata como UTC.
Páginas relacionadas
- Diario: pestaña de operaciones
- Vista general del diario y alcance de cuenta
- Sincronización del diario desde Rithmic
- Guía de backtesting de futuros
Esta página en otros idiomas
Preguntas frecuentes
- ¿Por qué se omitieron filas?
- Una fila se omite cuando no se pueden leer el símbolo, el lado o el precio de entrada. Abre la lista «Mapeo automático de columnas» para ver qué columnas no se detectaron.
- ¿Importar dos veces duplicará mis operaciones?
- No, siempre que el archivo tenga una columna de id o conserve el mismo orden de filas. Las filas coincidentes se actualizan y se cuentan como «actualizadas».
- ¿La importación necesita una conexión de bróker?
- No. Lee un archivo local y escribe en la base de datos local del diario.