Marketplace multivendor WooCommerce: arquitectura y plugins

Un marketplace multivendor WooCommerce es una tienda donde muchos vendedores publican productos, un único checkout cobra el dinero y la plataforma se queda con una comisión. WooCommerce no hace esto de serie. Necesita una capa de vendedores, una capa de pagos y un conjunto de reglas de operación, y la mayoría de los marketplaces que fracasan lo hacen por las reglas, no por el código.

Esta guía es para fundadores y responsables de operaciones que quieren saber cómo montar un marketplace con WooCommerce antes de firmar un presupuesto o instalar un plugin. Cubrimos la arquitectura, los tres plugins de vendedores más habituales, comisiones y pagos, la operación diaria, el rendimiento y los pocos puntos donde el código a medida se amortiza.

La respuesta corta: empieza con una solución basada en plugins, diseña primero los pagos y los envíos, y escribe código a medida solo donde el stack de plugins se queda corto. Las capacidades cambian entre versiones, así que consulta la documentación de WooCommerce para ver qué soportan hoy tus versiones.

Cuándo tiene sentido un marketplace multivendor WooCommerce#

Un marketplace es primero un modelo operativo y después software. Captas vendedores, defines reglas, moderas publicaciones, mueves dinero y resuelves disputas entre desconocidos. WooCommerce aporta la tienda, el carrito, el checkout y el motor de pedidos. Todo lo específico del marketplace se añade encima.

Señales de que WooCommerce basta#

WooCommerce es una buena base cuando tu flujo de vendedores sigue el patrón estándar. Los vendedores se registran, publican productos, reciben pedidos, los envían y cobran una parte de la venta. Tu catálogo son bienes físicos, variaciones simples o descargas digitales.

También encaja cuando quieres ser dueño de los datos del cliente, del checkout y del dominio, y cuando tu equipo ya trabaja en WordPress. El contenido, las landings de SEO y la tienda viven en un solo sistema, algo que importa en un marketplace que crece por búsqueda.

Señales de que necesitas desarrollo a medida#

Los problemas empiezan cuando las reglas son tuyas y no del plugin. Una comisión que cambia a la vez por categoría, nivel de vendedor y tamaño del pedido. Listas de precios B2B por vendedor y por comprador. Envío calculado por transportista desde el almacén de cada vendedor. Catálogos de vendedores sincronizados desde su ERP. Aprobaciones que pasan por tu CRM.

Todo esto se puede forzar dentro de un plugin, normalmente con una pila de add-ons que se pelean entre sí en cada actualización. Pasado cierto punto, una pequeña capa a medida sale más barata que los add-ons que reemplaza.

Valida la demanda antes de encargar desarrollo a medida. Diez vendedores reales y unos cientos de pedidos enseñan más que cualquier especificación. El código escrito antes es una apuesta, y las apuestas son caras de mantener.

Por qué Shopify es un modelo distinto#

Shopify está pensado para un comerciante por tienda. Los esquemas multivendedor allí dependen de apps o de una capa headless, cada una con compromisos distintos en pagos y control. Comparamos ambas plataformas en WooCommerce vs Shopify: qué modelo de ecommerce escala mejor. Si quieres un marketplace multivendedor de verdad con tus propias reglas, el código abierto de WooCommerce suele ser el encaje más natural.

Arquitectura de un marketplace multivendor WooCommerce#

No necesitas escribir PHP para juzgar un plugin o un presupuesto. Necesitas entender cuatro cosas: cómo se guardan los vendedores, cómo se asignan los productos, cómo se dividen los pedidos y dónde engancha la lógica. Cuando las ves claras, cualquier propuesta se lee mejor.

Vendedores, productos y roles#

En WordPress, un vendedor es un usuario con un rol. El rol lleva capacidades: crear productos, editar sus propios productos, ver sus propios pedidos y nada más. Cada producto es un post de tipo product y su post_author es el ID de usuario del vendedor. Ese único campo es como un plugin decide quién es dueño de cada publicación.

Los datos del perfil del vendedor, como nombre de tienda, banner y cuenta de cobro, viven en user meta o en tablas propias del plugin, según cuál sea. Dónde viven importa al exportar vendedores, migrar o integrar con un CRM.

Pedido principal y subpedidos por vendedor#

En el checkout, WooCommerce crea un pedido para el cliente. Si el carrito contiene artículos de los vendedores A y B, el plugin del marketplace lo divide en subpedidos por vendedor. Cada uno tiene sus artículos, estado, envío y comisión. El cliente ve un solo pago, cada vendedor ve solo su parte y la plataforma lo ve todo.

Ruta de división del pedido

1. 01Carrito con dos vendedoresProductos de los vendedores A y B
2. 02Pedido principalUn solo pago del cliente
3. 03Subpedidos por vendedorProductos, estado y envío propios
4. 04Los vendedores envíanCada vendedor cumple su parte
5. 05ComisiónSe calcula por subpedido
6. 06Pago con Stripe ConnectTransferencia al vendedor, la plataforma retiene su comisión

Flujo de pedido y pago en un marketplace multivendor WooCommerce, del carrito dividido al pago con Stripe Connect

Esta división es el hecho de diseño más importante del proyecto. Decide cómo funcionan los reembolsos, cómo se cotiza el envío y cuándo se mueve el dinero. Haz la misma pregunta a cada proveedor de plugin y a cada desarrollador: ¿los subpedidos son pedidos reales de WooCommerce o registros en una tabla propia? Los pedidos reales aparecen en informes, emails e integraciones. Las tablas propias necesitan código extra antes de que tu sistema contable las vea.

Dónde vive la lógica del marketplace#

WordPress y WooCommerce exponen hooks, que son acciones y filtros. Los plugins de marketplace se enganchan al guardado de productos, la creación de pedidos, el cálculo de paquetes de envío y los cambios de estado del pedido. El código a medida usa los mismos hooks, y por eso las extensiones pueden ser pequeñas. El Plugin Handbook de WordPress documenta el modelo de hooks.

Una comprobación más de arquitectura: WooCommerce puede guardar los pedidos en tablas dedicadas mediante el almacenamiento de pedidos de alto rendimiento (HPOS) en lugar de las tablas de posts. Confirma que tu plugin de marketplace y cada add-on lo soportan antes de comprometerte. Volvemos sobre el motivo en la sección de rendimiento.

Dokan, WCFM y WC Vendors comparados#

Dokan, WCFM y WC Vendors son los tres plugins que la mayoría de equipos preselecciona. Aquí no listaremos funciones ni precios, porque ambos cambian con cada versión y entre planes gratuitos y de pago. Comparamos la arquitectura que comparten y los puntos donde cada uno tiende a quedarse corto. Verifica cada punto con la documentación actual.

Lo que comparten los tres plugins#

Los tres convierten usuarios en vendedores, les dan un panel en el front-end, les asignan productos, dividen pedidos y calculan comisión. Los tres ofrecen extensiones para pagos, envíos y funciones extra de vendedor. Y los tres se apoyan en los mismos hooks de WooCommerce, así que el modelo de fondo es parecido.

Por eso la elección es menos dramática de lo que sugiere el marketing de cada proveedor. Usa criterios en lugar de listas de funciones:

Dónde se queda corto cada uno#

Son tendencias que vemos, no veredictos. Confírmalas con la versión que planeas usar.

• Dokan tiene un gran ecosistema de add-ons e integraciones. El límite es la compatibilidad: más código de terceros significa más combinaciones que probar en cada actualización.
• WCFM se organiza como una familia de módulos, lo que da una cobertura amplia. El límite es la superficie: muchos módulos que configurar, proteger y mantener sincronizados entre sí.
• WC Vendors es más ligero y está más cerca de un kit para desarrolladores. El límite es que quizá recurras antes al código a medida para paneles, alta de vendedores o informes.

En los tres aparecen los mismos huecos en los bordes: lógica de comisión que depende de varias variables, envío calculado por transportista para cada vendedor, alta de vendedores con verificación de documentos y pagos en países que las pasarelas integradas no cubren.

Cómo elegir en la práctica#

No elijas a partir de un artículo comparativo, incluido este. Haz la misma prueba con los tres, en staging, con tus reglas reales.

1. Instala en staging

   Usa el mismo tema, la misma versión de PHP y HPOS activado, un plugin por copia de staging.

2. Da de alta tres vendedores de prueba

   Dales orígenes de envío, categorías y tarifas de comisión distintos.

3. Haz pedidos divididos

   Compra a dos vendedores en un carrito, luego a tres, y revisa cada subpedido.

4. Reembolsa y paga

   Reembolsa un artículo antes del pago y otro después, ejecuta un pago y concilia las cifras.

5. Puntúa según tus reglas

   Marca cada regla como nativa, add-on o código a medida y compara el esfuerzo total.

Elige el plugin que necesite menos código a medida para tus reglas y se actualice sin romperse. Suele ser una señal más fiable que cualquier recuento de funciones.

Modelos de comisión y pagos a vendedores en WooCommerce#

El dinero es donde los marketplaces se complican. La comisión es aritmética simple. Los pagos a vendedores en WooCommerce son un problema de pagos, contabilidad y cumplimiento. Diseña ambos antes de elegir plugin, porque las respuestas limitan qué plugins son siquiera viables.

Modelos de comisión habituales#

La mayoría de marketplaces empieza con una tarifa fija y pasa a algo más matizado cuando ve sus márgenes por categoría.

Elijas lo que elijas, deja por escrito la base. ¿La comisión se calcula solo sobre el precio del producto o también sobre envío e impuestos? ¿Un cupón reduce la parte del vendedor o la tuya? Estas preguntas causan la mayoría de las disputas de pagos, y es barato resolverlas en papel.

Pagos divididos con Stripe Connect#

Stripe Connect es la vía habitual para los pagos divididos en WooCommerce. Permite que la plataforma cobre un pago y envíe partes a las cuentas conectadas de los vendedores. Stripe documenta tres tipos de cuenta, y la elección define cuánto trabajo y responsabilidad asumes:

• Standard: el vendedor tiene una cuenta completa de Stripe y gestiona la mayor parte de la relación con Stripe. Menos trabajo para ti, menos control.
• Express: Stripe aloja el alta y un panel ligero mientras tú controlas más de la experiencia. Un punto medio habitual.
• Custom: tú construyes el alta y los paneles y asumes la mayor responsabilidad.

Después viene el patrón de cargo. Con destination charges, la plataforma crea el cargo y dirige los fondos a una cuenta conectada. Un carrito con artículos de varios vendedores es otro caso: un pago del cliente debe llegar a varias cuentas. El patrón documentado por Stripe para eso son los cargos y transferencias separados (separate charges and transfers): la plataforma cobra una vez y luego transfiere una parte a cada vendedor. La comisión de la plataforma es simplemente lo que no transfieres.

La disponibilidad depende del país. Verifica la cobertura de Connect para el país de cada vendedor y de cada comprador, sobre todo en Argentina, México, Colombia y Uruguay. En algunos mercados puede que necesites una pasarela local que soporte pagos divididos, así que compruébalo antes de comprometerte con un diseño de pagos.

Reembolsos, disputas e impuestos#

Un reembolso en el subpedido de un vendedor debe revertir la parte correcta. Eso implica ajustar el pedido, revertir o reducir la transferencia al vendedor y corregir el registro de comisión. Los reembolsos parciales multiplican los casos. Prueba cada uno en staging con importes reales antes del lanzamiento.

Las disputas siguen el modelo de cargo. Si el cargo se hace a la plataforma, normalmente es ella quien afronta primero el contracargo y luego lo recupera del vendedor. Muchos marketplaces retienen los fondos hasta confirmar la entrega, o durante un plazo fijo, para mantener esa exposición pequeña.

Las normas fiscales varían por país y región, incluida la forma en que los marketplaces recaudan y declaran en nombre de los vendedores. No damos asesoramiento legal ni fiscal. Incorpora a un asesor antes del lanzamiento y asegúrate de que tu plugin pueda exportar los datos que necesite.

Paneles de vendedor, moderación y envíos#

Esta es la parte del marketplace que tus vendedores y tus administradores tocan cada día. Si es torpe, los vendedores se van en silencio y tu bandeja de soporte se llena. Merece el mismo cuidado que el checkout.

Qué debe hacer un panel de vendedor#

Un vendedor debería poder gestionar su tienda sin pedirte nada. Como mínimo, el panel necesita:

• Creación y edición de productos, con importación masiva por CSV para vendedores con muchos SKU.
• Una lista de pedidos con estados, registro del número de seguimiento y albaranes imprimibles.
• Ganancias, desglose de comisión e historial de pagos, coherentes con lo que ve la plataforma.
• Ajustes de tienda, ajustes de envío y un campo para la política de devoluciones.
• Notificaciones de nuevos pedidos, productos rechazados y pagos, además de una forma de contactarte.

Los vendedores nunca deben ver pedidos, clientes ni productos de otros vendedores. Prueba ese límite con dos cuentas, porque las fugas de permisos son el error más dañino en un marketplace.

Moderación de productos y vendedores#

La moderación es primero política y después herramienta. Decide qué activa una revisión: un vendedor nuevo, un producto nuevo, un cambio de precio en un producto publicado o un cambio de imágenes. Decide quién revisa, con qué rapidez y qué pasa en un rechazo. Un vendedor cuyo producto lleva una semana en cola no se quedará.

Suelen funcionar dos capas. Aprobación del vendedor en el registro, con documentos de identidad o de empresa donde tu mercado lo exija. Después, aprobación de productos para vendedores nuevos, más relajada para los de confianza. La mayoría de plugins ofrece una versión básica, y la sección de huecos a medida muestra una pequeña extensión para el resto.

Envío por vendedor en el checkout#

El envío por vendedor es la parte más difícil del checkout de un marketplace. WooCommerce divide un carrito en paquetes de envío, y en un marketplace los artículos de cada vendedor forman su propio paquete. Cada paquete necesita sus propias tarifas, desde el origen de ese vendedor y bajo sus reglas.

Los módulos de envío de los plugins suelen cubrir tarifas fijas, por producto y por zonas. Las tarifas calculadas por transportista para cada vendedor, con la dirección y las credenciales de cada uno, a menudo requieren desarrollo a medida. Además, el cliente ve varias líneas de envío en un solo checkout, así que la interfaz debe explicar por qué. Decide pronto si quieres plazos de entrega por vendedor y umbrales de envío gratuito por vendedor, porque ambos afectan al diseño del carrito.

Rendimiento y escala con muchos vendedores#

Un marketplace es una tienda WooCommerce más pesada que una tienda normal. Más productos, más pedidos, más usuarios y más trabajo en segundo plano llegan a la vez. La buena noticia es que las causas son conocidas y tienen arreglo.

Dónde se ralentizan los marketplaces#

No es un problema de número de vendedores. Es un problema de consultas. Los vendedores traen catálogos, y los catálogos traen filas. Cada producto y cada variación es un post con muchas filas de meta, así que la tabla wp_postmeta crece rápido, y los filtros construidos sobre meta queries se vuelven lentos con ella. Las listas de administración de productos y pedidos filtradas por vendedor son un segundo punto crítico. Un tercero es el trabajo hecho al crear el pedido, como el cálculo de comisión, los emails y los registros de pago.

El HPOS de WooCommerce saca los pedidos de las tablas de posts a tablas dedicadas, lo que alivia parte de esa carga. La documentación de WooCommerce explica cómo activarlo y comprobar la compatibilidad de las extensiones. El hosting también importa: los PHP workers y los recursos de base de datos deben ajustarse al tráfico. Nuestra página de la plataforma WordPress describe cómo gestionamos hosting y mantenimiento en estos proyectos.

Búsqueda, caché y tareas en segundo plano#

Tres cambios eliminan la mayor parte de la carga.

• Una caché de objetos persistente como Redis o Memcached evita que las lecturas repetidas de base de datos lleguen a la petición.
• Un índice de búsqueda externo atiende la búsqueda de productos y el filtrado por facetas de vendedor, categoría y precio, en lugar de lentas meta queries.
• Action Scheduler, que viene con WooCommerce, mueve pagos, importaciones y lotes de notificaciones a tareas en segundo plano.

Ruta de escalado

1. 01NavegadorCompradores y vendedores envían solicitudes
2. 02CDN y caché de páginasLas páginas en caché responden sin PHP
   • CDN
   • Caché de páginas
3. 03WordPress y WooCommerceEjecuta PHP, consultas y lógica de pedidos
   • Plugin de marketplace
   • HPOS
   • Action Scheduler
   • Índice de búsqueda
   • Cola en segundo plano
4. 04Caché de objetosLas lecturas repetidas evitan la base de datos
   • Redis
   • Memcached
5. 05Base de datosAquí solo llegan las consultas sin caché
   • Tablas de pedidos
   • wp_postmeta

Ruta de escala por capas que muestra dónde cada capa quita carga a medida que crecen vendedores y productos del marketplace

La caché de página ayuda en las páginas de catálogo y de tienda de vendedor. Debe omitir el carrito, el checkout y las páginas de cuenta, que son personales. Empieza por las capas que quitan más carga con menos cambios y añade la siguiente cuando las mediciones lo indiquen.

Pruebas antes de que lleguen los vendedores#

No esperes a que los vendedores reales encuentren los límites. Monta una copia de staging con cifras realistas, por ejemplo 200 vendedores y 50.000 SKU si ahí esperas estar dentro de un año, y haz pruebas de carga sobre los recorridos que importan: checkout con carrito dividido, listas del panel de vendedor, búsqueda y un lote de pagos. Es un método, no un benchmark, así que usa tus propias cifras y tu propio hosting.

