Add-On - KamBox Modul

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://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/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: