INTRODUCCION A MARKETPLACE

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
• 1.1. Propósito del Sistema
• 1.2. Objetivo
• 2. CONSIDERACIONES GENERALES (TENER EN CUENTA SIEMPRE)
• 2.1. Fundamentos del Modelo Marketplace
• 2.2. Separación Estricta de Roles y Entornos
• 3. ESTRUCTURA DE ROLES Y SUS FUNCIONALIDADES PRINCIPALES
• 3.1. Administrador de la Plataforma
• 3.2. Vendedor
• 3.3. Cliente (Comprador)
• 4. FLUJO OPERATIVO PRINCIPAL CON LOGÍSTICA SHALOM
• 5. PROCEDIMIENTO DE VALIDACIÓN DE ACCESOS Y PERMISOS
• 5.1. Verificación de Roles en Bagisto
• 5.2. Contrastación con Responsabilidades
• 6. NOTAS TÉCNICAS Y CONSIDERACIONES
• 6.1. Base Tecnológica
• 6.2. Seguridad y Buenas Prácticas
• 6.3. Soporte y Desarrollo

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:

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