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 Microsoft 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 Microsoft Copilot. 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.
💡 ¿No tienes 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 + 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.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
SPARTOO_HOST, SPARTOO_PARTNER_KEY
Paso 1 — Obtener credenciales
La configuración tarda 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 has iniciado sesión. 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.
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 la fecha o el 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 (se gestionan a través de un archivo de catálogo XML), albaranes y decisiones de devolución.
Paso 2 — Instalar el adaptador
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
Paso 3 — Añadir el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Spartoo Marketplace. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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) a 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 a 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 indicaciones
- "¿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 a 6."
Preguntas frecuentes
¿De dónde proviene el código de socio? En el back office de Spartoo marketplace, Documentación, Webservices, cualquier página de servicio: la fila partner muestra tu código y la línea Webservice URL nombra la dirección de tu sitio. Si no se muestra ningún código, pregunta a tu contacto de Spartoo marketplace.
¿Qué cubre y qué no? Pedidos con detalles del cliente y de entrega, aceptación y envío con un número de seguimiento, devoluciones, estado del producto y stock por tamaño. No acepta ni rechaza devoluciones. Para buscar en el catálogo de Spartoo como comprador, utiliza el conector Spartoo Shop.
¿Qué herramientas se instalan apagadas? spartoo_cancel_order, porque una cancelación reembolsa al cliente y no se puede deshacer. Actívala en la página del conector solo si la IA debe usarla.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?