Skip to main content
Usa Midaz Module para gestionar las Cuentas asociadas a tu Ledger. Las Cuentas contienen saldos y participan en las transacciones de tu sistema financiero.

​
¿Qué son las Cuentas?

Las Cuentas representan titulares de saldo individuales dentro de la estructura de tu ledger. Cada cuenta:
  • Contiene saldos en un Activo específico (moneda o materia prima)
  • Participa en transacciones como origen o destino de fondos
  • Pertenece a una entidad, como un cliente, una unidad de negocio o un tercero externo
  • Admite portafolios, segmentos y tipos de cuenta para su organización e informes
  • Registra su historial con un registro de auditoría completo de todos los movimientos
Las Cuentas pueden clasificarse como:
  • Cuentas internas: cuentas que creas y gestionas para las operaciones de tu organización
  • Cuentas externas: Midaz las crea automáticamente para activos o pasivos externos
Para más detalles técnicos, consulta la página Cuentas.

​
Conceptos clave

  • Tipos de cuenta: clasifican las cuentas según la estructura financiera de tu organización (por ejemplo, checking, savings, revenue). Habilita la validación para aplicar las reglas de tipo de cuenta.
  • Alias de cuenta: un identificador único y legible (por ejemplo, @customer_john_doe) que facilita referenciar las cuentas en transacciones y consultas.
  • Portafolios: agrupan cuentas relacionadas para fines de informes y gestión. Útiles para dar seguimiento a portafolios de clientes o divisiones de negocio.
  • Segmentos: organizan las cuentas en estructuras jerárquicas para centros de costos 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ú lateral izquierdo. La página Accounts muestra una tabla con todas las Cuentas del Ledger actual, entre ellas:
  • Account Name: el nombre visible de la cuenta
  • ID: el identificador único de la cuenta
  • Account Alias: el alias único y legible (si está definido)
  • Assets: el Activo (moneda o materia prima) que contiene la cuenta
  • Metadata: la cantidad de pares clave-valor personalizados de la cuenta
  • Portfolio: el portafolio al que pertenece la cuenta (si tiene uno)
  • Actions: el menú de tres puntos con las acciones disponibles. Las cuentas externas muestran en su lugar un ícono de candado
El ícono 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

Agrega cuentas internas para clientes, departamentos u operaciones de negocio

Editar la información de una Cuenta

Modifica los detalles, los metadatos y la configuración organizativa de la cuenta

Eliminar una Cuenta

Elimina cuentas que ya no necesites (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 (Type: checking, Asset: USD)
  • Cuenta de ahorro del cliente: @customer_123_savings (Type: savings, Asset: USD)
  • Agrupa ambas bajo un Portafolio: Customer 123 Portfolio
Crea cuentas de tesorería dedicadas para gestionar la liquidez y los fondos operativos.Ejemplo:
  • Tesorería principal: @treasury_main (Type: treasury, Asset: USD)
  • Fondo de reserva: @treasury_reserve (Type: reserve, Asset: USD)
  • Cuenta flotante: @float_operations (Type: float, Asset: USD)
Crea cuentas separadas para cada moneda que maneje tu organización.Ejemplo:
  • Operaciones en USD: @ops_usd (Type: operations, Asset: USD)
  • Operaciones en EUR: @ops_eur (Type: operations, Asset: EUR)
  • Operaciones en BRL: @ops_brl (Type: operations, Asset: BRL)
Usa segmentos y tipos de cuenta para dar seguimiento a los gastos por departamento.Ejemplo:
  • Gastos de ingeniería: @eng_expenses (Type: expense, Segment: Engineering)
  • Gastos de marketing: @mkt_expenses (Type: expense, Segment: Marketing)
  • Consolida con el segmento padre para informes de toda la organización

​
Validación de Tipo de cuenta

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

​
Habilitar la validación de Tipo de cuenta

La validación de Tipo de cuenta es una configuración por Ledger. Para activarla en la Console: en la página Ledgers, abre Details del Ledger, haz clic en la pestaña Settings y activa 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 tipo de cuenta, cada cuenta nueva debe tener un tipo de cuenta registrado. Actualiza las cuentas existentes que no tengan tipo.
Para más información sobre cómo gestionar los tipos de cuenta, consulta Gestionar Tipos de cuenta.

​
Mejores prácticas

1

Usa nombres y alias descriptivos

Nombra las cuentas con claridad y usa alias para que sea fácil identificarlas (por ejemplo, @customer_john_checking en vez de referencias por UUID).
2

Usa tipos de cuenta

Habilita la validación de tipo de cuenta para aplicar la estructura de tu plan de cuentas y evitar clasificaciones incorrectas.
3

Organiza con portafolios

Agrupa las cuentas relacionadas en portafolios para mejorar los informes y la gestión, sobre todo en relaciones con clientes.
4

Planifica tus códigos de Activo

Usa convenciones consistentes para los códigos de Activo (ISO 4217 para monedas) y simplifica así las operaciones multimoneda.
5

Documenta con metadatos

Usa campos de metadatos para guardar contexto adicional, como IDs de clientes, códigos de departamento o referencias de integración.