Použite Live Prices na pridanie automaticky aktualizovaných valuačných cien do hostovanej účtovnej knihy Beancount.io. Spravované kanály poskytujú datované direktívy price pre podporované kryptomeny, akcie, fondy a cudzie meny. Nákupy, predaje a prevody zaznamenávate ako obvykle.
Výber zdrojov cien
- Otvorte výber zdroja cien.
- Zvoľte menu, v ktorej chcete oceňovať svoje aktíva.
- Vyberte svoje aktíva zo skratiek alebo ich vyhľadajte podľa symbolu, ako napríklad
BTCaleboAAPL. Môžete tiež vložiť výňatok z účtovnej knihy na vyhľadanie jeho aktív; výňatok zostáva vo vašom prehliadači. - Skontrolujte, či každý symbol aktíva zodpovedá komodite vo vašej účtovnej knihe. Výber generuje include pre uvedené páry. Neuvedený pár môže podporovať odvodenie na požiadanie, ale výber ho vynechá, kým sa podpora nepotvrdí.
- Skopírujte vygenerované include. Prihláste sa do Beancount.io, aby ste mohli používať svoju hostovanú účtovnú knihu a skontrolovať kanály vyžadujúce overenie.
Zvoľte valutačnú menu pre svoje knihy, nie pre jazyk tejto stránky. Výber kótovanej meny nepomenúva komodity ani nemení vaše transakcie.
Zahrnutie kanálov do hostovanej účtovnej knihy
Vložte vygenerované riadky do main.bean alebo do iného súboru, ktorý vaša účtovná kniha už zahŕňa. Každý riadok identifikuje jeden zdroj cien. Napríklad hostovaný include pre Bitcoin v amerických dolároch je nižšie uvedený ako zakomentovaný, aby tento príklad zostal bezpečný na načítanie s upstream Beancount:
; Hosted Beancount.io ledger: remove the leading semicolon to enable this feed.
; include "https://beancount.io/prices/BTC-USD"Pri pridávaní riadku do svojej hostovanej účtovnej knihy odstráňte úvodný znak ;. URL include sú rozšírením Beancount.io. Bežné lokálne include stále prijímajú názvy súborov, ako je popísané v podpore viacerých súborov.
Otvorte svoju účtovnú knihu ako obvykle. Jej načítavač prekladá spravované kanály na cenové záznamy iba na čítanie. Pri načítaní účtovnej knihy po päťminútovom okne aktualizácie kontroluje nové údaje. Aktualizácia cien neprepisuje vaše zdrojové súbory ani nevytvára commity v účtovnej knihe. Spravované cenové záznamy sa nezapočítavajú do limitu záznamov vašej účtovnej knihy.
Čítanie cien a ocenení
Kanál obsahuje datované ceny a môže zahŕňať metadáta price-source, price-kind, observed-at a provisional. Pri posudzovaní kóty skontrolujte čas pozorovania a druh ceny. Čas aktualizácie načítavača nie je časom pozorovania poskytovateľa.
Ide o automaticky aktualizované valuačné ceny, nie o streamované obchodné kóty. Prehľad potrebuje cenu pre príslušný menový pár k dátumu ocenenia alebo pred ním. Dnešná cena nemôže vyplniť medzeru v skoršom prehľade.
Ceny umožňujú trhové ocenenie v nástrojoch a prehľadoch, ktoré používajú cenové direktívy. Zobrazenie účtu zobrazujúce náklady bude stále zobrazovať náklady; pripojenie kanála toto zobrazenie neprepne na trhovú hodnotu. Rozdiel medzi nákladovým a trhovým ocenením nájdete v sprievodcovi dotazmi.
Aktualizácia ceny nemení množstvá, nákupné náklady, peňažné toky, poplatky ani realizované zisky zaznamenané vo vašej účtovnej knihe. Taktiež nevyplňuje @ cenu ani {cost} transakcie. Tie zaznamenajte zo samotnej transakcie. Ocenenia nehnuteľností, fiktívne príkladové komodity a aktíva bez podporovaného kanála stále potrebujú vaše vlastné datované ceny.
Prepis spravovanej ceny
Keď potrebujete konkrétne ocenenie, napíšte vlastnú datovanú direktívu price do upraviteľného súboru účtovnej knihy. Pre rovnaký dátum a menový pár má vaša cena prednosť pred spravovaným kanálom. Platí to aj pre recipročný pár a nezávisí to od poradia include.
Manuálna cena nie je trvalý zámok: spravovaná kóta k neskoršiemu dátumu sa stále môže použiť na neskoršie ocenenie. Samotné spravované záznamy sú iba na čítanie. Upravte svoju vlastnú cenovú direktívu alebo odstráňte include, aby ste prestali daný kanál používať.
Používanie cien s lokálnymi nástrojmi
| Kde načítate účtovnú knihu | Ako dodať ceny |
|---|---|
| Hostovaný Beancount.io | Použite spravované URL include z výberu. |
Kompatibilná verzia CLI bea | Postupujte podľa pokynov CLI pre spravované ceny týkajúcich sa rozlíšenia URL a exportu lokálnych cenových súborov. |
| Upstream Beancount alebo Fava | Načítajte lokálne cenové súbory; tieto nástroje samy nenačítavajú URL include. |
Pre správanie CLI špecifické pre verziu použite sprievodcu spravovanými cenami bea. Kompatibilné verzie ponúkajú bea price status, bea price refresh a bea price export --output audit. Pre čítanie iba z vyrovnávacej pamäte použite bea --offline balance alebo bea --strict-prices check na odmietnutie zastaraných či nedostupných zdrojov. Podrobnosti a alternatívny lokálny pracovný postup Beanprice nájdete v referencii CLI.
CLI načítava bez poverení a odmieta presmerovania. Kanál, ktorý presmerúva na hostované prihlásenie, nie je dostupný pre nové načítanie CLI, aj keď ste prihlásený cez prehliadač. Použite namiesto toho dostupný podporovaný kanál alebo lokálne datované ceny. Staršie verzie CLI môžu akýkoľvek URL include považovať za nezhodný glob súborov.
Lokálne datované cenové súbory si ponechajte, keď potrebujete reprodukovateľný offline prehľad. Samotný commit účtovnej knihy nezachytáva revíziu spravovaného kanála použitú pri minulom ocenení. Ceny použité spolu s účtovnou knihou a prehľadom uchovajte.
Pre integrácie s cenovou službou sa obráťte na referenciu Prices API. Jej koncové body sú oddelené od pridania include do hostovanej účtovnej knihy.
Riešenie chýbajúceho alebo neočakávaného ocenenia
| Príznak | Čo skontrolovať |
|---|---|
| Katalóg sa nenačíta | Skúste výber znova. Neodhadujte URL include z nepodporovaného symbolu. |
| Vybrané aktívum je vynechané zo skopírovaných include | Skontrolujte podporu daného aktíva vo zvolenej kótovanej mene a zhodu so symbolom v účtovnej knihe. |
| Otvorenie kanála presmeruje na prihlásenie | Prihláste sa, aby ste ho mohli skontrolovať v hostovanom pracovnom postupe. CLI túto reláciu neposiela a odmieta presmerovania. |
| Ceny vyzerajú staré | Porovnajte čas pozorovania s dátumom prehľadu. Neúspešná aktualizácia môže ponechať predtým overený kanál z vyrovnávacej pamäte; údaje z vyrovnávacej pamäte môžu byť zastarané. |
| Nie je dostupná žiadna cena | Bez overenej ceny z vyrovnávacej pamäte sa knihy stále môžu načítať, ale držbe môže chýbať trhové ocenenie. V prípade potreby dodajte vhodnú manuálnu cenu. |
| Vaša manuálna cena sa zdá byť ignorovaná | Skontrolujte presný dátum a pár. Neskoršia spravovaná kóta sa môže vzťahovať na neskorší prehľad. |
| Lokálny načítavač hlási nezhodný include | Použite kompatibilnú verziu bea alebo nahraďte URL include lokálnym cenovým súborom. |
| Hodnota účtu sa nezmenila | Skontrolujte, či zobrazenie zobrazuje náklady a či prehľad obsahuje ceny pokrývajúce jeho dátum ocenenia. |
Manuálne direktívy nájdete v referencii syntaxe cien a statické, reprodukovateľné záznamy o investíciách v príkladoch účtovných kníh.