Export To Ghostfolio

Export To Ghostfolio

Kode sumber lainnya

Release 0.19.1

Unduh

Ekspor ke Ghostfolio

Alat ini memungkinkan Anda mengonversi beberapa ekspor transaksi (CSV) menjadi file impor yang dapat dibaca oleh Ghostfolio. Saat ini ada dukungan untuk:

Bitvavo
BUX
DEGIRO
eToro
Pensiun Fin
perdagangan bebas
Broker Interaktif (IBKR)
Investasi
Parket
Rabobank
Revolusi
Swab
kutipan Swiss
Perdagangan 212
XTB

Apakah broker Anda tidak ada dalam daftar? Jangan ragu untuk membuat masalah atau, lebih baik lagi, buat sendiri dan buat permintaan tarik! Untuk informasi selengkapnya, lihat berkontribusi.

Unduh ekspor transaksi

Lihat petunjuk ekspor transaksi untuk masing-masing broker yang didukung di bawah ini.

Lihat instruksi ekspor transaksi

Bitvavo

Masuk ke akun Bitvavo Anda dan klik nama Anda di kanan atas. Selanjutnya, klik "Riwayat transaksi". Klik tombol biru "Ekspor" di untuk membuat ekspor. Pilih salah satu opsi CSv dan klik lagi "Ekspor".

BUX

Buka aplikasi dan buka "Nilai Akun", lalu "Lihat Riwayat". Klik ikon download di pojok kanan atas untuk mendownload riwayat transaksi Anda. Ekspor akan dikirim ke alamat email Anda.

Karena keterbatasan BUX, Anda dapat meminta hingga 3 ekspor CSV per hari! .

DEGIRO

Masuk ke akun DEGIRO Anda dan buat file ekspor (melalui Kotak Masuk > Ikhtisar Akun, lihat gambar di bawah). Pilih periode di mana Anda ingin mengekspor riwayat Anda dan klik unduh.

eToro

Masuk ke akun eToro Anda dan arahkan ke "Portofolio". Kemudian pilih "Riwayat" di menu atas. Selanjutnya, klik ikon di paling kanan dan pilih "Laporan Rekening". Pilih tanggal yang diinginkan dan klik "Buat". Di halaman berikutnya, klik ikon Excel di kanan atas untuk mendownload file. Setelah diunduh, buka file di Excel dan hapus semua tab kecuali tab "Aktivitas Akun". Kemudian gunakan Excel untuk mengonversi file ke CSV.

Pensiun Fin

Masuk ke akun Finpension Anda. Pilih portofolio Anda dari halaman arahan. Kemudian di sebelah kanan layar pilih “Transaksi”, di halaman berikutnya di sebelah kanan pemberitahuan “laporan transaksi (file CSV)” dan klik untuk mengirim email atau klik untuk mengunduh secara lokal.

perdagangan bebas

Buka aplikasi Perdagangan Bebas. Pilih portofolio Anda dari opsi di kiri atas di bawah judul "Portofolio". Pilih "Aktivitas" dari daftar ikon di bagian bawah layar. Pilih ikon bagikan di sudut kanan atas lalu ikuti petunjuk di layar.

Broker Interaktif (IBKR)

Masuk ke akun Pialang Interaktif Anda. Navigasikan ke Manajemen Akun dan klik "Pelaporan" di sidebar. Selanjutnya, klik pada tab "Flex Queries" di bagian "Reporting". Dari Flex "Queries section", Klik ikon plus (+) di sisi kanan untuk membuat Flex Query baru. Buat Kueri Fleksibel baru untuk Perdagangan, dan satu lagi untuk Dividen. Setel format ekspor ke "CSV". Lihat kolom wajib di bawah gambar.

Perdagangan

Untuk perdagangan, pilih "Perdagangan". Kemudian pilih properti berikut: Buy/Sell, TradeDate, ISIN, Quantity, TradePrice, TradeMoney, CurrencyPrimary, IBCommission, IBCommissionCurrency .

Dividen

Untuk dividen, pilih "Transaksi Tunai". Kemudian pilih properti berikut: Type, SettleDate, ISIN, Description, Amount, CurrencyPrimary .

Investasi

