Trazza

Texto del repositorio público, commit 8729248. Fuente: docs/claude/imports.md.

Importación de brokers (DeGiro, IBKR, MyInvestor, Trading 212, Binance, IA)

Detalle movido desde CLAUDE.md el 2026-10-04 para que el fichero que se carga en cada sesión solo lleve el índice y las reglas críticas. Léelo antes de tocar esta zona.

DeGiro CSV import — known facts

Column layout (comma-delimited)

Fecha, Hora, Fecha valor, Producto, ISIN, Descripción, Tipo(FX rate), Variación(currency), col_8(amount), Saldo(currency), col_10(balance amount), ID Orden

Multi-language support (Account.csv)

The 12-column layout is IDENTICAL in every DeGiro language — only header names and description keywords change. The parser resolves columns by localized name with positional fallback, and classifies rows via per-type multilingual keyword lists (KW in degiroParser.js) covering ES/EN/DE/NL/FR/PT/IT. Order matters: FX before BUY/SELL ("Ingreso Cambio de Divisa" contains "ingreso"), TAX before DIVIDEND ("Dividendbelasting" contains "dividend"), SELL before BUY ("Verkauf" contains "Kauf"). FX legs in a trade merge are matched by currency (the leg whose currency ≠ trade currency is the EUR cost side), never by localized description text. Fixtures EN/DE/NL live in degiroParser.test.js.

Wrong-file detection

Uploading DeGiro's OTHER export (Transactions.csv — venue/execution-centre columns, no description column) throws an error with err.code === 'degiro_transactions_file'; handleCsvFileSelected catches it and shows cartera.degiro_wrong_file_hint with the AI fallback still available.

Archivo de OTRO broker (2026-10-15): si el lector del broker elegido no saca operaciones, processImportText prueba detectOtherBroker (lib/parsers/brokerDetect.js, la misma detección del import IA) y, si el archivo es de otro broker conocido, lo procesa con SU lector y avisa con cartera.broker_file_redirect_desc. Caso real: "Sincronizar" un MyInvestor con el selector en DeGiro (importBroker vuelve a 'degiro' al cerrar el diálogo) → "No se encontraron transacciones" y la única salida era gastar cuota de IA. El Transactions.csv de DeGiro no se redirige (0 operaciones): sigue con su pista propia.

Anti-empty-import guard (all brokers)

If a parse yields no BUY/SELL/DIVIDEND rows (e.g. an unsupported-language export producing only a cash-snapshot row), handleCsvFileSelected routes to the AI-fallback panel with cartera.parse_no_trades_hint instead of letting the user "successfully" import an empty portfolio.

Import save architecture (planner/executor)

The save flow is split in src/services/import/ — the DECISION half is pure and the I/O half is dumb:

Invariant (pinned by tests): planning against the state that results from applying a plan produces an EMPTY plan — re-sync idempotence is a verified property, not a hope. handleSaveImportedData (en hooks/useImportFlow.js desde 2026-07) is a thin orchestrator (fetch inputs → plan → execute → toasts). NEVER add decision logic back into the hook/component; it goes in the planner with a test. La reconciliación CSV↔DB del preview vive en src/services/import/processedImportData.js (pura, characterization-tested) — misma regla.

Import dedupe & telemetry

Import por IA: telemetría y el callejón de MyInvestor (2026-10-02)

Trading 212 (CSV del historial, 2026-10-03)

src/lib/parsers/trading212Parser.js (+17 tests), en el selector de brokers y en detectBrokerCsv. Se hizo SIN un fichero real: el formato sale de fuentes públicas contrastadas — sobre todo el parser mantenido de cgt-calc (calculadora de plusvalías UK, probada con exports reales) — y los fixtures son sintéticos con esa forma exacta. El primer fichero real que llegue es la prueba de verdad: mirar su telemetría (broker = 'trading212') y, si algo no cuadra, pedir una muestra anonimizada.

HOLDING (snapshot de cartera) en el import IA — nunca mueve caja

freeformMapper mapea el tipo neutro HOLDING (fila de una tabla de posiciones) a un BUY con isConsolidated: true. El flag NO es cosmético: calculateNetBuys replica todo BUY no consolidado contra el ledger de caja, así que pegar una cartera (que por definición no trae ingresos) restaba el coste completo de la liquidez y creaba posiciones CASH_USD/CASH_EUR negativas — la cabecera lo mostraba como "Margen utilizado" y "Patrimonio neto (apal.)" inventados, exactamente iguales al coste de lo pegado (bug real 2026-07-26: −25.869 USD −1.208 EUR ≈ 23.950 €). Consolidado = define posición y coste medio, no mueve caja y NO se escribe al histórico de transactions (un snapshot no es un evento: fabricar BUYs con una fecha inventada además ensucia el TWR). Misma semántica que los snapshots de IBKR/Binance. Regresión fijada en freeformMapper.test.js. Los BUY reales pegados sí siguen moviendo la caja.