Repite la prueba tras cada actualización importante de un plugin. Un marketplace que era rápido al lanzarse puede ralentizarse cuando un add-on cambia sus consultas.

Dónde el desarrollo de plugins a medida cubre los huecos#

Un stack de plugins te lleva la mayor parte del camino. El código a medida se justifica donde tus reglas difieren de las que trae el plugin. La clave es mantenerlo pequeño, separado y basado en hooks, para que las actualizaciones de WooCommerce y del plugin de vendedores no lo rompan.

Huecos que justifican código a medida#

Estos son los huecos que vemos con más frecuencia:

• Lógica de comisión que depende a la vez de nivel, categoría, volumen o promociones.
• Tarifas de envío calculadas por transportista para cada vendedor.
• Alta de vendedores con verificación de documentos y flujos de aprobación.
• Sincronización de catálogo y pedidos con el ERP o CRM del vendedor o el tuyo.
• Pagos mediante una pasarela local donde Stripe Connect no está disponible.
• Informes que tu equipo de finanzas pueda conciliar.

El servicio de desarrollo de plugins WordPress a medida existe para este tipo de extensión acotada y bien definida. Para costes y proceso en general, consulta nuestra guía de desarrollo de plugins WordPress a medida.

Ejemplo: retener productos para revisión#

Muchos plugins de vendedores tienen un ajuste básico de moderación, así que revisa primero el tuyo. Si necesitas una regla propia, como que los vendedores de confianza se salten la revisión, un pequeño filtro lo resuelve. Este fuerza los productos de vendedores al estado pending salvo que el vendedor tenga una capacidad personalizada.

<?php
// Hold products published by vendors until an admin approves them.
add_filter( 'wp_insert_post_data', function ( array $data ): array {
  // Only products about to go live; trash, draft and auto-draft pass through.
  if ( 'product' !== $data['post_type'] || ! in_array( $data['post_status'], array( 'publish', 'future' ), true ) ) {
    return $data;
  }
  $user = wp_get_current_user();
  // Role slug depends on the marketplace plugin (for example 'vendor' or 'seller').
  $is_vendor = in_array( 'vendor', (array) $user->roles, true );
  // Trusted vendors get this custom capability and skip review.
  if ( $is_vendor && ! user_can( $user, 'publish_without_review' ) ) {
    $data['post_status'] = 'pending';
  }
  return $data;
} );

Un administrador aprueba el producto con la acción normal de Publicar, porque los administradores no tienen el rol de vendedor y pasan directamente. Los roles de vendedor suelen tener publish_productspor eso el filtro comprueba una capacidad aparte. Concede publish_without_review a un rol o a un usuario concreto cuando un vendedor se gane la confianza.

Cómo mantener el código a medida#

Pon el código en su propio plugin, nunca en el tema ni en un plugin de vendedores. Usa hooks, nunca ediciones en archivos ajenos. Pon prefijo a cada función y capacidad, guarda el código en control de versiones y pásalo por staging antes de cada actualización de WooCommerce o del plugin del marketplace. Declara la compatibilidad con HPOS si tocas pedidos.

Documenta qué hace cada pieza y por qué existe. Dentro de un año, quien la lea quizá no sea quien la escribió.

Por dónde empezar#

Antes de hablar con cualquier desarrollador o instalar cualquier plugin, responde a una lista corta de preguntas. Convierten una idea difusa en un alcance que se puede presupuestar y probar.

• Define tus tipos de vendedor: particulares, pequeñas empresas o proveedores B2B
• Escribe las reglas de comisión, incluida la base y cómo se reparten los cupones
• Elige el calendario de pagos y los países que debes cubrir
• Decide el modelo de envío: fijo, por producto, por zonas o calculado por transportista para cada vendedor
• Fija la política de moderación para vendedores y para productos
• Estima el volumen de vendedores y SKU del primer año
• Lista los sistemas que deben integrarse: ERP, CRM y contabilidad
• Nombra quién se encarga del soporte, las disputas y la relación con vendedores

Después haz un piloto. Lanza con un grupo pequeño de vendedores reales, una configuración basada en plugins y las reglas que dejaste por escrito. Observa dónde se atascan los vendedores, dónde los pagos requieren trabajo manual y dónde el checkout confunde a los compradores. Esos hallazgos te dicen exactamente dónde se justifica el código a medida.

Si quieres una segunda opinión sobre el alcance, contáctanos y trae tu lista. Los equipos de España y Latinoamérica también pueden conocer nuestro servicio de desarrollo marketplace WooCommerce, que cubre este mismo trabajo en español.

Preguntas frecuentes#