Module UltimateMarketPlace ES - Revision history

Grandoc at 08:50, 12 October 2026

2026-10-12T08:50:42Z

@@ Line 20: / Line 20: @@
 |Autor||Philippe Grand — Atoo-Net
 |-
-|Versión||24.0.0
+|Versión||24.0.1
 |-
 |Licencia||GNU GPL v3+
@@ Line 77: / Line 77: @@
 El módulo no declara ningún permiso propio: las páginas de administración están reservadas a los administradores de Dolibarr, y las páginas de la tienda utilizan su propia sesión de cliente.
 ==Configuración==
@@ Line 308: / Line 343: @@
 <code>robots.txt</code>, <code>sitemap.xml</code> y <code>llms.txt</code> se regeneran automáticamente al activar el módulo, al abrir la pestaña Configuraciones y tras un restablecimiento de la plantilla. Una vez activadas las URLs simplificadas, las antiguas URLs siguen siendo válidas durante la transición.
 ==Novedades de la versión 24.0.0==
@@ Line 330: / Line 369: @@
 ==FAQ==

Grandoc at 20:36, 6 October 2026

2026-10-06T20:36:40Z

Show changes

Grandoc: /* Otros idiomas */

2026-07-10T10:09:55Z

Otros idiomas

← Older revision		Revision as of 10:09, 10 July 2026
Line 283:		Line 283:
	==Otros idiomas==		==Otros idiomas==

			* [[Module_UltimateMarketPlace_FR\|Documentation en français du module UltimateMarketPlace]]
	* [[Module_UltimateMarketPlace_EN\|English documentation for the UltimateMarketPlace module]]		* [[Module_UltimateMarketPlace_EN\|English documentation for the UltimateMarketPlace module]]
	* [[Module_UltimateMarketPlace_DE\|Deutsche Dokumentation für das Modul UltimateMarketPlace]]		* [[Module_UltimateMarketPlace_DE\|Deutsche Dokumentation für das Modul UltimateMarketPlace]]
			* [[Module_UltimateMarketPlace_IT\|Documentazione in italiano del modulo UltimateMarketPlace]]

			[[fr:Module_UltimateMarketPlace_FR]]
	[[en:Module_UltimateMarketPlace_EN]]		[[en:Module_UltimateMarketPlace_EN]]
	[[de:Module_UltimateMarketPlace_DE]]		[[de:Module_UltimateMarketPlace_DE]]
			[[it:Module_UltimateMarketPlace_IT]]

Grandoc: Created page with "Category:Modules Category:AtooNet =Módulo UltimateMarketPlace= ==Presentación== El módulo '''UltimateMarketPlace''' es una extensión para Dolibarr ERP/CRM publi..."

2026-07-10T10:03:58Z

Created page with "Category:Modules Category:AtooNet =Módulo UltimateMarketPlace= ==Presentación== El módulo '''UltimateMarketPlace''' es una extensión para Dolibarr ERP/CRM publi..."

New page

[[Category:Modules]]
[[Category:AtooNet]]

=Módulo UltimateMarketPlace=

==Presentación==