Masuk ke akun Investasi Anda dan klik "Log Harian Pesanan". Pilih akun dan jangka waktu yang diinginkan lalu klik tombol segarkan. Transaksi akan muncul dan kemudian klik tombol unduh.

Parket

Masuk ke Parket dan navigasikan ke bagian "Aktivitas" (dalam bahasa Jerman, "Aktivitäten"). Di pojok kanan atas, di samping tombol hijau "Neue Aktivität", Anda akan melihat opsi "Unduh sebagai CSV" (Dalam bahasa Jerman, "Ekspor als CSV"). Klik tombol ini untuk mengunduh file CSV yang berisi semua aktivitas Anda.

Rabobank

Masuk ke Rabobank dan navigasikan ke investasi Anda. Arahkan ke "Transaksi & Catatan Kontrak" (Mutaties & Nota's). Pilih rentang yang ingin Anda ekspor di bagian atas. Kemudian gulir ke bagian bawah halaman dan klik "Ekspor sebagai .csv"

Revolusi

Buka aplikasi Revolut dan buka tab "Investasi". Tekan tombol "Lainnya", lalu pilih "Dokumen". Pilih akun investasi Anda dan pilih opsi pertama, "Laporan akun". Pilih opsi "Excel" dan pilih rentang tanggal. Kemudian unduh file dan simpan di perangkat Anda. Konversikan file dari .xlsx ke .csv . Atur karakter pemisah menjadi , (koma)!

Swab

Masuk ke akun Schwab Anda. Buka "Akun" lalu "Riwayat". Pilih akun tempat Anda ingin mengunduh detailnya. Pilih "Rentang Tanggal" dan pilih "Ekspor" (csv). Simpan berkasnya.

kutipan Swiss

Masuk ke akun Swissquote Anda. Dari menu bar klik “Transaksi”. Pilih jangka waktu dan jenis yang diinginkan, lalu pilih tombol “ekspor CSV” di sebelah kanan.

Perdagangan 212

Masuk ke akun Trading 212 Anda dan buat file ekspor (melalui ikon Riwayat > Unduh). Pilih periode di mana Anda ingin mengekspor riwayat Anda dan klik unduh.

XTB

Masuk ke akun XTB Anda dan dari bilah atas klik "Riwayat akun", lalu "Operasi tunai". Klik "tombol Ekspor". Pilih periode di mana Anda ingin mengekspor riwayat Anda, pilih jenis laporan "Operasi Tunai" pilih format file "csv" lalu klik tombol "Ekspor Laporan".

Cara menggunakan

Anda dapat menjalankan alat ini di mesin lokal Anda dengan mengkloning repositori ini. Anda juga dapat menjalankan alat ini di dalam container Docker. Lihat petunjuk khusus runtime di bawah.

Buruh pelabuhan

Lihat instruksi

Persyaratan sistem

Untuk menjalankan container Docker, Anda harus menginstal Docker di mesin Anda. Gambar dipublikasikan ke Docker Hub.

Cara menggunakan gambar Dockerhub

Berbeda dengan versi alat yang dijalankan secara lokal, versi dalam container mencoba menentukan jenis file mana yang akan diproses dengan melihat baris header di dalam file. Jadi tidak perlu menentukan konverter mana yang akan digunakan.

Anda kemudian dapat menjalankan gambar seperti:

 menjalankan buruh pelabuhan --rm -v {local_in-folder}:/var/tmp/e2g-input -v {local_out_folder}:/var/tmp/e2g-output --env GHOSTFOLIO_ACCOUNT_ID=xxxxxxx dickwolff/export-to-ghostfolio

Parameter berikut dapat diberikan ke perintah Docker run.

Memerintah	Opsional	Keterangan
`-v {local_in-folder}:/var/tmp/e2g-input`	N	Folder masukan tempat Anda meletakkan file yang akan diproses
`-v {local_out_folder}:/var/tmp/e2g-output`	N	Folder keluaran tempat JSON impor Ghostfolio akan ditempatkan. File masukan juga akan dipindahkan ke sini ketika terjadi kesalahan saat memproses file.
`-v {local_cache_folder}:/var/tmp/e2g-cache`	Y	Folder tempat simbol Yahoo Finance akan di-cache
`--env GHOSTFOLIO_ACCOUNT_ID=xxxxxxx`	N	ID akun Ghostolio Anda ¹
`--env USE_POLLING=true`	Y	Jika disetel ke true, container akan terus mencari file baru untuk diproses dan container tidak akan berhenti.
`--env DEBUG_LOGGING=true`	Y	Jika disetel ke true, penampung akan menampilkan log secara lebih detail, berguna untuk pelacakan kesalahan.
`--env PURGE_CACHE=true`	Y	Jika disetel ke true, cache file akan dihapus saat dimulai.
`--env GHOSTFOLIO_VALIDATE=true`	Y	Jika disetel ke true, alat akan secara otomatis memvalidasi file yang dihasilkan terhadap Ghostfolio.
`--env GHOSTFOLIO_IMPORT=true`	Y	Jika disetel ke true, alat ini akan mencoba mengimpor file yang dihasilkan secara otomatis ke Ghostfolio.
`--env GHOSTFOLIO_URL=http://xxxxxxx`	Y	Titik akhir dari instans Ghostfolio lokal Anda. Misalnya `http://192.168.1.15:3333` . Gunakan HANYA dengan instance Ghostfolio lokal!
`--env GHOSTFOLIO_SECRET=xxxxxxx`	Y	Kredensial pengguna Ghostfolio Anda. Digunakan untuk mengautentikasi dengan titik akhir API `import` . Gunakan HANYA dengan instance Ghostfolio lokal!

Cara menggunakannya dengan menghasilkan gambar Anda sendiri

Gunakan opsi ini jika Anda ingin menjalankan menggunakan lingkungan buruh pelabuhan terisolasi di mana Anda memiliki kontrol penuh atas gambar dan dengan demikian dapat mempercayai gambar tersebut hanya berisi apa yang diharapkan.

Kloning repositori ini ke sistem Anda lalu jalankan:

 docker build -t ekspor-ke-ghostfolio .docker run --rm -v {local_in-folder}:/var/tmp/e2g-input -v {local_out_folder}:/var/tmp/e2g-output --env GHOSTFOLIO_ACCOUNT_ID= xxxxxxx -t ekspor-ke-ghostfolio

Anda dapat menggunakan opsi yang sama seperti di atas untuk menggunakan image di Dockerhub

cache

Alat ini menggunakan cacache untuk menyimpan data yang diambil dari Yahoo Finance di dalam wadah. Dengan cara ini beban pada Yahoo Finance berkurang dan alat tersebut akan berjalan lebih cepat. Data cache disimpan di dalam container di /var/tmp/e2g-cache . Jika Anda merasa perlu membatalkan cache, Anda dapat melakukannya dengan menambahkan --env PURGE_CACHE=true ke perintah run Anda. Ini akan menghapus cache saat kontainer dimulai, dan alat akan membuat ulang cache saat berikutnya harus mengambil data dari Yahoo Finance.

Jalankan secara lokal

Lihat instruksi

Persyaratan sistem

Alat ini mengharuskan Anda menginstal Node versi LTS terbaru, yang dapat Anda unduh di sini. Alat ini dapat berjalan di OS apa pun tempat Anda dapat menginstal Node.js.

Gunakan alat ini

Selanjutnya, kloning repo ke mesin lokal Anda dan buka dengan editor pilihan Anda (misalnya Visual Studio Code).

Jalankan npm install untuk menginstal semua paket yang diperlukan.

Repositori berisi contoh file .env . Ganti nama ini dari .env.sample .

Letakkan jalur file ekspor Anda di variabel INPUT_FILE . Hal ini harus berhubungan dengan akar proyek.
Masukkan nama akun Ghostfolio tempat Anda ingin transaksi Anda berakhir di GHOSTFOLIO_ACCOUNT_ID

Ini dapat diambil dengan membuka Akun > pilih akun Anda dan menyalin ID dari URL

Secara opsional, Anda dapat mengatur variabel GHOSTFOLIO_UPDATE_CASH ke TRUE untuk secara otomatis memperbarui saldo kas akun Ghostfolio Anda setelah memproses aktivitas.
Secara opsional, Anda dapat mengaktifkan pencatatan debug dengan menyetel variabel DEBUG_LOGGING ke TRUE .

Anda sekarang dapat menjalankan npm run start [exporttype] . Lihat tabel dengan perintah run di bawah. Alat ini akan membuka ekspor Anda dan mengonversinya. Ini mengambil simbol-simbol yang didukung oleh YAHOO Finance (misalnya untuk saham Eropa seperti ASML , ini akan mengambil ASML.AS dengan ISIN yang sesuai).

Eksportir	Jalankan perintah
Bitvavo	`run start bitvavo` (atau `bv` )
BUX	`run start bux`
DEGIRO	`run start degiro`
eToro	`run start etoro`
Pensiun Fin	`run start finpension` (atau `fp` )
perdagangan bebas	`run start freetrade` (atau `ft` )
IBKR	`run start ibkr`
Investasi	`run start investimental`
Parket	`run start pareqt`
Rabobank	`run start rabobank`
Revolusi	`run start revolut`
Swab	`run start schwab`
kutipan Swiss	`run start swissquote` (atau `sq` )
Perdagangan 212	`run start trading212` (atau `t212` )
XTB	`run start xtb`

cache

Alat ini menggunakan cacache untuk menyimpan data yang diambil dari Yahoo Finance pada disk. Dengan cara ini beban pada Yahoo Finance berkurang dan alat tersebut akan berjalan lebih cepat. Data cache disimpan di /var/tmp/e2g-cache . Jika Anda merasa perlu membuat cache Anda tidak valid, Anda dapat melakukannya dengan menghapus folder tersebut dan alat tersebut akan membuat ulang cache tersebut saat Anda menjalankannya di lain waktu.

Impor ke Ghostfolio

Secara manual

File ekspor sekarang dapat diimpor di Ghostfolio dengan membuka Portofolio > Aktivitas dan menekan 3 titik di kanan atas tabel. Sejak Ghostfolio 1.221.0, kini Anda dapat melihat pratinjau impor dan memvalidasi data yang telah dikonversi dengan benar. Jika sudah sesuai dengan keinginan Anda, tekan impor untuk menambahkan aktivitas ke portofolio Anda.

Secara otomatis (eksperimental)

Ada fitur eksperimental (sejak 0.12.0) yang dengannya Anda dapat secara otomatis memvalidasi dan mengimpor file yang dihasilkan ke Ghostfolio! Untuk menggunakan ini, atur variabel lingkungan yang sesuai:

Variabel	Keterangan
`--env GHOSTFOLIO_VALIDATE=true`	Jika disetel ke true, alat akan secara otomatis memvalidasi file yang dihasilkan terhadap Ghostfolio.
`--env GHOSTFOLIO_IMPORT=true`	Jika disetel ke true, alat ini akan mencoba mengimpor file yang dihasilkan secara otomatis ke Ghostfolio.
`--env GHOSTFOLIO_URL=http://xxxxxxx`	Titik akhir dari instans Ghostfolio lokal Anda. Misalnya `http://192.168.1.15:3333` . Gunakan HANYA dengan instance Ghostfolio lokal!
`--env GHOSTFOLIO_SECRET=xxxxxxx`	Kredensial pengguna Ghostfolio Anda. Digunakan untuk mengautentikasi dengan titik akhir API `import` . Gunakan HANYA dengan instance Ghostfolio lokal!

Berkontribusi

Kami menyambut baik kontribusi apa pun ke repositori. Jangan ragu untuk membuat masalah atau, lebih baik lagi, buat sendiri dan buat permintaan tarik!

Alat ini dapat dijalankan dengan dua cara, secara manual dan melalui Docker. Kedua titik masuk alat ini dapat ditemukan di folder 'src/'. Alat ini menggunakan tiruan dalam pengujian, yang memungkinkan pengujian dijalankan secara konsisten dan berulang. Dengan cara ini tidak diperlukan layanan Yahoo Finance langsung. Tiruan ini ditambahkan karena ketidakkonsistenan antara uji coba dan masalah pembatasan nilai pada Yahoo Finance (dengan beberapa uji coba berturut-turut, terutama saat dijalankan secara lokal).

Setiap kali Anda menambahkan konverter baru atau membuat perbaikan untuk konverter yang sudah ada, silakan merujuk ke Wiki untuk instruksi tentang cara memperluas tiruan dengan data uji.