Export To Ghostfolio

تصدير إلى Ghostfolio

تتيح لك هذه الأداة تحويل عمليات تصدير المعاملات المتعددة (CSV) إلى ملف استيراد يمكن قراءته بواسطة Ghostfolio. يوجد حاليًا دعم لـ:

• بيتفافو

• بوكس

• ديجيرو

• إي تورو

• فينبنسيون

• التجارة الحرة

• الوسطاء التفاعليون (IBKR)

• استثماري

• باركيه

• رابوبانك

• ثورة

• شواب

• سويسكوت

• التداول 212

• XTB

هل الوسيط الخاص بك ليس في القائمة؟ لا تتردد في إنشاء مشكلة، أو الأفضل من ذلك، أنشئها بنفسك وأنشئ طلب سحب! لمزيد من المعلومات، راجع المساهمة.

تحميل تصدير المعاملات

راجع تعليمات تصدير المعاملات لكل من الوسطاء المدعومين أدناه.

عرض تعليمات تصدير المعاملة

بيتفافو

قم بتسجيل الدخول إلى حساب Bitvavo الخاص بك وانقر على اسمك في الجزء العلوي الأيسر. بعد ذلك، انقر فوق "سجل المعاملات". انقر فوق الزر "تصدير" الأزرق الموجود في الأسفل لإنشاء عملية تصدير. حدد أحد خيارات CSv وانقر مرة أخرى على "تصدير".

بوكس

افتح التطبيق وانتقل إلى "قيمة الحساب"، ثم "عرض السجل". انقر على أيقونة التنزيل في الزاوية اليمنى العليا لتنزيل سجل معاملاتك. سيتم إرسال التصدير إلى عنوان بريدك الإلكتروني.

نظرًا للقيود التي يفرضها BUX، يمكنك طلب ما يصل إلى 3 عمليات تصدير بتنسيق CSV يوميًا! .

ديجيرو

قم بتسجيل الدخول إلى حساب DEGIRO الخاص بك وقم بإنشاء ملف تصدير (عبر البريد الوارد > نظرة عامة على الحساب، انظر الصورة أدناه). اختر الفترة التي ترغب في تصدير السجل الخاص بك إليها وانقر فوق تنزيل.

إي تورو

قم بتسجيل الدخول إلى حساب eToro الخاص بك وانتقل إلى "المحفظة". ثم حدد "التاريخ" في القائمة العلوية. بعد ذلك، انقر على الأيقونة الموجودة في أقصى اليمين واختر "كشف الحساب". اختر التواريخ التي تهمك وانقر على "إنشاء". في الصفحة التالية، انقر على أيقونة Excel في أعلى اليمين لتنزيل الملف. بعد التنزيل، افتح الملف في برنامج Excel واحذف جميع علامات التبويب باستثناء علامة التبويب "نشاط الحساب". ثم استخدم Excel لتحويل الملف إلى CSV.

فينبنسيون

قم بتسجيل الدخول إلى حساب Finpension الخاص بك. حدد محفظتك من الصفحة المقصودة. ثم على يمين الشاشة، حدد "المعاملات"، في الصفحة التالية إلى الإشعار الأيمن "تقرير المعاملات (ملف CSV)" وانقر فوق إرسال بريد إلكتروني أو انقر فوق التنزيل محليًا.

التجارة الحرة

افتح تطبيق التجارة الحرة. حدد محفظتك الاستثمارية من الخيار الموجود في الجزء العلوي الأيسر تحت عنوان "المحفظة". حدد "النشاط" من قائمة الرموز الموجودة أسفل الشاشة. حدد رمز المشاركة في الزاوية العلوية اليمنى، ثم اتبع التعليمات التي تظهر على الشاشة.

الوسطاء التفاعليون (IBKR)

قم بتسجيل الدخول إلى حساب الوسطاء التفاعليين الخاص بك. انتقل إلى إدارة الحساب وانقر على "إعداد التقارير" في الشريط الجانبي. بعد ذلك، انقر فوق علامة التبويب "الاستعلامات المرنة" في قسم "التقارير". من قسم "الاستعلامات المرنة"، انقر فوق أيقونة علامة الزائد (+) الموجودة على الجانب الأيمن لإنشاء استعلام مرن جديد. أنشئ استعلامًا مرنًا جديدًا للتداولات، واستعلامًا آخر لتوزيعات الأرباح. اضبط تنسيق التصدير على "CSV". انظر الأعمدة المطلوبة أسفل الصورة.

الصفقات

بالنسبة للتداولات، حدد "التداولات". ثم حدد الخصائص التالية: Buy/Sell, TradeDate, ISIN, Quantity, TradePrice, TradeMoney, CurrencyPrimary, IBCommission, IBCommissionCurrency .

توزيعات الأرباح

