Duplicati e re-importazione

La re-importazione di un file già importato non crea transazioni duplicate. Ogni riga di un'importazione viene confrontata con ciò che è già presente nel tuo progetto; le ripetizioni vengono contrassegnate come Duplicato e saltate. Le sovrapposizioni di date non sono un problema, lo stesso file può essere importato due volte e la procedura standard — esportare dal tuo broker ogni settimana o mese e caricare l'intero file — non richiede alcuna pulizia manuale.

Questo articolo illustra cosa confronta esattamente l'importatore, a cosa serve ogni stato della riga, come sovrascrivere valori corretti su transazioni già esistenti e cosa succede alle righe che non possono essere importate.

Cosa confronta l'importatore

Vengono effettuati due tipi di confronto, a seconda del file. Se i dati includono un riferimento di transazione — un ID univoco assegnato dal broker a ogni operazione — Capitally esegue il match su asset, conto e riferimento; in questo modo, anche se quantità, prezzo o data dovessero cambiare, la riga viene comunque riconosciuta come quella già presente. Se il riferimento manca, il sistema si basa su asset, conto, tipo di transazione, data e quantità arrotondata a due decimali. Il tipo di transazione deve corrispondere in entrambi i casi.

La quantità conta solo per i tipi che ne prevedono una: acquisti, vendite, trasferimenti, saldi conto e conversioni. Per dividendi, commissioni o pagamenti di interessi privi di riferimento, l'asset, il conto, il tipo e la data costituiscono l'intera chiave; due pagamenti di importi diversi, sullo stesso asset e nello stesso giorno, appaiono identici all'importatore.

Il match tramite riferimento è il metodo più preciso ed è disponibile per i broker che includono identificatori univoci nelle loro esportazioni. Il riferimento è una proprietà standard della transazione, quindi può essere mappato anche tramite un preset personalizzato: consulta il Riferimento alle proprietà delle transazioni, dove è elencato come Riferimento. Alcuni preset integrati lo fanno già quando il broker non pubblica un identificatore proprio: il preset TFI di Goldman Sachs, ad esempio, compone un riferimento basato su tipo di transazione, data e numero di unità, rendendo le sue conversioni precise quanto quelle di un'operazione IBKR.

Interactive Brokers ne è l'esempio più chiaro: ogni riga in una Flex Query contiene uno degli identificatori proprietari di IBKR, quindi ogni transazione importata da questo broker ha un riferimento. Le operazioni di trading prendono il TradeID, le transazioni di liquidità il TransactionID e i dividendi l'ActionID — che è anche ciò che raggruppa in Capitally un dividendo distribuito su più righe in un'unica transazione anziché cinque. Poiché il riferimento è la chiave per la deduplicazione, puoi modificare manualmente una transazione IBKR importata, ad esempio cambiandone la data, e la re-importazione di un intervallo sovrapposto non creerà comunque duplicati.

Duplicato, Aggiorna e le righe saltate

Ogni riga nella tabella di revisione dell'importazione ha uno Stato. Duplicato significa che la transazione è già presente nel progetto: la riga viene saltata e non cambia nulla. Crea significa che verrà aggiunta. Aggiorna sovrascrive i valori della riga sulla transazione già esistente. Escluso indica una riga che l'importatore non è riuscito a trasformare in una transazione, solitamente perché l'asset o il tipo di transazione non sono stati riconosciuti, mentre fallito indica una riga che ha generato un errore. Passa il mouse sull'icona informativa accanto allo stato per vederne il motivo.

Puoi modificare lo stato di qualsiasi riga. Il menu a tendina offre crea e ignora, oltre ad aggiorna ogni volta che viene trovata una transazione corrispondente; una riga contrassegnata come Duplicato può quindi essere impostata su aggiorna o forzata come seconda transazione separata con crea. Per modificare più righe contemporaneamente, selezionale e imposta il valore su una di esse; la modifica si applicherà all'intera selezione. Cliccando sull'intestazione di una colonna puoi ordinare la tabella, e ordinare per Stato raggruppa le righe sotto un'intestazione specifica, rendendo la revisione di un'importazione lunga molto più rapida.

