Modulo gestión de comercios v1.0
6 min
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
