Saltar al contenido principal
Usa Midaz Module para gestionar Accounts asociadas con tu Ledger. Las Cuentas son las unidades fundamentales que mantienen saldos y participan en transacciones dentro de tu sistema financiero.

​
¿Qué son las Cuentas?

Las Cuentas representan titulares de saldos individuales dentro de la estructura de tu Ledger. Cada cuenta:
  • Mantiene saldos en un Activo específico (moneda o commodity)
  • Participa en transacciones como orígenes o destinos de fondos
  • Pertenece a una entidad como un cliente, unidad de negocio o parte externa
  • Puede organizarse usando Portafolios, Segmentos y Tipos de Cuenta
  • Rastrea el historial con registros de auditoría completos de todos los movimientos
Las Cuentas pueden clasificarse como:
  • Internal Accounts - Cuentas que creas y gestionas para las operaciones de tu organización
  • External Accounts - Cuentas creadas automáticamente que representan activos o pasivos externos
Para detalles técnicos, consulta la página de Cuentas.

​
Conceptos clave

  • Account Types - Clasifican las cuentas según la estructura financiera de tu organización (por ejemplo, checking, savings, revenue). Habilita la validación para aplicar reglas de tipos de cuenta.
  • Account Alias - Un identificador único y legible (por ejemplo, @customer_john_doe) que facilita la referencia a cuentas en transacciones y consultas.
  • Portfolios - Agrupan cuentas relacionadas para propósitos de reportes y gestión. Útil para rastrear portfolios de clientes o divisiones de negocio.
  • Segments - Organizan cuentas en estructuras jerárquicas para necesidades organizacionales complejas como centros de costo o departamentos.

​
Acceder a la página de Cuentas

Para abrir la página Accounts, selecciona la opción Accounts en la sección Accounts del menú del lado izquierdo. La página Accounts muestra una tabla que lista todas las Cuentas en el Ledger actual, incluyendo:
  • Name - El nombre de visualización de la cuenta
  • Alias - El identificador único (si está configurado)
  • Type - La clasificación del tipo de cuenta
  • Asset Code - El código de moneda o commodity
  • Entity - El propietario o entidad asociada
  • Balance - Saldo actual en la cuenta
  • Status - Activa, bloqueada o externa (indicado por el icono de candado)
El icono de candado indica que la cuenta no puede ser editada o eliminada. Esto aplica a cuentas externas que se crean automáticamente cuando creas Activos.

​
Acciones disponibles

Desde la página Accounts, puedes:

Crear una Cuenta

Agregar cuentas internas para clientes, departamentos u operaciones de negocio

Editar información de Cuenta

Modificar detalles de cuenta, metadatos y configuraciones organizacionales

Eliminar una Cuenta

Eliminar cuentas que ya no son necesarias (solo cuentas internas)

​
Estrategias de organización de cuentas

Crea cuentas separadas para cada cliente, organizadas por tipo de cuenta y código de activo.Ejemplo:
  • Cuenta corriente del cliente: @customer_123_checking (Tipo: checking, Activo: USD)
  • Cuenta de ahorros del cliente: @customer_123_savings (Tipo: savings, Activo: USD)
  • Agrupar ambas bajo un Portfolio: Customer 123 Portfolio
Configura cuentas de tesorería dedicadas para gestionar liquidez y fondos operativos.Ejemplo:
  • Tesorería principal: @treasury_main (Tipo: treasury, Activo: USD)
  • Fondo de reserva: @treasury_reserve (Tipo: reserve, Activo: USD)
  • Cuenta flotante: @float_operations (Tipo: float, Activo: USD)
Crea cuentas separadas para cada moneda que maneja tu organización.Ejemplo:
  • Operaciones USD: @ops_usd (Tipo: operations, Activo: USD)
  • Operaciones EUR: @ops_eur (Tipo: operations, Activo: EUR)
  • Operaciones BRL: @ops_brl (Tipo: operations, Activo: BRL)
Usa segmentos y tipos de cuenta para rastrear gastos departamentales.Ejemplo:
  • Gastos de ingeniería: @eng_expenses (Tipo: expense, Segmento: Engineering)
  • Gastos de marketing: @mkt_expenses (Tipo: expense, Segmento: Marketing)
  • Consolidar con el segmento padre para reportes a nivel organizacional

​
Validación de tipos de cuenta

Si está habilitado, puedes aplicar validación de tipos de cuenta para asegurar que las cuentas sigan la estructura financiera de tu organización.

​
Habilitar validación de tipos de cuenta

Para activar la validación de tipos de cuenta para un Ledger específico, configúralo en los archivos .env: 
# Account Types Validation
MIDAZ_ACCOUNT_TYPE_VALIDATION_ENABLED=true
# List of <organization-id>:<ledger-id> separated by comma
MIDAZ_ACCOUNT_TYPE_VALIDATION=<organization-id>:<ledger-id>
Una vez que habilites la validación de Tipos de Cuenta, el Tipo de Cuenta se convierte en un campo requerido al crear nuevas cuentas. Las cuentas existentes sin tipos pueden necesitar ser actualizadas.
Para más información sobre la gestión de tipos de cuenta, consulta Gestionar Tipos de Cuenta.

​
Mejores prácticas

1

Usa nombres y alias descriptivos

Nombra las cuentas claramente y usa alias para fácil referencia (por ejemplo, @customer_john_checking en lugar de referencias UUID).
2

Aprovecha los tipos de cuenta

Habilita la validación de tipos de cuenta para aplicar la estructura de tu plan de cuentas y prevenir clasificaciones erróneas.
3

Organiza con portfolios

Agrupa cuentas relacionadas en portfolios para mejores reportes y gestión, especialmente para relaciones con clientes.
4

Planifica tus códigos de activo

Usa convenciones de códigos de activo consistentes (ISO 4217 para monedas) para simplificar operaciones multi-moneda.
5

Documenta con metadatos

Usa campos de metadatos para almacenar contexto adicional como IDs de cliente, códigos de departamento o referencias de integración.
Las Cuentas son la base de tu sistema de Ledger. Una estructura y organización de cuentas apropiada impacta directamente la claridad de tus operaciones financieras y capacidades de reportes.