Broker picker scope

Binance and MyInvestor are deliberately NOT offered in the CSV broker picker (removed 2026-07 at the owner's request). Their parsers, enrichers and tests REMAIN fully functional: detectBrokerCsv still routes their exports (pasted or dropped into the AI import, including the MyInvestor Movimientos XLSX) to the native pipelines. Re-enabling = restoring their entries in ImportBrokerSelector.BROKERS.

AI import guardrails

Import self-validation (DeGiro) & failure reporting

Price sanity guard

isPlausiblePriceUpdate(stored, next) (src/services/priceGuard.js) gates every update_asset_market_data price write — since 2026-10-26 the ONLY writer is the server cron (server/lib/assetPrices.js); the client (usePositions, Dashboard, import save) no longer writes prices, and the import only backfills metadata with update_asset_metadata after creating positions. The RPC repeats the same ratio in SQL. Asymmetric by design: blocks collapses (> 85% drop = unit/currency mixup, the pence ÷100 class) but allows big increases so an already-corrupted small price can heal. Never bypass it for a new write site. Split real (precio nuevo < 15 % del guardado): el cron lo rechazará siempre; escape documentado = POST /api/admin/force-asset-price (server/routes/adminForceAssetPrice.js, solo plan admin) → RPC force_asset_price (migración 20261028000100_force_asset_price.sql): escribe el precio nuevo en una sola operación (sin clear a NULL), exige reason y audita en asset_price_force_log. Alta de filas nuevas en assets (r15b/r17/r17b): createAssets() → POST /api/assets → ensure_asset (service role; lookup exacto sin upper(), altas nuevas ≤120/sin cntrl; ON CONFLICT DO NOTHING; precio 1 en CASH_*). FASE 1 20261027000100; FASE 2 revoke 20261029000300. Despliegue en dos fases (history.md); NO supabase db push a ciegas. Lookup de existentes (r18): services/import/existingAssets.js carga por ticker y por los asset_id de las posiciones del broker, e indexa exacto + lower(btrim) como ensure_asset; el planner busca con findAssetByTicker. Nunca existingAssetsByTicker[ref] a pelo: un ticker legado con espacios no casaba y cada reimport añadía otra posición sobre el mismo activo.

MyInvestor import (CSV + XLSX)

SnapTrade — ELIMINADO (2026-07-17)

El import por broker-API (SnapTrade) se retiró de toda la plataforma a petición del owner: dialog, mapper, servicio cliente, rutas del server, proxy y sección i18n borrados. La tabla snaptrade_users sigue en la BD (huérfana, service-role only, inofensiva) y las credenciales SNAPTRADE_* del server/.env ya no se usan — se pueden rotar/borrar. El método "Broker API" ya no aparece en el ImportMethodChooser (quedan CSV/XLSX e IA).

Shared ISIN→ticker mappings

ticker_mappings table (crowd-populated) + src/services/tickerMappingService.js. Resolution precedence: static TICKER_MAP → user's imported_data.ticker_map → shared table → live Yahoo search; successful search resolutions are contributed back through the server since 2026-10-26 (POST /api/ticker-mappings, server/routes/tickerMappings.js; migration 20261026000200_ticker_mappings_server_only.sql, SIN APLICAR, removes the client's insert/update — audit 7f2c915d A2: any account could rewrite any mapping for everyone). The server publishes a pair only if the symbol appears in Yahoo's search FOR THAT ISIN (a name-search resolution stays local to the session) and inserts with ignoreDuplicates, so no existing row — 'manual' or 'auto' — is ever overwritten. New /api/* route = vite proxy + location in nginx, as always.

Number format

DeGiro Spain exports use comma as CSV delimiter and European number format (dot=thousands, comma=decimal). isEuropean is detected from data patterns (regex [",]\d{1,3}\.\d{3}[,"]), NOT just from the delimiter. Never assume ; delimiter means European — Spanish DeGiro uses , with European numbers.

Transaction type mapping

(Spanish keywords shown — the full multilingual lists are in KW in degiroParser.js)

DeGiro description keywordParser type
Cambio de DivisaCURRENCY_EXCHANGE (internal, merged with BUY/SELL)
CompraBUY
VentaSELL
DividendoDIVIDEND
RetenciónTAX (merged into DIVIDEND)
Comisión, Costes de transacción, Conectividad, Stamp Duty, Impuesto, Interés, InterestFEE
SweepCASH
Ingreso, Transferir, Deposit, Retirada, WithdrawalTRANSFER

Merge logic

GBX stocks (UK pence)

Prices in GBX are divided by 100 → GBP. The variacion audit checks the ratio between the CSV amount and qty×price to detect if the CSV reports amounts already in GBP or still in GBX.

French transaction tax

Impuesto de transacción Francés appears as a separate row on LVMH and other French/Italian stocks. Classified as FEE and merged into comisiones for the trade.

What gets silently dropped