DataFirefly Marketplace — Guía completa

Presentación

DataFirefly Marketplace convierte su tienda PrestaShop en un marketplace multivendedor. Vendedores externos se registran, publican sus productos y gestionan sus pedidos, mientras usted orquesta las comisiones, los pagos y el cumplimiento desde el back office.

El módulo cubre todo el ciclo: registro y validación de vendedores, área de vendedor completa, división real de pedidos en subpedidos, motor de comisiones, pago dividido regulado (Mangopay y Stripe Connect), envío por vendedor, cumplimiento europeo (DSA, P2B, IVA), reseñas, mensajería, planes, disputas y analíticas, todo en cinco idiomas (FR, EN, ES, DE, IT).

Compatibilidad y requisitos

• PrestaShop 8.0, 8.1, 8.2 y 9.x
• PHP 8.1 o superior
• Multitienda y multiidioma
• Para el pago dividido: una cuenta Mangopay o Stripe Connect (claves sandbox para pruebas, claves de producción para explotación)

Instalación

1. En el back office, vaya a Módulos > Gestor de módulos, haga clic en Subir un módulo y seleccione el archivo dfmarketplace.zip.
2. La instalación crea las tablas necesarias, registra los hooks y añade el menú Marketplace al back office, junto con un conjunto de datos de demostración (planes y reglas de comisión).
3. Abra Marketplace > Configuración para configurar el módulo.

Configuración inicial

En Marketplace > Configuración, defina los parámetros principales:

• Comisión por defecto: tasa aplicada cuando no existe una regla más específica (15 % por defecto).
• Proveedor de pago por defecto: Mangopay o Stripe Connect, y luego las claves correspondientes.
• Modo híbrido: permite al operador vender sus propios productos junto a los vendedores externos.
• Facturar los pedidos hijos: genera una factura dedicada para cada subpedido de vendedor.
• Estado que libera el depósito: estado del pedido que desencadena la liberación de fondos a los monederos de los vendedores (por ejemplo «Enviado» o «Entregado»).
• Mostrar identidad del vendedor (DSA): activa el bloque de identidad del vendedor profesional en el escaparate.
• Prefijo de factura de comisión y preaviso P2B (días).
• Aprobación automática de productos: si está activada, los productos de los vendedores se publican sin moderación.

Gestión de vendedores

Registro

Un cliente conectado puede convertirse en vendedor mediante la página de registro del módulo (enlazada desde su cuenta). Indica el nombre de la tienda, su forma jurídica y sus datos legales. Se envía un correo de acuse de recibo.

Validación y KYC

Desde Marketplace > Vendedores, el operador puede aprobar, suspender o rechazar a un vendedor. Al aprobar, se activa el onboarding del PSP y se envía un correo de validación. El vendedor puede subir sus documentos KYC (extracto de registro, identidad, datos bancarios) desde su panel.

Área del vendedor

Cada vendedor dispone de un panel compartimentado: solo accede a sus propios datos.

• Panel: saldo del monedero, importe a liquidar, número de productos, estado, pedidos, libro mayor.
• Mi perfil: logo, banner, presentación, políticas de devolución y de envío, datos de contacto públicos y campos DSA.
• Mis productos: creación y edición de fichas completas (fotos, referencia/SKU, EAN, estado, precio e IVA, cantidad, categoría, peso y dimensiones, descripciones).
• Envío: selección de transportistas ofrecidos y reglas de gastos (por precio o peso, por zona, con umbral de gratuidad).

División de pedidos

Cuando un pedido contiene productos de varios vendedores, el módulo lo divide en verdaderos pedidos hijos (uno por vendedor). Cada subpedido tiene sus propios gastos de envío, su comisión fijada, su factura y su crédito de monedero. El detalle lógico se conserva para la trazabilidad, y la separación entre vendedores es estricta.

Comisiones

El motor aplica una cascada de reglas, de la más específica a la más general: producto › vendedor › categoría › global, con repliegue a la comisión por defecto. Las reglas pueden ser en porcentaje, importe fijo o híbridas, sobre una base con o sin impuestos.

Se admiten tramos de facturación mensual: por ejemplo, 15 % hasta 5 000 € de facturación mensual, luego 12 % por encima. La comisión se fija en el momento del pedido y nunca se recalcula.

Pago dividido, monedero y depósito en garantía

Los adaptadores Mangopay y Stripe Connect cobran los fondos de forma dividida y los mantienen en depósito. Al alcanzar el estado de pedido configurado, los fondos se liberan a los monederos de los vendedores.

Liquidaciones

El vendedor solicita una retirada desde su panel. El operador ejecuta las liquidaciones desde Marketplace > Comisiones y pagos con un clic (transferencia SEPA vía PSP). Cada movimiento queda registrado en el libro mayor del monedero.

Webhooks

Configure la URL de webhook del módulo en el lado del PSP (controlador webhook) para sincronizar los estados de pago. La firma se verifica en cada llamada.

Envío por vendedor

Cada vendedor define sus transportistas y sus reglas de gastos. Al enviar, introduce el transportista y el número de seguimiento desde su panel: se envía un correo al comprador y, cuando todos los subpedidos de un pedido se han enviado, el pedido padre pasa automáticamente al estado «Enviado».

Cumplimiento europeo

• DSA: la identidad del vendedor profesional (razón social, número de registro, IVA, punto de contacto) se muestra en su escaparate.
• Facturas de comisión: generadas automáticamente por periodo mensual, numeradas y archivadas. El operador puede lanzar la generación en masa desde Marketplace > Facturas de comisión.
• P2B: una página publica las condiciones aplicables a los vendedores, los parámetros de clasificación y el preaviso en caso de modificación.
• IVA «plataforma considerada proveedor»: un indicador por vendedor se muestra y se traslada a la factura de comisión.

Reseñas, mensajería, planes, disputas y analíticas

• Reseñas: los compradores que han comprado a un vendedor pueden dejar una reseña, moderada desde Marketplace > Reseñas. La nota media se recalcula automáticamente.
• Mensajería: hilos entre comprador, vendedor y operador; bandeja de entrada del vendedor.
• Planes de vendedor: Free, Pro y Premium por defecto, con cuotas de productos, tasa de comisión y acceso a analíticas. Gestionados desde Marketplace > Planes de vendedor.
• Disputas y devoluciones: abiertas por subpedido, resueltas desde Marketplace > Disputas y devoluciones, con el reembolso eventual trasladado al monedero del vendedor.
• Analíticas: vista del operador (GMV, tasa de comisión, mejores vendedores) en Marketplace > Analíticas, y estadísticas por vendedor (según el plan) en su panel.

Pestañas del back office

El menú Marketplace agrupa: Vendedores, Pedidos de vendedores, Comisiones y pagos, Facturas de comisión, Reseñas, Disputas y devoluciones, Planes de vendedor, Analíticas y Configuración.

Preguntas frecuentes y resolución de problemas

Los fondos no se liberan a los vendedores

Compruebe que el «Estado que libera el depósito» está definido en la configuración y que los vendedores afectados han completado el onboarding del PSP (monedero creado).

Un producto de vendedor no aparece en la tienda

Un producto permanece oculto hasta su aprobación. Compruebe su estado de validación en la lista de productos del vendedor, o active la aprobación automática.

Tras una actualización, una pantalla de administración da error

Vacíe la caché de PrestaShop (carpeta var/cache) tras la instalación o actualización, y vuelva a cargar el back office.