Saltar al contenido principal
Use Midaz Module para gestionar Cuentas asociadas con su Libro Contable. Las Cuentas son las unidades fundamentales que mantienen saldos y participan en transacciones dentro de su sistema financiero.

​
¿Qué son las Cuentas?

Las Cuentas representan titulares de saldos individuales dentro de la estructura de su libro contable. 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 portfolios, segmentos y tipos de cuenta
  • Rastrea el historial con registros de auditoría completos de todos los movimientos
Las Cuentas pueden clasificarse como:
  • Cuentas Internas - Cuentas que usted crea y gestiona para las operaciones de su organización
  • Cuentas Externas - Cuentas creadas automáticamente que representan activos o pasivos externos
Para detalles técnicos, consulte la página de Cuentas.

​
Conceptos clave

  • Tipos de Cuenta - Clasifican las cuentas según la estructura financiera de su organización (por ejemplo, checking, savings, revenue). Habilite la validación para aplicar reglas de tipos de cuenta.
  • Alias de Cuenta - 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.
  • Segmentos - 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, seleccione 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 Libro Contable 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 crea Activos.

​
Acciones disponibles

Desde la página Accounts, puede:

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

Cree 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
Configure 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)
Cree cuentas separadas para cada moneda que maneja su 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)
Use 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, puede aplicar validación de tipos de cuenta para asegurar que las cuentas sigan la estructura financiera de su organización.

​
Habilitar validación de tipos de cuenta

Para activar la validación de tipos de cuenta para un libro contable específico, configúrelo 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 habilite 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, consulte Gestionar Tipos de Cuenta.

​
Mejores prácticas

1

Use nombres y alias descriptivos

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

Aproveche los tipos de cuenta

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

Organice con portfolios

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

Planifique sus códigos de activo

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

Documente con metadatos

Use 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 su sistema de libro contable. Una estructura y organización de cuentas apropiada impacta directamente la claridad de sus operaciones financieras y capacidades de reportes.