بالنسبة لتوزيعات الأرباح، اختر "المعاملات النقدية". ثم حدد الخصائص التالية: Type, SettleDate, ISIN, Description, Amount, CurrencyPrimary .

استثماري

قم بتسجيل الدخول إلى حسابك الاستثماري وانقر على "سجل الطلبات اليومي". حدد الحساب والفترة الزمنية المطلوبة ثم انقر فوق زر التحديث. يجب أن تظهر المعاملات ثم انقر فوق زر التنزيل.

باركيه

قم بتسجيل الدخول إلى Parquet وانتقل إلى قسم "الأنشطة" (باللغة الألمانية، "Aktivitäten"). في الزاوية العلوية اليمنى، بجوار زر "Neue Aktivität" الأخضر، سترى خيار "التنزيل بتنسيق CSV" (باللغة الألمانية، "Export als CSV"). انقر فوق هذا الزر لتنزيل ملف CSV يحتوي على جميع أنشطتك.

رابوبانك

قم بتسجيل الدخول إلى Rabobank وانتقل إلى استثماراتك. انتقل إلى "المعاملات ومذكرات العقد" (الطفرات والمذكرات). حدد النطاق الذي ترغب في تصديره في الأعلى. ثم قم بالتمرير إلى أسفل الصفحة وانقر على "تصدير بتنسيق .csv"

ثورة

افتح تطبيق Revolut وافتح علامة التبويب "استثمار". اضغط على زر "المزيد"، ثم اختر "المستندات". قم باختيار حسابك الاستثماري ثم اختر الخيار الأول "كشف الحساب". اختر خيار "Excel" وحدد النطاق الزمني. ثم قم بتحميل الملف وحفظه على جهازك. قم بتحويل الملف من .xlsx إلى .csv . اضبط حرف الفصل , (فاصلة)!

شواب

قم بتسجيل الدخول إلى حساب شواب الخاص بك. انتقل إلى "الحسابات" ثم "السجل". حدد الحساب الذي تريد تنزيل التفاصيل منه. حدد "النطاق الزمني" وحدد "تصدير" (ملف CSV). احفظ الملف.

سويسكوت

قم بتسجيل الدخول إلى حسابك في سويسكوت. من قائمة الشريط انقر على "المعاملات". حدد الفترة الزمنية المطلوبة وكذلك الأنواع ثم حدد زر "تصدير CSV" الموجود على اليمين.

التداول 212

قم بتسجيل الدخول إلى حساب Trading 212 الخاص بك وقم بإنشاء ملف تصدير (عبر السجل > أيقونة التنزيل). اختر الفترة التي ترغب في تصدير السجل الخاص بك إليها وانقر فوق تنزيل.

XTB

قم بتسجيل الدخول إلى حساب XTB الخاص بك ومن الشريط العلوي انقر على "سجل الحساب"، ثم "العمليات النقدية". انقر فوق الزر "تصدير". اختر الفترة التي ترغب في تصدير السجل الخاص بك منها، حدد نوع التقرير "العمليات النقدية" اختر تنسيق الملف "csv" ثم انقر فوق زر "تصدير التقرير".

كيفية الاستخدام

يمكنك تشغيل الأداة على جهازك المحلي عن طريق استنساخ هذا المستودع. يمكنك أيضًا تشغيل الأداة داخل حاوية Docker. راجع التعليمات المحددة لوقت التشغيل أدناه.

عامل ميناء

عرض التعليمات

متطلبات النظام

لتشغيل حاوية Docker، يجب تثبيت Docker على جهازك. تم نشر الصورة على Docker Hub.

كيفية الاستخدام مع صورة Dockerhub

على عكس الإصدار الذي يتم تشغيله محليًا من الأداة، يحاول الإصدار الموجود في حاوية تحديد نوع الملف المطلوب معالجته من خلال النظر إلى سطر الرأس داخل الملف. لذلك ليست هناك حاجة لتحديد المحول الذي سيتم استخدامه.

يمكنك بعد ذلك تشغيل الصورة مثل:

 تشغيل عامل ميناء --rm -v {local_in-folder}:/var/tmp/e2g-input -v {local_out_folder}:/var/tmp/e2g-output --env GHOSTFOLIO_ACCOUNT_ID=xxxxxxxxx dickwolff/export-to-ghostfolio

يمكن إعطاء المعلمات التالية لأمر تشغيل Docker.