I dividendi automatici si comportano in modo leggermente diverso. Quando carichi i dati del broker, Capitally rimuove le sue previsioni sui dividendi per quel periodo, quindi importare i dividendi dal proprio broker è la scelta corretta. L'eccezione è rappresentata da una previsione che hai modificato o confermato tu stesso: questa viene conservata e la riga in arrivo viene contrassegnata come duplicato. La regola separata che impedisce la creazione di dividendi automatici accanto a uno manuale è descritta in Monitoraggio dei dividendi — si tratta di un meccanismo diverso dal matching delle transazioni qui descritto.

Forzare un aggiornamento su transazioni già importate

Cambia lo stato delle righe interessate da Duplicato a Aggiorna. Le righe duplicate vengono saltate, quindi un valore corretto in una nuova esportazione — come una ritenuta d'acconto, una commissione o un dividendo rideterminato — non raggiunge la transazione esistente finché non modifichi lo stato. Aggiorna sovrascrive i valori sulla transazione già presente anziché aggiungerne una seconda.

1. Avvia nuovamente l'importazione con la nuova esportazione dal tuo broker.
2. Nella schermata di revisione, clicca sull'intestazione della colonna Stato per ordinare per stato, in modo che tutte le righe Duplicato si trovino sotto un'unica intestazione di gruppo.
3. Seleziona l'intero gruppo usando la casella di controllo nell'intestazione del gruppo.
4. Su una qualsiasi delle righe selezionate, cambia lo stato in Aggiorna. La modifica verrà applicata a ogni riga selezionata.
5. Prosegui fino alla fase di Riepilogo, dove vengono mostrati i saldi finali di ogni posizione che stai importando, e conferma l'importazione.

Questa è anche la soluzione dopo aver corretto un preset di importazione: non è necessario eliminare nulla o avviare un nuovo progetto per recepire la correzione. Re-importa lo stesso file e imposta le righe Duplicato su Aggiorna.

Quando una transazione reale viene segnalata come duplicato

Imposta lo stato di quella riga su crea prima di confermare l'importazione. La deduplicazione si applica a ogni importazione e non esiste un'impostazione per disattivarla; il controllo che hai è lo stato sulla riga, e crea importa la transazione come nuova e aggiuntiva anziché saltarla.

Vale la pena accertarsene prima. Saltare deliberatamente una riga che è effettivamente un duplicato non ha conseguenze, mentre forzare una riga correttamente segnalata registra la stessa transazione due volte.

Falsi duplicati su due conti presso lo stesso broker

Imposta le righe erroneamente segnalate su crea prima di confermare, quindi scollega i due conti in modo che il problema non si ripeta. Due conti presso lo stesso broker importati in un unico account Capitally entrano in conflitto ogni volta che una commissione o una transazione condivide la stessa data, asset e tipo in entrambi. La seconda viene saltata e il saldo di quel conto risulterà errato esattamente di quell'importo.

Lo stesso accade al primo import da una fonte la cui unica esportazione copre due conti — ad esempio, un file Robinhood contenente sia il conto brokerage che il Roth IRA.

Non esiste un interruttore per disattivare il matching, quindi la soluzione permanente è modificare una delle tre cose confrontate dall'importatore prima della data e della quantità: il conto, l'asset o il riferimento.

• Il conto. Mantieni un conto Capitally per ogni conto reale — consulta Organizzazione del portafoglio. Una volta che i due set di righe finiscono in conti diversi, smetteranno di entrare in conflitto. Dai a ogni conto la sua variante di preset e la suddivisione avverrà automaticamente a ogni importazione successiva — le varianti di preset sono trattate in Importazione da un broker o app.
• L'asset. Se preferisci mantenere entrambi i conti reali sotto un unico conto Capitally, assegna a ciascuno di essi il suo asset di liquidità — due asset liquidità in EUR invece di uno condiviso. L'asset viene confrontato prima di ogni altra cosa, quindi i due set di commissioni non sembreranno più identici. Consulta Monitoraggio contanti.
• Il riferimento. In un preset salvato, mappa la proprietà Riferimento su qualcosa che differisce tra i due conti — una colonna del numero di conto, o una formula che lo combini con la data. Laddove entrambi i lati portano un riferimento, è questo a decidere, quindi due riferimenti distinti non entreranno mai in conflitto. Consulta Importazione in modalità avanzata.

