Duplikaty i ponowny import

Ponowny import pliku, który już został zaimportowany, nie tworzy duplikatów transakcji. Każdy wiersz importu jest porównywany z danymi już istniejącymi w Twoim projekcie, a powtórzenia są oznaczane jako Duplikat i pomijane. Nakładające się zakresy dat nie stanowią problemu – ten sam plik można zaimportować dwukrotnie, a typowa procedura (eksport z konta maklerskiego co tydzień lub miesiąc i wgranie całości) nie wymaga ręcznego usuwania danych.

Ten artykuł wyjaśnia, jakie dane porównuje moduł importu, co oznacza każdy status wiersza, jak wymusić nadpisanie wartości w istniejących transakcjach oraz co dzieje się z wierszami, których nie udało się zaimportować.

Co porównuje moduł importu

Dostępne są dwa rodzaje porównań w zależności od pliku. Jeśli dane zawierają referencję transakcji – unikalny identyfikator nadawany przez brokera dla każdej operacji – Capitally dopasowuje dane na podstawie aktywa, konta i referencji. Dzięki temu nawet jeśli cena, ilość czy data ulegną zmianie, wiersz nadal zostanie rozpoznany jako ta sama transakcja. Jeśli brakuje referencji, system sprawdza aktywo, konto, typ transakcji, datę oraz ilość zaokrągloną do dwóch miejsc po przecinku. Typ transakcji musi zgadzać się w obu przypadkach.

Ilość jest brana pod uwagę tylko dla typów transakcji, które ją posiadają: kupna, sprzedaży, transfery, salda kont i konwersje. W przypadku dywidend, opłat lub płatności odsetek bez referencji, kluczem jest zestaw: aktywo, konto, typ i data. Dwie płatności o różnych kwotach, dotyczące tego samego aktywa i tego samego dnia, wyglądają dla importera identycznie.

Dopasowywanie na podstawie referencji jest najprecyzyjniejszą metodą i jest dostępne dla brokerów, którzy publikują unikalne identyfikatory w swoich eksportach. Referencja jest standardowym parametrem transakcji, więc własny preset importu również może ją mapować – zobacz Referencję parametrów transakcji, gdzie figuruje ona jako Referencja. Niektóre wbudowane presety robią to automatycznie, gdy broker nie udostępnia własnego identyfikatora: np. preset Goldman Sachs TFI tworzy referencję z typu transakcji, daty i liczby jednostek, dzięki czemu konwersje są deduplikowane tak samo precyzyjnie jak transakcje w IBKR.

Interactive Brokers to najklarowniejszy przykład: każdy wiersz w Flex Query posiada identyfikator IBKR, więc każda transakcja importowana z tego źródła ma referencję. Transakcje giełdowe otrzymują TradeID, transakcje gotówkowe TransactionID, a dywidendy ActionID – to właśnie on sprawia, że dywidendy wypłacone w kilku wierszach są w Capitally grupowane w jedną transakcję zamiast pięciu. Ponieważ to referencja jest kluczem deduplikacji, możesz ręcznie edytować zaimportowaną transakcję z IBKR (np. zmienić jej datę), a ponowny import tego samego zakresu nie spowoduje utworzenia duplikatu.

Duplikat, Aktualizuj i wiersze pomijane

Każdy wiersz w tabeli przeglądu importu posiada Status. Duplikat oznacza, że transakcja jest już w Twoim projekcie: wiersz jest pomijany, a w danych nic się nie zmienia. Utwórz oznacza, że transakcja zostanie dodana. Aktualizuj nadpisuje wartości wiersza w istniejącej transakcji. Wykluczone oznacza wiersz, którego importer nie mógł przekształcić w transakcję (zazwyczaj przez nierozpoznane aktywo lub typ transakcji), a błąd oznacza, że wystąpił problem techniczny. Najedź na ikonę informacji przy statusie, aby poznać przyczynę.

Możesz zmienić status każdego wiersza. Menu rozwijane oferuje opcje utwórz i ignoruj, a także aktualizuj w miejscach, gdzie dopasowano istniejącą transakcję. Oznacza to, że wiersz oznaczony jako Duplikat można ustawić jako Aktualizuj lub wymusić jako drugą, oddzielną transakcję poprzez Utwórz. Aby zmienić status wielu wierszy naraz, zaznacz je i ustaw wartość w jednym z nich; zmiana zostanie zastosowana do całej selekcji. Kliknięcie nagłówka kolumny sortuje tabelę, a sortowanie według Statusu grupuje wiersze pod nagłówkami poszczególnych statusów, co znacznie przyspiesza weryfikację długich importów.

