Technische Dokumentation für Entwickler. Verbinden Sie BaseLinker, WooCommerce, Apilo oder Ihre eigene WMS/ERP-Lösung direkt mit dem Scopio Marketplace. Sorgen Sie für eine automatische Auftragsabwicklung und sofortige Synchronisation von Lieferstatus und Sendungsnummern.
Verkäufer-API-Schlüssel
Jede Anfrage an die Scopio-API muss mit einem eindeutigen Verkäufer-Token autorisiert werden. Dieser Token wird im Administrationsbereich generiert. Verwenden Sie den Authorization-Header mit dem Bearer-Präfix oder direkt den X-API-Key-Header.
Token sind an Ihr Verkäuferkonto und Profil gebunden. Bewahren Sie sie an einem sicheren Ort auf (z. B. in Umgebungsvariablen) und geben Sie sie niemals im Client-Code preis. Die API unterstützt nur SSL/TLS 1.3-Verbindungen.
# Authorization Header
Authorization: Bearer sk_mkt_ca1d5b9...
X-API-Key: sk_mkt_ca1d5b9...
Endpunkt: GET /api/seller/orders
Dieser Endpunkt ermöglicht das automatische Abrufen neu bezahlter Bestellungen. Er gibt nur die Bestellpositionen zurück, die zu Ihrem Angebot gehören (Filterung nach sellerId). Die Lieferadresse und die bevorzugte Versandart werden in JSON bereitgestellt.
Das empfohlene Abfrageintervall beträgt 5 bis 15 Minuten. Die Antwort enthält das Feld shipping_address mit den vollständigen Kontaktdaten des Käufers, einer Liste der bestellten Produkte mit EAN-Codes, Mengen und Preisen.
# Response excerpt
{ "success": true, "orders": [...] }
Endpunkt: POST /api/seller/orders/{orderId}/fulfill
Nachdem Sie das Paket verpackt und das Versandetikett in Ihrem System erstellt haben, senden Sie den Status zurück an Scopio. Geben Sie die Sendungsverfolgungsnummer und den Logistikdienstleister an, um die Bestellung sofort zu aktualisieren.
Zugelassene Logistik-IDs: inpost_locker, inpost_courier, dpd, dhl, ups. Sie können auch optional einen direkten PDF-Link zum Versandetikett (label_url) übertragen, damit dieses direkt in der Scopio-Oberfläche angezeigt werden kann.
# Payload data
{ "tracking_number": "XYZ123", "carrier": "inpost_locker" }
Echtzeit-HTTP-POST-Ereignisse
Konfigurieren Sie eine Webhook-URL im Verkäuferportal, um Echtzeit-Ereignisse zu empfangen. Das System sendet sofort nach erfolgreicher Bezahlung einer Bestellung ein POST-Signal an Ihre Adresse. Dadurch entfällt das kontinuierliche API-Polling.
Jede Webhook-Nachricht enthält einen Signatur-Header, der mittels eines Webhook-Secrets erstellt wird. Dies dient zur Überprüfung der Authentizität des Absenders. Im Fehlerfall wird das Senden dreimal wiederholt.
Bereit für die KI-Agenten-Ökonomie
Alle Bestellstrukturen und -status sind vollständig kompatibel mit dem Universal Commerce Protocol (UCP). Dadurch können autonome Shopping-Bots und Suchmaschinen Bestelldaten ohne manuelle Schnittstellenanpassung auslesen.
Durch die Einhaltung des UCP-Formats werden Bestellungen von autonomen Einkaufsassistenten problemlos an Ihr CRM-System weitergeleitet, ohne dass für jeden Bot ein eigener Parser programmiert werden muss.
Infrastruktursicherheit und Stabilität
Das Standardlimit beträgt 120 Anfragen pro Minute pro API-Schlüssel oder IP-Adresse. Das Überschreiten dieses Limits führt zu einem HTTP-Fehler 429. Fehler werden als standardisierte JSON-Objekte mit Fehlercode ausgegeben.
Mögliche HTTP-Codes: 400 (ungültiger Payload), 401 (nicht autorisiert), 403 (kein Zugriff auf Bestellung), 404 (Bestellung nicht gefunden), 500 (Serverfehler). Alle API-Fehler werden in der Tabelle seller_crm_logs dokumentiert.
# HTTP 429 Rate Limit Response
{ "error": "Too Many Requests", "retry_after_seconds": 60 }