Righe con un tipo di transazione non supportato

Un avviso che indica che un tipo di transazione non è supportato significa che il preset non ha ancora visto quel tipo in un file di esempio, non che Capitally non sia in grado di modellarlo. Quella riga viene saltata e ogni altra riga nel file viene comunque importata, quindi l'importazione non è vana. Non viene memorizzato nulla per una riga saltata, motivo per cui re-importare lo stesso file in seguito è sicuro.

Cosa fare in questi casi:

1. Annota il tipo menzionato nell'avviso sulla schermata di revisione — il messaggio lo riporta, ad esempio "Le transazioni di liquidità di tipo X non sono attualmente supportate" — e invia il file a support@mycapitally.com, indicando il nome del broker. Se il file contiene dati che preferisci non inviare, usa l'esportazione anonimizzata descritta in Richiedere assistenza.
2. Di solito aggiungiamo il supporto per un nuovo tipo entro pochi giorni.
3. Importa nuovamente lo stesso file. Verranno aggiunte solo le righe precedentemente mancanti; tutto il resto apparirà come Duplicato e verrà saltato.

Lo stesso vale per le righe che salti deliberatamente o che contrassegni come ignorate durante l'importazione: esistono solo all'interno di quella sessione di importazione e non vengono mai salvate. Una volta risolto l'impedimento — un asset aggiunto al nostro database, monitoraggio contanti abilitato sul conto — re-importa il file e verranno caricate.

Quando una correzione sembra non avere effetto

Ci sono due cause possibili, in quest'ordine. L'app potrebbe eseguire una versione precedente a quella che contiene la correzione. Se la versione è quella corrente, è molto probabile che tu stia continuando una sessione di importazione avviata prima che la correzione venisse rilasciata, quindi il sistema sta ancora applicando la vecchia logica del preset dall'inizio alla fine.

1. Controlla la versione dell'app nel menu in alto a destra. Se è precedente alla versione con la correzione, attendi un momento e aggiorna la pagina.
2. Scarta l'importazione in corso.
3. Se i dati errati sono già nel tuo progetto, re-importa e imposta le righe Duplicato su Aggiorna, come descritto sopra, affinché i valori corretti sovrascrivano quelli esistenti.
4. Se i dati errati sono già presenti nel progetto, importa nuovamente e imposta le righe duplicate su Aggiorna, come descritto sopra, affinché i valori corretti sovrascrivano quelli esistenti.

Maggiori informazioni sui controlli di versione e sull'aggiornamento dell'app sono disponibili in Risoluzione dei problemi dell'app.

Importare più file in sequenza

Importa prima il file meno recente e prosegui cronologicamente. Non è necessario combinare i file: importali singolarmente, in ordine cronologico, e lascia che gli intervalli si sovrappongano ove necessario. Interactive Brokers esporta al massimo un anno per volta, quindi uno storico di dieci anni sarà composto da dieci file anziché uno solo.

Una volta caricato lo storico, riesporta e importa ogni volta che effettui operazioni; una cadenza settimanale o mensile è la norma. I prezzi degli asset quotati si aggiornano autonomamente, pertanto l'importazione è necessaria solo quando avvengono effettive transazioni. La configurazione della Flex Query è descritta nella schermata di importazione, accanto alla preimpostazione IBKR; Interactive Brokers illustra le problematiche comuni relative alle esportazioni prodotte.

Annullare un'importazione

Ogni importazione può essere annullata completamente. Subito dopo averla eseguita, utilizza la notifica che appare. In alternativa, apri lo Storico dal menu in alto a destra: tutte le modifiche relative a una singola importazione sono raggruppate in una voce, che puoi espandere per visualizzare le singole transazioni effettuate.

Da lì puoi selezionare l'intero gruppo ed eliminarlo, oppure selezionare solo alcune delle modifiche contenute; tutto ciò che elimini può essere ripristinato dalla stessa schermata. I dettagli sono disponibili in Storico delle modifiche. Se preferisci ricominciare da zero, crea un nuovo progetto e importa tutto dall'inizio: è un'operazione consigliata quando prevedi di importare molti altri dati dagli stessi broker.