Automatyczne dywidendy zachowują się nieco inaczej. Podczas przesyłania danych od brokera Capitally usuwa własne prognozy dywidend dla danego okresu, więc import dywidend z Twojego konta maklerskiego jest właściwym krokiem. Wyjątkiem jest prognoza, którą samodzielnie edytowałeś lub potwierdziłeś – zostanie ona zachowana, a przychodzący wiersz zostanie oznaczony jako duplikat. Osobna zasada, która blokuje tworzenie automatycznych dywidend obok ręcznych, opisana jest w sekcji Śledzenie dywidend – to inny mechanizm niż opisane tutaj dopasowywanie transakcji.

Wymuszanie aktualizacji transakcji już zaimportowanych

Zmień status odpowiednich wierszy z Duplikat na Aktualizuj. Wiersze typu Duplikat są pomijane, więc poprawiona wartość w świeżym eksporcie – np. kwota podatku u źródła (WHT), opłata czy skorygowana dywidenda – nie trafi do istniejącej transakcji, dopóki nie zmienisz statusu. Aktualizacja nadpisuje wartości w istniejącej transakcji zamiast dodawać drugą.

1. Rozpocznij import ponownie, używając najnowszego eksportu od brokera.
2. Na ekranie przeglądu kliknij nagłówek kolumny Status, aby posortować wiersze i zgrupować wszystkie Duplikaty w jednej sekcji.
3. Zaznacz całą grupę za pomocą pola wyboru w nagłówku grupy.
4. W dowolnym z zaznaczonych wierszy zmień status na Aktualizuj. Zmiana zostanie zastosowana do wszystkich wybranych wierszy.
5. Przejdź do kroku Podsumowanie, gdzie wyświetlone zostaną końcowe salda wszystkich pozycji, a następnie potwierdź import.

To również rozwiązanie po naprawie presetu importu: nie musisz niczego usuwać ani tworzyć nowego projektu, aby uwzględnić poprawkę. Zaimportuj ponownie ten sam plik i zmień status wierszy z Duplikat na Aktualizuj.

Kiedy rzeczywista transakcja jest błędnie oznaczana jako duplikat

Ustaw status takiego wiersza na utwórz przed potwierdzeniem importu. Deduplikacja dotyczy każdego importu i nie ma ustawienia, które by ją wyłączyło; masz jednak kontrolę nad statusem wiersza, a opcja utwórz importuje go jako nową, dodatkową transakcję zamiast pomijania.

Warto się wcześniej upewnić. Celowe pominięcie wiersza, który faktycznie jest duplikatem, jest bezpieczne, podczas gdy wymuszone dodanie wiersza, który został poprawnie oznaczony, spowoduje podwójny zapis tej samej transakcji.

Fałszywe duplikaty między dwoma kontami u jednego brokera

Ustaw błędnie oznaczone wiersze na utwórz przed potwierdzeniem, a następnie rozdziel oba konta w Capitally, aby problem nie powracał. Dwa konta u tego samego brokera importowane do jednego profilu Capitally kolidują ze sobą, gdy opłata lub transakcja mają tę samą datę, aktywo i typ w obu miejscach. Druga transakcja jest pomijana, a saldo tego konta okazuje się niższe o dokładnie tę kwotę.

To samo dzieje się przy pierwszym imporcie z źródła, którego pojedynczy eksport obejmuje dwa konta – np. plik z Robinhood zawierający zarówno konto maklerskie, jak i Roth IRA.

Nie ma przełącznika wyłączającego dopasowywanie, więc trwałym rozwiązaniem jest zmiana jednej z trzech rzeczy, które importer porównuje przed datą i ilością: konta, aktywa lub referencji.

• Konto. Utrzymuj jedno konto w Capitally na każde rzeczywiste konto maklerskie – zobacz Organizację portfolio. Gdy obie serie wierszy trafią do różnych kont, przestaną kolidować. Przypisz każdemu kontu własny wariant presetu, a podział będzie następował automatycznie przy każdym kolejnym imporcie – warianty presetów opisano w sekcji Import z brokera lub aplikacji.
• Aktywo. Jeśli wolisz trzymać oba rzeczywiste konta pod jednym kontem w Capitally, przypisz każdemu z nich własne aktywo gotówkowe – np. dwa aktywa gotówkowe EUR zamiast jednego wspólnego. Aktywo jest porównywane jako pierwsze, więc dwie serie opłat przestaną wyglądać identycznie. Zobacz Śledzenie gotówki.
• Referencja. W zapisanym presecie zmapuj parametr Referencja na wartość, która różni się między kontami – np. kolumnę z numerem konta lub formułę łączącą go z datą. Gdy obie strony posiadają referencję, to ona decyduje o dopasowaniu, więc dwie różne referencje nigdy nie spowodują kolizji. Zobacz Import w trybie zaawansowanym.

Wiersze z nieobsługiwanym typem transakcji