El módulo '''UltimateMarketPlace''' es una extensión para Dolibarr ERP/CRM publicada por [https://www.atoo-net.com 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.

{| class="wikitable"
|-
!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 [https://www.dolistore.com DoliStore] o clonar el repositorio Git en <code>htdocs/custom/ultimatemarketplace</code>
#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''

[[File:ultimatemarketplace_activation.png|center|thumb|800px|Activación del módulo UltimateMarketPlace en la sección AtooNet]]

Al activarse, el módulo realiza automáticamente varias acciones:

*Creación de un '''sitio web dedicado''' (referencia <code>ultimatemarketplace</code>) 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 (<code>PriceComment</code>) y mensaje de aviso público (<code>DisclaimerMessage</code>)

==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===

{| class="wikitable"
|-
!Constante!!Descripción
|-
|<code>ULTIMATEMARKETPLACE_NAME</code>||Nombre del marketplace
|-
|<code>ULTIMATEMARKETPLACE_EMAIL</code>||Correo de contacto del marketplace
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID</code>||Categoría raíz de los productos vendidos en el marketplace
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS</code>||Categoría destacada en el bloque central de la página de inicio
|-
|<code>ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID</code>||Categoría utilizada por el widget "Versión" de la página de inicio
|-
|<code>ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID</code>||Categoría utilizada por el widget "Promociones" de la página de inicio
|-
|<code>ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE</code>||Precio mínimo de un producto (si este no es gratuito)
|-
|<code>ULTIMATEMARKETPLACE_DELAY_FOR_NEW</code>||Antigüedad máxima (en días) para que un producto aparezca en la sección "Novedades"
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID</code>||Categoría asignada a todos los prospectos/clientes creados desde el sitio de venta
|}

===Descuentos para clientes preferentes===

{| class="wikitable"
|-
!Constante!!Descripción
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID</code>||Categoría de terceros etiquetados como "Preferente", elegibles para el descuento
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT</code>||Porcentaje de descuento aplicado a estos terceros
|-
|<code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code>||Categoría de productos excluidos de este descuento
|}

===Sitio Web===

{| class="wikitable"
|-
!Constante!!Descripción
|-
|<code>ULTIMATEMARKETPLACE_URL_FOR_LOGO</code>||URL del logotipo del marketplace
|-
|<code>ULTIMATEMARKETPLACE_THEME_COLOR</code>||Color principal del tema (botones, banners, elementos destacados)
|-
|<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>||Sitio Web de Dolibarr utilizado por el marketplace
|-
|<code>ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE</code>||Usuario técnico autorizado a ejecutar las acciones del sitio (añadir productos, gestionar terceros, crear pedidos)
|}

'''Importante''': si cambia el sitio web asociado (<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>), 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:

{| class="wikitable"
|-
!Constante!!Descripción
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID</code>||Producto adicional a añadir
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT</code>||Precio del producto adicional, expresado en % del total del carrito
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES</code>||Códigos de país donde se aplica este producto adicional
|}

===Gastos de envío===

{| class="wikitable"
|-
!Constante!!Descripción
|-
|<code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT</code> / <code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID</code>||Producto de Dolibarr utilizado para facturar los gastos de envío
|}

===Registro: Google reCAPTCHA===

{| class="wikitable"
|-
!Constante!!Descripción
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM</code>||Activa el Captcha de Google en el formulario de registro
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY</code>||Clave pública reCAPTCHA proporcionada por Google
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY</code>||Clave privada reCAPTCHA (mantener confidencial)
|}

===Pago===

{| class="wikitable"
|-
!Constante!!Descripción
|-
|<code>ULTIMATEMARKETPLACE_BLOCK_SALES</code>||Bloquea temporalmente las ventas en el marketplace
|-
|<code>ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT</code>||Cierra automáticamente el pedido tras un pago correcto
|-
|<code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>||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===

{| class="wikitable"
|-
!Constante!!Descripción
|-
|<code>ULTIMATEMARKETPLACE_PUBLIC_API_KEY</code>||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 <code>categorieid</code>, <code>limit</code>, <code>page</code>, <code>search</code> y <code>lang</code>. Se puede configurar un enrutamiento proxy para ocultar la URL real de la API detrás del dominio de la tienda.

===Matomo===

{| class="wikitable"
|-
!Constante!!Descripción
|-
|<code>ULTIMATEMARKETPLACE_ENABLE_MATOMO</code>||Activa Matomo Analytics en el sitio del marketplace
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SITE_KEY</code>||Identificador de sitio (Site ID) de Matomo
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SERVER_URL</code>||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

[[File:ultimatemarketplace_coupons.png|center|thumb|800px|Pestaña de administración de códigos de descuento]]

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

[[File:ultimatemarketplace_home.png|center|thumb|800px|Página de inicio de la tienda generada por UltimateMarketPlace]]

===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 <code>module_source = ultimatemarketplace</code>).

==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 <code>ULTIMATEMARKETPLACE_WEBSITE_ID</code> 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 <code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code> 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 <code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>.

==Véase también==

*[https://www.atoo-net.com Atoo-Net — Editor del módulo]
*[https://framagit.org/grandoc/ultimatemarketplace Repositorio del módulo]
*[https://wiki.dolibarr.org/index.php/Module_Website Documentación del módulo Sitio Web de Dolibarr]

==Otros idiomas==

* [[Module_UltimateMarketPlace_EN|English documentation for the UltimateMarketPlace module]]
* [[Module_UltimateMarketPlace_DE|Deutsche Dokumentation für das Modul UltimateMarketPlace]]

[[en:Module_UltimateMarketPlace_EN]]
[[de:Module_UltimateMarketPlace_DE]]