Documentación del Sistema

Appearance

Integracion CRM con Clientes del Modulo Ventas ​

Modulo: CRM / Ventas Tipo: Resource Estado: Implementado Fecha: 2026-02-02

Descripcion ​

El sistema de CRM permite integrar los contactos del modulo CRM con los clientes del modulo de Ventas. Esta integracion facilita el proceso de conversion de contactos potenciales (leads) en clientes comerciales efectivos, permitiendo acceder a la informacion comercial del cliente desde el contexto del CRM.

Proposito de la Integracion ​

  • Vincular contactos de CRM con clientes comerciales
  • Acceder a datos del cliente desde el contexto del CRM
  • Facilitar la conversion de leads a clientes
  • Mantener trazabilidad entre gestiones de CRM y operaciones comerciales

Frontend (Perspectiva de Usuario) ​

Vistas ​

  • Detalle de Contacto: Muestra si el contacto esta vinculado a un cliente comercial
  • Listado de Registros: Permite acceder a la informacion del cliente vinculado

Interacciones del Usuario ​

Consulta de Cliente Vinculado:

  1. El usuario visualiza un registro de CRM
  2. Si el contacto tiene cliente vinculado, se muestra la informacion comercial
  3. El usuario puede acceder a los datos completos del cliente

Vinculacion de Contacto con Cliente:

  1. Al crear o editar un contacto en CRM
  2. Se puede asociar a un cliente existente del modulo Ventas
  3. La asociacion queda establecida para futuras consultas

Datos del Cliente Accesibles desde CRM ​

Al consultar un cliente desde el CRM, se pueden visualizar:

  • Nombre comercial
  • Numero de identificacion (CUIT/CUIL/DNI)
  • Domicilios (principal y secundario)
  • Telefonos de contacto
  • Correo electronico
  • Localidad

Backend (Perspectiva de Datos de Negocio) ​

Entidades de Negocio ​

Cliente (del Modulo Ventas) ​

Representa un cliente comercial con relacion activa con la empresa.

Datos accesibles desde CRM:

  • Identificador unico del cliente
  • Nombre comercial completo
  • Identificacion fiscal (CUIT/CUIL/DNI)
  • Domicilio principal
  • Domicilio secundario
  • Codigo postal
  • Telefono principal
  • Telefono secundario
  • Fax
  • Correo electronico
  • Condicion ante IVA
  • Localidad
  • Provincia
  • Observaciones

Relaciones de Negocio ​

  • Un contacto de CRM puede estar vinculado a UN cliente del modulo Ventas
  • Un cliente puede estar vinculado a multiples contactos (diferentes interlocutores de la misma empresa)
  • La vinculacion es opcional - un contacto puede existir sin cliente asociado

Validaciones de Negocio ​

  • El identificador del cliente debe ser mayor a cero para considerarse valido
  • Si el cliente referenciado no existe en el modulo Ventas, se retorna vacio
  • No se pueden modificar datos del cliente desde el CRM (solo lectura)

Reglas de Negocio ​

  • Regla 1: Consulta por Lotes

    • Condicion: Cuando se consultan multiples registros de CRM
    • Accion: Los clientes vinculados se cargan en lote para optimizar rendimiento, evitando consultas individuales por cada registro

  • Regla 2: Acceso de Solo Lectura

    • Condicion: Desde el modulo CRM
    • Accion: Solo se puede consultar informacion del cliente, no modificarla. Las modificaciones deben hacerse desde el modulo Ventas

  • Regla 3: Datos Complementarios

    • Condicion: Algunos datos pueden no estar disponibles desde el contexto CRM
    • Accion: Campos como codigo postal, fax, condicion IVA y observaciones pueden no estar disponibles dependiendo del origen de consulta

Casos de Uso ​

Caso 1: Consulta de Historial de Cliente ​

Actor: Operador de atencion telefonica

Precondiciones:

  • El contacto de CRM tiene un cliente comercial vinculado
  • El usuario tiene permisos de CRM

Flujo principal:

  1. El operador recibe una llamada de un cliente existente
  2. Busca el registro de CRM por nombre o telefono
  3. Visualiza el contacto y su cliente comercial vinculado
  4. Accede a los datos comerciales del cliente:
    • CUIT para identificacion
    • Domicilio para despacho
    • Telefono alternativo
  5. Continua con la gestion informada del historial

Postcondiciones:

  • El operador tiene contexto comercial del cliente
  • Puede ofrecer atencion personalizada basada en historial

Caso 2: Conversion de Lead a Cliente ​

Actor: Ejecutivo de ventas

Precondiciones:

  • Existe un contacto en CRM sin cliente comercial asociado
  • Se ha concretado una venta

Flujo principal:

  1. El ejecutivo identifica un contacto que realizo una compra
  2. Crea el cliente en el modulo de Ventas con todos sus datos comerciales
  3. Vincula el contacto de CRM con el nuevo cliente
  4. Las futuras gestiones de CRM mostraran el cliente vinculado

Postcondiciones:

  • El contacto queda asociado al cliente comercial
  • Se mantiene trazabilidad entre gestiones de CRM y operaciones

Caso 3: Consulta Masiva de Clientes ​

Actor: Sistema (automatico)

Precondiciones:

  • Se consulta un listado de multiples registros de CRM

Flujo principal:

  1. El sistema recibe solicitud de listado de CRM
  2. Identifica todos los contactos que tienen clientes vinculados
  3. Realiza consulta en lote al modulo Ventas
  4. Asocia los datos de cliente a cada registro correspondiente
  5. Retorna listado con informacion de cliente incluida

Postcondiciones:

  • El listado incluye datos de cliente sin multiples consultas
  • El rendimiento se optimiza mediante carga por lotes

Consideraciones ​

Seguridad ​

  • Los datos del cliente se acceden segun permisos del usuario en el modulo Ventas
  • La informacion comercial sensible esta protegida por permisos

Auditoria ​

  • No se genera auditoria adicional en CRM por consultas de cliente
  • Las modificaciones a clientes se auditan en el modulo Ventas

Rendimiento ​

  • Consultas en lote para evitar problema N+1
  • Los identificadores invalidos (menores o iguales a 0) se filtran antes de consultar
  • El sistema indexa por identificador de cliente para busquedas eficientes

Dependencias ​

Funcionalidades Relacionadas ​

  • Modulo de Ventas (gestion de clientes)
  • Modulo de CRM (gestion de contactos)

Servicios Externos ​

  • Ninguno requerido

Criterios de Aceptacion ​

  • [ ] AC-001: Se pueden consultar datos de cliente desde un registro de CRM
  • [ ] AC-002: Los clientes se cargan en lote al consultar listados
  • [ ] AC-003: Contactos sin cliente vinculado no generan errores
  • [ ] AC-004: Los datos del cliente son de solo lectura desde CRM
  • [ ] AC-005: El rendimiento es aceptable con grandes volumenes de registros

Notas Adicionales ​

  • Esta integracion es unidireccional: CRM consulta a Ventas, no al reves
  • No todos los campos del cliente estan disponibles desde CRM (solo un subconjunto relevante)
  • La vinculacion contacto-cliente se gestiona desde el modulo de contactos de CRM
  • El campo condicion_iva viene del contacto, no del cliente, cuando se accede desde CRM