Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt

Use this file to discover all available pages before exploring further.

Die Reporting-API stellt für bestimmte Services die Möglichkeit bereit, Daten zu exportieren (z. B. Newsletter-Abonnenten oder Bestellungen). Der Export kann in unterschiedlichen Formaten erfolgen, abhängig vom jeweiligen Service. Außerdem liefert die API Statusinformationen über den Fortschritt des Exportprozesses. Die folgende Übersicht zeigt, welche Services aktuell unterstützt werden und wie die Status-Codes zu interpretieren sind.

​
Unterstützte Methoden

Angabe aller unterstützten Methoden.
Befehl/InfoEndpunkteGETPOSTPUTDELETE
Exportreport/

​
Allgemein

​
Unterstützte Services und Formate

Der Endpunkt report/ stellt eine einheitliche Schnittstelle zur Verfügung, mit der sich Daten aus dem Shop-System exportieren lassen. Die API ermöglicht es, Exportprozesse gezielt zu starten, deren Fortschritt abzufragen und bei Bedarf abzubrechen. Aktuell wird die Exportfunktion für die folgenden Services unterstützt:
ServiceUnterstützte Formate
adminUserjson, csv
categoryjson, csv
customerAccountjson, csv
dataFeedjson, csv
dataFeedTemplatejson, csv
inquiryjson, csv, xml
inventoryjson, csv
orderjson, xml
newsletterSubscriberjson, csv
productjson, csv
productRatingjson, csv
seoViewsjson, csv
transactionjson, csv
voucherjson, csv
voucherPresetjson, csv
voucherTemplatejson, csv

​
Statuswerte des Exportprozesses

Exportprozesse laufen asynchron im Hintergrund. Während des Exports wird der aktuelle Reportstatus fortlaufend aktualisiert. Der Status eines Exportvorgangs kann folgende Werte annehmen:
WertBezeichnungBedeutung
0ReadyDer Exportprozess ist bereit zur Ausführung.
1StartingDer Prozess wurde gestartet, aber noch nicht begonnen.
2RunningDer Export wird derzeit ausgeführt.
3PausedDer Export ist derzeit pausiert.
4CanceledDer Exportprozess wurde manuell abgebrochen.
5FinishedDer Export wurde erfolgreich abgeschlossen.
6ErrorBeim Export ist ein Fehler aufgetreten.

​
Methoden für den Datenexport

​
GET report//status

Mit diesem Endpunkt kann der aktuelle Status eines Exportprozesses abgefragt werden. Dies umfasst u. a. Fortschritt, Anzahl verarbeiteter Einträge, Start- und Endzeit sowie den Link zur exportierten Datei (sofern der Export abgeschlossen wurde). Für den Export müssen die Leseberechtigungen für den jeweiligen Service vorhanden sein.

​
Beispiel

https://www.<ihr-shop>.de/admin/api/v1/report/order/status

​
Antwort

{
    "duration": 0,
    "end": "",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<ihr-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 2,
    "total": 4
}

​
Fehlercodes

FehlerTypGrund
401 UnauthorizedNicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Starten des Services.
400 Bad Requestservice ist unbekannt.
503 Service Unavailable”internalError”Redis hat keinen Status geliefert.

​
POST report//start

Mit diesem Endpunkt wird der Exportprozess für den angegebenen Service gestartet. Optional können Filter und das gewünschte Ausgabeformat (json, csv etc.) über Query-Parameter angegeben werden. Damit der Export ausgelöst werden kann, müssen die Leseberechtigungen für den jeweiligen Service vorhanden sein. Falls bereits ein Exportprozess für den Service läuft, wird dieser automatisch abgebrochen, bevor der neue Export gestartet wird.

​
Beispiel

https://www.<ihr-shop>.de/admin/api/v1/report/order/start?format=json&filter_gte[createdAt]=2024-11-01T00:00:00.000Z

​
Antwort

{
    "duration": 0,
    "end": "",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<ihr-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 2,
    "total": 4
}

​
Fehlercodes

FehlerTypGrund
401 UnauthorizedNicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Lesen der Daten des Services.
400 Bad Requestservice ist unbekannt.
Der Service unterstützt das format nicht.
503 Service Unavailable”Service currently unavailable”Der Exportprozess konnte nicht getriggert werden.
503 Service Unavailable”internalError”Redis hat keinen Status geliefert.
Der Status konnte nicht in Redis aktualisiert werden.
Der Status hat sich 10 Sekunden lang nicht geändert.

​
POST report//pause

Mit diesem Endpunkt kann ein laufender Exportprozess für den angegebenen Service pausiert werden. Um den Vorgang zu pausieren, müssen die Leseberechtigungen für den jeweiligen Service vorhanden sein.

​
Beispiel

https://www.<ihr-shop>.de/admin/api/v1/report/order/pause

​
Antwort

{
    "duration": 0,
    "end": "",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<ihr-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 3,
    "total": 4
}

​
Fehlercodes

FehlerTypGrund
401 UnauthorizedNicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Starten des Services.
400 Bad Requestservice ist unbekannt.
404 Not foundDer Prozess läuft nicht.
503 Service Unavailable”internalError”Redis hat keinen Status geliefert. Redis kann nicht erreicht werden. Der Prozess konnte nicht gestoppt werden.

​
POST report//resume

Mit diesem Endpunkt kann ein pausierter Exportprozess für den angegebenen Service fortgefahren werden. Um den Vorgang fortzufahren, müssen die Leseberechtigungen für den jeweiligen Service vorhanden sein.

​
Beispiel

https://www.<ihr-shop>.de/admin/api/v1/report/order/resume

​
Antwort

{
    "duration": 0,
    "end": "",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<ihr-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 2,
    "total": 4
}

​
Fehlercodes

FehlerTypGrund
401 UnauthorizedNicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Starten des Services.
400 Bad Requestservice ist unbekannt.
404 Not foundDer Prozess ist nicht pausiert worden.
503 Service Unavailable”internalError”Redis hat keinen Status geliefert. Redis kann nicht erreicht werden. Der Prozess konnte nicht gestoppt werden.

​
DELETE report//cancel

Mit diesem Endpunkt kann ein laufender Exportprozess für den angegebenen Service vorzeitig abgebrochen werden. Um den Vorgang zu beenden, müssen die Leseberechtigungen für den jeweiligen Service vorhanden sein.

​
Beispiel

https://www.<ihr-shop>.de/admin/api/v1/report/order/cancel

​
Antwort

{
    "duration": 0,
    "end": "2025-02-19T09:15:15.000000000Z",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<ihr-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 4,
    "total": 4
}

​
Fehlercodes

FehlerTypGrund
401 UnauthorizedNicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Starten des Services.
400 Bad Requestservice ist unbekannt.
404 Not foundDer Prozess läuft nicht.
503 Service Unavailable”internalError”Redis hat keinen Status geliefert. Redis kann nicht erreicht werden. Der Prozess konnte nicht gestoppt werden.

​
Support

Bei technischen Fragen und Hilfestellungen ist unser Support-Team für Sie erreichbar: Zum Kundenportal Bitte senden Sie uns eine möglichst detaillierte Beschreibung sowie Screenshots, Requests/Antworten, damit wir Ihre Anfrage zeitnah und zielführend beantworten können.