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
...
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 übertragenan 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: