Cuentas

Una Cuenta es la unidad financiera central dentro de un Midaz Ledger. Cada Cuenta está vinculada a un Activo específico (como una moneda o instrumento financiero) y rastrea todos los débitos, créditos y saldos para ese Activo. En términos bancarios, una Cuenta representa un producto financiero, como una cuenta corriente, cuenta de ahorros o cuenta de préstamo.

​

Estructura de Cuenta

• Cuenta > Ledger: Las Cuentas existen dentro de un Ledger.
• Cuenta > Portafolio: Las Cuentas pueden agruparse en Portafolios para agregación a nivel de cliente o negocio.
• Cuenta > Activo: Cada Cuenta está vinculada a un Activo, garantizando claridad del saldo. Por ejemplo, una Cuenta podría estar denominada en BRL, USD, o representar un activo específico como oro, bitcoin o puntos de lealtad.

​

Características clave

• Cada Cuenta está vinculada exactamente a un tipo de Activo.
• Las Cuentas se identifican de manera única dentro de un Ledger.
• Todas las transacciones involucran débitos y créditos entre Cuentas.

​

Tipos de Cuenta

Cada tipo de cuenta determina cómo se comporta y qué papel desempeña dentro del Ledger:

• Deposit: La cuenta de referencia para transacciones diarias, desde consultar saldos hasta realizar pagos.
• Savings: Ideal para inversiones, con ganancias potenciales (como intereses) cuando el plugin Interest está habilitado.
• Loans: Hace seguimiento de préstamos de clientes y automatiza cálculos cuando el plugin Interests está en uso.
• Marketplace: Diseñada para ventas basadas en cuotas (piense en planes de pago de cinco meses), más productos de liquidación y anticipos de cuentas por cobrar.
• Credit Card: Rastrea saldos de tarjetas de crédito, pagos y uso en un solo lugar.
• External Cuenta: Las External Cuentas en Midaz representan cuentas fuera de la estructura de su organización. Se utilizan para rastrear dinero que entra o sale, típicamente vinculado a usuarios, socios o proveedores financieros más allá de su ledger interno. Pero son más que simples marcadores de posición.
  • Administran saldos temporales durante operaciones que involucran partes externas.
  • Son las únicas cuentas permitidas para tener saldo negativo, lo que indica que los fondos están en tránsito.
  • Son creadas automáticamente por el Ledger cada vez que crea un Activo.
  • Siguen un patrón de nomenclatura claro: @external/<Activo-code>, como @external/BRL.

En la práctica, estas cuentas actúan como puentes entre su sistema y el mundo exterior, manejando entradas, salidas y todo lo intermedio con claridad y control.

​

Comportamientos de Cuenta

La siguiente tabla describe la modificabilidad y comportamientos para cada tipo de cuenta:

​

Parent Cuenta ID

El Parent Cuenta ID vincula dos cuentas dentro de Midaz, dándole la flexibilidad de definir la relación según su lógica de negocio. Ya sea que lo use para representar una estructura tradicional padre-hijo o algo completamente diferente, la elección es suya. Midaz proporciona la base; usted decide cómo construir sobre ella.

​

Alias de Cuenta

Los alias facilitan la identificación de cuentas al reemplazar IDs complejos con etiquetas legibles y fáciles de usar.

• Por ejemplo: En lugar de referenciar una cuenta como 3172933b-50d2-4b17-96aa-9b378d6a6eac, simplemente puede usar @username_1.

​

Usar el Alias de Cuenta en Transacciones

Al crear una transacción, siempre use el alias de cuenta en el campo Cuenta, no el ID de cuenta. Asignar un alias cuando crea una cuenta es opcional. Si lo omite, no hay problema: el sistema usará automáticamente el ID de cuenta como alias. De cualquier manera, cada cuenta termina con un alias único. Entonces, cuando sea el momento de referenciar una cuenta en una transacción, simplemente use el alias. Limpio, consistente y listo para usar.

​

Administrar Cuentas

Puede administrar sus Cuentas ya sea vía API o a través de la Console.

​

Vía API

• Create an Cuenta — Abrir una nueva Cuenta vinculada a un Activo.
• List Cuentas — Ver todas las Cuentas en su espacio de trabajo.
• Retrieve an Cuenta — Obtener detalles de una Cuenta específica.
• Retrieve an Cuenta by Alias — Obtener detalles de una Cuenta específica por su alias.
• Retrieve an External Cuenta — Obtener detalles de una External Cuenta específica por su código de Activo.
• Update an Cuenta — Editar los metadatos o configuraciones de una Cuenta existente.
• Delete an Cuenta — Eliminar una Cuenta específica.

​

Vía Console

Todas las acciones de administración de Cuentas, incluidas ver, crear, editar y eliminar, se pueden realizar a través de la página Cuentas en Midaz Console. Obtenga más información en la guía Managing Cuentas.