از قیمتهای زنده استفاده کنید تا قیمتهای ارزشگذاری که بهطور خودکار بازخوانی میشوند را به یک دفتر میزبانی شده Beancount.io اضافه کنید. فیدهای مدیریتشده دستورهای price تاریخدار را برای رمزارزها، سهام، صندوقها و ارزهای خارجی پشتیبانیشده فراهم میکنند. شما خریدها، فروشها و انتقالها را مثل همیشه ثبت میکنید.
منابع قیمت خود را انتخاب کنید
- انتخابگر منبع قیمت را باز کنید.
- ارزی را که میخواهید داراییهایتان را با آن ارزشگذاری کنید انتخاب کنید.
- داراییهای خود را از میانبر ها انتخاب کنید یا بر اساس نماد جستجو کنید، مثل
BTCیاAAPL. همچنین میتوانید گزیدهای از دفتر را جایگذاری کنید تا داراییهای آن را پیدا کند؛ گزیده در مرورگر شما باقی میماند. - بررسی کنید که هر نماد دارایی با کالا در دفتر شما مطابقت دارد. انتخابگر برای جفتهای فهرستشده include تولید میکند. ممکن است یک جفت فهرستنشده از اشتقاق درخواستی پشتیبانی کند، اما انتخابگر تا زمانی که پشتیبانی تأیید نشود آن را کنار میگذارد.
- includeهای تولیدشده را کپی کنید. برای استفاده از دفتر میزبانی شده خود وارد Beancount.io شوید و فیدهایی که نیازمند احراز هویت هستند را بررسی کنید.
ارز ارزشگذاری را برای دفاتر خود انتخاب کنید، نه برای زبان این صفحه. انتخاب یک ارز مظنه، کالاها را تغییر نام نمیدهد و تراکنشهای شما را تغییر نمیدهد.
فیدها را در دفتر میزبانی شده خود include کنید
خطوط تولیدشده را در main.bean یا فایل دیگری که دفتر شما از قبل آن را include میکند جایگذاری کنید. هر خط یک منبع قیمت را مشخص میکند. برای مثال، include میزبانی شده برای بیتکوین به دلار آمریکا در زیر بهصورت کامنتشده نشان داده شده است تا این مثال برای بارگذاری با Beancount بالادستی امن باقی بماند:
; Hosted Beancount.io ledger: remove the leading semicolon to enable this feed.
; include "https://beancount.io/prices/BTC-USD"هنگام افزودن خط به دفتر میزبانی شده خود، ; ابتدایی را حذف کنید. includeهای URL یک افزونه Beancount.io هستند. includeهای محلی معمولی همچنان نام فایل میگیرند، همانطور که در پشتیبانی چندفایلی توضیح داده شده است.
دفتر خود را مثل همیشه باز کنید. بارگذار آن، فیدهای مدیریتشده را به ورودیهای قیمت فقطخواندنی تبدیل میکند. وقتی دفتر پس از بازه بازخوانی پنجدقیقهای بارگذاری میشود، دادههای جدید را بررسی میکند. بازخوانی قیمتها فایلهای منبع شما را بازنویسی نمیکند یا commit دفتری ایجاد نمیکند. ورودیهای قیمت مدیریتشده به سقف ورودی دفتر شما اضافه نمیشوند.
قیمتها و ارزشگذاریها را بخوانید
یک فید شامل قیمتهای تاریخدار است و ممکن است فرادادههای price-source، price-kind، observed-at و provisional را دربر بگیرد. هنگام قضاوت درباره یک مظنه، زمان مشاهده و نوع قیمت را بررسی کنید. زمان بازخوانی بارگذار، زمان مشاهده ارائهدهنده نیست.
اینها قیمتهای ارزشگذاری هستند که بهطور خودکار بازخوانی میشوند، نه مظنههای معاملاتی جریانی. یک گزارش برای جفت کالای مرتبط در تاریخ ارزشگذاری خود یا پیش از آن به قیمت نیاز دارد. قیمت امروز نمیتواند خلأ یک گزارش قبلی را پر کند.
قیمتها ارزشگذاری بازار را در ابزارها و گزارشهایی که از دستورهای قیمت استفاده میکنند ممکن میسازند. نمای حساب که بهای تمامشده را نشان میدهد همچنان بهای تمامشده را نشان خواهد داد؛ اتصال یک فید آن نما را به ارزش بازار تغییر نمیدهد. برای تفاوت میان بهای تمامشده و ارزشگذاری بازار، راهنمای پرسوجو را ببینید.
بازخوانی قیمت، مقادیر، بهای خرید، جریانهای نقدی، کارمزدها یا سودهای محققشده ثبتشده در دفتر شما را تغییر نمیدهد. همچنین قیمت @ یا {cost} یک تراکنش را پر نمیکند. آنها را از خود تراکنش ثبت کنید. ارزیابی املاک، کالاهای نمونه تخیلی و داراییهای بدون فید پشتیبانیشده همچنان به قیمتهای تاریخدار خودتان نیاز دارند.
بازنویسی یک قیمت مدیریتشده
وقتی به ارزشگذاری خاصی نیاز دارید، دستور price تاریخدار خودتان را در یک فایل دفتر قابل ویرایش بنویسید. برای همان تاریخ و جفت کالا، قیمت شما بر فید مدیریتشده اولویت دارد. این موضوع برای جفت معکوس نیز صدق میکند و به ترتیب include بستگی ندارد.
قیمت دستی یک قفل دائمی نیست: یک مظنه مدیریتشده در تاریخ بعدی همچنان میتواند برای ارزشگذاری بعدی استفاده شود. خود ورودیهای مدیریتشده فقطخواندنی هستند. دستور قیمت خودتان را ویرایش کنید، یا include را حذف کنید تا استفاده از آن فید متوقف شود.
استفاده از قیمتها با ابزارهای محلی
| جایی که دفتر را بارگذاری میکنید | چگونه قیمتها را تأمین کنید |
|---|---|
| Beancount.io میزبانی شده | از includeهای URL مدیریتشده از انتخابگر استفاده کنید. |
یک نسخه سازگار از CLI bea | دستورالعملهای قیمت مدیریتشده CLI را برای حل URL و برونریزی فایلهای قیمت محلی دنبال کنید. |
| Beancount یا Fava بالادستی | فایلهای قیمت محلی را بارگذاری کنید؛ این ابزارها خودشان includeهای URL را واکشی نمیکنند. |
برای رفتار CLI وابسته به نسخه، از راهنمای قیمت مدیریتشده bea استفاده کنید. نسخههای سازگار bea price status، bea price refresh و bea price export --output audit را ارائه میدهند. برای خواندن تنها از حافظه پنهان از bea --offline balance استفاده کنید یا برای رد منابع کهنه یا در دسترس نبودن، از bea --strict-prices check استفاده کنید. برای جزئیات و گردش کار جایگزین محلی Beanprice، مرجع CLI را ببینید.
CLI بدون اعتبارنامه واکشی میکند و تغییر مسیرها را رد میکند. فیدی که به ورود میزبانی شده تغییر مسیر میدهد برای یک واکشی تازه CLI در دسترس نیست، حتی اگر از طریق مرورگر خود وارد شده باشید. در عوض از یک فید پشتیبانیشده قابل دسترسی یا قیمتهای تاریخدار محلی استفاده کنید. نسخههای قدیمیتر CLI ممکن است هر include URL را بهعنوان یک glob فایل بیهمتا در نظر بگیرند.
وقتی به یک گزارش آفلاین بازتولیدپذیر نیاز دارید، فایلهای قیمت تاریخدار محلی را نگه دارید. یک commit دفتر بهتنهایی بازبینی فید مدیریتشدهای که یک ارزشگذاری گذشته از آن استفاده کرده را ثبت نمیکند. قیمتهای استفادهشده را در کنار دفتر و گزارش حفظ کنید.
برای یکپارچهسازی با سرویس قیمت، مرجع API قیمتها را ببینید. نقاط پایانی آن از افزودن یک include به یک دفتر میزبانی شده جدا هستند.
رفع اشکال ارزشگذاری گمشده یا غیرمنتظره
| نشانه | چه چیزی را بررسی کنید |
|---|---|
| کاتالوگ بارگذاری نمیشود | انتخابگر را دوباره امتحان کنید. یک URL include را از یک نماد پشتیبانینشده حدس نزنید. |
| یک دارایی انتخابشده از includeهای کپیشده کنار گذاشته شده | پشتیبانی آن دارایی را در ارز مظنه انتخابی خود بررسی کنید و نماد دفتر را مطابقت دهید. |
| باز کردن یک فید به ورود تغییر مسیر میدهد | برای بررسی آن در گردش کار میزبانی شده وارد شوید. CLI آن نشست را ارسال نمیکند و تغییر مسیرها را رد میکند. |
| قیمتها کهنه به نظر میرسند | زمان مشاهده را با تاریخ گزارش مقایسه کنید. یک بازخوانی ناموفق میتواند یک فید حافظه پنهان معتبرشده قبلی را نگه دارد؛ دادههای حافظه پنهان ممکن است کهنه باشند. |
| هیچ قیمتی در دسترس نیست | بدون قیمت حافظه پنهان معتبرشده، دفاتر همچنان میتوانند بارگذاری شوند، اما ممکن است دارایی فاقد ارزشگذاری بازار باشد. در صورت نیاز یک قیمت دستی مناسب تأمین کنید. |
| قیمت دستی شما نادیده گرفته شده به نظر میرسد | تاریخ و جفت دقیق را بررسی کنید. یک مظنه مدیریتشده بعدی میتواند برای یک گزارش بعدی اعمال شود. |
| یک بارگذار محلی یک include بیهمتا گزارش میکند | از یک نسخه سازگار bea استفاده کنید یا include URL را با یک فایل قیمت محلی جایگزین کنید. |
| ارزش حساب تغییر نکرده است | بررسی کنید که آیا نما بهای تمامشده را نشان میدهد و آیا گزارش قیمتهایی دارد که تاریخ ارزشگذاری آن را پوشش دهند. |
برای دستورهای دستی، مرجع نحو قیمت و برای سوابق سرمایهگذاری ثابت و بازتولیدپذیر، نمونههای دفتر کاری را ببینید.