Estructura de la Cuenta
- Cuenta > _Ledger: Las Cuentas se crean dentro de un Ledger, que rastrea y consolida todos los saldos y operaciones.
- Cuenta > Portafolio: Las Cuentas se pueden agrupar en Portafolios para representar grupos de clientes, líneas de productos o unidades de negocio.
- Cuenta > Activo: Cada Cuenta está vinculada a un único Activo, que define el tipo de valor que posee, como BRL, USD, BTC o puntos de fidelidad.
- Cuenta > Tipo de Cuenta: Con la validación de Tipo de Cuenta habilitada, cada Cuenta debe categorizarse por un Tipo de Cuenta que se puede crear de acuerdo con necesidades específicas del usuario o clasificación de negocio.
Características clave
- Cada cuenta está vinculada exactamente a un tipo de activo.
- Las cuentas se identifican de forma única dentro de un Ledger.
- Todas las transacciones implican débitos y créditos entre cuentas.
Cuenta Externa (External Account)
Las Cuentas Externas en Midaz representan cuentas fuera de la estructura de tu organización. Se utilizan para rastrear dinero que está entrando o saliendo, generalmente vinculado a usuarios, socios o proveedores financieros fuera de tu Ledger interno. Pero son más que simples marcadores de posición. Las Cuentas Externas:
- Gestionan saldos temporales durante operaciones que involucran a partes externas.
- Son las únicas cuentas a las que se les permite ir a negativo, lo que indica que los fondos están en tránsito.
- Se crean automáticamente por el Ledger cada vez que se crea un Activo.
- Siguen un patrón de nomenclatura claro:
@external/<código-activo>, como@external/BRL.
Para mantener el Ledger preciso y fiable, las cuentas externas no se pueden eliminar ni modificar.
ID de Cuenta Principal (Parent Account ID)
El ID de Cuenta Principal vincula dos cuentas dentro de Midaz, lo que te da la flexibilidad de definir la relación basándose en tu lógica de negocio. Ya sea que lo uses para representar una estructura tradicional de padre-hijo o algo completamente distinto, la elección es tuya. Midaz proporciona la base; tú decides cómo construir sobre ella.
Alias de Cuenta (Account aliases)
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 hacer referencia a una cuenta como
3172933b-50d2-4b17-96aa-9b378d6a6eac, simplemente puedes usar@username_1.
Usar el Alias de Cuenta en Transacciones
Al crear una transacción, utiliza siempre el alias de cuenta en el campoaccount, no el ID de cuenta.
Asignar un alias al crear una cuenta es opcional. Si lo omites, no hay problema: el sistema utilizará automáticamente el ID de cuenta como alias. De cualquier manera, cada cuenta termina con un alias único.
Así que cuando sea el momento de hacer referencia a una cuenta en una transacción, simplemente usa el alias. Limpio, coherente y listo para usar.
Gestión de Cuentas
Puedes gestionar tus cuentas a través de la API o mediante Lerian Console.
Vía API
- Crear una Cuenta — Abre una nueva Cuenta vinculada a un Activo.
- Listar Cuentas — Consulta todas las Cuentas en tu espacio de trabajo.
- Recuperar una Cuenta — Obtén detalles de una Cuenta específica.
- Recuperar una Cuenta por Alias — Obtén detalles de una Cuenta específica por su alias.
- Recuperar una Cuenta Externa — Obtén detalles de una Cuenta Externa específica por su código de activo.
- Actualizar una Cuenta — Edita los metadatos o la configuración de una Cuenta existente.
- Eliminar una Cuenta — Elimina una Cuenta específica.