يأمر	خياري	وصف
-v {local_in-folder}:/var/tmp/e2g-input	ن	مجلد الإدخال حيث تضع الملفات المراد معالجتها
-v {local_out_folder}:/var/tmp/e2g-output	ن	مجلد الإخراج حيث سيتم وضع استيراد Ghostfolio JSON. كما سيتم نقل ملف الإدخال هنا عند حدوث خطأ أثناء معالجة الملف.
-v {local_cache_folder}:/var/tmp/e2g-cache	ي	المجلد الذي سيتم فيه تخزين رموز Yahoo Finance مؤقتًا
--env GHOSTFOLIO_ACCOUNT_ID=xxxxxxx	ن	معرف حساب Ghostolio الخاص بك 1
--env USE_POLLING=true	ي	عند التعيين على "صحيح"، ستبحث الحاوية باستمرار عن ملفات جديدة لمعالجتها ولن تتوقف الحاوية.
--env DEBUG_LOGGING=true	ي	عند التعيين على "صحيح"، ستعرض الحاوية السجلات بمزيد من التفاصيل، وهو أمر مفيد لتتبع الأخطاء.
--env PURGE_CACHE=true	ي	عند التعيين على "صحيح"، سيتم مسح ذاكرة التخزين المؤقت للملف عند البداية.
--env GHOSTFOLIO_VALIDATE=true	ي	عند التعيين على "صحيح"، تقوم الأداة تلقائيًا بالتحقق من صحة الملف الذي تم إنشاؤه مقابل Ghostfolio.
--env GHOSTFOLIO_IMPORT=true	ي	عند التعيين على "صحيح"، ستحاول الأداة استيراد الملف الذي تم إنشاؤه تلقائيًا إلى Ghostfolio.
--env GHOSTFOLIO_URL=http://xxxxxxx	ي	نقطة النهاية لمثيل Ghostfolio المحلي الخاص بك. على سبيل المثال http://192.168.1.15:3333 . استخدم فقط مع مثيل Ghostfolio المحلي!
--env GHOSTFOLIO_SECRET=xxxxxxx	ي	بيانات اعتماد مستخدم Ghostfolio الخاص بك. يُستخدم للمصادقة باستخدام نقطة نهاية واجهة برمجة التطبيقات import . استخدم فقط مع مثيل Ghostfolio المحلي!

كيفية الاستخدام عن طريق إنشاء صورتك الخاصة

استخدم هذا الخيار إذا كنت ترغب في التشغيل باستخدام بيئة إرساء معزولة حيث يمكنك التحكم الكامل في الصورة وبالتالي يمكنك الوثوق بها لاحتواءها فقط على ما هو متوقع.

انسخ هذا المستودع إلى نظامك ثم قم بتشغيل:

 docker build -t Export-to-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 التصدير إلى Ghostfolio

يمكنك استخدام نفس الخيارات المذكورة أعلاه لاستخدام الصورة على Dockerhub

التخزين المؤقت

تستخدم الأداة cacache لتخزين البيانات المستردة من Yahoo Finance داخل الحاوية. بهذه الطريقة يتم تقليل الحمل على Yahoo Finance ويجب أن تعمل الأداة بشكل أسرع. يتم تخزين البيانات المخزنة مؤقتًا داخل الحاوية في /var/tmp/e2g-cache . إذا كنت تشعر أنك بحاجة إلى إبطال ذاكرة التخزين المؤقت الخاصة بك، فيمكنك القيام بذلك عن طريق إضافة --env PURGE_CACHE=true إلى أمر التشغيل الخاص بك. سيؤدي هذا إلى مسح ذاكرة التخزين المؤقت عند بدء الحاوية، وستعيد الأداة إنشاء ذاكرة التخزين المؤقت في المرة التالية التي يتعين عليها فيها استرداد البيانات من Yahoo Finance.

تشغيل محليا

عرض التعليمات

متطلبات النظام

تتطلب منك الأداة تثبيت أحدث إصدار LTS من Node، والذي يمكنك تنزيله هنا. يمكن تشغيل الأداة على أي نظام تشغيل يمكنك تثبيت Node.

استخدم الأداة

بعد ذلك، انسخ الريبو على جهازك المحلي وافتحه باستخدام المحرر الذي تختاره (مثل Visual Studio Code).

قم بتشغيل npm install لتثبيت كافة الحزم المطلوبة.

يحتوي المستودع على نموذج لملف .env . أعد تسمية هذا من .env.sample .

• ضع مسار ملف التصدير في المتغير INPUT_FILE . يجب أن يكون هذا متعلقًا بجذر المشروع.

• ضع اسم حساب Ghostfolio حيث تريد أن تنتهي معاملاتك في GHOSTFOLIO_ACCOUNT_ID

• يمكن استرداد ذلك بالانتقال إلى الحسابات > حدد حسابك ونسخ المعرف من عنوان URL

• اختياريًا، يمكنك ضبط المتغير GHOSTFOLIO_UPDATE_CASH على TRUE لتحديث الرصيد النقدي لحساب Ghostfolio تلقائيًا بعد معالجة الأنشطة.

• اختياريًا، يمكنك تمكين تسجيل التصحيح عن طريق ضبط المتغير DEBUG_LOGGING على TRUE .

