Skip to main content
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
  • Admite Portafolios, Segmentos y Tipos de Cuenta para organización y reportes
  • 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 - Midaz las crea automáticamente para 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 con todas las Cuentas en el Ledger actual, incluyendo:
  • Account Name - El nombre de visualización de la cuenta
  • ID - El identificador único de la cuenta
  • Account Alias - El alias único y legible (si está configurado)
  • Assets - El activo (moneda o commodity) que mantiene la cuenta
  • Metadata - El número de pares clave-valor personalizados de la cuenta
  • Portfolio - El portafolio al que pertenece la cuenta (si aplica)
  • Actions - El menú de tres puntos con las acciones disponibles — las cuentas externas muestran un icono de candado en su lugar
El icono de candado marca una cuenta que no puedes editar ni eliminar. Midaz crea estas cuentas externas automáticamente cuando creas un Activo.

​
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

Elimina las cuentas que ya no necesitas (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
Crea 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

La validación de tipos de cuenta hace que cada cuenta siga la estructura financiera de tu organización.

​
Habilitar validación de tipos de cuenta

La validación de tipos de cuenta es una configuración por Ledger. Para activarla en la Consola: en la página Ledgers, abre los Details del Ledger, haz clic en la pestaña Settings y activa el toggle Validate Account Type. Como alternativa programática, envía una solicitud PATCH a /v1/organizations/{organization_id}/ledgers/{ledger_id}/settings con este cuerpo:
Cuando habilitas la validación de tipos de cuenta, cada nueva cuenta debe tener un tipo de cuenta registrado. Actualiza las cuentas existentes que no tienen tipo.
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

Usa 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 Ledger. Una estructura de cuentas clara mejora tus operaciones financieras y reportes.