# Desintoxica las finanzas de tu pequeña empresa — la manera Beancount

_Convierte un libro mayor desordenado en un negocio tranquilo y seguro con el efectivo en 30 días—usando contabilidad de texto plano._

---

## TL;DR

- **Separa, simplifica y asegura** tus libros con un plan de cuentas ajustado, importaciones consistentes y verificaciones de balance automatizadas.
- **Muestra lo que importa**—COGS, gastos generales, reserva de efectivo—a través de informes rápidos de `bean-query`.
- **Corta el ruido** (suscripciones no utilizadas, herramientas duplicadas) y **codifica buenos hábitos** (conciliación semanal, cierre mensual, recibos adjuntos).
- **Haz que la temporada fiscal sea aburrida** manteniendo extractos, recibos y balances verificables en un lugar.

---

## ¿Por qué una "Desintoxicación"?

El desorden financiero en una pequeña empresa no es solo desordenado—es caro. Oculta gastos desperdiciados, oscurece tu verdadera rentabilidad y convierte la temporada fiscal en una búsqueda frenética del tesoro. Una desintoxicación financiera es un reinicio enfocado de 30 días: identificas qué mueve (y filtra) dinero, eliminas la complejidad y luego institucionalizas rutinas simples y repetibles para mantenerlo limpio.

Beancount es la herramienta perfecta para esto porque es **transparente, scriptable y verificable**. A diferencia del software de caja negra, un libro mayor de texto plano significa que cada número es explicable. Cada verificación y balance puede ser automatizado con directivas y consultas, creando un sistema de auto-auditoría que fuerza la claridad. Esta guía te llevará a través de un plan de cuatro semanas para lograr exactamente eso.

---

## Semana 0 — Establece tu línea base

Antes de poder limpiar, necesitas una base sólida. Esta semana se trata de definir la estructura de tu mundo financiero.

### Crea un plan de cuentas ajustado

Tu plan de cuentas es el esqueleto de tu sistema financiero. El objetivo aquí es el minimalismo. No crees una cuenta para cada posible gasto que _podrías_ tener. Comienza con lo esencial que usas hoy; siempre puedes agregar más después. Un plan de cuentas desordenado fomenta la categorización incorrecta y hace que el análisis de alto nivel sea difícil.

Aquí tienes un punto de partida simple y efectivo:

```beancount
; Entidades principales
2025-01-01 open Assets:Bank:Checking           USD
2025-01-01 open Assets:Bank:Savings            USD
2025-01-01 open Liabilities:CreditCard:Business USD
2025-01-01 open Income:Sales
2025-01-01 open Expenses:COGS
2025-01-01 open Expenses:Overhead:Rent
2025-01-01 open Expenses:Overhead:Utilities
2025-01-01 open Expenses:SaaS
2025-01-01 open Equity:Opening-Balances
```

### Asegura balances que puedas verificar

La característica más poderosa en la contabilidad de texto plano es la capacidad de afirmar la realidad. Una directiva `balance` le dice a Beancount: "En esta fecha, esta cuenta tenía exactamente esta cantidad de dinero." Si no es así, Beancount arrojará un error. Esta es tu red de seguridad principal.

Al comenzar, usa `pad` en combinación con `balance` para inicializar tus cuentas desde un extracto bancario. La directiva `pad` crea una transacción que fuerza la cuenta al balance inicial correcto, registrando la diferencia en una cuenta de patrimonio.

```beancount
; Inicializar desde extractos
2024-12-31 pad     Assets:Bank:Checking      Equity:Opening-Balances
2025-01-01 balance Assets:Bank:Checking      12345.67 USD
```

**Una palabra de precaución:** Usa `pad` con moderación. Es para comenzar limpiamente, no para cubrir errores recurrentes de conciliación.

---

## Semana 1 — Separa y simplifica los flujos

Con una estructura en su lugar, es hora de aclarar cómo se mueve el dinero a través de tu negocio.

### Mantén Negocio ≠ Personal

Esta es la regla de oro de las finanzas de pequeña empresa. Mezclar fondos es una receta para la confusión y dolores de cabeza fiscales.

- Mantén una cuenta bancaria dedicada al negocio y una tarjeta de crédito comercial.
- Refleja esta separación en tu libro mayor: `Assets:Bank:Business:Checking`, `Liabilities:CreditCard:Business`.
- Si te pagas a ti mismo, regístralo como una distribución a `Equity:Owner-Draws`. Nunca categorices gastos personales directamente desde cuentas comerciales.

### Estandariza las categorías de proveedores

¿Pagas por AWS, Google Cloud y Vercel? No crees tres cuentas separadas. Mapéalos todos a una sola categoría lógica como `Expenses:Cloud`. Evita crear micro-cuentas que realmente no analizarás. El objetivo es ver patrones, no rastrear cada proveedor individual con su propia cuenta.

---

## Semana 2 — Automatiza entradas y recibos

La entrada manual de datos es lenta, propensa a errores e insostenible. Esta semana se trata de construir una máquina para alimentar tu libro mayor de manera confiable.

### Construye un camino de importación sin drama

