Saltar al contenido principal
El plugin CRM (Customer Relationship Manager) es una capa de integración de datos que gestiona datos de registro esenciales vinculados a un usuario de Cuenta de Midaz, también conocido como Titular, Owner o Customer. En Midaz, este usuario está representado por la Entity. Este plugin no pertenece al dominio transaccional del ledger. En su lugar, enriquece los Cuentas del ledger con atributos relevantes para el negocio sin interferir con la lógica o el rendimiento del ledger. CRM es donde vive la metadata del usuario. No se trata de saldos, transferencias o tarifas, sino de quién está detrás del Cuenta y qué necesitas saber para operar tu negocio.

​
¿Por qué usar el CRM?

Los Cuentas del ledger de Midaz son genéricos por diseño, construidos para ser transaccionales primero y agnósticos del dominio. El plugin CRM interviene para agregar significado a esos Cuentas, vinculando cada uno a perfiles de usuario detallados y contextos de negocio.

​
Ejemplos de casos de uso

  • Banca (individuos y empresas) CRM almacena identificadores como CPF o CNPJ, dirección, detalles de contacto o números de cuenta, mientras que Midaz maneja exactamente la misma lógica de transacciones para cualquier tipo de cliente.
  • Cadenas de suministro (proveedor, fábrica, minorista) CRM rastrea metadata como ID de proveedor, ubicación del almacén o información contractual. Estos datos no pertenecen a la transacción, pero son esenciales al decidir si una transacción debe ser permitida.
SugerenciaCRM es un plugin separado. Si deseas obtener más información o evaluarlo para tu caso de uso, ponte en contacto con nuestro equipo.

​
Entities

CRM gira en torno a dos entidades principales:
  • Titular – La entidad central en CRM, representando la persona asociada con un Cuenta del ledger en Midaz. Almacena atributos relacionados con la identidad y características individuales.
  • Cuenta Alias – Define el contexto empresarial asociado con un Ledger Cuenta en Midaz Ledger, incluyendo detalles financieros como información de cuenta bancaria.
En la Figura 1, puedes encontrar una ilustración de cómo las entidades del CRM están conectadas a Midaz.

Figura 1. Una ilustración de cómo las entidades del CRM se conectan a Midaz

​
Principios de diseño

El plugin CRM está construido para:
  • Separación de responsabilidades: Mantiene los datos del perfil de usuario fuera de la lógica transaccional.
  • Rendimiento del sistema: Sin orquestación a nivel de usuario dentro de los servicios principales de Midaz.
  • Flexibilidad de integración: Cada cliente puede usar datos del CRM para impulsar reglas personalizadas, sin alterar el ledger.
ImportanteCRM no valida reglas a nivel de ledger ni procesos de cumplimiento como KYC. Es una capa de datos neutral y persistente diseñada para máxima interoperabilidad.

​
Comportamiento de la API

CRM se implementa como una API de registro independiente. Proporciona persistencia y acceso estructurado a datos no transaccionales vinculados a Cuentas en Midaz.
  • No aplica validaciones como estado de usuario, perfil de riesgo o verificación de documentos.
  • Es agnóstico al Activo, Ledger o lógica de agrupación utilizada en los Cuentas de Midaz.
  • Asegura acceso consistente a la metadata del titular sin contaminar la capa transaccional.

​
Seguridad y cumplimiento

Lerian proporciona Midaz y sus plugins como componentes on-premise, lo que significa que tú mantienes el control de tu infraestructura, políticas de cumplimiento y ciclo de vida de los datos de usuario. Dicho esto, aseguramos las mejores prácticas de seguridad por defecto:
  • Datos en tránsito están cifrados con protocolos estándar de la industria.
  • Datos en reposo están protegidos por cifrado y controles de acceso refinados.
Confiamos en que nuestros clientes definan y hagan cumplir sus propias políticas en torno a LGPD y otras regulaciones regionales de protección de datos. CRM simplemente proporciona la estructura.

​
Estrategias de eliminación de datos

En Lerian, tratamos la propiedad de los datos seriamente. Por eso el plugin CRM te da control completo sobre cómo se elimina la información, con dos opciones integradas:
  • Soft delete (predeterminado): El registro permanece en la base de datos pero se marca como eliminado. Esto es útil si necesitas mantener una pista de auditoría o recuperar información más tarde.
  • Hard delete: Si tu política interna requiere eliminación completa, puedes usar un comando específico para eliminar los datos permanentemente—sin recuperación.
Tú estás a cargo. No imponemos límites o suposiciones sobre tu estrategia de datos. Cada institución define sus propias reglas, y el plugin se adapta de manera segura y confiable.

​
Control de acceso

¿Necesitas restringir quién puede acceder a tus datos del CRM? Puedes habilitar nuestro plugin Access Manager para ayudarte a restringir quién tiene acceso a los datos.

​
Habilitación de Access Manager

Para habilitar el control de acceso, primero asegúrate de que Access Manager esté instalado. Luego, abre el archivo .env ubicado en la raíz de la carpeta CRM usando cualquier editor de texto, y establece las siguientes variables de entorno: 
## AUTH
PLUGIN_AUTH_ADDRESS=http://plugin-auth:4000
PLUGIN_AUTH_ENABLED=true
El plugin CRM comenzará a hacer cumplir los permisos de acceso según tu configuración de Auth.
SugerenciaAccess Manager está disponible como parte del modelo Enterprise. Si deseas obtener más información o evaluarlo para tu caso de uso, ponte en contacto con nuestro equipo.