Website About BE-terna Contact

Webservice

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

image.png

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

Einrichtung

Allgemein

image.png

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

Feld Beschreibung
Pfad Basispfad der Aufruf-URL, setzt sich zusammen aus Namen/IP, ODATA-Port und Dienstnamen (Bsp.: 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

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, Funktionsname und Mandant (Bsp.: 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

Webservices zum Aufruf von externen Systemen

Gutscheine

Gutscheinbetrag abfragen:

URL: http://“Server“:“ODataPort“/BC/ODATAV4/BET_POS_WebInterface_GetVoucherRemainingAmount?company=“Company“

Request: {request:"{voucherNo:\"22L1BBE5GP\"}"}

Response: {"timestamp":"2025-03-20T08:17:33.304Z","voucherNo":"22L1BBE5GP","remainingAmount":247.05,"hasError":false}

Request-Parameter: voucherNo (Text, Länge 20)

Gutschein ausgeben:

URL: http:// “Server“:“ODataPort“/BC/ODATAV4/BET_POS_WebInterface_IssueVoucher?company=“Company“

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}

Request-Parameter: voucherNo (Text, Länge 20); orderNo (Text, Länge 50); amount (Decimal)

Gutschein aufladen:

URL: http:// “Server“:“ODataPort“/BC/ODATAV4/BET_POS_WebInterface_ChargeVoucher?company=“Company“

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}

Request-Parameter: voucherNo (Text, Länge 20); orderNo (Text, Länge 50); amount (Decimal)

Gutschein einlösen:

URL: http:// “Server“:“ODataPort“/BC/ODATAV4/BET_POS_WebInterface_RedeemVoucher?company=“Company“

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}

Parameter: voucherNo (Text, Länge 20); orderNo (Text, Länge 50); amount (Decimal)

offene Gutscheine abfragen:

URL: http://“Server“:“ODataPort“/BC/ODATAV4/BET_POS_WebInterface_GetOpenVouchers?company=“Company“

Request: {request:"{locationCode:\"101\"}"}

Response: 

{"timestamp":"2025-03-20T09:03:23.382Z","locationCode":"101","vouchers":"No open vouchers found","hasError":false} bzw.  {"timestamp":"2025-03-20T09:47:28.509Z","locationCode":"101","vouchers":"[{"voucherNo":"2GNSTSLRPZ"},{"voucherNo":"2YTX7SY6WC"}]","hasError":false}

Request-Parameter: locationCode (Text, Länge 10)

In this article