Gestionar una tienda multimarca implica mucho copiar y pegar. Los totales de comisiones van a una hoja de cálculo, las nuevas solicitudes de vendedores se reenvían a un chat de equipo y los vendedores piden exportaciones para poder actualizar sus propias herramientas de inventario o envío. Cada uno de esos trabajos es una persona moviendo datos manualmente. WC Vendors 2.7.3 cambia eso. Añade una API de mercado de WooCommerce que permite a otras aplicaciones leer y actualizar tu mercado de forma segura: vendedores, pedidos de vendedores, comisiones, tasas de comisión y resúmenes de ventas. También añade webhooks de mercado y un conjunto de habilidades que los asistentes de IA pueden descubrir y ejecutar en tu sitio.
En este artículo, explicaremos qué incluye la nueva API, quién puede usarla y qué puedes crear con ella. Luego, repasaremos la configuración paso a paso, desde la primera credencial hasta tu primer webhook.
¿Qué es la API del mercado de WooCommerce?
Es un conjunto de direcciones web en tu sitio que otro software puede llamar para leer o modificar datos del mercado. Los desarrolladores llaman a estas direcciones puntos de conexión. Todas ellas empiezan por /wp-json/wcvendors/v1 y se incluyen en el plugin gratuito WC Vendors a partir de la versión 2.7.3.
La versión tiene tres partes que trabajan juntas.
Puntos de conexión REST para vendedores, pedidos y comisiones
Los endpoints cubren los registros sobre los que se ejecuta un marketplace. Las aplicaciones pueden listar y leer vendedores, actualizar el perfil de la tienda y los detalles de pago de un vendedor, y aprobar, denegar, activar o desactivar vendedores. También pueden leer registros de comisiones, leer pedidos de vendedores, leer y cambiar las tasas de comisión, y obtener un resumen de ventas para cualquier rango de fechas.
Webhooks para eventos del marketplace
Los webhooks funcionan en la otra dirección. En lugar de que una aplicación pida noticias a tu sitio, tu sitio le dice a la aplicación en el momento en que sucede algo. WC Vendors añade 11 eventos del marketplace a los webhooks de WooCommerce, como una nueva solicitud de vendedor, una aprobación de vendedor, una nueva comisión y un nuevo pedido de vendedor.
Habilidades para agentes de IA
WC Vendors también registra 10 habilidades del marketplace en la API de Habilidades de WordPress. Una habilidad es una acción con nombre con una entrada y salida claras que las herramientas de IA pueden encontrar y ejecutar. Cinco habilidades solo leen datos, como un resumen del marketplace. Las otras cinco realizan cambios, como aprobar un vendedor o un producto pendiente, por lo que una herramienta de IA bien construida pide a una persona que confirme primero.
Esto es lo que permite que un asistente conectado a través del Protocolo de Contexto de Modelo responda preguntas como "¿Qué vendedores están esperando aprobación?" utilizando los datos en vivo de tu marketplace.
Por qué una tienda multicanal necesita su propia API
WooCommerce ya tiene una API REST para productos, pedidos y clientes. Sin embargo, no sabe que existen los vendedores. No puede decirle a una aplicación qué vendedor posee un pedido, cuánta comisión se debe o si un vendedor todavía está esperando la aprobación.
Una API de marketplace de WooCommerce llena ese vacío. Habla en términos de marketplace, por lo que una aplicación pide "comisiones debidas al vendedor 42" en lugar de juntar la respuesta a partir de datos brutos de pedidos.
También está diseñada para una tienda con muchos vendedores. Las credenciales de un vendedor solo llegan a los registros de ese vendedor. Eso significa que puedes permitir que los vendedores conecten sus propias herramientas sin exponer los pedidos, clientes o ganancias de nadie más.
Quién puede usarla y qué puede ver cada usuario
Cada solicitud inicia sesión con una credencial, y lo que se devuelve depende de a quién pertenece esa credencial.
- Propietario de la tienda: Cualquier usuario que pueda administrar WooCommerce, como un Administrador o un Gerente de Tienda, ve todos los vendedores, pedidos, comisiones e informes. Solo el propietario de la tienda puede aprobar, denegar, activar o desactivar vendedores y cambiar las tasas de comisión.
- Vendedor activo: Ve solo sus propios registros. Pedir datos de otro vendedor devuelve un error.
- Vendedor pendiente o inactivo: No obtiene acceso, incluso con una credencial válida.
- Cualquier otra persona: No obtiene acceso.
Los detalles privados se mantienen privados
Los campos de banco y pago solo aparecen cuando una aplicación lee o actualiza un solo vendedor. Las listas de vendedores y los mensajes de webhook nunca los incluyen, por lo que una solicitud no puede obtener todos los detalles bancarios de los vendedores a la vez.
Los detalles del cliente en los pedidos del proveedor siguen la configuración que ya utiliza para el panel del proveedor. Los encontrará en WC Vendors > Ajustes > Capacidades > Pedidos, como se explica en nuestra guía de configuración de capacidades. Si oculta el correo electrónico o el número de teléfono de un cliente a los proveedores allí, la API también lo oculta, incluso cuando el propietario de la tienda la llama.
Límites de frecuencia integrados
Cada usuario puede realizar 100 solicitudes por minuto a cada punto final. Superar el límite devuelve un error de "demasiadas solicitudes" hasta que finalice el minuto. Los límites de frecuencia están desactivados en los sitios configurados en un entorno local o de desarrollo, por lo que no los verá en la mayoría de los sitios de prueba.
Qué puedes construir con él
Aquí hay algunas ideas que utilizan solo lo que viene con WC Vendors 2.7.3.
- Informes de comisiones para su contable: Obtenga todas las comisiones con el estado "pendientes" para un proveedor antes del día del pago. Si aún está configurando sus tarifas, nuestra guía sobre cómo cobrar comisiones a los proveedores cubre las opciones.
- Alertas de solicitud instantáneas: Envíe la webhook "Solicitud de proveedor enviada" a su chat de equipo o CRM. Su equipo puede revisar al solicitante y aprobarlo a través de la API, utilizando el mismo proceso de aprobación de proveedores que la pantalla de administración.
- Integraciones propiedad del proveedor: Un proveedor crea sus propias credenciales y conecta una herramienta de inventario o una aplicación de envío. Esa aplicación ve los pedidos del proveedor y los de nadie más.
- Informes semanales del mercado: Solicite un resumen de ventas de la semana pasada y obtenga el total de pedidos, ingresos brutos, comisiones adeudadas, ganancias del mercado y sus 10 principales proveedores en una sola respuesta.
- Un asistente de IA para la administración del mercado: Pida a un asistente el resumen del mes pasado o la lista de productos que esperan aprobación. Nuestra marca hermana StoreAgent muestra cómo conectar Claude y ChatGPT a su tienda.
Antes de esta versión, cada uno de estos significaba un plugin personalizado o una exportación manual. Con la API del mercado de WooCommerce, son un puñado de solicitudes que cualquier herramienta de automatización o desarrollador puede configurar.
Cómo configurar la API del mercado de WooCommerce
No hay ningún ajuste para activar. Una vez que WC Vendors 2.7.3 esté activo, los puntos finales estarán en vivo y cada solicitud necesitará una credencial. Siga estos pasos para conectar su primera aplicación.
Paso 1: Actualizar WC Vendors y verificar las contraseñas de aplicación
- Actualice WC Vendors a la versión 2.7.3 o posterior. Si WordPress muestra un aviso de "Actualización de WC Vendors requerida" después, haga clic en Ejecutar la actualización.
- Vaya a Usuarios > Perfil en su administrador de WordPress y desplácese hasta Contraseñas de aplicación.
- Si ve un formulario para agregar una nueva contraseña, está listo. Si la sección dice que necesita HTTPS, active HTTPS para su sitio primero.
- Si la sección falta, un plugin de seguridad o tu hosting ha desactivado las contraseñas de aplicación. Puedes volver a activarlas o usar una clave de API REST de WooCommerce en su lugar.
Paso 2: Crea una credencial para el propietario de la tienda
La API acepta dos tipos de credenciales, y ambas inician sesión a través de HTTPS.
- Contraseña de aplicación: En Usuarios > Perfil > Contraseñas de aplicación, introduce un nombre para la aplicación, crea la contraseña y cópiala de inmediato. WordPress solo la muestra una vez. La guía oficial de contraseñas de aplicación explica cómo funcionan.
- Clave de API REST de WooCommerce: Ve a WooCommerce > Ajustes > Avanzado > REST API y añade una clave para tu usuario. Una clave de Lectura solo puede leer datos. Elige Lectura/Escritura si la aplicación necesita modificar algo.
Si planeas usar las funciones de IA, crea una contraseña de aplicación. Las claves de API REST de WooCommerce no funcionan para las funciones.
Paso 3: Permite que los vendedores creen sus propias credenciales
Los vendedores no necesitan que les crees credenciales. Pueden hacerlo desde su propio panel.
- El vendedor abre su panel de vendedor y va a Ajustes, luego a la pestaña API.
- Hacen clic en Generar credencial de API.
- La nueva credencial aparece una vez con un botón de Copiar y la advertencia “Guárdala ahora. Por seguridad, no se volverá a mostrar”.
- Después de eso, la pestaña muestra el nombre de la credencial, la fecha en que se creó, cuándo se usó por última vez y un botón de Regenerar.
Cada vendedor puede tener una credencial a la vez. Regenerarla pide confirmación, luego desactiva la antigua inmediatamente, por lo que cualquier aplicación que la use debe actualizarse. La pestaña de API solo aparece cuando las contraseñas de aplicación están disponibles en tu sitio.
Paso 4: Haz tu primera solicitud
Inicia sesión con el nombre de usuario de WordPress y la contraseña de aplicación. Esta solicitud lista los primeros cinco vendedores:
curl -u "USERNAME:APPLICATION_PASSWORD" \
"https://your-site.com/wp-json/wcvendors/v1/vendors?per_page=5"La respuesta es una lista de vendedores en formato JSON. Dos encabezados de respuesta, X-WP-Total y X-WP-TotalPages, te indican cuántos registros y páginas existen, y puedes solicitar hasta 100 registros por página.
Aquí tienes una solicitud que la aplicación de un vendedor podría hacer para ver las comisiones que no se han pagado todavía:
curl -u "VENDOR_USERNAME:APPLICATION_PASSWORD" \
"https://your-site.com/wp-json/wcvendors/v1/commissions?status=due"Paso 5: Añade un webhook de marketplace
- Ve a WooCommerce > Ajustes > Avanzado > Webhooks y haz clic en Añadir webhook.
- Introduce un nombre y la URL de entrega donde tu aplicación debe recibir el mensaje.
- Abre el desplegable Tema y elige un tema del marketplace, por ejemplo, Vendedor aprobado o Comisión creada.
- Establece Estado en Activo y guarda.
WooCommerce se encarga de la entrega, la firma y los registros de entrega. Su documentación de webhooks explica cómo comprobar que un mensaje realmente provino de tu tienda.
Paso 6: Conecta un agente de IA con habilidades
Las habilidades requieren WordPress 6.9 o posterior y una Contraseña de Aplicación del propietario de la tienda. Para ver qué está disponible, solicita la lista de habilidades en la categoría wcvendors:
curl -u "OWNER_USERNAME:APPLICATION_PASSWORD" \
"https://your-site.com/wp-json/wp-abilities/v1/abilities?category=wcvendors"La mayoría de la gente no llamará a esto manualmente. Una herramienta de IA compatible con MCP lee la misma lista y decide qué habilidad ejecutar. Para un ejemplo práctico de nuestras marcas hermanas, ve cómo Advanced Coupons te permite gestionar cupones con la API de Habilidades de WordPress, o cómo Wholesale Suite ejecuta tareas mayoristas desde Claude o ChatGPT.
Ejecuta tu marketplace desde Claude o ChatGPT con StoreAgent
¿Quieres un asistente de IA que use estas habilidades sin configurar tú mismo un servidor MCP? StoreAgent, nuestro plugin hermano, le da a tu tienda su propia conexión MCP para Claude y ChatGPT. Apruebas la conexión con un inicio de sesión, por lo que no hay claves API que copiar, y eliges acceso de solo lectura o de lectura y escritura.
Las habilidades de tus otros plugins aparecen en la lista de habilidades de StoreAgent agrupadas por plugin, y cada una permanece desactivada hasta que la actives. StoreAgent también incluye un Moderador de Productos de WC Vendors que revisa los productos pendientes de vendedores con IA antes de que los apruebes. MCP funciona en todos los planes de StoreAgent, incluido el gratuito.
¿Quieres conectar un asistente de IA? Nuestra guía paso a paso, Cómo usar habilidades de IA en WC Vendors, te muestra cómo conectar Claude o ChatGPT a tu marketplace a través de StoreAgent. También explica qué hace cada una de las 10 habilidades, quién puede ejecutarlas y cómo solucionar problemas comunes de configuración.
Todos los puntos de conexión, webhooks y habilidades de un vistazo
Puntos de conexión
Todas las rutas comienzan con /wp-json/wcvendors/v1.
| Método | Ruta | Qué hace | Quién puede usarla |
|---|---|---|---|
| GET | /vendors | Listar vendedores | Propietario de la tienda, vendedor (su propio registro) |
| GET, PUT | /vendors/{id} | Leer o actualizar el perfil de la tienda y los detalles de pago de un vendedor | Propietario de la tienda, vendedor (su propio registro) |
| POST | /vendors/{id}/approve, /deny | Decidir sobre una solicitud pendiente | Propietario de la tienda |
| POST | /vendors/{id}/activate, /deactivate | Suspender o restaurar un vendedor | Propietario de la tienda |
| GET, PUT | /vendors/{id}/commission | Leer o establecer la tasa de comisión propia de un vendedor | Propietario de la tienda (los vendedores pueden leer la suya propia) |
| GET, PUT | /settings/commission | Leer o cambiar la tasa de comisión global | Propietario de la tienda |
| GET | /commissions, /commissions/{id} | Leer registros de comisiones | Propietario de la tienda, vendedor (sus propios registros) |
| GET | /orders, /orders/{id} | Leer pedidos de vendedores | Propietario de la tienda, vendedor (sus propios pedidos) |
| GET | /reports/sales | Resumen de ventas para un período de fechas | Propietario de la tienda, vendedor (sus propias ventas) |
Temas de webhooks
- Vendedores: Solicitud de vendedor enviada, Vendedor aprobado, Vendedor denegado, Vendedor activado, Vendedor desactivado, Vendedor actualizado y Vendedor eliminado.
- Comisiones: Comisión creada.
- Pedidos de vendedores: Pedido de vendedor creado, Pedido de vendedor actualizado y Pedido de vendedor eliminado.
Capacidades
- Leer: listar vendedores, obtener un vendedor, listar productos pendientes, obtener configuración de comisiones y obtener un resumen del mercado.
- Escribir: aprobar un vendedor, rechazar un vendedor, actualizar el perfil de la tienda de un vendedor, aprobar un producto y rechazar un producto.
Ninguna capacidad mueve dinero, cambia una tasa de comisión, cambia dónde se paga a un vendedor o elimina un registro. Las capacidades de escritura envían los mismos correos electrónicos que los botones correspondientes en tu administrador de WordPress, y un producto rechazado vuelve al vendedor como borrador con tu motivo adjunto.
Mejores prácticas para una integración segura del mercado
Trata la API de WooCommerce como cualquier otra puerta a tu tienda. Estos hábitos la mantienen segura y confiable.
- Otorga a cada aplicación el mínimo acceso que necesita. Si una aplicación solo lee informes, dale una clave de Lectura en lugar de una clave de Lectura/Escritura.
- Planifica los cambios de credenciales de los vendedores. Un vendedor tiene una credencial, y regenerarla corta todas las aplicaciones que usaban la anterior de inmediato.
- Revisa la configuración del cliente antes de conectar una herramienta de envío o contabilidad. Si los detalles del cliente aparecen vacíos, revisa Capacidades > Pedidos y haz clic en Guardar.
- Conserva tu propia copia de cualquier cosa que puedas necesitar más tarde. Los webhooks de “Vendedor eliminado” y “Pedido de vendedor eliminado” envían solo el ID, porque el registro ya no existe.
- Vigila el estado de los webhooks. WooCommerce no reenvía una entrega fallida y desactiva un webhook después de más de cinco entregas fallidas.
- Conoce qué tipos de comisión necesitan Pro. Sin WC Vendors Pro, la API solo acepta comisiones porcentuales. Las nuevas tasas se aplican a las nuevas comisiones, y los registros existentes no cambian.
- Desactiva lo que no uses. Añadir
define( 'WCV_DISABLE_ABILITIES', true );awp-config.phpelimina las capacidades, ydefine( 'WCV_DISABLE_REST_API', true );elimina toda la API.
Para una lista de verificación más completa, lee nuestra guía de seguridad del marketplace de WooCommerce.
Conclusión
WC Vendors 2.7.3 le da a tu tienda algo que nunca tuvo antes: una forma pública y documentada para que otro software trabaje con vendedores, pedidos y comisiones. La API del marketplace de WooCommerce se encarga de las tareas diarias que solían requerir exportaciones y copiar y pegar, desde la conciliación de comisiones hasta la aprobación de nuevos vendedores.
Fue construido teniendo en cuenta los riesgos de una tienda multi-vendedor. Los vendedores solo ven sus propios datos, los detalles de pago permanecen fuera de las listas y webhooks, y la información del cliente sigue las mismas reglas que tu panel de vendedor. Los webhooks mantienen tus otras herramientas actualizadas sin necesidad de sondeos, y las capacidades permiten que un asistente de IA maneje la administración rutinaria mientras tú mantienes el control de cada cambio.
Empieza poco a poco. Crea una credencial, conecta un webhook y observa cuánto trabajo manual desaparece. Luego, construye a partir de ahí a medida que tu marketplace crezca.
Esto es lo que cubrimos en este artículo:
- ¿Qué es la API del marketplace de WooCommerce?
- ¿Por qué una tienda multi-vendedor necesita su propia API?
- ¿Quién puede usarla y qué puede ver cada usuario?
- ¿Qué puedes construir con ella?
- ¿Cómo configurar la API del marketplace de WooCommerce?
- Cada endpoint, webhook y capacidad de un vistazo
- Mejores prácticas para una integración segura del marketplace
Preguntas frecuentes
¿Necesito WC Vendors Pro para usar la API del mercado de WooCommerce?
No. La API, los webhooks y las habilidades forman parte del plugin gratuito WC Vendors a partir de la versión 2.7.3. Dos cosas dependen de Pro: tipos de comisión distintos del porcentaje y la lista de productos pendientes, que normalmente está vacía a menos que Pro esté configurado para revisar los nuevos productos antes de que se publiquen.
¿Puede un vendedor ver los pedidos o comisiones de otro vendedor?
No. La credencial de un vendedor solo devuelve los registros de ese vendedor. Si la aplicación de un vendedor solicita el pedido o la comisión de otro vendedor, la API responde como si el registro no existiera.
¿Qué pasa con las rutas antiguas wcv-api/v1?
Permanecen en su lugar y siguen funcionando, pero están congelados y no recibirán nuevas funciones. Las nuevas integraciones deben usar las rutas wcvendors/v1 descritas en este artículo.
¿Qué versión de WordPress necesito para las habilidades de IA?
Las capacidades requieren WordPress 6.9 o posterior, porque ahí es donde se agregó la API de Habilidades. Los endpoints REST y los webhooks también funcionan en versiones anteriores compatibles.
¿Puedo desactivar la API?
Sí. Agrega define( ‘WCV_DISABLE_REST_API’, true ); a tu archivo wp-config.php para eliminar cada ruta, tema de webhook y capacidad. Para eliminar solo las capacidades, usa define( ‘WCV_DISABLE_ABILITIES’, true ); en su lugar.
