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 normal in der Printlounge gespeichert, aber ebenfalls an die KamBox übertragen.
Testumgebung:
https://sso.smarttest.8s.de/
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 KamBox
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: