Zusammenfassung
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.
Geführte Einrichtung
Skroutz in 2 Minuten mit ChatGPT verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Skroutz in der geführten Einrichtung und trag deine MCP-URL in ChatGPT ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Das AnythingMCP-Plugin im ChatGPT-Verzeichnis beantwortet auf AnythingMCP Cloud Fragen aus deinen Firmendatenbanken (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, nur lesend): Öffne den Eintrag (öffnet in neuem Tab) und klicke auf Install plugin. Alle anderen Connectors fügst du in ChatGPT als eigenen MCP-Server mit deiner AnythingMCP-MCP-URL hinzu.
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 + ChatGPT
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.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
SKROUTZ_API_TOKEN
Schritt 1 — Zugangsdaten erhalten
Die Einrichtung dauert etwa 3 Minuten.
- Melde dich im Skroutz Händlerpanel an und öffne Services, Skroutz Marketplace (die Einstellungen der Smart Cart-Seite).
- 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 Updates 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 anfangen: 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 sind sicher zu lesen, anzunehmen und abzulehnen zu Testzwecken: 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 Abholort-ID und die ID eines der eigenen 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 installiert, aber 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 vorher 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 markieren: 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). Eine frühzeitige Markierung 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 von Merchant (FBM) erfüllte 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 installiert, aber 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.
Von Skroutz erfüllt: 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 ihn 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. Zeilenartikel-IDs sind kurze Strings (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 installiert, aber deaktiviert, damit ein Administrator sie absichtlich aktivieren kann.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in ChatGPT hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.
- Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
- Gib einen Namen ein, z. B. Name:
Skroutz. - Trag unter Connection als Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDein und lass Authentication auf OAuth. - Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
- Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.
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, versendet, 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 Zeilenartikel mit einer Grund-ID aus reject_options (mit available_quantity, wenn der Grund… |
skroutz_reschedule_order_pickup | Verschiebe die Abholung des Kuriers einer akzeptierten Bestellung auf ein anderes Datum. Lese die Bestellung mit action_options 1 kurz vorher und sende eine ihrer… |
skroutz_relocate_order_pickup | Verschiebe die Abholung des Kuriers einer akzeptierten Bestellung an einen anderen Abholort des Shops, wobei das Abholdatum und der Slot beibehalten werden. Der Kurier wird… |
skroutz_set_order_ready | Markiere eine akzeptierte Bestellung als verpackt und bereit zum Versand (Als bereit markieren). Erforderlich für Shops, deren Bestellungen set_as_ready_required wahr anzeigen… |
skroutz_set_order_not_ready | Mache Set as Ready 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 von Merchant (FBM) erfüllten 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 (das Panel's Create… |
skroutz_upload_invoice | Lade den Beleg oder die Rechnung einer Bestellung von einem Link zur Datei hoch (PDF, PNG oder JPG, maximal 7 MB). 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 Zeilenartikel zu entschädigen, die als JSON ohne Fotos gesendet werden, also nur aus Gründen, die keine 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_defekt (mit Kommentar, wenn… |
skroutz_submit_service_inspection | Reiche das technische Inspektionsergebnis 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 Skroutz erfüllten Produkte des Shops auf, die in Skroutz-Lagern gespeichert sind: id, shop_uid (deine Produkt-ID), aktiv (kaufbar vom… |
skroutz_list_fbs_purchase_orders | Liste die vom Skroutz erfüllten Bestellungen des Shops auf (Lagerbestand, der an Skroutz-Lager gesendet wurde): code, created_at, expected_date und received_at.… |
skroutz_list_fbs_purchase_order_items | Liste die Zeilenartikel einer vom Skroutz erfüllten Bestellung auf: product_id, shop_uid, aktiv, expected_quantity und actual_quantity… |
skroutz_create_fbs_purchase_order | Kündige eine neue vom Skroutz erfüllte 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 Skroutz erfüllten Lieferanten des Shops auf: id (verwende sie für Bestellungen), code, name, adresse, stadt, gebiet, plz, telefon… |
skroutz_create_fbs_supplier | Füge einen vom Skroutz erfüllten Lieferanten hinzu (der Lagerbestand für dich an das Skroutz-Lager versendet) mit einem einzigartigen Code, Namen, Adresse, Stadt, Gebiet, PLZ… |
skroutz_update_fbs_supplier | Ändere Felder eines vom Skroutz erfüllten 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 Cents, 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 completed), 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 Set as Ready: ist sie bereit zu 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?"
FAQ
Woher kommen die Tokens? Aus dem Skroutz Händlerpanel, und sie sind drei separate Tokens: das Marktplatz-API-Token unter Services, Skroutz Marketplace (Bestellungen, Rücksendungen, von Skroutz erfüllt), das optionale Produkte-API-Token unter Produkte, Feed Updates für Massenpreis- und Lageraktualisierungen und das optionale CPS-Token für Bestellungen deines eigenen Webshops. Das Generieren eines neuen Marktplatz-Tokens beendet das alte.
Kann es meine Bestellungen auflisten? Nein. Die Skroutz API hat keine Bestellliste: Bestellungen erreichen einen Shop über den WebHook, das Händlerpanel und die Bestell-E-Mails. Gib der KI den Bestellcode (wie 251114-3920517) und sie liest die Bestellung. Democodes wie DEMO-OPEN sind sicher zum Testen.
Welche Tools sind deaktiviert installiert? skroutz_reject_order und skroutz_reject_cps_order, da eine Ablehnung nicht rückgängig gemacht werden kann, die Rücksendungswerkzeuge skroutz_handle_return, skroutz_submit_service_inspection und skroutz_file_compensation_request, skroutz_create_fbs_purchase_order, was zu Lagergebühren führt, und skroutz_update_products.
Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.
Nächste Schritte
War dieser Guide hilfreich?