Използвайте Live Prices, за да добавите автоматично опреснявани цени за оценка към хостван Beancount.io регистър. Управляваните потоци предоставят датирани директиви price за поддържани криптовалути, акции, фондове и чуждестранни валути. Продължавате да записвате покупки, продажби и преводи както обикновено.
Изберете вашите източници на цени
- Отворете избора на източник на цени.
- Изберете валутата, в която искате да оценявате активите си.
- Изберете вашите активи от бързите връзки или потърсете по символ, като
BTCилиAAPL. Можете също да поставите извадка от регистъра, за да намерите нейните активи; извадката остава във вашия браузър. - Проверете дали всеки символ на актив съвпада със стоката във вашия регистър. Изборът генерира включвания за изброените двойки. Неизброена двойка може да поддържа извеждане при поискване, но изборът я пропуска, докато поддръжката не бъде потвърдена.
- Копирайте генерираните включвания. Влезте в Beancount.io, за да използвате хоствания си регистър и да инспектирате потоци, които изискват удостоверяване.
Изберете валутата за оценка за вашите счетоводни книги, а не за езика на тази страница. Изборът на валута на котировка не преименува стоките и не променя вашите транзакции.
Включете потоците във вашия хостван регистър
Поставете генерираните редове в main.bean или в друг файл, който вашият регистър вече включва. Всеки ред идентифицира един източник на цени. Например, хостваното включване за Bitcoin в щатски долари е показано закоментирано по-долу, за да остане този пример безопасен за зареждане с upstream Beancount:
; Hosted Beancount.io ledger: remove the leading semicolon to enable this feed.
; include "https://beancount.io/prices/BTC-USD"Премахнете водещия ;, когато добавяте реда към хоствания си регистър. Включванията с URL са разширение на Beancount.io. Обикновените локални включвания все още приемат имена на файлове, както е описано в поддръжка на множество файлове.
Отворете регистъра си както обикновено. Неговият зареждащ механизъм преобразува управляваните потоци в ценови записи само за четене. Той проверява за нови данни, когато регистърът се зареди след петминутния прозорец за опресняване. Опресняването на цените не пренаписва вашите изходни файлове и не създава къмити в регистъра. Управляваните ценови записи не се броят към лимита за записи на вашия регистър.
Разчитане на цени и оценки
Един поток съдържа датирани цени и може да включва метаданни price-source, price-kind, observed-at и provisional. Инспектирайте времето на наблюдение и вида на цената, когато оценявате котировка. Времето за опресняване на зареждащия механизъм не е времето на наблюдение на доставчика.
Това са автоматично опреснявани цени за оценка, а не поточни търговски котировки. Един отчет се нуждае от цена за съответната двойка стоки на или преди неговата дата на оценка. Днешната цена не може да запълни празнина в по-ранен отчет.
Цените правят пазарната оценка възможна в инструменти и отчети, които използват ценови директиви. Изглед на сметка, който показва себестойност, все още ще показва себестойност; свързването на поток не превключва този изглед към пазарна стойност. Вижте ръководството за заявки за разликата между себестойност и пазарна оценка.
Опресняването на цените не променя количествата, разходите за покупка, паричните потоци, таксите или реализираните печалби, записани във вашия регистър. То също не попълва @ цената или {cost} на дадена транзакция. Записвайте ги от самата транзакция. Оценки на имоти, фиктивни примерни стоки и активи без поддържан поток все още се нуждаят от ваши собствени датирани цени.
Заместване на управлявана цена
Напишете своя собствена датирана директива price в редактируем файл на регистъра, когато се нуждаете от конкретна оценка. За същата дата и двойка стоки вашата цена има предимство пред управлявания поток. Това се отнася също и за реципрочната двойка и не зависи от реда на включване.
Ръчната цена не е постоянно заключване: управлявана котировка на по-късна дата все още може да бъде използвана за по-късна оценка. Самите управлявани записи са само за четене. Редактирайте своята директива за цена или премахнете включването, за да спрете да използвате този поток.
Използване на цени с локални инструменти
| Къде зареждате регистъра | Как да предоставите цени |
|---|---|
| Хостван Beancount.io | Използвайте управляваните включвания с URL от избора. |
Съвместима версия на bea CLI | Следвайте инструкциите на CLI за управлявани цени за разрешаване на URL и експортиране на локални ценови файлове. |
| Upstream Beancount или Fava | Зареждайте локални ценови файлове; тези инструменти не извличат сами включвания с URL. |
За поведение на CLI, специфично за версията, използвайте ръководството за управлявани цени на bea. Съвместимите версии предлагат bea price status, bea price refresh и bea price export --output audit. Използвайте bea --offline balance за четения само от кеша или bea --strict-prices check, за да отхвърляте остарели или недостъпни източници. Вижте справката за CLI за подробности и алтернативния локален работен процес с Beanprice.
CLI извлича без идентификационни данни и отказва пренасочвания. Поток, който пренасочва към хоствания вход, не е достъпен за ново извличане от CLI, дори ако сте влезли през браузъра си. Използвайте достъпен поддържан поток или локални датирани цени вместо това. По-старите версии на CLI може да третират всяко включване с URL като несъответстващ файлов шаблон.
Пазете локалните файлове с датирани цени, когато се нуждаете от възпроизводим офлайн отчет. Само къмит в регистъра не улавя ревизията на управлявания поток, използвана от минала оценка. Запазвайте цените, използвани заедно с регистъра и отчета.
За интеграции с услугата за цени се консултирайте със справката за Prices API. Нейните крайни точки са отделни от добавянето на включване към хостван регистър.
Отстраняване на проблеми с липсваща или неочаквана оценка
| Симптом | Какво да проверите |
|---|---|
| Каталогът не се зарежда | Опитайте отново избора. Не отгатвайте URL за включване от неподдържан символ. |
| Избран актив е пропуснат от копираните включвания | Проверете поддръжката за този актив в избраната от вас валута на котировка и съответствието със символа в регистъра. |
| Отварянето на поток пренасочва към вход | Влезте, за да го инспектирате в хоствания работен процес. CLI не изпраща тази сесия и отказва пренасочвания. |
| Цените изглеждат стари | Сравнете времето на наблюдение с датата на отчета. Неуспешно опресняване може да запази предварително валидиран кеширан поток; кешираните данни може да са остарели. |
| Няма налична цена | Без валидирана кеширана цена книгите все още могат да се заредят, но притежанието може да няма пазарна оценка. Предоставете подходяща ръчна цена, ако е необходимо. |
| Ръчната ви цена изглежда пренебрегната | Проверете точната дата и двойка. По-късна управлявана котировка може да се приложи към по-късен отчет. |
| Локален зареждащ механизъм съобщава за несъответстващо включване | Използвайте съвместима версия на bea или заменете включването с URL с локален ценови файл. |
| Стойността на сметката не се е променила | Проверете дали изгледът показва себестойност и дали отчетът има цени, покриващи неговата дата на оценка. |
Вижте справката за синтаксиса на цените за ръчни директиви и работещите примери за регистър за статични, възпроизводими инвестиционни записи.