Configurar precios automáticos en Beancount

Usa Live Prices para añadir precios de valoración actualizados automáticamente a un libro Beancount.io alojado. Las fuentes gestionadas proporcionan directivas price con fecha para criptomonedas, acciones, fondos y divisas compatibles. Tú sigues registrando compras, ventas y transferencias como de costumbre.

Elige tus fuentes de precios​

1. Abre el selector de fuentes de precios.
2. Elige la moneda en la que quieres valorar tus activos.
3. Selecciona tus activos desde los atajos o busca por símbolo, como BTC o AAPL. También puedes pegar un fragmento del libro para encontrar sus activos; el fragmento permanece en tu navegador.
4. Comprueba que cada símbolo de activo coincida con el commodity en tu libro. El selector genera includes para los pares listados. Un par no listado puede admitir derivación bajo demanda, pero el selector lo omite hasta que se confirme la compatibilidad.
5. Copia los includes generados. Inicia sesión en Beancount.io para usar tu libro alojado e inspeccionar las fuentes que requieren autenticación.

Elige la moneda de valoración para tus libros, no para el idioma de esta página. Seleccionar una moneda de cotización no renombra los commodities ni cambia tus transacciones.

Incluye las fuentes en tu libro alojado​

Pega las líneas generadas en main.bean, o en otro archivo que tu libro ya incluya. Cada línea identifica una fuente de precios. Por ejemplo, el include alojado para Bitcoin en dólares estadounidenses se muestra comentado a continuación para que este ejemplo siga siendo seguro de cargar con Beancount upstream:

; Hosted Beancount.io ledger: remove the leading semicolon to enable this feed.
; include "https://beancount.io/prices/BTC-USD"

Elimina el ; inicial al añadir la línea a tu libro alojado. Los includes de URL son una extensión de Beancount.io. Los includes locales ordinarios siguen aceptando nombres de archivo, como se describe en soporte multifichero.

Abre tu libro como de costumbre. Su cargador resuelve las fuentes gestionadas en entradas de precios de solo lectura. Comprueba si hay datos nuevos cuando el libro se carga tras la ventana de actualización de cinco minutos. Actualizar los precios no reescribe tus archivos de origen ni crea commits en el libro. Las entradas de precios gestionadas no cuentan para el límite de entradas de tu libro.

Leer precios y valoraciones​

Una fuente contiene precios con fecha y puede incluir metadatos price-source, price-kind, observed-at y provisional. Inspecciona el momento de observación y el tipo de precio al juzgar una cotización. La hora de actualización del cargador no es la hora de observación del proveedor.

Estos son precios de valoración actualizados automáticamente, no cotizaciones bursátiles en streaming. Un informe necesita un precio para el par de commodities correspondiente en la fecha de valoración o antes. El precio de hoy no puede cubrir un hueco en un informe anterior.

Los precios hacen posible la valoración de mercado en las herramientas e informes que usan directivas de precios. Una vista de cuenta que muestra el coste seguirá mostrando el coste; conectar una fuente no cambia esa vista a valor de mercado. Consulta la guía de consultas para la distinción entre coste y valoración de mercado.

Una actualización de precios no cambia las cantidades, los costes de compra, los flujos de efectivo, las comisiones ni las ganancias realizadas registradas en tu libro. Tampoco rellena el precio @ ni el {cost} de una transacción. Registra esos datos desde la propia transacción. Las tasaciones de propiedades, los commodities ficticios de ejemplo y los activos sin una fuente compatible siguen necesitando tus propios precios con fecha.

Anular un precio gestionado​

Escribe tu propia directiva price con fecha en un archivo de libro editable cuando necesites una valoración concreta. Para la misma fecha y par de commodities, tu precio tiene prioridad sobre la fuente gestionada. Esto también se aplica al par recíproco y no depende del orden de los includes.

Un precio manual no es un bloqueo permanente: una cotización gestionada en una fecha posterior aún puede usarse para una valoración posterior. Las entradas gestionadas en sí son de solo lectura. Edita tu propia directiva de precio, o elimina el include para dejar de usar esa fuente.

Usar precios con herramientas locales​

Para el comportamiento de la CLI específico de cada versión, usa la guía de precios gestionados de bea. Las versiones compatibles ofrecen bea price status, bea price refresh y bea price export --output audit. Usa bea --offline balance para lecturas solo desde caché o bea --strict-prices check para rechazar fuentes obsoletas o no disponibles. Consulta la referencia de la CLI para más detalles y el flujo de trabajo alternativo con Beanprice local.

La CLI obtiene datos sin credenciales y rechaza las redirecciones. Una fuente que redirige al inicio de sesión alojado no está disponible para una obtención nueva de la CLI, aunque hayas iniciado sesión a través de tu navegador. Usa una fuente compatible accesible o precios locales con fecha. Las versiones antiguas de la CLI pueden tratar cualquier include de URL como un glob de archivo no coincidente.

Conserva los archivos de precios locales con fecha cuando necesites un informe offline reproducible. Un commit del libro por sí solo no captura la revisión de la fuente gestionada usada en una valoración pasada. Conserva los precios usados junto con el libro y el informe.

Para integraciones con el servicio de precios, consulta la referencia de la API de precios. Sus endpoints son independientes de añadir un include a un libro alojado.

Solucionar una valoración ausente o inesperada​

Consulta la referencia de sintaxis de precios para las directivas manuales y los ejemplos de libros funcionales para registros de inversión estáticos y reproducibles.