Connector-Anleitung9 Minuten Lesezeit27 MCP-Tools7 Sprachen

Skroutz MCP-Server: Bestellungen, Lager und Retouren

Skroutz Marketplace (Smart Cart) API für Verkäufer auf dem griechischen und zypriotischen Marktplatz: Bestellungen lesen, akzeptieren und planen, Als Bereit Einstellen, Tracking, Rechnungsuploads, Rücksendungen, Erfüllt durch Skroutz Lagerbestand, Bestellungen und Lieferanten, Massenpreis- und Lageraktualisierungen sowie CPS-Bestellungen. API-Token aus dem Händlerpanel.

HCVom HelpCode-TeamAktualisiert 9 Min. Lesezeit Open Source auf GitHub

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

Skroutz

Skroutz

Skroutz Marketplace (Smart Cart) API for sellers on the Greek and Cypriot marketplace: read, accept and schedule orders, Set as Ready, tracking, invoice uploads, returns, Fulfilled by Skroutz stock, purchase orders and suppliers, bulk price and stock updates and CPS orders. API token from the merchants panel.

Tools

27

Region

INTL

Kategorie

E-Commerce

Authentifizierung

API credentials

Benötigte Env-Vars

SKROUTZ_API_TOKEN
Mit einem Klick in der Cloud installieren

7 Tage kostenlos testen · Keine Kreditkarte

  • 7 Tage kostenlos
    Keine Kreditkarte nötig
  • DSGVO & SOC 2 ready
    EU-Datenhaltung, Audit-Logs
  • Open Source auf GitHub
    Open-Source · AGPL-3.0
  • Funktioniert mit ChatGPT, Claude, Gemini
    Jeder MCP-kompatible Client

Zusammenfassung

Skroutz Marketplace (Smart Cart) API für Verkäufer auf dem griechischen und zypriotischen Marktplatz: Bestellungen lesen, akzeptieren und planen, Als Bereit Einstellen, Tracking, Rechnungsuploads, Rücksendungen, Erfüllt durch Skroutz Lagerbestand, Bestellungen und Lieferanten, Massenpreis- und Lageraktualisierungen sowie CPS-Bestellungen. API-Token aus dem Händlerpanel.

Geführte Einrichtung

Skroutz in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Skroutz in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

Frag einfach

Beispiel-Prompts für Skroutz

Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.

Skroutz · live via MCP
Teilen
Opus 4.7

Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Skroutz, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

Skroutz

Skroutz Marketplace (Smart Cart) API für Verkäufer auf dem griechischen und zypriotischen Marktplatz: Bestellungen lesen, akzeptieren und planen, Als Bereit Einstellen, Tracking, Rechnungsuploads, Rücksendungen, Erfüllt durch Skroutz Lagerbestand, Bestellungen und Lieferanten, Massenpreis- und Lageraktualisierungen sowie CPS-Bestellungen. API-Token aus dem Händlerpanel.

Einrichtung

Die Einrichtung dauert etwa 3 Minuten.

  1. Melde dich im Skroutz Händlerpanel an und öffne Services, Skroutz Marketplace (die Einstellungen der Smart Cart).
  2. Generiere das API-Token und füge es in SKROUTZ_API_TOKEN ein. Ein Shop hat ein aktives Token: Das Generieren eines neuen beendet das vorherige, sodass ein Token, das von einer anderen Integration verwendet wird, dort nicht mehr funktioniert.
  3. Optional, für Massenpreis- und Lageraktualisierungen: in Produkte, Feed-Aktualisierungen generiere das Produkte API-Token und füge es in SKROUTZ_PRODUCTS_TOKEN ein.
  4. Optional, für CPS-Bestellungen deines eigenen Webshops: in Παραγγελίες καταστήματος, Αυτόματη διαχείριση (Shop-Bestellungen, automatische Verwaltung) generiere das CPS-Token und füge es in SKROUTZ_CPS_TOKEN ein.

Jeder Aufruf sendet das Token als Authorization: Bearer mit dem Medientyp application/vnd.skroutz+json; version=3.0. Die Installationsprüfung liest die Demobestellung DEMO-OPEN, die das Marktplatz-Token nachweist, ohne echte Daten zu berühren.

Wo du anfangen kannst: die API hat keine Bestellliste. Bestellungen erreichen einen Shop über den Bestell-WebHook, das Händlerpanel und die Bestell-E-Mails, also frage den Benutzer nach dem Bestellcode (wie 191128-1234567) und lese ihn mit skroutz_get_order. Die Democodes DEMO-OPEN, DEMO-ACCEPTED, DEMO-REJECTED, DEMO-INVOICE, DEMO-FBS, DEMO-STORE-PICKUP und DEMO-RETURN können sicher zum Lesen, Akzeptieren und Ablehnen zu Testzwecken verwendet werden: nichts wird gespeichert.

Bestellungen: Eine offene Bestellung trägt accept_options und reject_options und muss vor expires_at bearbeitet werden. Akzeptiere sie mit skroutz_accept_order, indem du eine Abholstandort-ID und die ID eines der Abholfenster dieses Standorts sendest (Fenster unterscheiden sich je nach Standort). Skroutz bucht dann den Kurier und das Gutschein-PDF erscheint in courier_voucher. Expressbestellungen werden automatisch von Skroutz akzeptiert. skroutz_reject_order ist standardmäßig deaktiviert: eine Ablehnung kann nicht rückgängig gemacht werden und zählt gegen den Shop. Um die Abholung einer akzeptierten Bestellung zu ändern, lese sie mit action_options 1 kurz davor und verwende skroutz_reschedule_order_pickup (ein Datum aus reschedule_options) oder skroutz_relocate_order_pickup (eine ID aus relocate_options); die Listen schrumpfen im Laufe der Zeit. skroutz_request_preorder_voucher erstellt den Gutschein einer akzeptierten Vorbestellung frühzeitig.

Als Bereit Einstellen: Wenn eine Bestellung set_as_ready_required wahr anzeigt, holt Skroutz Last Mile sie erst nach skroutz_set_order_ready ab; das Herunterladen des Gutscheins markiert sie nicht mehr als bereit (seit dem 30. März 2026). Ein frühes Markieren kann die Abholung auf ein früheres Fenster verschieben. skroutz_set_order_not_ready macht es vor der Abholung rückgängig. Shops mit set_as_ready_required falsch benötigen dies nicht.

Versand und Dokumente: skroutz_update_tracking_details sendet Kurier- und Tracking-Code nur für Erfüllt durch Händler (FBM) Bestellungen. skroutz_upload_invoice und skroutz_upload_credit_invoice benötigen einen öffentlichen Link zur PDF, PNG oder JPG (maximal 7 MB); der Connector lädt sie herunter und lädt die Datei hoch, eine pro Bestellung, und ersetzt einen früheren Upload.

Rücksendungen: skroutz_get_return liest eine Rücksendung anhand ihres Codes (wie R-111111-1111111, vom Rücksendungs-WebHook oder dem Händlerpanel; die returns einer Bestellung geben nur eine UUID und Tracking-IDs an). skroutz_handle_return (entscheide über eine Rücksendung, die auf eine Überprüfung wartet, bevor review.expires_at, einschließlich des Versands eines fehlenden Teils auf Kosten des Shops) und skroutz_submit_service_inspection (technischer Bericht über einen fehlerhaften Artikel, als Dateilink) sind standardmäßig deaktiviert, da sie zu Rückerstattungen, Ersatzlieferungen oder bezahlten Sendungen führen. skroutz_file_compensation_request ist ebenfalls deaktiviert: es fordert Geld von Skroutz für zurückgegebene Artikel an, und über diesen Connector nur aus Gründen, die keine Fotos benötigen.

Erfüllt durch Skroutz: skroutz_list_fbs_products (Lagerbestand in Skroutz-Lagern), skroutz_list_fbs_purchase_orders, skroutz_list_fbs_purchase_order_items, skroutz_list_fbs_suppliers, skroutz_create_fbs_supplier und skroutz_update_fbs_supplier. skroutz_create_fbs_purchase_order ist deaktiviert, da Lagergebühren daraus folgen. Listen sind paginiert mit page und kommen mit meta.pagination (100 Zeilen pro Seite). Ein Shop ohne FBS erhält hier 401.

