INTRODUCCION A MARKETPLACE

Fecha: 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.

 

1. INTRODUCCIÓN

1.1. Propósito del Sistema

Marketplace Shalom Bus es una plataforma integralde comercio electrónico basada en el modelo de gestiónmarketplace (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 empresaspublicar y vender sus productos. Shalom, como operador de transportela terrestreplataforma, se encarga de pasajeros,facilitar diseñadalos paraenvíos, administraractuando elcomo cicloun completopuente delogístico operaciones: desde la programación de salidas hasta la liquidación financiera. El sistema centraliza la venta de boletos, control de flota, gestión de clientes y reportes administrativos en una sola solución.centralizado.

1.2. Objetivo

Establecer los lineamientos operativospara la operación, roles y técnicosacceso 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 usorecojo correctopor logística de Shalom.

• Gestión de Perfil: Configurar su tienda dentro del sistemamarketplace (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 Bus,en asegurandolos queenví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 cumpladel 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 las restriccionesperfiles de rol definidasvendedor y cliente para garantizar que los empleadospermisos comprendanse laapliquen estructuracorrectamente.

   funcional

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 realizarmúltiples sus actividadespasarelas de manerapago eficiente(PayPal, yPagoEfectivo, segura.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.