Im Backend unter AddOns → Kambox können die Einstellungen für das KamBox Modul pro Shop eingestellt werden.
Die Kambox heißt seit der Umstellung im August 2024 Regio-Shop.
Der Link für den Erstaufruf der Schnittstelle ist /shop/module/kamBox/Shop/authorize
Durch Aufruf des Links wird man durch den Anmeldeprozess des Telekom SmartSSO geleitet und in Lead-Print per SSO angemeldet.
Falls vom SmartSSO übergebene User nicht vorhanden ist, wird er in der Printlounge angelegt.
Bestellungen des Benutzers werden an die Regio-Shop API übertragen.
Wenn die Übertragung erfolgreich war (HTTP-Status 201) wird die Bestellung in der Printlounge angelegt.
Wenn die Übertragung nicht erfolgreich war (HTTP-Status nicht 201), wird dem Benutzer die Fehlermeldung der API angezeigt und die Bestellung wird nicht in der Printlounge angelegt.
Testumgebung:
https://client.smarttest.8s.de/
Produktivumgebung:
https://id.smart.telekom-dienste.de/
https://portal.smart.telekom-dienste.de/
SmartSSO Doku
https://developer.smart.telekom-dienste.de/principles
Interface Doku der/des KamBox/Regio-Shop
Interface between KAM Box and Online-Druckerei.pdf (Alt)
Online Druckerei API.pdf (Neu - Regio-Shop)
Testsystem Benutzer:
https://sso.smarttest.8s.de/oauth/applications/9be4c1a2-9c12-459c-a04a-180a0d171450
https://kambox.smarttest.8s.de/dashboard
Ich habe im Live System einen Shop für die Nutzung mit der KamBox konfiguriert.
Mandant 1709 Shop 9378
https://joerg.print-server.net/
Logging:
Wenn das Logging aktiviert ist wird in live/storage/logs/kamBox.log eine Logdatei erzeugt.
In der die gesamte API KOmmunikation geloggt wird.
Meldungen:
Dies sind die Rückgaben, die ich bis jetzt für die REgio-Shop API gesehen habe.
Es gibt leider keine Doku dazu.
- Meldung mit 201 als HTTP-Status
Bedeutet die Bestellung ist vom Regio Shop angenommen Meldungen mit HTTP-Status 422
{
"stdClass": {
"errors": {
"address.number": [
"muss ausgefüllt werden"
]
},
}
}Meldungen mit HTTP-Status 404
{
"stdClass": {
"status": 404,
"error": "Not Found",
"message": "Der Betrag des Budgets ist zu niedrig"
}
}
Beispiel einer Produktivkonfiguration: