Module UltimateMarketPlace ES
Módulo UltimateMarketPlace
Presentación
El módulo UltimateMarketPlace es una extensión para Dolibarr ERP/CRM publicada por Atoo-Net.
Proporciona todas las funcionalidades necesarias para publicar un marketplace en línea de un solo vendedor: una plantilla de sitio web lista para usar (catálogo de productos, carrito, proceso de pedido, cuentas de cliente), utilizable con el módulo Sitio Web de Dolibarr, para vender sus propios productos y servicios directamente en línea.
Se trata de una bifurcación (fork) simplificada del módulo Dolibarr «Marketplace» (utilizado para dolistore.com), del que se ha eliminado todo lo específico de la asociación Dolibarr, así como el circuito multivendedor de envío y revisión de módulos por parte de desarrolladores externos.
| Propiedad | Valor |
|---|---|
| Autor | Philippe Grand — Atoo-Net |
| Versión | 1.0 |
| Licencia | GNU GPL v3+ |
| Dolibarr mínimo | v24.0 |
| PHP mínimo | v8.0 |
¿Por qué usar UltimateMarketPlace?
UltimateMarketPlace transforma su instalación de Dolibarr en una tienda en línea autónoma, sin depender de un CMS ni de una plataforma de comercio electrónico de terceros (como PrestaShop, WooCommerce…). El catálogo, los pedidos, las facturas y los clientes permanecen de forma nativa en Dolibarr.
Casos de uso
Venta de productos físicos o desmaterializados
Publique su catálogo de productos o servicios directamente desde las fichas de producto de Dolibarr. El módulo gestiona tanto los bienes físicos (con gastos de envío) como los artículos desmaterializados (descargas, licencias, servicios).
Fidelización de clientes profesionales
Gracias a los descuentos automáticos para «clientes preferentes» (categoría de terceros dedicada), ofrezca una tarifa preferencial negociada a sus mejores clientes, con la posibilidad de excluir determinados productos del descuento.
Promociones comerciales y códigos de descuento
Cree códigos de descuento (porcentaje o importe fijo), limitados en el tiempo o en número de usos, eventualmente reservados a un producto concreto, para dinamizar sus ventas en línea.
Venta adicional (upsell) en el carrito
Proponga automáticamente un producto complementario en el carrito (p. ej. seguro, garantía, ecotasa), calculado como porcentaje del total y limitado a los países que elija.
Pago en línea
Conecte el proceso de compra con los métodos de pago ya configurados en Dolibarr (Stripe, PayPal, transferencia…), ya sea mediante redirección clásica a su back-office o integrado en un frame dentro de la tienda.
Seguimiento de audiencia
Integre Matomo Analytics para seguir la afluencia y el comportamiento de compra en su tienda, sin depender de Google Analytics.
Instalación
Requisitos previos: el módulo necesita que los siguientes módulos de Dolibarr estén activados (se activan automáticamente si es necesario): Terceros, Productos, Servicios, Categorías, Pedidos, Facturas, Banco, Mailing y Sitio Web.
- Descargar el módulo desde DoliStore o clonar el repositorio Git en
htdocs/custom/ultimatemarketplace - Ir a Inicio → Configuración → Módulos/Aplicaciones
- Localizar UltimateMarketPlace en la sección AtooNet
- Activar el módulo haciendo clic en el botón de la columna Activado
Al activarse, el módulo realiza automáticamente varias acciones:
- Creación de un sitio web dedicado (referencia
ultimatemarketplace) con la plantilla "website_template-ultimatemarketplace" importada - Creación de una categoría raíz de productos para los artículos visibles en el marketplace
- Creación de una categoría de terceros para los clientes/prospectos creados desde el sitio de venta
- Adición de 3 campos adicionales de producto: separador "Marketplace", comentario tras el precio (
PriceComment) y mensaje de aviso público (DisclaimerMessage)
Configuración
La configuración del módulo se realiza en Inicio → Configuración → Módulos/Aplicaciones → UltimateMarketPlace, repartida en varias pestañas.
General: productos y terceros
| Constante | Descripción |
|---|---|
ULTIMATEMARKETPLACE_NAME |
Nombre del marketplace |
ULTIMATEMARKETPLACE_EMAIL |
Correo de contacto del marketplace |
ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID |
Categoría raíz de los productos vendidos en el marketplace |
ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS |
Categoría destacada en el bloque central de la página de inicio |
ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID |
Categoría utilizada por el widget "Versión" de la página de inicio |
ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID |
Categoría utilizada por el widget "Promociones" de la página de inicio |
ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE |
Precio mínimo de un producto (si este no es gratuito) |
ULTIMATEMARKETPLACE_DELAY_FOR_NEW |
Antigüedad máxima (en días) para que un producto aparezca en la sección "Novedades" |
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID |
Categoría asignada a todos los prospectos/clientes creados desde el sitio de venta |
Descuentos para clientes preferentes
| Constante | Descripción |
|---|---|
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID |
Categoría de terceros etiquetados como "Preferente", elegibles para el descuento |
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT |
Porcentaje de descuento aplicado a estos terceros |
ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID |
Categoría de productos excluidos de este descuento |
Sitio Web
| Constante | Descripción |
|---|---|
ULTIMATEMARKETPLACE_URL_FOR_LOGO |
URL del logotipo del marketplace |
ULTIMATEMARKETPLACE_THEME_COLOR |
Color principal del tema (botones, banners, elementos destacados) |
ULTIMATEMARKETPLACE_WEBSITE_ID |
Sitio Web de Dolibarr utilizado por el marketplace |
ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE |
Usuario técnico autorizado a ejecutar las acciones del sitio (añadir productos, gestionar terceros, crear pedidos) |
Importante: si cambia el sitio web asociado (ULTIMATEMARKETPLACE_WEBSITE_ID), los usuarios, terceros y pedidos ya creados permanecen vinculados al antiguo sitio y no se migran automáticamente.
Plantillas de correo
Se pueden personalizar tres plantillas de correo de Dolibarr:
- Correo de bienvenida enviado al crear la cuenta de cliente
- Correo de "contraseña olvidada"
- Correo de confirmación de pedido enviado al comprador
Producto adicional en el carrito
Permite añadir automáticamente un producto complementario (seguro, garantía, ecotasa…) al carrito:
| Constante | Descripción |
|---|---|
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID |
Producto adicional a añadir |
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT |
Precio del producto adicional, expresado en % del total del carrito |
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES |
Códigos de país donde se aplica este producto adicional |
Gastos de envío
| Constante | Descripción |
|---|---|
ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT / ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID |
Producto de Dolibarr utilizado para facturar los gastos de envío |
Registro: Google reCAPTCHA
| Constante | Descripción |
|---|---|
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM |
Activa el Captcha de Google en el formulario de registro |
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY |
Clave pública reCAPTCHA proporcionada por Google |
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY |
Clave privada reCAPTCHA (mantener confidencial) |
Pago
| Constante | Descripción |
|---|---|
ULTIMATEMARKETPLACE_BLOCK_SALES |
Bloquea temporalmente las ventas en el marketplace |
ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT |
Cierra automáticamente el pedido tras un pago correcto |
ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD |
Método de pago a utilizar |
Existen dos modos posibles de integración del pago:
- Página separada (por defecto): sin configuración particular, el cliente es redirigido a las páginas de pago públicas de su back-office de Dolibarr. Inconveniente: el dominio del back-office es visible para el cliente.
- Frame (usuarios avanzados): la página de pago del back-office se invoca a través de una URL de la propia tienda del marketplace. Requiere una configuración de proxy en el servidor web del marketplace para redirigir las solicitudes hacia el back-office de Dolibarr. Ventaja: el dominio del back-office permanece oculto.
API
| Constante | Descripción |
|---|---|
ULTIMATEMARKETPLACE_PUBLIC_API_KEY |
Clave pública utilizada para acceder a la API de productos/categorías |
La API expone un flujo XML de los productos y categorías, con los parámetros categorieid, limit, page, search y lang. Se puede configurar un enrutamiento proxy para ocultar la URL real de la API detrás del dominio de la tienda.
Matomo
| Constante | Descripción |
|---|---|
ULTIMATEMARKETPLACE_ENABLE_MATOMO |
Activa Matomo Analytics en el sitio del marketplace |
ULTIMATEMARKETPLACE_MATOMO_SITE_KEY |
Identificador de sitio (Site ID) de Matomo |
ULTIMATEMARKETPLACE_MATOMO_SERVER_URL |
URL completa del servidor Matomo |
Códigos de descuento (cupones)
Una pestaña dedicada Códigos de descuento permite crear códigos de descuento:
- Tipo de descuento: porcentaje o importe fijo sin impuestos
- Número máximo de usos (dejar vacío para uso ilimitado)
- Posible restricción a un producto concreto
- Seguimiento del número de usos ya realizados
El código se verifica al aplicarlo en el carrito: un código inexistente, caducado o ya utilizado por completo es rechazado (mensaje "Este código de descuento no es válido, ha caducado o ya se ha utilizado").
Uso
Tienda en línea (front office)
El sitio generado por el módulo retoma la identidad visual definida en la configuración (logotipo, color principal) y ofrece:
- Un catálogo de productos organizado por categorías, con destacado de novedades y promociones
- Una ficha de producto con precio, comentario libre tras el precio y mensaje de aviso público si están configurados
- Un carrito con aplicación de código de descuento, cálculo automático de los descuentos de "cliente preferente" y adición del eventual producto adicional
- Un proceso de pedido conectado a los métodos de pago configurados en Dolibarr
- Un área de cliente (registro, inicio de sesión, historial de pedidos) protegida por Google reCAPTCHA si está activado
Gestión de las etiquetas de producto
El menú UltimateMarketPlace → Productos sin etiquetas lista los productos/servicios del marketplace que aún no se han asociado a una categoría/etiqueta, para aplicarles de forma masiva una o varias etiquetas (categorías).
Estadísticas
El módulo añade páginas de estadísticas dedicadas al marketplace:
- Estadísticas de facturas y de ventas (agrupación por país/tipo de IVA o por zona/tipo de IVA)
- Estadísticas de clientes (últimos terceros creados, últimos terceros "preferentes")
- Estadísticas de productos/servicios (clasificación por popularidad)
Seguimiento de pedidos y facturas
Dos entradas de menú permiten localizar rápidamente los pedidos y facturas procedentes del marketplace (filtrados por module_source = ultimatemarketplace).
Preguntas frecuentes
El sitio del marketplace no se ha creado automáticamente
Compruebe que el módulo Sitio Web de Dolibarr esté activado. Si el sitio sigue sin existir tras activar el módulo, desactive y vuelva a activar UltimateMarketPlace.
¿Cómo cambio el sitio web utilizado sin perder los pedidos existentes?
No se recomienda: cambiar ULTIMATEMARKETPLACE_WEBSITE_ID no migra los usuarios, terceros y pedidos ya creados al nuevo sitio. Permanecen asociados al sitio antiguo.
¿Puedo limitar el descuento de "cliente preferente" solo a determinados productos?
Sí, configurando ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID con una categoría que agrupe los productos a excluir del descuento.
¿Es obligatorio el pago en frame?
No, es una opción para usuarios avanzados. Por defecto, el pago simplemente redirige a las páginas públicas de pago de su back-office de Dolibarr, sin ninguna configuración de servidor particular.
¿Qué medios de pago son compatibles?
Todos los métodos de pago ya soportados de forma nativa por Dolibarr (Stripe, PayPal, transferencia, etc.), seleccionados mediante ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD.