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://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
...
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:
1. Meldungen mit Exception 401 - Signature has expired
Dafür ist mit der Version 7.8.0 ein fix online gegangen.
Wir holen jetzt ein neues Token, wenn das access_token nach 30 Minuten abgelaufen ist.
Diese Meldungen sollten nicht mehr vorkommen.
2. Exception unprocessable_entity
Dies sind Meldungen kommen von der KamBox API.
Exception unprocessable_entity - muss ausgefüllt werden, Telefonnummer ist ungültig. Bitte geben Sie eine Telefonnummer bestehend aus mind. 8 Zahlen ein.
Exception unprocessable_entity - Postleitzahl ist fehlerhaft. Bitte geben Sie eine Postleitzahl im Format "12345" ein.
Exception unprocessable_entity - muss ausgefüllt werden.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: