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.
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.
- 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.
- La línea Webservice URL nombra la dirección del servicio web de tu sitio Spartoo, por ejemplo,
https://sws.spartoo.euohttps://sws.spartoo.it. Coloca la parte antes de/mp/enSPARTOO_HOST. - En la misma página, la fila
partnermuestra tu código único cuando estás conectado. Colócalo enSPARTOO_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:sscon 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_pricees el precio unitario con descuento multiplicado por la cantidad. - Un pedido para un punto de recogida tiene
relay_infoen 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
| Herramienta | Qué hace |
|---|---|
spartoo_list_orders | Lista los pedidos realizados desde una fecha, opcionalmente solo aquellos en un estado. Por pedido bajo root.orders.order: orders_id, customers… |
spartoo_get_order | Lee 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_order | Acepta 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_order | Marca 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_order | Cancela 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_returns | Lista las devoluciones registradas desde un momento, opcionalmente solo aquellas en un estado. Por devolución bajo root.returns.return: return_id… |
spartoo_get_return | Lee 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_status | Verifica 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_stock | Establece 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?