Produkte API (benötigt SKROUTZ_PRODUCTS_TOKEN): skroutz_validate_product_updates überprüft eine Charge, ohne etwas zu ändern; skroutz_update_products (deaktiviert) aktualisiert Verfügbarkeit, Preis und Menge von bis zu 500 bestehenden Produkten und Variationen asynchron; skroutz_get_product_update_status berichtet über Erfolg, keine Änderung oder Fehler pro Produkt. Preise hier sind ganzzahlige Euro-Cents (1050 sind 10,50 EUR), während Bestellmengen dezimale Euros sind. Es erstellt keine Produkte: diese kommen aus dem XML-Feed. Eine 422, die besagt, dass das XML gescannt wird, bedeutet, dass du es später erneut versuchen sollst.

CPS-Bestellungen (benötigt SKROUTZ_CPS_TOKEN): skroutz_get_cps_order liest einen Verkauf deines eigenen Webshops anhand deiner eigenen Bestellnummer, mit Umsatz und Provision; skroutz_reject_cps_order (deaktiviert) lehnt sie ab, sodass keine Provision berechnet wird.

Feldnotizen: Zeiten sind im ISO 8601-Format mit dem Athener Offset (+02:00 im Winter, +03:00 im Sommer). Bezeichnungen wie Abholfenster, Ablehnungsgründe und CPS-Zustände kommen auf Griechisch. Artikel-IDs sind kurze Zeichenfolgen (l39vKqxqwe); shop_uid ist deine eigene Produkt-ID. Fehler tragen ein errors-Array mit einem code und messages: 422 order_status bedeutet, dass die Bestellung sich nicht in einem Zustand für diese Aktion befindet. Ein falsches oder ersetztes Marktplatz-Token antwortet mit 403. Der Connector bewegt niemals Geld: Ablehnungen, Rücksendungsentscheidungen, Entschädigungsanträge, Bestellungen und Massenproduktaktualisierungen sind standardmäßig deaktiviert, damit ein Administrator sie absichtlich aktivieren kann.

Voraussetzungen: SKROUTZ_API_TOKEN

Installiere den Connector lokal

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

Öffne http://localhost:3000/connectors/store, wähle Skroutz und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

