# PROCESOS DE INICIO MARKETPLACE # INTRODUCCION A MARKETPLACE ![](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-12/embedded-image-4ubwaaaa.png) Introducción a Marketplace 30/12/2025 Versión: 1.0 *Queda prohibido cualquier tipo de explotación y, en particular, la reproducción, distribución, comunicación pública y/o transformación, total o parcial, por cualquier medio, de este documento sin el previo consentimiento expreso y por escrito a overskull.* #### INDICE. - [1. INTRODUCCIÓN](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-1.-introducci%C3%93n) - [1.1. Propósito del Sistema](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-1.1.-prop%C3%B3sito-del-s) - [1.2. Objetivo](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-1.2.-objetivo) - [2. CONSIDERACIONES GENERALES (TENER EN CUENTA SIEMPRE)](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-2.-consideraciones-g) - [2.1. Fundamentos del Modelo Marketplace](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-2.1.-fundamentos-del) - [2.2. Separación Estricta de Roles y Entornos](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-2.2.-separaci%C3%B3n-estr) - [3. ESTRUCTURA DE ROLES Y SUS FUNCIONALIDADES PRINCIPALES](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-3.-estructura-de-rol) - [3.1. Administrador de la Plataforma](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-3.1.-administrador-d) - [3.2. Vendedor](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-3.2.-vendedor) - [3.3. Cliente (Comprador)](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-3.3.-cliente-%28compra) - [4. FLUJO OPERATIVO PRINCIPAL CON LOGÍSTICA SHALOM](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-4.-flujo-operativo-p) - [5. PROCEDIMIENTO DE VALIDACIÓN DE ACCESOS Y PERMISOS](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-5.-procedimiento-de-) - [5.1. Verificación de Roles en Bagisto](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-5.1.-verificaci%C3%B3n-de) - [5.2. Contrastación con Responsabilidades](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-5.2.-contrastaci%C3%B3n-c) - [6. NOTAS TÉCNICAS Y CONSIDERACIONES](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-6.-notas-t%C3%89cnicas-y-) - [6.1. Base Tecnológica](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-6.1.-base-tecnol%C3%B3gic) - [6.2. Seguridad y Buenas Prácticas](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-6.2.-seguridad-y-bue) - [6.3. Soporte y Desarrollo](https://shalom-documentation.shalomcontrol.com/books/procesos-de-inicio-marketplace/page/introduccion-a-marketplace#bkmrk-6.3.-soporte-y-desar) ## 1. INTRODUCCIÓN ### 1.1. Propósito del Sistema Marketplace Shalom es una plataforma de comercio electrónico basada en el modelo de *marketplace* (mercado en línea), construida sobre **Bagisto**, un proyecto de código abierto de Webkul. Permite que cualquier persona o empresa actúe como vendedor para publicar y vender sus productos. Shalom, como operador de la plataforma, se encarga de facilitar los envíos, actuando como un puente logístico centralizado. ### 1.2. Objetivo Establecer los lineamientos para la operación, roles y acceso a la plataforma Marketplace Shalom en sus distintos entornos, asegurando una experiencia unificada para clientes, vendedores y administradores, con un enfoque en la gestión centralizada de logística. ## 2. CONSIDERACIONES GENERALES (TENER EN CUENTA SIEMPRE) ### 2.1. Fundamentos del Modelo Marketplace A diferencia de una tienda en línea tradicional, un **marketplace** reúne a múltiples vendedores independientes en una única plataforma. Aquí, Shalom no es el único vendedor, sino el **operador** que: - **Proporciona la plataforma tecnológica.** - **Gestiona o facilita el proceso de envío.** - **Define las reglas y estándares de operación.** - **Administra las transacciones y pagos.** ### 2.2. Separación Estricta de Roles y Entornos La funcionalidad está completamente segmentada por roles de usuario y entornos (QA/Producción). Es imperativo que cada actor acceda únicamente a la interfaz y entorno correspondiente a su función. **Entornos Disponibles:**
RolEntorno QA (Pruebas)Entorno Producción
**Administrador**`https://marketplace-bagisto-qa.shalom.com.pe/``https://shalom-market.shalom.com.pe/admin/login`
**Cliente (Comprador)**`https://marketplace-bagisto-qa.shalom.com.pe/customer/login`*(URL derivada del dominio principal)*
**Vendedor**`https://marketplace-bagisto-qa.shalom.com.pe/seller/login`*(URL derivada del dominio principal)*
**Nota Crítica:** Los datos entre los entornos de **QA** y **Producción NO están sincronizados**. El entorno QA debe usarse exclusivamente para pruebas, capacitación y validación de nuevas configuraciones. ## 3. ESTRUCTURA DE ROLES Y SUS FUNCIONALIDADES PRINCIPALES ### 3.1. Administrador de la Plataforma Es el superusuario con control total sobre el marketplace, responsable de su configuración, mantenimiento y supervisión. **Responsabilidades Clave:** - **Gestión de Vendedores:** Aprobar, suspender o eliminar cuentas de vendedores. - **Configuración del Sistema:** Administrar categorías de productos, métodos de pago, envío, impuestos y comisiones. - **Moderación de Contenido:** Revisar y autorizar productos publicados por los vendedores antes de que sean visibles en la tienda. - **Resolución de Conflictos:** Intervenir en disputas entre compradores y vendedores. - **Reportes Globales:** Acceder a análisis de ventas, rendimiento de vendedores y métricas financieras. **Acceso:** A través del panel `/admin`. ### 3.2. Vendedor Persona o empresa que se registra en la plataforma para vender sus productos. **Responsabilidades y Funcionalidades Clave:** - **Gestión de Catálogo:** Crear, editar y eliminar productos (sujeto a aprobación del administrador). - **Gestión de Inventario:** Actualizar existencias y variantes (tallas, colores). - **Gestión de Pedidos:** Ver órdenes de compra, actualizar su estado y preparar los productos para el recojo por logística de Shalom. - **Gestión de Perfil:** Configurar su tienda dentro del marketplace (logo, descripción, políticas). - **Finanzas:** Consultar reportes de ventas, comisiones y solicitar retiros de sus ganancias. **Acceso:** A través del panel `/seller`. ### 3.3. Cliente (Comprador) Usuario final que navega y compra productos en el marketplace. **Funcionalidades Clave:** - **Registro y Perfil:** Crear una cuenta para gestionar sus pedidos y direcciones. - **Navegación y Búsqueda:** Explorar productos de múltiples vendedores. - **Carrito y Checkout:** Realizar compras con un proceso de pago unificado. - **Seguimiento de Pedidos:** Rastrear el envío gestionado por Shalom. - **Atención al Cliente:** Contactar al vendedor o abrir disputas a través de la plataforma. **Acceso:** A través del portal principal o la ruta `/customer`. ## 4. FLUJO OPERATIVO PRINCIPAL CON LOGÍSTICA SHALOM El siguiente flujo integra a los tres actores y destaca el rol de Shalom en los envíos: 1. **Configuración (Admin):** El administrador configura las reglas de envío, zonas de cobertura, tarifas y acuerda los puntos de recolección con los vendedores. 2. **Publicación (Vendedor):** El vendedor sube su producto. El administrador lo revisa y **autoriza** para su venta. 3. **Compra (Cliente):** El cliente ordena un producto. El sistema calcula automáticamente el costo total (producto + envío gestionado por Shalom). 4. **Procesamiento (Vendedor):** El vendedor recibe la notificación, prepara el paquete y lo marca como "listo para recoger" en su panel. 5. **Recolección y Envío (Logística Shalom):** Shalom recoge el paquete del vendedor según la programación, lo procesa en su centro logístico y lo despacha al cliente. 6. **Entrega y Cierre (Cliente/System):** El cliente recibe el producto y confirma la entrega. Los fondos se liberan al vendedor (menos la comisión de la plataforma y el costo logístico). ## 5. PROCEDIMIENTO DE VALIDACIÓN DE ACCESOS Y PERMISOS ### 5.1. Verificación de Roles en Bagisto Bagisto, como framework base, cuenta con un robusto sistema de control de acceso basado en roles (ACL). Para cada módulo del panel de administración (`/admin`), es obligatorio: 1. **Consultar la Matriz de Permisos:** Verificar los roles configurados para cada sección (Gestión de Catálogo, Pedidos, Vendedores, etc.). 2. **Validar Niveles de Acceso:** Confirmar permisos específicos (Ver, Crear, Editar, Eliminar, Exportar). 3. **Pruebas por Rol:** Las pruebas de funcionalidad nueva deben ejecutarse no solo como administrador, sino también con perfiles de vendedor y cliente para garantizar que los permisos se apliquen correctamente. ### 5.2. Contrastación con Responsabilidades Cada usuario debe operar únicamente dentro de su interfaz asignada: - Un **vendedor** nunca debe acceder al panel `/admin`. - Un **cliente** no debe poder acceder a las funciones de gestión de pedidos del vendedor. - El **administrador** es el único que puede gestionar configuraciones a nivel de sistema (como el módulo de envíos). ## 6. NOTAS TÉCNICAS Y CONSIDERACIONES ### 6.1. Base Tecnológica - **Plataforma:** Bagisto (Open Source). - **Framework:** Laravel 11.x. - **Idioma Base:** Español (`locale = 'es'`). - **Moneda Principal:** Sol Peruano (`currency = 'PEN'`). - **Zona Horaria:** America/Lima. ### 6.2. Seguridad y Buenas Prácticas - **Separación de Entornos:** Nunca utilizar datos reales de producción en el entorno QA. - **Gestión de Sesiones:** Cada rol (`admin`, `customer`, `seller`) mantiene una sesión independiente. - **Reporte de Discrepancias:** Si un usuario identifica que puede acceder a funciones fuera de su rol, debe reportarlo inmediatamente. ### 6.3. Soporte y Desarrollo - El código muestra que el sistema integra módulos para múltiples pasarelas de pago (PayPal, PagoEfectivo, Openpay), lo que indica un diseño preparado para el mercado peruano e internacional. - Cualquier personalización o desarrollo nuevo debe probarse primero en el entorno QA, verificando el comportamiento para los tres roles. **Última Revisión:** 30/12/2025 **Ámbito de Aplicación:** Equipos de Operaciones, Soporte TI y Nuevos Empleados del Marketplace Shalom. *Esta documentación sirve como introducción general. Para procedimientos detallados sobre configuración de envíos, gestión de comisiones o uso del panel de administración de Bagisto, consulte los manuales técnicos específicos.* *Configurar Plataforma → Definir Comisiones → Establecer Reglas de Envío → Configurar Métodos de Pago → Crear Categorías → Activar Marketplace* *Notificación pedido → Vendedor prepara producto → Marca "Listo para recojo" → Sistema notifica a Shalom → Programación recolección → Recojo físico → Procesamiento centro logístico → Envío a cliente → Entrega y confirmación* *Nuevo producto → Sistema notifica admin → Revisión manual → Verificar: \- Calidad imágenes \- Descripción adecuada \- Precio razonable \- Categoría correcta → Aprobar/Rechazar/Modificar → Notificación vendedor* PANEL ADMIN (/admin) \- Control total sistema \- Gestión vendedores \- Configuración global \- Resolución disputas \- Reportes financieros PANEL VENDEDOR (/seller) \- Solo SU tienda \- Gestionar SUS productos \- Ver SUS pedidos \- SUS reportes de ventas \- SUS configuraciones PANEL CLIENTE (/customer) \- SUS datos personales \- SUS pedidos \- SUS direcciones \- SUS reviews \- SUS reclamos Cliente compra → Email confirmación cliente → Notificación pedido vendedor → Alerta logística Shalom Vendedor marca "listo" → Notificación recolección Shalom → Update estado para cliente Shalom recolecta → Update tracking → Notificación a cliente → Update para vendedor Entrega exitosa → Confirmación automática → Inicio período garantía → Notificación cierre ciclo DESARROLLO NUEVA FUNCIÓN: 1\. Implementación QA 2\. Pruebas Admin QA 3\. Pruebas Vendedor QA 4\. Pruebas Cliente QA 5\. Corrección errores 6\. Validación flujo completo 7\. Migración a Producción 8\. Monitoreo 24h