Gebruik Live Prices om automatisch vernieuwde waarderingsprijzen toe te voegen aan een gehost Beancount.io-grootboek. Beheerde feeds leveren gedateerde price-richtlijnen voor ondersteunde crypto, aandelen, fondsen en buitenlandse valuta's. Je blijft aankopen, verkopen en overboekingen gewoon vastleggen.
Kies je prijsbronnen
- Open de prijsbron-kiezer.
- Kies de valuta waarin je je activa wilt waarderen.
- Selecteer je activa via de snelkoppelingen of zoek op symbool, zoals
BTCofAAPL. Je kunt ook een fragment uit je grootboek plakken om de activa daarin te vinden; het fragment blijft in je browser. - Controleer of elk activasymbool overeenkomt met het goed in je grootboek. De kiezer genereert includes voor vermelde paren. Een niet-vermeld paar kan on-demand-afleiding ondersteunen, maar de kiezer laat het weg tot de ondersteuning is bevestigd.
- Kopieer de gegenereerde includes. Meld je aan bij Beancount.io om je gehoste grootboek te gebruiken en feeds te bekijken die authenticatie vereisen.
Kies de waarderingsvaluta voor je boekhouding, niet voor de taal van deze pagina. Het selecteren van een quote-valuta hernoemt geen goederen en wijzigt je transacties niet.
Neem de feeds op in je gehoste grootboek
Plak de gegenereerde regels in main.bean, of in een ander bestand dat je grootboek al includeert. Elke regel verwijst naar één prijsbron. De gehoste include voor Bitcoin in Amerikaanse dollars staat hieronder bijvoorbeeld uitgecommentarieerd, zodat dit voorbeeld veilig te laden blijft met upstream Beancount:
; Hosted Beancount.io ledger: remove the leading semicolon to enable this feed.
; include "https://beancount.io/prices/BTC-USD"Verwijder de leidende ; wanneer je de regel aan je gehoste grootboek toevoegt. URL-includes zijn een Beancount.io-uitbreiding. Gewone lokale includes nemen nog steeds bestandsnamen, zoals beschreven in ondersteuning voor meerdere bestanden.
Open je grootboek zoals gewoonlijk. De loader zet beheerde feeds om in alleen-lezen prijsregels. Hij controleert op nieuwe gegevens wanneer het grootboek wordt geladen na het verversingsvenster van vijf minuten. Het verversen van prijzen herschrijft je bronbestanden niet en maakt geen grootboekcommits aan. Beheerde prijsregels tellen niet mee voor de regellimiet van je grootboek.
Prijzen en waarderingen lezen
Een feed bevat gedateerde prijzen en kan metadata bevatten zoals price-source, price-kind, observed-at en provisional. Bekijk het observatietijdstip en het prijstype bij het beoordelen van een quote. Het verversingstijdstip van de loader is niet het observatietijdstip van de provider.
Dit zijn automatisch vernieuwde waarderingsprijzen, geen streaming handelsquotes. Een rapport heeft een prijs nodig voor het relevante goederenpaar op of vóór zijn waarderingsdatum. De prijs van vandaag kan geen gat in een eerder rapport opvullen.
Prijzen maken marktwaardering mogelijk in tools en rapporten die prijsrichtlijnen gebruiken. Een accountweergave met kostprijs toont nog steeds de kostprijs; het verbinden van een feed schakelt die weergave niet om naar marktwaarde. Zie de querygids voor het onderscheid tussen kostprijs en marktwaardering.
Een prijsverversing wijzigt geen hoeveelheden, aankoopkosten, kasstromen, kosten of gerealiseerde winsten die in je grootboek zijn vastgelegd. Het vult ook niet de @-prijs of {cost} van een transactie in. Leg die vast vanuit de transactie zelf. Vastgoedtaxaties, fictieve voorbeeldgoederen en activa zonder ondersteunde feed hebben nog steeds je eigen gedateerde prijzen nodig.
Een beheerde prijs overschrijven
Schrijf je eigen gedateerde price-richtlijn in een bewerkbaar grootboekbestand wanneer je een specifieke waardering nodig hebt. Voor dezelfde datum en hetzelfde goederenpaar krijgt jouw prijs voorrang op de beheerde feed. Dit geldt ook voor het omgekeerde paar en is niet afhankelijk van de include-volgorde.
Een handmatige prijs is geen permanente vergrendeling: een beheerde quote op een latere datum kan nog steeds worden gebruikt voor een latere waardering. Beheerde regels zelf zijn alleen-lezen. Bewerk je eigen prijsrichtlijn, of verwijder de include om die feed niet meer te gebruiken.
Prijzen gebruiken met lokale tools
| Waar je het grootboek laadt | Hoe je prijzen aanlevert |
|---|---|
| Gehost Beancount.io | Gebruik de beheerde URL-includes uit de kiezer. |
Een compatibele bea CLI-versie | Volg de beheerde-prijsinstructies van de CLI voor URL-resolutie en het exporteren van lokale prijsbestanden. |
| Upstream Beancount of Fava | Laad lokale prijsbestanden; deze tools halen URL-includes niet zelf op. |
Gebruik voor versiespecifiek CLI-gedrag de bea managed-price gids. Compatibele versies bieden bea price status, bea price refresh en bea price export --output audit. Gebruik bea --offline balance voor alleen-cache-lezingen of bea --strict-prices check om verouderde of niet-beschikbare bronnen te weigeren. Zie de CLI-referentie voor details en de alternatieve lokale Beanprice-workflow.
De CLI haalt op zonder inloggegevens en weigert redirects. Een feed die doorverwijst naar de gehoste login is niet beschikbaar voor een verse CLI-fetch, zelfs niet als je via je browser bent aangemeld. Gebruik een bereikbare ondersteunde feed of lokale gedateerde prijzen. Oudere CLI-versies kunnen een URL-include aanzien voor een niet-overeenkomende bestandsglob.
Bewaar lokale gedateerde prijsbestanden wanneer je een reproduceerbaar offline rapport nodig hebt. Een grootboekcommit alleen legt niet de beheerde feed-revisie vast die bij een eerdere waardering is gebruikt. Bewaar de gebruikte prijzen naast het grootboek en het rapport.
Raadpleeg voor integraties met de prijsservice de Prices API-referentie. De endpoints daarvan staan los van het toevoegen van een include aan een gehost grootboek.
Een ontbrekende of onverwachte waardering oplossen
| Symptoom | Wat je moet controleren |
|---|---|
| De catalogus laadt niet | Probeer de kiezer opnieuw. Raad geen include-URL van een niet-ondersteund symbool. |
| Een geselecteerd actief wordt weggelaten uit de gekopieerde includes | Controleer de ondersteuning voor dat actief in je gekozen quote-valuta en laat het symbool overeenkomen met dat van het grootboek. |
| Het openen van een feed verwijst door naar login | Meld je aan om het in de gehoste workflow te bekijken. De CLI stuurt die sessie niet mee en weigert redirects. |
| Prijzen zien er oud uit | Vergelijk het observatietijdstip met de rapportdatum. Een mislukte verversing kan een eerder gevalideerde gecachte feed behouden; gecachte gegevens kunnen verouderd zijn. |
| Er is geen prijs beschikbaar | Zonder gevalideerde gecachte prijs kan de boekhouding nog steeds laden, maar de positie kan een marktwaardering missen. Geef indien nodig een passende handmatige prijs op. |
| Je handmatige prijs lijkt genegeerd te worden | Controleer de exacte datum en het paar. Een latere beheerde quote kan van toepassing zijn op een later rapport. |
| Een lokale loader meldt een niet-overeenkomende include | Gebruik een compatibele bea-versie of vervang de URL-include door een lokaal prijsbestand. |
| De accountwaarde is niet veranderd | Controleer of de weergave de kostprijs toont en of het rapport prijzen bevat die zijn waarderingsdatum dekken. |
Zie de prijssyntaxis-referentie voor handmatige richtlijnen en de werkende grootboekvoorbeelden voor statische, reproduceerbare beleggingsadministratie.