La cuenta es la verdad
Una cuenta es el contenedor de saldo — la verdad que vive dentro del Ledger. Registra exactamente cuánto de un asset guarda, construido a partir de cada movimiento de entrada y salida. Eso es todo lo que hace, y es deliberado: la cuenta se mantiene limpia y fiable porque no carga con datos desordenados de identidad del mundo real. En la bóveda, la cuenta es la caja numerada. Guarda valor; no guarda tu nombre, tus documentos ni tu número de teléfono.
El Holder es la persona o empresa
Un Holder es el dueño del mundo real que está detrás de la cuenta — la persona o empresa que registras. Este es el registro del cliente: nombre, número de documento, datos de contacto. Registrar a estos dueños es su propia tarea, a menudo llamada cadastro de pessoas — llevar el control de las personas y empresas con las que tu negocio trata. ¿Por qué mantener al Holder separado de la cuenta? Dos razones:
- Un solo dueño puede tener muchas cuentas. El dueño se registra una vez; las cuentas se le vinculan.
- El Ledger se mantiene confiable. Los datos de identidad cambian a menudo y a veces son sensibles — no quieres que se enreden en los registros que demuestran tus saldos.
Alias: nombres amigables para las cuentas
Las cuentas se identifican mediante IDs largos y únicos — precisos, pero nada divertidos de teclear o recordar. Así que les das nombres más amigables. Aquí es donde dos términos de sonido parecido se confunden — hacen cosas distintas:
- Un alias es un identificador amigable para una cuenta — un apodo como
marketing-fundpara no lidiar con un ID largo. - Un alias account es un registro que vincula los datos bancarios del mundo real de un dueño (banco, sucursal, número de cuenta) con una cuenta subyacente del Ledger.
Volvamos a la bóveda. El alias es la pegatina con el apodo en la caja (“Marketing fund”) para que el personal no necesite el número de caja. El alias account es la ficha del mostrador de recepción que vincula los datos bancarios externos de un cliente con cuál caja es la suya.
Por qué molestarse con toda esta separación
Separar estos roles parece trabajo extra, pero te compra flexibilidad real:
- Un Holder, muchas cuentas, sin duplicar al dueño cada vez.
- Alias amigables para que personas y sistemas referencien cuentas sin IDs largos.
- Alias accounts que conectan con múltiples bancos y sistemas externos — sin contaminar nunca el registro limpio de valor del Ledger.
En resumen
- Una cuenta es el contenedor de saldo — la verdad dentro del Ledger, libre de datos de identidad.
- Un Holder es el dueño del mundo real que registras — la persona o empresa (cadastro de pessoas). Un Holder puede poseer muchas cuentas.
- Un alias es un apodo amigable que apunta a una de tus cuentas.
- Un alias account es un registro que vincula datos bancarios del mundo real con una cuenta del Ledger.
- Mantener estos separados compra flexibilidad mientras mantiene limpio el Ledger.
Míralo en LerianMira estas ideas en la práctica: Cuentas y Alias accounts.