ToolWas es tut
skroutz_get_orderLese eine Skroutz Marketplace (Smart Cart) Bestellung anhand ihres Codes: Zustand (offen, akzeptiert, abgelehnt, storniert, abgelaufen, versandt, geliefert…
skroutz_accept_orderAkzeptiere eine offene Bestellung: Skroutz bucht dann den Kurier und stellt den Gutschein aus (er erscheint in der Bestellung als courier_voucher). Sende eine…
skroutz_reject_orderLehne eine offene Bestellung ab, entweder pro Artikel mit einer Grund-ID aus reject_options (mit available_quantity, wenn der Grund…
skroutz_reschedule_order_pickupVerschiebe die Kurierabholung einer akzeptierten Bestellung auf ein anderes Datum. Lese die Bestellung mit action_options 1 kurz davor und sende eine ihrer…
skroutz_relocate_order_pickupVerschiebe die Kurierabholung einer akzeptierten Bestellung an einen anderen Abholstandort des Shops, wobei das Abholdatum und der Slot beibehalten werden. Der Kurier wird…
skroutz_set_order_readyMarkiere eine akzeptierte Bestellung als verpackt und versandbereit (Als Bereit Einstellen). Erforderlich für Shops, deren Bestellungen set_as_ready_required wahr anzeigen…
skroutz_set_order_not_readyMache das Als Bereit Einstellen bei einer akzeptierten Bestellung rückgängig, die der Kurier noch nicht abgeholt hat. Skroutz versucht, die Abholung auf das ursprüngliche Datum zurückzusetzen.…
skroutz_update_tracking_detailsSende den Kurier- und Tracking-Code jeder Sendung einer Erfüllt durch Händler (FBM) Bestellung, damit der Kunde sie verfolgen kann. Nur für FBM…
skroutz_request_preorder_voucherFordere jetzt den Kuriergutschein einer akzeptierten Vorbestellung an, wenn das Produkt vor dem geplanten Versanddatum angekommen ist (die Erstellung im Panel…
skroutz_upload_invoiceLade den Beleg oder die Rechnung einer Bestellung von einem Link zur Datei (PDF, PNG oder JPG, maximal 7 MB) hoch. Eine Datei pro Bestellung: ein neuer Upload…
skroutz_upload_credit_invoiceLade die Gutschriftrechnung einer Bestellung hoch, die storniert, zurückgegeben, teilweise zurückgegeben oder nach Erhalt oder Rechnung an den Absender zurückgeschickt wurde…
skroutz_file_compensation_requestBitte Skroutz, den Shop für zurückgegebene Artikel zu entschädigen, die als JSON ohne Fotos gesendet werden, also nur aus Gründen, die keine Fotos benötigen…
skroutz_get_returnLese eine Rücksendung anhand ihres Codes: Zustand (pending_merchant_review, returning, pending_physical_review, pending_service_inspection, returned…
skroutz_handle_returnEntscheide über eine Rücksendung im Zustand pending_merchant_review mit einer ihrer handle_options: genehmigen, eine Ablehnung wie nicht fehlerhaft (mit Kommentar, wenn…
skroutz_submit_service_inspectionReiche das Ergebnis der technischen Inspektion eines fehlerhaften zurückgegebenen Artikels ein (Rücksendung im Zustand pending_service_inspection): die Artikel-ID, eine ihrer…
skroutz_list_fbs_productsListe die vom Shop erfüllten Produkte von Skroutz (FBS), die in Skroutz-Lagern gespeichert sind: ID, shop_uid (deine Produkt-ID), aktiv (kaufbar vom…
skroutz_list_fbs_purchase_ordersListe die vom Shop erfüllten Bestellungen von Skroutz (Lagerbestand, der an Skroutz-Lager gesendet wurde): Code, created_at, expected_date und received_at.…
skroutz_list_fbs_purchase_order_itemsListe die Artikel einer Fulfilled by Skroutz Bestellung: product_id, shop_uid, aktiv, expected_quantity und actual_quantity…
skroutz_create_fbs_purchase_orderKündige eine neue Fulfilled by Skroutz Bestellung an: den Lagerbestand, den du an ein Skroutz-Lager liefern wirst, mit dem erwarteten Datum, dem Lieferanten…
skroutz_list_fbs_suppliersListe die vom Shop erfüllten Lieferanten von Skroutz: ID (verwende sie für Bestellungen), Code, Name, Adresse, Stadt, Gebiet, PLZ, Telefon…
skroutz_create_fbs_supplierFüge einen Fulfilled by Skroutz Lieferanten hinzu (der Lagerbestand für dich an das Skroutz-Lager versendet) mit einem eindeutigen Code, Namen, Adresse, Stadt, Gebiet, PLZ…
skroutz_update_fbs_supplierÄndere Felder eines Fulfilled by Skroutz Lieferanten; nur die Felder, die du sendest, ändern sich. Antwortet mit success: true
skroutz_validate_product_updatesÜberprüfe eine Charge von Produktaktualisierungen (Verfügbarkeit, Preis in Cent, Menge, Variationen), ohne etwas zu ändern: Skroutz führt jede Überprüfung…
skroutz_update_productsAktualisiere Verfügbarkeit, Preis (Euro-Cents) und Menge von bis zu 500 bestehenden Produkten und deren Variationen in einer Charge; es erstellt keine…
skroutz_get_product_update_statusLese das Ergebnis einer Produktbatch-Aktualisierung: Status (in_progress, während ein Produkt aussteht, dann abgeschlossen), created_at und pro Produkt…
skroutz_get_cps_orderLese eine CPS-Bestellung (einen Verkauf in deinem eigenen Webshop, der von Skroutz kam, bezahlt durch Provision) anhand des Bestellcodes, den dein Shop ihr gegeben hat: Datum…
skroutz_reject_cps_orderLehne eine CPS-Bestellung ab, damit Skroutz keine Provision dafür berechnet, mit einer ihrer reject_options (user_cancel, user_return, undelivered…

Beispielaufforderungen

  • "Zeige Bestellung 251114-3920517 mit ihren Artikeln, ihren Abholoptionen und wann sie abläuft."
  • "Akzeptiere Bestellung 251114-3920517 für das erste Abholfenster meines Lagers in Athen."
  • "Bestellung 251112-1187340 benötigt Als Bereit Einstellen: Ist sie bereit zum Markieren, und wann ist die Abholung?"
  • "Was sagt Rücksendung R-251110-2045318, und bis wann muss ich sie überprüfen?"
  • "Wie viele Einheiten jedes Produkts habe ich in den Skroutz-Lagern?"

Nächste Schritte

War dieser Guide hilfreich?

Skroutz in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Skroutz in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.

Verwandte Anleitungen

Connectors

Skroutz MCP mit ChatGPT verbinden

Skroutz Marketplace (Smart Cart) API für Verkäufer auf dem griechischen und zypriotischen Marktplatz: Bestellungen lesen, annehmen und planen, als bereit markieren, Tracking, Rechnungsuploads, Rücksendungen, von Skroutz erfüllter Lagerbestand, Bestellungen und Lieferanten, Massenpreis- und Lageraktualisierungen sowie CPS-Bestellungen. API-Token aus dem Händlerpanel.

Connectors

Skroutz MCP mit Claude verbinden

Skroutz Marketplace (Smart Cart) API für Verkäufer auf dem griechischen und zypriotischen Marktplatz: Bestellungen lesen, annehmen und planen, als bereit markieren, Tracking, Rechnungsuploads, Rücksendungen, von Skroutz erfüllter Lagerbestand, Bestellungen und Lieferanten, Massenpreis- und Lageraktualisierungen sowie CPS-Bestellungen. API-Token aus dem Händlerpanel.

Connectors

Skroutz MCP mit Microsoft Copilot verbinden

Skroutz Marketplace (Smart Cart) API für Verkäufer auf dem griechischen und zypriotischen Marktplatz: Bestellungen lesen, annehmen und planen, als bereit markieren, Tracking, Rechnungsuploads, Rücksendungen, von Skroutz erfüllter Lagerbestand, Bestellungen und Lieferanten, Massenpreis- und Lageraktualisierungen sowie CPS-Bestellungen. API-Token aus dem Händlerpanel.

Connectors

Skroutz MCP mit Cursor verbinden

Skroutz Marketplace (Smart Cart) API für Verkäufer auf dem griechischen und zypriotischen Marktplatz: Bestellungen lesen, annehmen und planen, als bereit markieren, Tracking, Rechnungsuploads, Rücksendungen, von Skroutz erfüllter Lagerbestand, Bestellungen und Lieferanten, Massenpreis- und Lageraktualisierungen sowie CPS-Bestellungen. API-Token aus dem Händlerpanel.

Connectors

Skroutz MCP mit Gemini CLI verbinden

Skroutz Marketplace (Smart Cart) API für Verkäufer auf dem griechischen und zypriotischen Marktplatz: Bestellungen lesen, annehmen und planen, als bereit markieren, Tracking, Rechnungsuploads, Rücksendungen, von Skroutz erfüllter Lagerbestand, Bestellungen und Lieferanten, Massenpreis- und Lageraktualisierungen sowie CPS-Bestellungen. API-Token aus dem Händlerpanel.

Connectors

Skroutz MCP mit Meta Muse verbinden

Skroutz Marketplace (Smart Cart) API für Verkäufer auf dem griechischen und zypriotischen Marktplatz: Bestellungen lesen, annehmen und planen, als bereit markieren, Tracking, Rechnungsuploads, Rücksendungen, von Skroutz erfüllter Lagerbestand, Bestellungen und Lieferanten, Massenpreis- und Lageraktualisierungen sowie CPS-Bestellungen. API-Token aus dem Händlerpanel.