Roles de flujo de caja

Agrega metadatos cash-flow-role a la directiva open de una cuenta para declarar cómo el informe de flujo de caja clasifica esa cuenta. Una clave, cuatro valores. Las cuentas sin los metadatos mantienen las heurísticas predeterminadas.

2000-01-01 open Assets:US:Brokerage
  cash-flow-role: "investing"
 
2000-01-01 open Assets:US:Marcus:Savings
  cash-flow-role: "cash"

Clave y valores​

La coincidencia distingue entre mayúsculas y minúsculas y es exacta. El valor debe ser una cadena entre comillas. Otras claves de metadatos en la misma directiva son ignoradas por el informe, y esta clave es ignorada por todas las demás herramientas.

Qué hace cada valor​

Un rol declarado responde dos preguntas a la vez: si la cuenta es parte del efectivo y equivalentes, y a qué sección de actividad pertenece en caso contrario.

• "cash" — la cuenta se une al conjunto de efectivo y equivalentes. Las cuentas de efectivo nunca aparecen como partidas de actividad. La línea final del estado, el cambio neto en efectivo y equivalentes, es igual a la suma de sus cambios en el período. Las transferencias entre dos cuentas de efectivo se cancelan. Úsalo para cuentas que la heurística de nombres no detecta, como un fondo del mercado monetario o una billetera de stablecoin.
• "operating", "investing", "financing" — la cuenta no es efectivo, y su cambio en el período aparece como una línea bajo esa sección de actividad. Declarar uno de estos en una cuenta que la heurística de nombres trataría como efectivo, como Assets:US:Bank:CD, tanto la elimina del conjunto de efectivo como la archiva bajo la sección declarada.

Las declaraciones se confían sobre las convenciones contables. Una cuenta de Equity declarada "operating" se honra textualmente.

Precedencia​

Gana el mayor:

1. Metadatos cash-flow-role en la directiva open de la cuenta.
2. Las heurísticas predeterminadas integradas a continuación.

Clasificaciones predeterminadas​

Una cuenta sin rol declarado se clasifica por su raíz, con una verificación de nombre decidiendo la membresía de efectivo:

Las cuentas de activos cuyos nombres contienen Cash, Checking, Savings o Bank se tratan como efectivo y equivalentes por predeterminado. Un rol declarado anula la verificación de nombre en ambas direcciones.

Valores inválidos​

Un valor no reconocido se trata como ausente. Un error tipográfico como "invsting", un valor que no es cadena o mayúsculas incorrectas recurren a la heurística predeterminada, y el informe marca la cuenta en el panel de estado con una nota de valor desconocido. Nada falla al renderizar, y nada se acepta silenciosamente.

Cambiar una clasificación​

Las clasificaciones no dependen de la fecha. Un estado para cualquier período usa las declaraciones tal como están hoy. Para cambiar una, edita la directiva open; el control de versiones del libro mayor registra qué cambió y cuándo.

Dónde se aplican las declaraciones​

Un resolvedor compartido produce el rol final para cada cuenta, y cada consumidor lee de él:

• El informe de flujo de caja: secciones de actividad, el conjunto de efectivo y equivalentes, y la conciliación de la línea final.
• Exportaciones CSV, Markdown y de impresión: los mismos números. La divulgación de clasificación inferida aparece solo para filas aún resueltas por la heurística.
• El diagrama general de flujo de caja: "cash" excluye la cuenta de los nodos de flujo, y los roles de actividad declarados se honran para cuentas que no son de Income. Income permanece como lado de origen y Equity permanece excluido del diagrama; las declaraciones nunca reasignan esos dos.
• El panel de estado de cuenta: una cuenta declarada ya no aparece como un activo no clasificado.

Portabilidad​

Los metadatos en directivas open son sintaxis central de Beancount. bean-check, Fava y cada herramienta v2/v3 los analizan e ignoran la clave desconocida, por lo que el libro mayor permanece completamente utilizable fuera de Beancount.io. Consulta Sintaxis de Beancount para el formato general de metadatos.