Storno
Bereits in das Kundenportal hochgeladene Wiegedaten können mit der Storno-Funktion storniert werden.
Im Folgenden erfahren Sie, wie Sie erfasste Wiegedaten stornieren können und welchem Aufbau Ihre Anfrage entsprechen muss.
Anfrage an den Server
Um Daten über die Schnittstelle zu stornieren, müssen Sie über ein gültiges JWT-Token verfügen. Sollten Sie nicht im Besitz eines gültigen JWT-Tokens sein,
müssen Sie eine Authentifizierung via Authenticate mit Ihren Zugangsdaten durchführen.
Falls Sie hochgeladene Daten bearbeiten möchten, verwenden Sie die Funktion Update anstelle von Storno.
Setzen Sie Ihr aktuell gültiges JWT-Token in dem Http Authorization-Header mit dem Schlüssel "Bearer" ein.
Um gespeicherte Wiegedaten zu stornieren, senden Sie eine HTTP-Post-Anfrage an https://api.mhkw-rothensee.de/WeighingData/Storno.
Ihre Anfrage muss die Belegnummer der zu stornierenden Wiegedaten als Parameter enthalten.
Wie die Belegnummer Ihrer Anfrage als Parameter beigelegt werden kann, können Sie folgendem Beispiel entnehmen.
https://api.mhkw-rothensee.de/WeighingData/Storno?documentNumber=MyDocumentNumberAntwort des Servers
Bei erfolgreicher Stornierung
Nachdem Ihre Anfrage den Server erreicht hat wird dieser Ihren Token zur Authentifizierung und die übermittelte Dokumentennummer prüfen.
Werden passende Wiegedaten gefunden, werden diese storniert und der Code 200 (Success) zurückgegeben.
Mit dem Erhalt des Codes 200 wurde der Storno-Vorgang erfolgreich abgeschlossen und die Daten werden verarbeitet.
Bei fehlgeschlagener Stornierung
Antwortet der Server mit Code 400 und der Fehlermeldung "Storno von Wiegedaten fehlgeschlagen", konnten die Daten nicht verarbeitet werden.
Beispielsweise konnten keine passenden Wiegedaten gefunden werden.
Prüfen Sie in diesem Fall die Belegnummer und übermitteln Sie die Anfrage erneut.
Antwortet der Server mit Code 401 schlug die Authentifizierung fehl. Kehren Sie in diesem Fall zu
Authenticate zurück um ein neues JWT-Token zu erhalten.