Modulo gestión de comercios v1.0
El módulo de Gestión de Comercios provee las capacidades necesarias para administrar el ciclo de vida operativo de los comercios dentro de la Plataforma Adquirente SUGA, implementando el dominio de administración y control de entidades comerciales.
Es responsable de exponer una vista unificada del universo de comercios onboardeados, permitiendo su búsqueda, visualización, clasificación y gestión de estado, así como la habilitación o deshabilitación de medios de pago asociados.
El módulo se integra de forma nativa con los módulos de onboarding, expediente digital, gestión de medios de pago y orquestación transaccional, formando parte de los flujos end-to-end de alta, operación y mantenimiento.
Capacidades principales
- Visualización del listado completo de comercios onboardeados.
- Búsqueda de comercios por identificador único (ID).
- Consulta del estado actual del comercio.
- Cambio de estado operativo.
- Bloqueo y desbloqueo de comercios.
- Baja lógica de comercios.
- Activación y desactivación de medios de pago por comercio.
- Filtrado por estado.
- Ordenamiento alfabético.
- Modificación de estado vía interfaz administrativa.
- Modificación de estado vía API.
- Modificación de estado mediante archivos ABM (procesamiento batch).
Modelo de Estados del Comercio
El módulo implementa un state machine que gobierna el ciclo de vida del comercio desde su creación hasta su baja.
Cada transición de estado responde a eventos provenientes de procesos de onboarding, validación documental u operaciones manuales, garantizando consistencia operativa y trazabilidad.
Estados soportados
Estado | Descripción |
|---|---|
Activo | Comercio habilitado para operar. |
Limitado | Comercio activo con restricciones operativas. |
Bloqueado | Comercio temporalmente inhabilitado para operar. |
Rechazado | Comercio rechazado durante proceso de onboarding. |
Baja | Comercio dado de baja de manera lógica. |
Transiciones principales
Onboarding
- Onboarding completado con expediente aprobado → Activo
- Onboarding completado con expediente rechazado → Rechazado
Operación
- Activo → Limitado
- Activo → Bloqueado
- Activo → Baja
Acciones administrativas
- Limitado → Activo
- Bloqueado → Activo
- Activo → Baja
Solicitud del comercio
- Activo → Baja (por solicitud de inhabilitación)
Consideraciones
- La baja es lógica y preserva histórico.
- Un comercio en estado Baja no puede retornar a estados operativos.
- Los cambios de estado generan eventos internos para sincronización con módulos dependientes.