Skip to main content
CRM no forma parte del dominio transaccional del ledger. Añade atributos de negocio a las cuentas del ledger. No cambia la lógica, la consistencia ni el rendimiento del ledger. CRM es donde viven los metadatos del usuario. No guarda saldos, transferencias ni tarifas. Registra quién está detrás de una cuenta y qué necesitas saber para operar tu negocio.

​
Versionado con Midaz

CRM se ejecuta dentro del ledger de Midaz y no necesita ninguna licencia aparte. Midaz es source-available. CRM comparte la versión de Midaz. Por ejemplo, Midaz v3.5.0 usa CRM v3.5.0. CRM se ejecuta en el mismo binario que el ledger. Siempre está disponible. Tú decides si almacenas datos de holder y llamas a sus endpoints.
Prueba CRM localmentePuedes ejecutar CRM con el stack de Midaz localmente, sin Kubernetes, usando nuestro repositorio plugins-docker-compose.

​
¿Por qué usar CRM?

Las cuentas del ledger de Midaz son genéricas por diseño. Son transaccionales primero y agnósticas al dominio. CRM añade significado a esas cuentas y vincula cada una a un perfil de usuario y un contexto de negocio. No tienes que usar CRM. Puedes adoptarlo más tarde, solo cuando tu caso de uso necesita metadatos de cliente o de negocio más allá del ledger.

​
Ejemplos de casos de uso

  • Banca (individuos y empresas): CRM almacena identificadores como CPF o CNPJ, una dirección, datos de contacto o números de cuenta. Midaz ejecuta la misma lógica de transacción para ambos tipos de cliente.
  • Cadenas de suministro (proveedor, fábrica, minorista): CRM rastrea metadatos como IDs de proveedores, ubicaciones de almacenes o detalles de contrato. Estos datos no pertenecen a la transacción, pero impulsan las decisiones de negocio.
CRM se ejecuta dentro del ledger de Midaz, así que no hay un servicio aparte que desplegar. Úsalo solo si tu producto o contexto regulatorio necesita metadatos de cliente o de negocio.

​
Entidades

CRM tiene dos entidades principales:
  • Holder (Titular) – La entidad principal en CRM. Representa la persona de una cuenta del ledger de Midaz. Almacena atributos de identidad y características individuales.
  • Alias Account (Cuenta Alias) – El contexto de negocio de una Cuenta del Ledger en Midaz Ledger. Contiene detalles financieros como la información de cuenta bancaria.
La Figura 1 muestra cómo las entidades de CRM se conectan a Midaz.
Cómo las entidades de CRM, el Holder y la Alias Account, se conectan con las cuentas del ledger de Midaz

Figura 1. Ilustración de cómo las entidades de CRM se conectan a Midaz

​
Principios de diseño

CRM se enfoca en:
  • Separación de responsabilidades: Mantiene los datos del perfil de usuario fuera de la lógica de transacción.
  • Rendimiento del sistema: No añade orquestación a nivel de usuario dentro de los servicios core de Midaz.
  • Despliegue más simple: CRM se ejecuta dentro del binario del ledger, sin un servicio aparte que ejecutar.
  • Límites de dominio claros: Evoluciona con Midaz sin acoplarse a los internos del ledger.
CRM no valida reglas a nivel de ledger ni procesos de cumplimiento como KYC. Es una capa de datos neutral y persistente.

​
Comportamiento de la API

CRM se ejecuta dentro del binario del ledger de Midaz. Expone una API de registro para datos no transaccionales vinculados a cuentas de Midaz.
  • No aplica validaciones como estado del usuario, perfil de riesgo o verificación de documentos.
  • Es agnóstico al activo, ledger o lógica de agrupación que usan las cuentas de Midaz.
  • Da acceso consistente a los metadatos del titular sin cargar la capa de transacción.

​
Seguridad y cumplimiento

Lerian entrega Midaz y sus componentes para despliegue on-premise. Tú mantienes el control de tu infraestructura, tus políticas de cumplimiento y el ciclo de vida de los datos de usuario. CRM se entrega con Midaz y sigue los mismos estándares de seguridad que el resto de la plataforma:
  • Datos en tránsito: Midaz los cifra con protocolos estándar de la industria.
  • Datos en reposo: Midaz los protege con cifrado y control de acceso granular.
Tú gestionas las claves de cifrado. Usa un servicio de gestión de secretos para almacenar, rotar y controlar el acceso a las claves.
Defines y aplicas tus propias políticas para LGPD, GDPR y otras normas regionales de protección de datos. CRM proporciona la estructura. Revisa las Recomendaciones de seguridad antes de desplegar cualquier componente en tu entorno. Aplica las mejores prácticas de seguridad a cada componente — Access Manager, Fees Engine, Pix y CRM. Asegura los límites de red, gestiona los secretos, aplica parches y aplica un control de acceso estricto.

​
Estrategias de eliminación de datos

CRM te da control total sobre cómo elimina los datos. Ofrece dos opciones:
  • Eliminación suave (predeterminado): CRM marca el registro como eliminado pero lo mantiene en la base de datos. Úsala para conservar un rastro de auditoría o recuperar datos más tarde.
  • Eliminación definitiva: Cuando tu política permite la remoción, puedes solicitar la eliminación de los datos. La remoción física depende de tu configuración de retención, cumplimiento y retención legal (legal hold).
Tus políticas definen el comportamiento. CRM se adapta a tus requisitos de cumplimiento.

​
Control de acceso

Para restringir quién puede acceder a tus datos de CRM, habilita nuestro Access Manager.

​
Habilitando Access Manager

Primero, instala Access Manager. Luego abre el archivo .env del ledger de Midaz y define estas variables de entorno:
Después de habilitarlo, CRM aplica los permisos de acceso desde tu configuración de autenticación.
Access Manager está disponible bajo el modelo Enterprise. Para evaluarlo, ponte en contacto con nuestro equipo.
¿Listo para comenzar? Consulta Primeros pasos con CRM para una guía paso a paso.

​
Próximos pasos

Conceptos principales

Comprende las entidades clave que gestiona CRM: Holders y Alias Accounts.

Explora la API de CRM

Consulta endpoints para holders, alias accounts y partes relacionadas.

Usando CRM

Aprende a registrar holders y vincularlos a cuentas del ledger.