Resumen
API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.
Configuración guiada
Conecta Skroutz a Claude en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Skroutz con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Prueba a pedir
Prompts de ejemplo para Skroutz
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 → Skroutz, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Skroutz + Claude
API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.
Requisitos previos
Consulta las instrucciones de configuración completas 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:
SKROUTZ_API_TOKEN
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 3 minutos.
- Inicia sesión en el panel de comerciantes de Skroutz y abre Servicios, Skroutz Marketplace (la página de configuración de Smart Cart).
- Genera el token de API y pégalo en
SKROUTZ_API_TOKEN. Una tienda tiene un token activo: generar uno nuevo finaliza el anterior, por lo que un token utilizado por otra integración deja de funcionar allí. - Opcional, para actualizaciones masivas de precios y stock: en Productos, Actualizaciones de Feed genera el token de API de Productos y pégalo en
SKROUTZ_PRODUCTS_TOKEN. - Opcional, para órdenes CPS de tu propia tienda web: en Παραγγελίες καταστήματος, Αυτόματη διαχείριση (órdenes de tienda, gestión automática) genera el token CPS y pégalo en
SKROUTZ_CPS_TOKEN.
Cada llamada envía el token como Authorization: Bearer con el tipo de medio application/vnd.skroutz+json; version=3.0. La verificación de instalación lee el pedido de demostración DEMO-OPEN, lo que prueba el token del mercado sin tocar datos reales.
Dónde empezar: la API no tiene lista de pedidos. Los pedidos llegan a una tienda a través del webhook de pedidos, el panel de comerciantes y los correos electrónicos de pedidos, así que pide al usuario el código del pedido (como 191128-1234567) y léelo con skroutz_get_order. Los códigos de demostración DEMO-OPEN, DEMO-ACCEPTED, DEMO-REJECTED, DEMO-INVOICE, DEMO-FBS, DEMO-STORE-PICKUP y DEMO-RETURN son seguros para leer, aceptar y rechazar para pruebas: nada se almacena.
Pedidos: un pedido abierto lleva accept_options y reject_options y debe ser gestionado antes de expires_at. Acepta con skroutz_accept_order, enviando un id de ubicación de recogida y el id de una de las ventanas de recogida de esa ubicación (las ventanas difieren por ubicación). Skroutz luego reserva el mensajero y el PDF del voucher aparece en courier_voucher. Los pedidos exprés son aceptados automáticamente por Skroutz. skroutz_reject_order está instalado apagado: una rechazo no se puede deshacer y cuenta en contra de la tienda. Para cambiar la recogida de un pedido aceptado, léelo con action_options 1 justo antes y usa skroutz_reschedule_order_pickup (una fecha de reschedule_options) o skroutz_relocate_order_pickup (un id de relocate_options); las listas se reducen con el tiempo. skroutz_request_preorder_voucher crea el voucher de un pedido anticipado aceptado temprano.
Marcar como listo: cuando un pedido muestra set_as_ready_required verdadero, Skroutz Last Mile solo lo recoge después de skroutz_set_order_ready; descargar el voucher ya no lo marca como listo (desde el 30 de marzo de 2026). Marcarlo temprano puede mover la recogida a una ventana anterior. skroutz_set_order_not_ready lo deshace antes de la recogida. Las tiendas con set_as_ready_required falso no lo necesitan.
Envío y documentos: skroutz_update_tracking_details envía el mensajero y el código de seguimiento de cada envío de un pedido Fulfilled by Merchant (FBM) solamente. skroutz_upload_invoice y skroutz_upload_credit_invoice toman un enlace público al PDF, PNG o JPG (máximo 7 MB); el conector lo descarga y sube el archivo, uno por pedido, reemplazando una carga anterior.
Devoluciones: skroutz_get_return lee una devolución por su código (como R-111111-1111111, desde el webhook de devoluciones o el panel de comerciantes; las returns de un pedido solo dan un uuid y códigos de seguimiento). skroutz_handle_return (decidir una devolución esperando revisión antes de review.expires_at, incluyendo enviar una parte faltante a costa de la tienda) y skroutz_submit_service_inspection (informe técnico sobre un artículo defectuoso, como un enlace de archivo) están instalados apagados, porque conducen a reembolsos, reemplazos o envíos pagados. skroutz_file_compensation_request también está apagado: reclama dinero a Skroutz por artículos devueltos, y a través de este conector solo por razones que no necesitan fotos.
Fulfilled by Skroutz: skroutz_list_fbs_products (stock en almacenes de Skroutz), skroutz_list_fbs_purchase_orders, skroutz_list_fbs_purchase_order_items, skroutz_list_fbs_suppliers, skroutz_create_fbs_supplier y skroutz_update_fbs_supplier. skroutz_create_fbs_purchase_order está apagado, porque las tarifas de almacén derivan de ello. Las listas están paginadas con page y vienen con meta.pagination (100 filas por página). Una tienda sin FBS recibe un 401 aquí.
API de Productos (necesita SKROUTZ_PRODUCTS_TOKEN): skroutz_validate_product_updates verifica un lote sin cambiar nada; skroutz_update_products (apagado) actualiza disponibilidad, precio y cantidad de hasta 500 productos existentes y variaciones, de forma asincrónica; skroutz_get_product_update_status informa éxito, no_change o fallo por producto. Los precios aquí son centavos de euro enteros (1050 son 10.50 EUR), mientras que los montos de pedidos son euros decimales. No crea productos: estos provienen del feed XML. Un 422 que dice que el XML está siendo escaneado significa que debes intentar de nuevo más tarde.
Órdenes CPS (necesita SKROUTZ_CPS_TOKEN): skroutz_get_cps_order lee una venta de tu propia tienda web por tu propio número de pedido, con ingresos y comisión; skroutz_reject_cps_order (apagado) la rechaza para que no se cobre comisión.
Notas de campo: los tiempos son ISO 8601 con el desfase de Atenas (+02:00 en invierno, +03:00 en verano). Etiquetas como ventanas de recogida, razones de rechazo y estados CPS vienen en griego. Los ids de línea son cadenas cortas (l39vKqxqwe); shop_uid es tu propio id de producto. Los errores llevan un array errors con un code y messages: 422 order_status significa que el pedido no está en un estado para esa acción. Un token de mercado incorrecto o reemplazado responde 403. El conector nunca mueve dinero: rechazos, decisiones de devolución, reclamaciones de compensación, órdenes de compra y actualizaciones masivas de productos están instalados apagados para que un administrador los active deliberadamente.
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 Claude
La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector, y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala dondequiera que esta guía muestreYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.
- En Claude, abre Plugins (en algunos planes aún Customize) → Connectors.
- Haz clic en + Add, luego en Add custom connector.
- Ingresa un nombre, por ejemplo
Skroutz, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, luego haz clic en Continue, deja los ajustes detectados y vuelve a hacer clic en Continue. - Elige Sign in now, haz clic en Add e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas a continuación aparecen en tu chat: comienza a escribir indicaciones.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
skroutz_get_order | Lee un pedido de Skroutz Marketplace (Smart Cart) por su código: estado (abierto, aceptado, rechazado, cancelado, expirado, despachado, entregado… |
skroutz_accept_order | Acepta un pedido abierto: Skroutz luego reserva el mensajero y emite el voucher (llega en el pedido como courier_voucher). Envía un… |
skroutz_reject_order | Rechaza un pedido abierto, ya sea por línea de artículo con un id de razón de reject_options (con available_quantity cuando la razón tiene… |
skroutz_reschedule_order_pickup | Mueve la recogida del mensajero de un pedido aceptado a otra fecha. Lee el pedido con action_options 1 justo antes y envía uno de sus… |
skroutz_relocate_order_pickup | Mueve la recogida del mensajero de un pedido aceptado a otra de las ubicaciones de recogida de la tienda, manteniendo la fecha y el horario de recogida. El mensajero es… |
skroutz_set_order_ready | Marca un pedido aceptado como empaquetado y listo para despachar (Marcar como listo). Requerido para tiendas cuyos pedidos muestran set_as_ready_required verdadero… |
skroutz_set_order_not_ready | Deshace Marcar como listo en un pedido aceptado que el mensajero aún no ha recogido. Skroutz intenta mover la recogida de vuelta a la fecha original.… |
skroutz_update_tracking_details | Envía el mensajero y el código de seguimiento de cada envío de un pedido Fulfilled by Merchant (FBM), para que el cliente pueda seguirlo. Solo para FBM… |
skroutz_request_preorder_voucher | Solicita el voucher del mensajero de un pedido anticipado aceptado ahora, cuando el producto llegó antes de la fecha de envío planificada (el panel de Crear… |
skroutz_upload_invoice | Sube el recibo o factura de un pedido desde un enlace al archivo (PDF, PNG o JPG, máximo 7 MB). Un archivo por pedido: una nueva carga… |
skroutz_upload_credit_invoice | Sube la factura de crédito de un pedido que fue cancelado, devuelto, parcialmente devuelto o devuelto al remitente después de su recibo o factura… |
skroutz_file_compensation_request | Pide a Skroutz que compense a la tienda por artículos de línea devueltos, enviados como JSON sin fotos, solo por razones que no necesitan ninguna… |
skroutz_get_return | Lee una devolución por su código: estado (pending_merchant_review, returning, pending_physical_review, pending_service_inspection, returned… |
skroutz_handle_return | Decide una devolución en estado pending_merchant_review con una de sus handle_options: aprobar, un rechazo como not_faulty (con comentario cuando… |
skroutz_submit_service_inspection | Envía el resultado de la inspección técnica de un artículo defectuoso devuelto (devolución en estado pending_service_inspection): el id del artículo, uno de sus… |
skroutz_list_fbs_products | Lista los productos Fulfilled by Skroutz (FBS) de la tienda almacenados en los almacenes de Skroutz: id, shop_uid (tu id de producto), activo (comprable desde el… |
skroutz_list_fbs_purchase_orders | Lista las órdenes de compra Fulfilled by Skroutz de la tienda (stock enviado a los almacenes de Skroutz): código, created_at, expected_date y received_at.… |
skroutz_list_fbs_purchase_order_items | Lista los artículos de línea de una orden de compra Fulfilled by Skroutz: product_id, shop_uid, activo, expected_quantity y actual_quantity… |
skroutz_create_fbs_purchase_order | Anuncia una nueva orden de compra Fulfilled by Skroutz: el stock que entregarás a un almacén de Skroutz, con la fecha esperada, el proveedor… |
skroutz_list_fbs_suppliers | Lista los proveedores Fulfilled by Skroutz de la tienda: id (úsalo para órdenes de compra), código, nombre, dirección, ciudad, área, código postal, teléfono… |
skroutz_create_fbs_supplier | Añade un proveedor Fulfilled by Skroutz (que envía stock al almacén de Skroutz por ti) con un código único, nombre, dirección, ciudad, área, código postal… |
skroutz_update_fbs_supplier | Cambia campos de un proveedor Fulfilled by Skroutz; solo los campos que envíes cambian. Responde success: true |
skroutz_validate_product_updates | Verifica un lote de actualizaciones de productos (disponibilidad, precio en centavos, cantidad, variaciones) sin cambiar nada: Skroutz ejecuta cada verificación… |
skroutz_update_products | Actualiza disponibilidad, precio (centavos de euro) y cantidad de hasta 500 productos existentes y sus variaciones en un lote; no crea… |
skroutz_get_product_update_status | Lee el resultado de una actualización de lote de productos: estado (in_progress mientras cualquier producto esté pendiente, luego completado), created_at, y por producto… |
skroutz_get_cps_order | Lee una orden CPS (una venta en tu propia tienda web que vino de Skroutz, pagada por comisión) por el código de pedido que tu tienda le dio: fecha… |
skroutz_reject_cps_order | Rechaza una orden CPS para que Skroutz no cobre comisión sobre ella, con una de sus reject_options (user_cancel, user_return, undelivered… |
Ejemplos de indicaciones
- "Muestra el pedido 251114-3920517 con sus artículos, sus opciones de recogida y cuándo expira."
- "Acepta el pedido 251114-3920517 para la primera ventana de recogida de mi almacén en Atenas."
- "El pedido 251112-1187340 necesita Marcar como listo: ¿está listo para marcar, y cuándo es la recogida?"
- "¿Qué dice la devolución R-251110-2045318, y hasta cuándo tengo que revisarla?"
- "¿Cuántas unidades de cada producto tengo en los almacenes de Skroutz?"
Preguntas frecuentes
¿Funciona con Claude Code así como con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
¿De dónde vienen los tokens? Desde el panel de comerciantes de Skroutz, y son tres tokens separados: el token de API del mercado bajo Servicios, Skroutz Marketplace (pedidos, devoluciones, Fulfilled by Skroutz), el token de API de Productos opcional bajo Productos, Actualizaciones de Feed para actualizaciones masivas de precios y stock, y el token CPS opcional para órdenes de tu propia tienda web. Generar un nuevo token de mercado finaliza el anterior.
¿Puede listar mis pedidos? No. La API de Skroutz no tiene lista de pedidos: los pedidos llegan a una tienda a través del webhook, el panel de comerciantes y los correos electrónicos de pedidos. Dale a la IA el código del pedido (como 251114-3920517) y lee el pedido. Los códigos de demostración como DEMO-OPEN son seguros para pruebas.
¿Qué herramientas están instaladas apagadas? skroutz_reject_order y skroutz_reject_cps_order, porque un rechazo no se puede deshacer, las herramientas de devolución skroutz_handle_return, skroutz_submit_service_inspection y skroutz_file_compensation_request, skroutz_create_fbs_purchase_order, que conduce a tarifas de almacén, y skroutz_update_products.
Próximos pasos
- Página de inicio del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?