Dokumentacja Doofolio

Witaj w Doofolio. W trzech szybkich krokach przejdziesz od porozrzucanych wyciągów do żywego, przeanalizowanego portfolio.

Portfolio to kontener na Twoje aktywa z jedną walutą bazową. Twórz osobne portfolia, by oddzielić konta — na przykład długoterminowe IKE i konto tradingowe — albo trzymaj wszystko w jednym.

Każde portfolio śledzi zainwestowany kapitał, bieżącą wartość rynkową, zrealizowany i niezrealizowany zysk/stratę oraz własną historię wyników.

Waluta portfela — przy zakładaniu portfolio wybierasz jego walutę bazową — do wyboru jest PLN (domyślna), USD lub EUR. To waluta „konta" portfolio: saldo gotówki, zainwestowany kapitał i wyniki pojedynczego portfolio liczone są właśnie w niej.

Wycena zawsze do PLN

Doofolio pracuje na dwóch poziomach waluty bazowej: szczegółowy widok pojedynczego portfolio pokazuje kwoty w jego własnej walucie, ale wartość całego konta (wszystkie portfolia razem) oraz tabela Pozycji są zawsze przeliczane na PLN po kursach NBP z danego dnia. Dzięki temu łączną wartość majątku zawsze widzisz w jednej, wspólnej walucie.

Transakcje są źródłem prawdy w Doofolio. Zapisuj kupna, sprzedaże i dywidendy, a aplikacja automatycznie odtworzy Twoje pozycje i historyczne migawki.

• Wpis ręczny — dodaj pojedynczą transakcję z tickerem, ilością, ceną, opłatami i datą.
• Import z arkusza — wgraj hurtowo plik.xlsxlub .xls wyeksportowany od brokera.
• Obsługa FX — transakcje w obcych walutach są przeliczane po historycznym kursie wymiany.

Jak działa import z arkusza (XTB)

Zamiast wpisywać transakcje pojedynczo, możesz hurtowo wgrać plik wyeksportowany od brokera. Obecnie obsługiwany jest XTB (kolejni brokerzy w drodze) — pliki .xlsx, .xls oraz .csv. Import przebiega etapami: walidacja pliku, parsowanie zawartości, podgląd i weryfikacja, zapis oraz przebudowa portfela.

Walidacja pliku

• Maksymalny rozmiar pliku to 5 MB; większy plik jest odrzucany.
• Eksport XTB ma na górze blok metadanych, więc pierwsze 4 wiersze są pomijane, a wiersz 5. traktowany jako nagłówki kolumn.
• Plik musi zawierać wymagane kolumny: Type, Ticker, Instrument, Time, Amount, ID, Comment, Product — brak którejś przerywa import.
• Całkowicie puste wiersze są pomijane, a błąd w pojedynczym wierszu oznacza tylko ten wiersz — reszta pliku przechodzi dalej.

Obsługiwane typy transakcji

• DEPOSIT → wpłata, WITHDRAWAL → wypłata, DIVIDEND → dywidenda.
• STOCK PURCHASE → kupno, STOCK SELL → sprzedaż, TRANSFER → transfer.
• FREE FUNDS INTEREST → przychód z odsetek; pasujący wiersz Free funds interest tax jest doliczany jako pobrany podatek. Wiersze Withholding tax są pomijane.

Obsługiwane giełdy i tickery — import rozpoznaje tickery z czterech rynków: US (.US), GPW (.PL → .WA), LSE (.UK → .L) oraz DE/Xetra (.DE). Ticker z innego rynku jest oznaczany błędem i pomijany przy zapisie.

Limit importu — jednorazowo można zaimportować do 1000 wierszy; większy plik zostanie odrzucony.

Odwzorowanie historii — weryfikacja wpłat — przed zapisem Doofolio odtwarza historię konta: pobiera obecne transakcje portfela, dokłada wiersze z importu i symuluje oś czasu dzień po dniu, prowadząc saldo gotówki i stany posiadania. Wiersze bez pokrycia są odrzucane pojedynczo — kupno bez gotówki oraz sprzedaż większa niż stan posiadania. Tak weryfikowana jest poprawność wpłat: wpłata zasila gotówkę, którą później zdejmują zakupy.

Reduplikacja dywidend — XTB potrafi wygenerować kilka wierszy dywidendy dla jednej wypłaty (osobno dla każdej paczki FIFO). Import scala je w jedną transakcję — po kluczu portfolio + ticker + dzień sumuje ilość, kwotę i podatek.

Przebudowa portfela — po zapisaniu zweryfikowanych wierszy portfel jest przebudowywany od najwcześniejszej zaimportowanej daty (kursy, dywidendy, dzienne migawki). Jeśli przebudowa napotka błąd, cały import jest wycofywany, a poprzedni stan przywracany.

Transakcje są jedynym źródłem prawdy. Na ich podstawie Doofolio odtwarza cały portfel dzień po dniu — pozycje, gotówkę i zyski — a wynik każdego dnia zapisuje jako migawkę (snapshot). Wszystkie wykresy i wskaźniki liczone są z tych migawek, dzięki czemu zawsze są ze sobą spójne.