يمكنك الآن تشغيل npm run start [exporttype] . انظر الجدول الذي يحتوي على أوامر التشغيل أدناه. ستقوم الأداة بفتح التصدير الخاص بك وسوف تقوم بتحويله. يقوم باسترداد الرموز المدعومة مع YAHOO Finance (على سبيل المثال بالنسبة للأسهم الأوروبية مثل ASML ، فإنه سيتم استرداد ASML.AS بواسطة رقم ISIN المطابق).

مصدر	تشغيل الأمر
بيتفافو	run start bitvavo (أو bv )
بوكس	run start bux
ديجيرو	run start degiro
إي تورو	run start etoro
فينبنسيون	run start finpension (أو fp )
التجارة الحرة	run start freetrade (أو ft )
إبكر	run start ibkr
استثماري	run start investimental
باركيه	run start pareqt
رابوبانك	run start rabobank
ثورة	run start revolut
شواب	run start schwab
سويسكوت	run start swissquote (أو sq )
التداول 212	run start trading212 (أو t212 )
XTB	run start xtb

التخزين المؤقت

تستخدم الأداة cacache لتخزين البيانات المستردة من Yahoo Finance على القرص. بهذه الطريقة يتم تقليل الحمل على Yahoo Finance ويجب أن تعمل الأداة بشكل أسرع. يتم تخزين البيانات المخزنة مؤقتًا في /var/tmp/e2g-cache . إذا كنت تشعر أنك بحاجة إلى إبطال ذاكرة التخزين المؤقت الخاصة بك، فيمكنك القيام بذلك عن طريق إزالة المجلد وستعيد الأداة إنشاء ذاكرة التخزين المؤقت عند تشغيلها في المرة التالية.

استيراد إلى Ghostfolio

يدويا

يمكن الآن استيراد ملف التصدير إلى Ghostfolio بالانتقال إلى Portfolio > الأنشطة والضغط على النقاط الثلاث في أعلى يمين الجدول. منذ إصدار Ghostfolio 1.221.0، يمكنك الآن معاينة الاستيراد والتحقق من صحة تحويل البيانات بشكل صحيح. عندما يرضيك الأمر، اضغط على "استيراد" لإضافة الأنشطة إلى محفظتك.

تلقائيا (تجريبي)

هناك ميزة تجريبية (منذ 0.12.0) يمكنك من خلالها التحقق تلقائيًا من صحة الملف الذي تم إنشاؤه واستيراده إلى Ghostfolio! لاستخدام هذا، قم بتعيين متغيرات البيئة المقابلة:

عامل	وصف
--env GHOSTFOLIO_VALIDATE=true	عند التعيين على "صحيح"، تقوم الأداة تلقائيًا بالتحقق من صحة الملف الذي تم إنشاؤه مقابل Ghostfolio.
--env GHOSTFOLIO_IMPORT=true	عند التعيين على "صحيح"، ستحاول الأداة استيراد الملف الذي تم إنشاؤه تلقائيًا إلى Ghostfolio.
--env GHOSTFOLIO_URL=http://xxxxxxx	نقطة النهاية لمثيل Ghostfolio المحلي الخاص بك. على سبيل المثال http://192.168.1.15:3333 . استخدم فقط مع مثيل Ghostfolio المحلي!
--env GHOSTFOLIO_SECRET=xxxxxxx	بيانات اعتماد مستخدم Ghostfolio الخاص بك. يُستخدم للمصادقة باستخدام نقطة نهاية واجهة برمجة التطبيقات import . استخدم فقط مع مثيل Ghostfolio المحلي!

---

المساهمة

نحن نرحب بأي مساهمة في المستودع. لا تتردد في إنشاء مشكلة، أو الأفضل من ذلك، أنشئها بنفسك وأنشئ طلب سحب!

يمكن تشغيل الأداة بطريقتين، يدويًا وعبر Docker. يمكن العثور على نقطتي الدخول للأداة في المجلد "src/". تستخدم الأداة نموذجًا في الاختبارات، مما يسمح بإجراء الاختبارات بطريقة متسقة وقابلة للتكرار. بهذه الطريقة ليست هناك حاجة إلى خدمة Yahoo Finance المباشرة. تمت إضافة النموذج الوهمي بسبب التناقضات بين عمليات التشغيل الاختبارية ومشكلات تحديد المعدل مع Yahoo Finance (مع عمليات تشغيل متعددة متتالية، خاصة عند التشغيل محليًا).

كلما قمت بإضافة محول جديد أو إنشاء إصلاح لمحول موجود، يرجى الرجوع إلى Wiki للحصول على إرشادات حول كيفية توسيع النموذج باستخدام بيانات الاختبار.

الحواشي

1. يمكنك استرداد معرف حساب Ghostfolio الخاص بك بالانتقال إلى الحسابات > تحرير لحسابك ونسخ حقل معرف الحساب ↩