Alias Accounts

Una Alias Account agrega contexto de negocio a una Cuenta del Ledger en Midaz. Vincula un Holder a una cuenta específica en el ledger. Agrega detalles bancarios, información regulatoria y datos de partes relacionadas a esa cuenta. Sin este vínculo, las funcionalidades del CRM que dependen del contexto de cuenta no funcionan como se espera.

​

Cómo funciona

---

La Alias Account es una representación a nivel de CRM de una Cuenta del Ledger en Midaz. Al crear una Alias Account, proporcionas el ledgerId y el accountId que identifican la cuenta objetivo en el ledger. La Alias Account hereda automáticamente el document y el type del Holder asociado. Este diseño mantiene los detalles de cuenta orientados al cliente separados del ledger transaccional. Los números bancarios, los códigos de sucursal y los identificadores regulatorios permanecen en el CRM, no en el ledger. Esta separación admite configuraciones multi-banco e integración con sistemas externos.

​

Campos de la Alias Account

---

​

Campos principales

​

Detalles bancarios

El objeto bankingDetails almacena información sobre la institución financiera del alias:

​

Campos regulatorios

El objeto regulatoryFields almacena datos que los reguladores financieros exigen:

​

Partes relacionadas

Una parte relacionada es una persona o entidad vinculada a una Alias Account. Cada parte relacionada tiene un rol definido y una relación con límite de tiempo. Las partes relacionadas representan a las personas u organizaciones reales conectadas a la cuenta, para titularidad, autoridad legal o responsabilidad operacional. El cumplimiento normativo, los informes regulatorios y los flujos de trabajo del CRM las utilizan.

​

Roles

Cada parte relacionada debe tener uno de los siguientes roles:

​

Relaciones con límite de tiempo

Cada relación de parte relacionada tiene un período activo definido:

• startDate — Requerido. La fecha en que la relación entró en vigor (AAAA-MM-DD).
• endDate — Opcional. La fecha en que la relación terminó (AAAA-MM-DD). Si la omites, la relación permanece activa. Cuando la defines, endDate debe ser posterior a startDate.

Este diseño registra quién tuvo una relación con la cuenta, y en qué capacidad. Mantiene las relaciones pasadas en el registro.

​

Gestionando partes relacionadas

Gestionas las partes relacionadas a través de los endpoints de Alias Account. No hay endpoints independientes de creación o listado:

• Agregar en la creación — Incluye un array relatedParties en el cuerpo de la solicitud de Crear Alias Account.
• Agregar a una existente — Incluye un array relatedParties en el cuerpo de la solicitud de Actualizar Alias Account. Midaz agrega nuevas entradas a la lista existente. No reemplaza las partes relacionadas existentes.
• Eliminar — Usa el endpoint Eliminar Parte Relacionada con el related_party_id específico.
• Listar — La respuesta de la Alias Account devuelve las partes relacionadas en el array relatedParties.

​

Campos

​

Seguridad de los datos

---

Midaz cifra varios campos de la Alias Account en reposo, incluyendo el campo document heredado y detalles bancarios como account e iban. El cifrado protege los datos financieros sensibles incluso si un atacante accede al almacenamiento subyacente. Para la lista completa de campos protegidos y estrategias de cifrado, consulta Seguridad de datos del CRM.

​

Gestionando Alias Accounts

---

​

Vía API

Usa la API del CRM para gestionar Alias Accounts programáticamente:

• Crear una Alias Account — Vincular un Holder a una Cuenta del Ledger en Midaz.
• Listar Alias Accounts — Ver todas las Alias Accounts con paginación y filtros.
• Consultar una Alias Account — Obtener los detalles de una Alias Account específica.
• Actualizar una Alias Account — Editar los detalles de una Alias Account existente.
• Eliminar una Alias Account — Eliminar lógicamente o remover permanentemente una Alias Account.

​

Vía Lerian Console

Puedes gestionar Alias Accounts a través de la página Alias Accounts en el Módulo Midaz de Lerian Console. La consola ofrece una interfaz visual para crear, ver, editar y eliminar Alias Accounts sin escribir código. Aprende más en la guía de Gestión de Alias Accounts.

​

Próximos pasos

---