Harmonogram aktualizacji — wartość portfela jest aktualizowana co godzinę od 10:00 do 18:00 EST w dni robocze oraz codziennie o 23:00. Podczas codziennej aktualizacji aplikacja księguje należne dywidendy i przelicza od nowa migawki portfeli — osobno dla każdego portfolio i zbiorczo dla całego konta.

Przebudowa historii — dodanie lub import transakcji z datą wsteczną automatycznie przebudowuje historię od tej daty, więc wykresy zawsze odzwierciedlają pełny, poprawiony stan.

Księgowość FIFO (kupna i sprzedaże)

• Każde kupno tworzy „paczkę” (lot) o koszcie równym kwocie transakcji plus prowizja.
• Każda sprzedaż zdejmuje najstarsze paczki w kolejności zakupu (FIFO — metoda zgodna z polskim rozliczeniem podatku od zysków kapitałowych).
• Zrealizowany zysk/strata to przychód ze sprzedaży (po odjęciu prowizji) minus koszt zdjętych paczek.
• Transakcje z tego samego dnia księgowane są w kolejności: wpłata → dywidenda → opłata → kupno → sprzedaż → wypłata, więc kupno sfinansowane wpłatą z tego samego dnia zawsze się powiedzie.
• Kupno wymaga pokrycia w gotówce — saldo gotówki prowadzone jest jak rachunek: wpłaty i dywidendy je zasilają, a kupna, opłaty i wypłaty je pomniejszają.

Przeliczanie walut

• Każda transakcja w obcej walucie jest przeliczana na walutę bazową po kursie z dnia transakcji (zapisanym razem z transakcją).
• Bieżąca wycena pozycji używa kursu walutowego z danego dnia.
• Wszystkie kwoty w aplikacji są wyrażone w walucie bazowej portfolio — dzięki temu wpływ zmian kursowych jest częścią Twojego wyniku, tak jak w rzeczywistości.

Poniżej znajdziesz dokładny opis każdego wskaźnika w aplikacji. Wszystkie liczone są z dziennych migawek portfela, więc zawsze są ze sobą spójne.

Obliczenia biegną na pełnej precyzji — zaokrąglenie następuje dopiero przy wyświetlaniu. Kwoty w walucie bazowej przechowywane są z dokładnością do 1 grosza (2 miejsca po przecinku), a ceny, ilości i kursy walut z dokładnością 4–8 miejsc po przecinku.

• Wynik ogólny w kafelku na Pulpicie jest zaokrąglany do pełnej wartości waluty (bez groszy): wartość portfela, zmiana dzienna, wpłacony kapitał i zysk netto.
• Metryki kafelka (MTD, YTD, Cały okres, XIRR, vs benchmark) pokazywane są z 1 miejscem po przecinku.
• Pozostałe procenty w aplikacji mają 2 miejsca po przecinku, a kwoty w kartach KPI i tabelach 2 miejsca (grosze/centy).
• Znak i kolor podążają za wartością po zaokrągleniu: wynik, który zaokrągla się do zera, wyświetla się neutralnie — bez „+/−” i bez koloru zysku/straty, żeby drobny ułamek grosza nigdy nie wyglądał jak zysk albo strata.

• Powitanie — wiadomość powitalna po założeniu konta z krótkim wprowadzeniem do aplikacji.
• Seria przewodników — cztery wiadomości onboardingowe krok po kroku: Portfolia, Transakcje, Pulpit i Obserwowane — każda objaśnia jeden z głównych widoków.
• Dywidenda zaksięgowana — dywidenda została automatycznie zaksięgowana — wiadomość zawiera ticker, liczbę akcji, stawkę oraz kwotę netto w walucie instrumentu i po przeliczeniu na walutę bazową.
• Brak stawki dywidendy — stawka dywidendy nie była znana, więc dywidenda nie została zaksięgowana — dodaj ją ręcznie jako transakcję.
• Brak kursu walutowego — stawka dywidendy była znana, ale zabrakło kursu walutowego z danego dnia — księgowanie zostało pominięte, dodaj dywidendę ręcznie.
• Niepewna stawka podatku — dywidenda została zaksięgowana, ale nie dało się ustalić stawki podatku u źródła — zaksięgowano z podatkiem 0%, ustaw stawkę samodzielnie.

Doofolio zbudował inwestor zmęczony walką z arkuszami. Cel jest prosty: dać inwestorom indywidualnym tę samą jasną, uczciwą analitykę portfolio, która kiedyś była zarezerwowana dla profesjonalistów — w interfejsie, którego naprawdę przyjemnie się używa.

Wdrażamy nieustannie. Ostatnie nowości to m.in. obsługa wielu portfoliów, śledzenie zdarzeń dywidendowych i porównanie z benchmarkiem. Śledź na bieżąco, jak pojawia się nowa analityka.

Wszystkie systemy działają.

Wartość portfela jest aktualizowana co godzinę od 10:00 do 18:00 EST w dni robocze oraz codziennie o 23:00. Jeśli coś wygląda nie tak, napisz na support@doofolio.app.