Appearance
Integraciones del Modulo de Membresias con Otros Modulos
Modulo: Membresias Tipo: Process Estado: Implementado Fecha: 2026-01-27
Descripcion
Problema que resuelve
El modulo de membresias no opera de forma aislada. Los datos de miembros, sus productos de membresia y su facturacion interactuan con los modulos de Ventas y Cuenta Corriente (CtaCte). Sin integraciones adecuadas, surgen los siguientes problemas:
- Productos sin contexto de membresia: Al consultar productos desde el modulo de Ventas, no se incluye informacion de su extension de membresia (ajustes de precio, categorias asociadas), lo cual es necesario para la facturacion correcta
- Cupones sin validacion: Los cupones de pago de membresia requieren validacion contra el registro de facturacion para confirmar la existencia y estado de la deuda del periodo, y esta informacion reside en el modulo de membresias
Solucion implementada
Se implementan dos puntos de integracion que permiten a los modulos consumidores obtener datos del modulo de membresias de forma transparente:
- Integracion con Ventas: Los productos de venta se enriquecen con su extension de membresia cuando se consultan con alcance completo
- Integracion con CtaCte: La validacion de cupones de pago consulta la facturacion de membresia para verificar la existencia y estado de la deuda de un periodo
Valor de negocio
- Datos de producto completos: El modulo de Ventas puede facturar correctamente productos de membresia con sus extensiones y ajustes
- Cobros agiles: Los cupones de pago se validan automaticamente contra la facturacion de membresia sin intervencion manual
- Consistencia de datos: Las integraciones garantizan que la informacion sea coherente entre modulos
Contexto del sistema
Estas integraciones conectan el modulo de membresias con:
- Modulo de Ventas: Para enriquecimiento de productos con datos de membresia
- Modulo de CtaCte: Para validacion de cupones de pago contra facturacion de membresia
Proceso de Negocio
Integracion 1: Enriquecimiento de Productos de Venta con Datos de Membresia
Descripcion del flujo
Cuando el modulo de Ventas consulta productos con alcance completo (maximo), los productos que tienen una extension de membresia son automaticamente enriquecidos con sus datos adicionales.
Flujo de integracion
- El modulo de Ventas solicita datos de uno o mas productos con alcance maximo
- El sistema obtiene los datos base del producto (nombre, precio, listas de precio)
- El sistema verifica si cada producto tiene una extension de membresia asociada
- Para los productos con extension: se carga la informacion de membresia (ajustes de precio, configuracion de membresia)
- Los datos enriquecidos se devuelven al modulo de Ventas
Datos de la extension de membresia en productos
| Dato | Descripcion |
|---|---|
| Signo del ajuste | Indica si el ajuste es incremento (+) o descuento (-) sobre el precio base |
| Tipo de ajuste | Porcentaje (P) o monto fijo (F) |
| Valor del ajuste | Monto o porcentaje del ajuste |
| Configuracion de facturacion | Parametros especificos para la facturacion de membresia |
Cuando se activa
La extension de membresia se carga solo cuando se solicita el alcance maximo del producto. Las consultas con alcance minimo devuelven solo los datos basicos del producto sin la extension.
Integracion 2: Validacion de Cupones de Pago contra Facturacion de Membresia
Descripcion del flujo
Cuando se escanea un cupon de pago de membresia en el modulo de CtaCte, el sistema valida la informacion del cupon contra el registro de facturacion de membresia para confirmar la deuda.
Flujo de integracion
- El cajero escanea un cupon de pago de membresia
- El modulo de CtaCte decodifica el codigo de barras y extrae: sucursal, cliente, periodo
- El sistema consulta la facturacion de membresia para el cliente y periodo indicados
- Se verifica que existe una factura de membresia para ese periodo
- Se verifica el estado de la factura (pendiente, cancelada)
- Se obtiene el monto actual de la factura desde la base de datos
- Se devuelve la informacion validada al modulo de CtaCte para precargar el recibo
Datos consultados de facturacion de membresia
| Dato | Descripcion |
|---|---|
| Existencia de factura | Si existe una factura de membresia para el cliente y periodo |
| Estado de la factura | Si esta pendiente de pago o ya fue cancelada |
| Monto de la factura | Importe actualizado de la deuda del periodo |
| Correlacion periodo-factura | Vinculacion entre el periodo de membresia y el comprobante de factura |
Regla de correlacion periodo-factura
Cada periodo de membresia genera una unica factura por cliente (o por titular de grupo familiar). El cupon identifica el periodo, y a traves del registro de facturacion de membresia se localiza la factura correspondiente.
Frontend (Perspectiva de Usuario)
Vistas
Las integraciones no agregan vistas nuevas, sino que enriquecen las vistas existentes de cada modulo:
Modulo de Ventas - Consulta de productos
- Los productos de membresia muestran informacion adicional de su extension cuando se consultan con detalle completo
Modulo de CtaCte - Carga de recibo con cupon
- Al escanear un cupon de membresia, el sistema valida automaticamente contra la facturacion y precarga los datos del recibo
Interacciones del usuario
- Consultar producto con extension de membresia: El usuario consulta un producto desde Ventas y puede ver los datos de extension de membresia si el producto los tiene
- Escanear cupon de membresia: El cajero escanea un cupon y el sistema valida automaticamente la deuda contra la facturacion de membresia
Estados de UI
- Producto enriquecido: El producto muestra sus datos base mas los datos de extension de membresia
- Cupon validado: El recibo se precarga con los datos validados de la facturacion de membresia
- Cupon invalido: Se muestra mensaje de error si la factura no existe o ya fue cancelada
Backend (Perspectiva de Datos de Negocio)
Entidades de negocio involucradas
Extension de Membresia del Producto
Datos adicionales de membresia asociados a un producto de venta.
| Dato de negocio | Descripcion |
|---|---|
| Producto base | Producto de venta al que se asocia la extension |
| Signo de ajuste | Incremento (+) o descuento (-) |
| Tipo de ajuste | Porcentaje (P) o monto fijo (F) |
| Valor de ajuste | Monto o porcentaje del ajuste |
Registro de Facturacion de Membresia
Registro que vincula un periodo de facturacion con la factura generada para un miembro.
| Dato de negocio | Descripcion |
|---|---|
| Miembro (cliente) | El miembro al que se facturo |
| Periodo | Periodo de facturacion (mes/ano) |
| Factura | Referencia a la factura generada |
| Estado | Estado de la factura (pendiente, cancelada) |
Relaciones de negocio
- Un producto de venta puede tener una extension de membresia asociada
- Un registro de facturacion vincula un miembro con una factura para un periodo especifico
- Un cupon de pago se valida contra un registro de facturacion para confirmar la deuda
Validaciones de negocio
| Validacion | Descripcion | Comportamiento si no cumple |
|---|---|---|
| Extension de producto | Solo se enriquecen productos que tienen extension de membresia | Los productos sin extension se devuelven con sus datos base unicamente |
| Factura existente | El cupon debe corresponder a una factura existente | Error: No se encontro factura para el periodo indicado |
| Factura pendiente | La factura del cupon debe estar pendiente de pago | Error: La factura ya fue cancelada |
| Alcance maximo | La extension de membresia solo se carga con alcance maximo | Con alcance minimo no se carga la extension |
Reglas de Negocio
RN-001: Enriquecimiento condicional de productos
Descripcion: Los productos de venta se enriquecen con datos de membresia unicamente cuando se consultan con alcance maximo y el producto tiene una extension de membresia asociada.
Condicion: Se consulta un producto con alcance maximo.
Accion:
- Verificar si el producto tiene extension de membresia
- Si la tiene: cargar los datos de la extension y agregarlos a la respuesta del producto
- Si no la tiene: devolver el producto con sus datos base unicamente
RN-002: Correlacion unica periodo-cliente-factura
Descripcion: Cada combinacion de cliente y periodo de membresia corresponde a una unica factura. Esta correlacion es la base para la validacion de cupones de pago.
Condicion: Se valida un cupon de pago de membresia.
Accion:
- Buscar la factura de membresia para el cliente y periodo indicados en el cupon
- Si existe y esta pendiente: devolver los datos para precarga del recibo
- Si existe pero esta cancelada: informar que la deuda ya fue pagada
- Si no existe: informar que no se encontro factura para ese periodo
Casos de Uso
CU-001: Consultar producto de membresia desde Ventas
Actor: Usuario de Ventas
Precondiciones:
- Usuario autenticado con permiso de consulta de productos
- Existe un producto de venta con extension de membresia
Flujo principal:
- El usuario consulta un producto desde el modulo de Ventas con detalle completo
- El sistema obtiene los datos base del producto (nombre, precios, listas)
- El sistema detecta que el producto tiene extension de membresia
- El sistema carga los datos de la extension (signo, tipo, valor de ajuste)
- El usuario visualiza el producto con toda su informacion incluyendo los datos de membresia
Postcondiciones:
- El producto se muestra con datos base y extension de membresia
- El usuario puede utilizar la informacion completa para facturacion o consulta
Flujos alternativos:
- Producto sin extension: El producto se muestra solo con datos base
- Consulta con alcance minimo: La extension de membresia no se carga
CU-002: Validar cupon de pago de membresia
Actor: Cajero / Usuario de CtaCte
Precondiciones:
- Usuario autenticado con permiso de cobro
- El cupon de pago corresponde a un miembro con factura de membresia
Flujo principal:
- El cajero escanea un cupon de pago de membresia
- El sistema extrae la sucursal, cliente y periodo del codigo de barras
- El sistema consulta el registro de facturacion de membresia
- El sistema confirma que existe una factura pendiente para el periodo
- El sistema devuelve los datos validados: cliente, factura, monto actualizado
- El sistema precarga el recibo con la informacion validada
Postcondiciones:
- El recibo esta precargado con los datos correctos de la factura de membresia
- El cajero solo debe confirmar y seleccionar forma de pago
Flujos alternativos:
- Factura no encontrada: El sistema informa que no existe factura para el periodo del cupon
- Factura ya cancelada: El sistema informa que la deuda ya fue pagada y la fecha de cancelacion
Consideraciones
Seguridad
- Las integraciones respetan los permisos de cada modulo: el usuario de Ventas no accede a datos de membresia mas alla de la extension del producto
- La validacion de cupones requiere permiso de cobro en CtaCte
- Los datos de CRM respetan el aislamiento multi-tenant
Auditoria
| Operacion | Informacion registrada |
|---|---|
| Enriquecimiento de producto | No se audita (operacion de lectura) |
| Validacion de cupon | Se registra el intento de validacion (exitoso o fallido) |
| Consulta de membresia desde CRM | No se audita (operacion de lectura) |
Rendimiento
- El enriquecimiento de productos se ejecuta solo con alcance maximo para evitar consultas innecesarias
- La validacion de cupones es una consulta directa por cliente y periodo (rendimiento constante)
- Los datos de contacto compartidos no generan consultas adicionales ya que son la misma entidad
Dependencias
Funcionalidades relacionadas
- Gestion de productos de venta: Entidad base que se enriquece con la extension de membresia
- Cupones de pago de membresia: Proceso que consume la validacion contra facturacion
- Facturacion por lotes: Genera los registros de facturacion que validan los cupones
Servicios externos
- ARCA (ex AFIP): Las facturas de membresia generadas pueden estar registradas en el organismo fiscal
Criterios de Aceptacion
- [x] AC-001: Los productos de venta con extension de membresia se enriquecen con datos adicionales cuando se consultan con alcance maximo
- [x] AC-002: Los productos sin extension de membresia se devuelven con datos base unicamente
- [x] AC-003: Con alcance minimo no se carga la extension de membresia del producto
- [x] AC-004: La validacion de cupon consulta la facturacion de membresia para confirmar la deuda
- [x] AC-005: La validacion devuelve error si no existe factura para el periodo del cupon
- [x] AC-006: La validacion devuelve error si la factura ya fue cancelada
- [x] AC-007: La correlacion periodo-cliente identifica univocamente una factura de membresia
Notas Adicionales
Direccion de las integraciones
| Integracion | Modulo consumidor | Modulo proveedor | Tipo |
|---|---|---|---|
| Extension de producto | Ventas | Membresias | Enriquecimiento de datos |
| Validacion de cupon | CtaCte | Membresias | Consulta de validacion |
Consideraciones multi-tenant
Todas las integraciones respetan el aislamiento multi-tenant del sistema. Las consultas entre modulos operan siempre dentro del mismo schema/tenant. La integracion de cupones con cobro cross-schema se documenta en el proceso de Cupon de Pago.
Historial de Cambios
| Fecha | Version | Autor | Descripcion |
|---|---|---|---|
| 2026-01-27 | 1.0 | Sistema | Documentacion de funcionalidad implementada |