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.
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.
- Melde dich im Skroutz Händlerpanel an und öffne Services, Skroutz Marketplace (die Einstellungen der Smart Cart).
- Generiere das API-Token und füge es in
SKROUTZ_API_TOKENein. 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. - Optional, für Massenpreis- und Lageraktualisierungen: in Produkte, Feed-Aktualisierungen generiere das Produkte API-Token und füge es in
SKROUTZ_PRODUCTS_TOKENein. - Optional, für CPS-Bestellungen deines eigenen Webshops: in Παραγγελίες καταστήματος, Αυτόματη διαχείριση (Shop-Bestellungen, automatische Verwaltung) generiere das CPS-Token und füge es in
SKROUTZ_CPS_TOKENein.
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
| Tool | Was es tut |
|---|---|
skroutz_get_order | Lese eine Skroutz Marketplace (Smart Cart) Bestellung anhand ihres Codes: Zustand (offen, akzeptiert, abgelehnt, storniert, abgelaufen, versandt, geliefert… |
skroutz_accept_order | Akzeptiere 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_order | Lehne eine offene Bestellung ab, entweder pro Artikel mit einer Grund-ID aus reject_options (mit available_quantity, wenn der Grund… |
skroutz_reschedule_order_pickup | Verschiebe 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_pickup | Verschiebe 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_ready | Markiere 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_ready | Mache 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_details | Sende 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_voucher | Fordere jetzt den Kuriergutschein einer akzeptierten Vorbestellung an, wenn das Produkt vor dem geplanten Versanddatum angekommen ist (die Erstellung im Panel… |
skroutz_upload_invoice | Lade 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_invoice | Lade 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_request | Bitte 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_return | Lese eine Rücksendung anhand ihres Codes: Zustand (pending_merchant_review, returning, pending_physical_review, pending_service_inspection, returned… |
skroutz_handle_return | Entscheide ü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_inspection | Reiche 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_products | Liste 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_orders | Liste 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_items | Liste die Artikel einer Fulfilled by Skroutz Bestellung: product_id, shop_uid, aktiv, expected_quantity und actual_quantity… |
skroutz_create_fbs_purchase_order | Kü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_suppliers | Liste die vom Shop erfüllten Lieferanten von Skroutz: ID (verwende sie für Bestellungen), Code, Name, Adresse, Stadt, Gebiet, PLZ, Telefon… |
skroutz_create_fbs_supplier | Fü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_products | Aktualisiere 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_status | Lese das Ergebnis einer Produktbatch-Aktualisierung: Status (in_progress, während ein Produkt aussteht, dann abgeschlossen), created_at und pro Produkt… |
skroutz_get_cps_order | Lese 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_order | Lehne 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?