El marco de importación de Beancount te permite enseñarle cómo leer archivos CSV u OFX de tu banco y generar automáticamente transacciones. Invierte el tiempo para configurar esto una vez, y ahorrarás cientos de horas a largo plazo. Mantén tus reglas de importación bajo control de versiones (como Git) para que tu sistema sea repetible y respaldado.

- Comienza con la guía oficial de Beancount **Importing External Data**.
- Para un flujo de trabajo más interactivo, considera una herramienta como **beancount-import**, que proporciona una interfaz web para coincidencias semi-automáticas.
- Muchos usuarios confían en los marcos integrados `ingest` o los más nuevos `beangulp` para construir sus importadores personalizados. Elige uno y mantente con él para consistencia.

### Adjunta documentos donde pertenecen

Una transacción sin recibo es una afirmación sin sustento. Beancount y su interfaz web, Fava, hacen trivial vincular documentos fuente a entradas, creando un rastro de auditoría inquebrantable.

Tienes dos excelentes opciones:

1.  **Carpeta de documentos + Directiva:** Almacena todos tus recibos y extractos en una carpeta dedicada. Luego, vincula un archivo a una transacción usando la directiva `document`.
2.  **Arrastrar y soltar en Fava:** Simplemente arrastra un archivo PDF o de imagen sobre una transacción en la interfaz de Fava. Fava automáticamente almacena el archivo e inserta la directiva `document` correcta en tu archivo de libro mayor.



```beancount
; En tu archivo principal del libro mayor, dile a Fava dónde viven tus documentos
option "documents" "/home/acme/docs"

; Vincula un recibo a una entrada de transacción específica
2025-08-07 * "Figma" "Monthly Subscription"
  Assets:CreditCard:Business    -12.00 USD
  Expenses:SaaS                 12.00 USD
    document: "receipts/figma-2025-08-07.pdf"
```

---

## Semana 3 — Ve la verdad (Consultas rápidas que reutilizarás)

Tu libro mayor ahora está limpio y alimentado con datos. Es hora de hacerle preguntas importantes. Inicia la herramienta de línea de comandos `bean-query` para obtener respuestas instantáneas.

### 1\) ¿Dónde está mi efectivo?

Obtén una instantánea rápida de tus activos líquidos.

```bash
bean-query business.beancount 'BALANCES FROM year = 2025 AND (account ~ "Assets:Bank" OR account ~ "Liabilities:CreditCard")'
```

Esto te da una vista inmediata y en tiempo real de tu posición de efectivo sin iniciar sesión en múltiples portales bancarios.

### 2\) ¿En qué estoy gastando en gastos generales vs. COGS?

Entiende a dónde va tu dinero _realmente_. ¿Estás gastando más en gastos generales no esenciales o en los costos directamente vinculados a entregar tu producto (Costo de Bienes Vendidos)?

```sql
SELECT
  account,
  units(sum(position))
WHERE
  account ~ "^Expenses:(Overhead|COGS)" AND year = 2025
GROUP BY
  account
ORDER BY
  account
```

Esta consulta separa tus costos operacionales principales de tu carga administrativa, una perspectiva crítica para la rentabilidad.

### 3\) ¿Qué suscripciones parecen "zombis"?

Encuentra gastos recurrentes y pequeños que a menudo vuelan bajo el radar. Estas suscripciones "zombi" pueden drenar tu flujo de efectivo.

```sql
SELECT
  payee,
  COUNT(*) AS num_transactions,
  SUM(number) AS total_spent
WHERE
  account ~ "^Expenses:SaaS" AND date >= '2025-01-01'
GROUP BY
  payee
ORDER BY
  num_transactions DESC,
  total_spent DESC
```

Esta consulta revela instantáneamente proveedores a los que pagas frecuentemente. Si ves uno que no reconoces o ya no necesitas, es hora de cancelar.

---

## Semana 4 — Ordena y asegura el sistema

La semana final se trata de construir los hábitos y barreras que mantienen tus finanzas limpias para siempre.

### Pon presupuestos simples en su lugar

Fava puede leer directivas `budget` de tu libro mayor y mostrar barras de progreso útiles en sus informes, mostrándote si estás en el camino correcto. Esto proporciona un recordatorio suave y constante de tus objetivos de gasto.

```beancount
; Limita el gasto en SaaS a $100 por mes
2025-01-01 custom "budget" Expenses:SaaS "monthly" 100.00 USD
```

Establécelos para categorías de gastos variables clave como software, publicidad o contratistas para notar desviaciones antes de que se conviertan en un problema.

### Cierra el mes, cada vez

Establece un proceso de cierre mensual simple e innegociable:

1.  **Concilia:** Para cada cuenta bancaria y de tarjeta de crédito, agrega una aserción `balance` que coincida con el número final en tu extracto mensual.
2.  **Adjunta:** Adjunta el extracto PDF en sí a la entrada `balance` usando la directiva `document`.
3.  **Reporta:** Ejecuta tus tres consultas guardadas (efectivo, gastos generales/COGS, suscripciones) y pega las salidas en una breve nota de revisión mensual.

La **aserción de balance** es un activador automático. Si tu libro mayor no coincide con el extracto bancario, Beancount arrojará un error, diciéndote exactamente dónde buscar la discrepancia.

