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, pedidos de compra y proveedores, actualizaciones masivas de precios y stock y pedidos CPS. Token de API desde el panel de comerciantes.
Configuración guiada
Conecta Skroutz a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Skroutz 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 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.
💡 ¿Sin 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
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, pedidos de compra y proveedores, actualizaciones masivas de precios y stock y pedidos CPS. Token de API desde el panel de comerciantes.
Configuración
Configurar toma alrededor de 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 termina 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 pedidos CPS de tu propia tienda web: en Παραγγελίες καταστήματος, Αυτόματη διαχείριση (pedidos 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 manejado 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: un 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 necesitan hacerlo.
Envío y documentos: skroutz_update_tracking_details envía el mensajero y el código de seguimiento para pedidos 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 carga 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, del webhook de devoluciones o del panel de comerciantes; las returns de un pedido solo dan un uuid y ids 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.
Gestionado por Skroutz: skroutz_list_fbs_products (stock en los 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 asíncrona; 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: esos provienen del feed XML. Un 422 diciendo que el XML está siendo escaneado significa que intentes de nuevo más tarde.
Pedidos 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) lo 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 con 403. El conector nunca mueve dinero: rechazos, decisiones de devolución, reclamaciones de compensación, pedidos de compra y actualizaciones masivas de productos están instalados apagados para que un administrador los active deliberadamente.
Requisitos previos: SKROUTZ_API_TOKEN
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 Skroutz y pega las variables de entorno listadas bajo Requisitos previos.
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 | Pide el voucher del mensajero de un pedido anticipado aceptado ahora, cuando el producto llegó antes de la fecha de envío planificada (la creación del panel… |
skroutz_upload_invoice | Carga 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 | Carga 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 devuelto defectuoso (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 los pedidos 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 un pedido de compra Fulfilled by Skroutz: product_id, shop_uid, activo, expected_quantity y actual_quantity… |
skroutz_create_fbs_purchase_order | Anuncia un nuevo pedido 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 pedidos de compra), código, nombre, dirección, ciudad, área, código postal, teléfono… |
skroutz_create_fbs_supplier | Agrega un proveedor Fulfilled by Skroutz (que envía stock al almacén de Skroutz para 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 realiza 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 un pedido 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 un pedido CPS para que Skroutz no cobre comisión sobre él, con una de sus reject_options (user_cancel, user_return, undelivered… |
Ejemplos de prompts
- "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?"
Próximos pasos
¿Te ha sido útil esta guía?