---
title: Modulo gestión de comercios v1.0
slug: modulo-gestion-de-comercios-v10
docTags: 
createdAt: 2026-01-24T16:29:09.349Z
---

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



::Image[]{src="https://api.archbee.com/api/optimize/wYlzYU9oe8HZjh9BkqeFY/q3x4QooUoCIzmRoOPU65x_image.png" size="34" width="966" height="896" position="center" showCaption="false"}

### 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.