---

## Haz que la temporada fiscal sea aburrida (de la manera buena)

Siguiendo este sistema, transformas la preparación fiscal de una crisis en un simple ejercicio de reporte.

- **Los recibos están adjuntos a las transacciones**, así que no hay búsqueda frenética. En Fava, estás a un clic del documento fuente para cualquier gasto.
- **Los elementos relevantes para impuestos pueden ser etiquetados** (ej., `#tax-deductible`), permitiéndote extraer un informe limpio con `bean-query` para tu contador.
- **Los balances de fin de año están asegurados y verificados** con aserciones `balance`, dándote a ti y a tu preparador confianza en los números.

---

## Una lista de verificación de 30 días (Imprime esto)

- **Día 1–3**
  - [ ] Crea un plan de cuentas mínimo.
  - [ ] Agrega `pad` + `balance` para cada banco/tarjeta usando los últimos extractos.
- **Día 4–10**
  - [ ] Configura un pipeline de importación y confirma tus reglas en control de versiones.
  - [ ] Rellena 90 días de transacciones; ejecuta una primera instantánea `BALANCES`.
- **Día 11–15**
  - [ ] Estandariza proveedores a sus respectivas cuentas (SaaS, Cloud, Envío, etc.).
  - [ ] Adjunta PDFs de extractos para los períodos conciliados; confirma que aparecen en Fava.
- **Día 16–20**
  - [ ] Ejecuta la consulta de gastos generales vs. COGS; corrige cualquier elemento mal categorizado.
  - [ ] Ejecuta la consulta de frecuencia de suscripciones; cancela o consolida servicios no utilizados.
- **Día 21–25**
  - [ ] Agrega uno o dos límites de presupuesto para gastos variables clave a través de `custom "budget"`.
  - [ ] Guarda tus tres comandos `bean-query` más importantes en un script para fácil reutilización.
- **Día 26–30**
  - [ ] Concilia todas las cuentas con aserciones `balance` de fin de mes.
  - [ ] Escribe una breve nota de "cierre mensual" resumiendo números clave y vinculando a documentos.

---

## Fragmentos comunes que reutilizarás

**Una entrada de gasto limpia**

```beancount
2025-08-05 * "Figma" "Pro plan"
  Expenses:SaaS               12.00 USD
  Assets:Bank:Checking       -12.00 USD
```

**Aserción de balance desde un extracto**

```beancount
2025-09-01 balance Assets:Bank:Checking  8423.17 USD
```

**Barrera presupuestaria para alquiler**

```beancount
2025-01-01 custom "budget" Expenses:Overhead:Rent "monthly" 2500.00 USD
```

---

## Manténlo simple, manténlo con scripts

La filosofía de una desintoxicación financiera impulsada por Beancount es simple:

- **Programa lo que repites:** Automatiza importaciones y reportes.
- **Deja que las aserciones fallen ruidosamente:** Son tus rieles de seguridad, no una inconveniencia.
- **Prefiere cuentas menos numerosas y más claras** sobre categorización perfecta y granular.

Adopta estos hábitos, y tu negocio funcionará con bucles de retroalimentación ajustados: visibilidad de efectivo diariamente, desviación de gastos visible semanalmente, y un fin de año verdaderamente aburrido. Esa es la claridad y control que esta desintoxicación está diseñada para entregar.

---

### Referencias y lectura adicional

- Beancount Query Language ([beancount][1])
- Importing External Data with Beancount ([beancount][4])
- Fava Budgets (`custom "budget" …`) ([Fava][11])
- Documents & `document` Directive ([beancount][2], [Fava][7])
- Balance and Pad Directives ([beancount][13])

_Este post es solo para propósitos educativos y no es consejo fiscal o legal._

[1]: https://www.google.com/search?q=%5Bhttps://beancount.github.io/docs/beancount_query_language.html%5D(https://beancount.github.io/docs/beancount_query_language.html) "Beancount Query Language - Beancount Documentation"
[4]: https://www.google.com/search?q=%5Bhttps://beancount.github.io/docs/importing_external_data.html%5D(https://beancount.github.io/docs/importing_external_data.html) "Importing External Data - Beancount Documentation"
[11]: https://www.google.com/search?q=%5Bhttps://fava.pythonanywhere.com/example-beancount-file/help/budgets%5D(https://fava.pythonanywhere.com/example-beancount-file/help/budgets) "Budgets"
[2]: https://www.google.com/search?q=%5Bhttps://beancount.github.io/docs/beancount_language_syntax.html%5D(https://beancount.github.io/docs/beancount_language_syntax.html) "Beancount Language Syntax"
[7]: https://www.google.com/search?q=%5Bhttps://fava.pythonanywhere.com/example-beancount-file/help/features%5D(https://fava.pythonanywhere.com/example-beancount-file/help/features) "Fava's features"
[13]: https://www.google.com/search?q=%5Bhttps://beancount.github.io/docs/balance_assertions_in_beancount.html%5D(https://beancount.github.io/docs/balance_assertions_in_beancount.html) "Balance Assertions in Beancount"