Ostrzeżenie o braku obsługi typu transakcji oznacza, że preset nie napotkał jeszcze takiego typu w przykładowym pliku – nie oznacza to, że Capitally nie potrafi go modelować. Taki wiersz jest pomijany, a wszystkie pozostałe zostają zaimportowane, więc praca nad importem nie idzie na marne. Pominięte dane nie są zapisywane, dlatego późniejszy ponowny import tego samego pliku jest bezpieczny.

Co z nimi zrobić:

1. Zanotuj typ wymieniony w ostrzeżeniu na ekranie przeglądu – komunikat podaje go w cytacie, np. "Transakcje gotówkowe typu X nie są aktualnie obsługiwane" – i wyślij plik na adres support@mycapitally.com, podając nazwę brokera. Jeśli plik zawiera dane, których nie chcesz udostępniać, użyj anonimowego eksportu opisanego w sekcji Uzyskiwanie pomocy.
2. Zazwyczaj dodajemy wsparcie dla nowego typu w ciągu kilku dni.
3. Zaimportuj ten sam plik ponownie. Dodane zostaną tylko wcześniej brakujące wiersze; cała reszta zostanie rozpoznana jako Duplikat i pominięta.

To samo dotyczy wierszy, które pominąłeś celowo lub oznaczyłeś jako ignorowane podczas importu: istnieją one tylko w ramach danej sesji i nigdy nie są zapisywane. Gdy przyczyna blokady zostanie usunięta – np. dodanie aktywa do naszej bazy lub włączenie śledzenia gotówki dla konta – zaimportuj plik ponownie, a transakcje zostaną dodane.

Gdy poprawka wydaje się nie działać

Istnieją dwie przyczyny, w tej kolejności. Twoja aplikacja może nadal używać wersji starszej niż ta, która zawiera poprawkę. Jeśli wersja jest aktualna, prawdopodobnie kontynuujesz sesję importu rozpoczętą przed wdrożeniem poprawki, więc system nadal korzysta ze starej logiki presetu od początku do końca.

1. Sprawdź wersję aplikacji w prawym górnym menu. Jeśli jest starsza niż wersja z poprawką, odczekaj chwilę i odśwież stronę.
2. Odrzuć trwający import.
3. Rozpocznij zupełnie nowy import od podstaw, używając świeżego eksportu od brokera, aby zaktualizowany preset został zastosowany od pierwszego wiersza.
   :Jeśli błędne dane są już w Twoim projekcie, zaimportuj plik ponownie i przełącz wiersze z Duplikat na Aktualizuj, jak opisano powyżej, aby skorygowane wartości nadpisały istniejące dane.
4. Jeśli błędne dane znajdują się już w Twoim projekcie, zaimportuj je ponownie i zmień ustawienie dla duplikatów na Aktualizuj, zgodnie z powyższym opisem, aby poprawione wartości nadpisały istniejące dane.

Więcej informacji na temat sprawdzania wersji i odświeżania aplikacji znajduje się w sekcji Rozwiązywanie problemów z aplikacją.

Importowanie kilku plików po kolei

Zaimportuj najpierw najstarszy plik i przechodź chronologicznie do najnowszych. Nie musisz łączyć plików — importuj je pojedynczo, w porządku chronologicznym i pozwól zakresom danych na pokrywanie się. Interactive Brokers pozwala na eksport danych z maksymalnie jednego roku, więc historia z dziesięciu lat będzie obejmować dziesięć plików zamiast jednego.

Gdy historia jest już wczytana, wykonuj ponowny eksport i import za każdym razem, gdy dokonasz transakcji; cotygodniowa lub comiesięczna częstotliwość jest standardem. Ceny notowanych aktywów aktualizują się automatycznie, więc import jest potrzebny tylko wtedy, gdy faktycznie miały miejsce transakcje. Konfigurację Flex Query opisano na ekranie importu, obok presetu IBKR; Interactive Brokers wyjaśnia, co może pójść nie tak z generowanym przez nich eksportem.

Cofanie importu

Każdy import można w pełni cofnąć. Bezpośrednio po jego zakończeniu skorzystaj z powiadomienia, które się pojawi. Później otwórz Historię z menu w prawym górnym rogu: wszystkie zmiany wynikające z jednego importu są pogrupowane w jeden wpis, który możesz rozwinąć, aby zobaczyć poszczególne zmiany.

W tym miejscu możesz wybrać całą grupę i usunąć ją lub wybrać tylko niektóre zmiany — wszystko, co usuniesz, można przywrócić z tego samego ekranu. Szczegóły znajdują się w sekcji Historia zmian. Jeśli wolisz zacząć od zera, utwórz nowy projekt i zaimportuj dane ponownie — warto to zrobić, gdy planujesz zaimportować znacznie więcej danych od tych samych brokerów.