Guía de conector5 minutos de lectura9 herramientas MCP7 idiomas

Spartoo Marketplace MCP: pedidos y stock

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

HCPor el equipo de HelpCodeActualizado 5 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Spartoo Marketplace

Spartoo Marketplace

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

herramientas

9

Región

INTL

Categoría

E-commerce

Autenticación

API credentials

Env vars requeridas

SPARTOO_HOSTSPARTOO_PARTNER_KEY
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Resumen

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Configuración guiada

Conecta Spartoo Marketplace a Claude, ChatGPT o Copilot en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Spartoo Marketplace con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Prueba a pedir

Prompts de ejemplo para Spartoo Marketplace

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

Spartoo Marketplace · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Spartoo Marketplace, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Spartoo Marketplace

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Configuración

Configurar toma aproximadamente 3 minutos.

  1. Inicia sesión en el back office de Spartoo marketplace y abre Documentación, luego Webservices y cualquier página de servicio, por ejemplo, Exportar pedidos.
  2. La línea Webservice URL nombra la dirección del servicio web de tu sitio Spartoo, por ejemplo, https://sws.spartoo.eu o https://sws.spartoo.it. Coloca la parte antes de /mp/ en SPARTOO_HOST.
  3. En la misma página, la fila partner muestra tu código único cuando estás conectado. Colócalo en SPARTOO_PARTNER_KEY. Si la página no muestra ningún código, pregunta a tu contacto de Spartoo marketplace por el código del servicio web de tu cuenta.

Por dónde empezar: spartoo_list_orders con una fecha de inicio. spartoo_get_order lee un pedido por su id.

Pedidos: un pedido llega en estado 11 (verificado). spartoo_accept_order lo mueve a 2 (en preparación): después de eso, su nombre, dirección y transportista ya no pueden cambiar. spartoo_ship_order lo mueve de 2 a 3 (enviado) con el número de seguimiento del transportista, y Spartoo envía el enlace de seguimiento al cliente. spartoo_cancel_order (estado 41) está instalado apagado: el cliente es reembolsado y no se puede deshacer. Los estados 45 (paquete perdido) y 47 (paquete no entregado) son establecidos por Spartoo.

Devoluciones: spartoo_list_returns y spartoo_get_return. Una devolución contiene un producto. Estados de devolución: 2 esperando ser recibida, 3 rechazada, 4 paquete recibido y devolución aceptada, 5 pagada, 7 reembolso, 14 esperando la etiqueta de devolución prepagada del comerciante. Este conector no acepta ni rechaza devoluciones.

Productos y stock: spartoo_check_product_status indica si un producto está en el sitio (OK), fuera de stock (OS), creado pero aún no en línea (EC) o desconocido (KO), con la razón. spartoo_update_stock establece el stock de un tamaño. Ambos utilizan tus propias referencias: reference_partenaire es el producto en un color, size_reference un tamaño de este. Stock 0 retira el tamaño del sitio.

Notas de campo

  • Los ids de pedidos y devoluciones son códigos cortos como 90D813EA1A2365A8.
  • El filtro de fecha de pedido se escribe YYYY-MM-DD:hh:mm:ss con dos puntos entre el día y la hora. El filtro de fecha de devolución es un timestamp Unix en segundos. Spartoo no documenta la zona horaria.
  • Los precios son números decimales en la moneda del sitio del pedido; products_final_price es el precio unitario con descuento multiplicado por la cantidad.
  • Un pedido para un punto de recogida tiene relay_info en lugar de la dirección de entrega.
  • Los valores de texto llegan como cadenas, incluidos los números. Un pedido o producto en una lista llega como un objeto, varios como un array.

Errores: cada respuesta lleva un código. 1 significa sin error. -1 y -2: falta o es desconocido el código de socio. -3: falta fecha o id. -4: formato de fecha incorrecto. -6 y -28: pedido o devolución no encontrados. -8: número de seguimiento rechazado. -9: el pedido ya tiene ese estado. -19: orden incorrecta de estados (2 solo de 11, 3 solo de 2). -14: producto no encontrado. -16, -18 y -20: stock no cambiado (no es posible, ya tiene ese valor, o el tamaño ya no es válido). -30: pedido demasiado antiguo para enviar, contacta a Spartoo. -428: cuenta desactivada. -429: demasiadas solicitudes en una hora. El conector informa un código negativo como una llamada fallida.

No cubierto: creación y edición de productos, precios y descuentos (pasan a través de un archivo de catálogo XML), albaranes y decisiones de devolución.

Requisitos previos: SPARTOO_HOST, SPARTOO_PARTNER_KEY

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Spartoo Marketplace y pega las variables de entorno listadas bajo Requisitos previos.

Herramientas disponibles

HerramientaQué hace
spartoo_list_ordersLista los pedidos realizados desde una fecha, opcionalmente solo aquellos en un estado. Por pedido bajo root.orders.order: orders_id, customers…
spartoo_get_orderLee un pedido por su id: detalles del cliente y de entrega (o el punto de recogida en relay_info), método de pago, nombre y precio de envío, pedido…
spartoo_accept_orderAcepta un nuevo pedido: lo mueve del estado 11 (verificado) al 2 (en preparación). Después de eso, el nombre del pedido, la dirección de entrega y el transportista pueden…
spartoo_ship_orderMarca un pedido aceptado como enviado con el número de seguimiento del transportista: lo mueve del estado 2 al 3, y Spartoo envía el enlace de seguimiento a…
spartoo_cancel_orderCancela un pedido que no ha sido enviado (estado 41). El cliente no recibe el pedido y es reembolsado por Spartoo; no se puede deshacer…
spartoo_list_returnsLista las devoluciones registradas desde un momento, opcionalmente solo aquellas en un estado. Por devolución bajo root.returns.return: return_id…
spartoo_get_returnLee las devoluciones de un pedido, o una devolución por su id: id de devolución y fecha, id y nombre de estado, razón, id de pedido y el producto devuelto…
spartoo_check_product_statusVerifica si uno de tus productos está en el sitio de Spartoo. Devuelve bajo root.products.product tu referencia, un estado (OK en el sitio…
spartoo_update_stockEstablece el stock de un tamaño de un producto, en tiempo real. Stock 0 retira ese tamaño del sitio; un producto cuyos tamaños son todos 0 se desconecta.…

Ejemplos de consultas

  • "¿Qué pedidos de Spartoo llegaron desde el lunes y aún necesitan ser aceptados?"
  • "Acepta el pedido 90D813EA1A2365A8 y envíalo con el seguimiento de Royal Mail AB123456789GB."
  • "¿Qué devoluciones están esperando ser recibidas?"
  • "¿Está mi producto REF-BOOT-221 en línea, y si no, por qué?"
  • "Establece el stock del tamaño 38 de REF-BOOT-221 en 6."

Próximos pasos

¿Te ha sido útil esta guía?

Conecta Spartoo Marketplace a Claude, ChatGPT o Copilot en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Spartoo Marketplace con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar Spartoo Marketplace MCP con ChatGPT

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Conectar Spartoo Marketplace MCP con Claude

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Spartoo Marketplace MCP con Microsoft Copilot

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Conectar Spartoo Marketplace MCP con Cursor

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Spartoo Marketplace MCP con Gemini CLI

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Spartoo Marketplace MCP con Meta Muse

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.