Webservice

Einrichtung von Webservice-Verbindungen zu Kassen und Hauptsystem sowie Referenz für externe Aufrufe in POS Core.

Unter Datentransfer → Webservice werden die Webservice-Verbindungen zu den Kassen bzw. zum Hauptsystem hinterlegt.

image.png Zum Vergrößern anklicken

Hinweis: Für Webserviceaufrufe muss jeweils eine separate BC-Instanz mit NavUserPassword-Authentifizierung auf dem Zielsystem installiert werden.

Einrichtung

Allgemein

image.png Zum Vergrößern anklicken

Feld Beschreibung
Lagerort Der Lagerortcode
Kasse Der Kassencode
Art POS: Verbindung zur Kasse (pro Kassenstamm)
ERP: Verbindung zum Hauptsystem (einmalig für alle Kassenstämme)

Einstellungen

image.png Zum Vergrößern anklicken

Feld Beschreibung
Pfad Basispfad der Aufruf-URL, setzt sich zusammen aus Namen/IP, ODATA-Port und Dienstnamen (Beispiel: http://192.168.103.137:7258/BC)
Benutzer BC-Benutzer für die jeweiligen Aufrufe
Passwort Passwort des zu verwendenden Benutzers
Mandant Der aufzurufende Mandantenname

Aktionen

Test

image.png Zum Vergrößern anklicken

Feld Beschreibung
Basispfad Wird aus Einrichtung übernommen
Dienstname Der Name des aufzurufenden Webdienstes
Funktionsname Der Name der aufzurufenden Webdienstfunktion
Mandant Wird aus Einrichtung übernommen
URL Zeigt die vollständige Aufruf-URL an, basierend auf den hinterlegten Werten unter Basispfad, Dienstname, Funktionsname und Mandant (Beispiel: http://192.168.103.137:7258/BC/ODATAV4/BET_POS_WebInterface_Test?company=CRONUS%20DE)
Benutzer Wird aus Einrichtung übernommen
Passwort Wird aus Einrichtung übernommen
HTTP-Status Zeigt den Ergebniscode der zuletzt getätigten Ausführung an
Anfrage Optionale Funktionsparameter im JSON-Format
Antwort Zeigt das Ergebnis der zuletzt getätigten Ausführung an

image.png Zum Vergrößern anklicken

Webservices zum Aufruf von externen Systemen

Gutscheine

Gutscheinbetrag abfragen

Daten
URL http://<Server>:<ODataPort>/BC/ODATAV4/BET_POS_WebInterface_GetVoucherRemainingAmount?company=<Company>
Parameter voucherNo (Text, Länge 20)
Request {request:"{voucherNo:\"22L1BBE5GP\"}"}
Response {"timestamp":"2025-03-20T08:17:33.304Z","voucherNo":"22L1BBE5GP","remainingAmount":247.05,"hasError":false}

Gutschein ausgeben

Daten
URL http://<Server>:<ODataPort>/BC/ODATAV4/BET_POS_WebInterface_IssueVoucher?company=<Company>
Parameter voucherNo (Text, Länge 20); orderNo (Text, Länge 50); amount (Decimal)
Request {request:"{voucherNo:\"23APWAF8XL\",orderNo:\"123456\",amount:\"50.01\"}"}
Response {"timestamp":"2025-03-20T08:26:15.568Z","voucherNo":"23APWAF8XL","amount":50.01,"remainingAmount":50.01,"hasError":false}

Gutschein aufladen

Daten
URL http://<Server>:<ODataPort>/BC/ODATAV4/BET_POS_WebInterface_RechargeVoucher?company=<Company>
Parameter voucherNo (Text, Länge 20); orderNo (Text, Länge 50); amount (Decimal)
Request {request:"{voucherNo:\"23APWAF8XL\",orderNo:\"123456\",amount:\"50.01\"}"}
Response {"timestamp":"2025-03-20T08:27:12.345Z","voucherNo":"23APWAF8XL","amount":50.01,"remainingAmount":100.02,"hasError":false}

Gutschein einlösen

Daten
URL http://<Server>:<ODataPort>/BC/ODATAV4/BET_POS_WebInterface_RedeemVoucher?company=<Company>
Parameter voucherNo (Text, Länge 20); orderNo (Text, Länge 50); amount (Decimal)
Request {request:"{voucherNo:\"23APWAF8XL\",orderNo:\"123456\",amount:\"50.00\"}"}
Response {"timestamp":"2025-03-20T08:32:23.304Z","voucherNo":"23APWAF8XL","amount":50.00,"remainingAmount":50.02,"hasError":false}

Gutschein stornieren

Hinweis: Die Einrichtung der Stornierungsfrist für Gutscheine befindet sich unter: Einrichtung/Gutschein.

Daten
URL http://<Server>:<ODataPort>/BC/ODATAV4/BET_POS_WebInterface_CancelVoucher?company=<Company>
Parameter voucherNo (Text, Länge 20); Optional: orderNo (Text, Länge 50); Optional: amount (Decimal)
Request {request:"{voucherNo:\"23APWAF8XL\"}"}
Response {"timestamp":"2025-11-26T07:02:46.838Z","voucherNo":"GC2UHMK9BT","remainingAmount":"0","hasError":false}
Response {"timestamp":"2025-11-26T07:01:52.952Z","voucherNo":"GC2UHMK9BT","remainingAmount":"0","hasError":true,"errorMessage":"Voucher already canceled"}
Response {"timestamp":"2025-11-26T07:05:19.483Z","voucherNo":"GC2UHMK9BT","remainingAmount":"50.01","hasError":true,"errorMessage":"Voucher cannot be canceled due to timeout"}

Offene Gutscheine abfragen

Daten
URL http://<Server>:<ODataPort>/BC/ODATAV4/BET_POS_WebInterface_GetOpenVouchers?company=<Company>
Request {request:"{locationCode:\"101\"}"}
Parameter locationCode (Text, Länge 10)
Response {"timestamp":"2025-03-20T09:03:23.382Z","locationCode":"101","vouchers":"No open vouchers found","hasError":false}
Response {"timestamp":"2025-03-20T09:47:28.509Z","locationCode":"101","vouchers":"[{\"voucherNo\":\"2GNSTSLRPZ\"},{\"voucherNo\":\"2YTX7SY6WC\"}]","hasError":false}