Використовуйте 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. Звичайні локальні включення, як і раніше, приймають імена файлів, як описано в multi-file support.
Відкрийте свій журнал як завжди. Його завантажувач перетворює керовані джерела на записи цін лише для читання. Він перевіряє наявність нових даних, коли журнал завантажується після п'ятихвилинного вікна оновлення. Оновлення цін не переписує ваші вихідні файли й не створює комітів журналу. Керовані записи цін не зараховуються до ліміту записів вашого журналу.
Читання цін та оцінок
Джерело містить датовані ціни й може включати метадані price-source, price-kind, observed-at і provisional. Перевіряйте час спостереження та вид ціни, коли оцінюєте котирування. Час оновлення завантажувача — це не час спостереження постачальника.
Це автоматично оновлювані ціни оцінки, а не потокові торгові котирування. Звіту потрібна ціна для відповідної пари товарів на дату оцінки або раніше. Сьогоднішня ціна не може заповнити прогалину в попередньому звіті.
Ціни уможливлюють ринкову оцінку в інструментах і звітах, які використовують директиви цін. Подання рахунку, що показує собівартість, усе одно показуватиме собівартість; підключення джерела не перемикає це подання на ринкову вартість. Дивіться посібник із запитів щодо різниці між собівартістю та ринковою оцінкою.
Оновлення цін не змінює кількості, витрати на придбання, грошові потоки, комісії чи реалізовані прибутки, записані у вашому журналі. Воно також не заповнює @ ціну транзакції чи {cost}. Записуйте їх із самої транзакції. Оцінки нерухомості, вигадані прикладні товари та активи без підтримуваного джерела все ще потребують ваших власних датованих цін.
Перевизначення керованої ціни
Напишіть власну датовану директиву price у редагованому файлі журналу, коли вам потрібна певна оцінка. Для тієї самої дати й пари товарів ваша ціна має перевагу над керованим джерелом. Це також стосується зворотної пари й не залежить від порядку включення.
Ручна ціна не є постійним блокуванням: кероване котирування на пізнішу дату все ще може використовуватися для пізнішої оцінки. Самі керовані записи доступні лише для читання. Відредагуйте власну директиву ціни або видаліть включення, щоб припинити використання цього джерела.
Використання цін із локальними інструментами
| Де ви завантажуєте журнал | Як надати ціни |
|---|---|
| Розміщений Beancount.io | Використовуйте керовані включення URL із вибору. |
Сумісна версія CLI bea | Дотримуйтеся інструкцій CLI щодо керованих цін для розв'язання URL та експорту локальних файлів цін. |
| Upstream Beancount або Fava | Завантажуйте локальні файли цін; ці інструменти самі не отримують включення URL. |
Щодо поведінки CLI, залежної від версії, скористайтеся посібником bea managed-price. Сумісні версії пропонують 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 локальним файлом цін. |
| Вартість рахунку не змінилася | Перевірте, чи подання показує собівартість і чи звіт має ціни, що охоплюють його дату оцінки. |
Дивіться довідник синтаксису цін щодо ручних директив і робочі приклади журналу щодо статичних, відтворюваних записів інвестицій.