HVS32 REST Schnittstelle (Automatik-Polling) - Versionsgeschichte

Bhauser: /* Packstückdaten aktualisieren (updateVersanddaten) */

2024-09-09T07:34:19Z

Packstückdaten aktualisieren (updateVersanddaten)

Bhauser: /* Packstückdaten aktualisieren (updateVersanddaten) */

2024-04-22T06:38:04Z

Packstückdaten aktualisieren (updateVersanddaten)

Treum am 15. Februar 2024 um 12:47 Uhr

2024-02-15T12:47:35Z

Odelice am 8. Januar 2024 um 09:49 Uhr

2024-01-08T09:49:23Z

Bhauser: /* packstueckDaten */

2023-12-05T11:21:38Z

packstueckDaten

Bhauser: /* Sendungs-Verarbeitung (sendungsdatenAnfrage) */

2023-12-05T11:21:07Z

Sendungs-Verarbeitung (sendungsdatenAnfrage)

Ddang am 18. August 2023 um 13:55 Uhr

2023-08-18T13:55:40Z

Bhauser: /* Zusätzliche Datentypen */

2023-07-07T10:52:32Z

Zusätzliche Datentypen

Odelice am 11. April 2023 um 13:43 Uhr

2023-04-11T13:43:48Z

Odelice am 30. März 2023 um 10:50 Uhr

2023-03-30T10:50:58Z

@@ Zeile 2.035: / Zeile 2.035: @@
 |-
 | frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 |-
 | [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)

@@ Zeile 1.968: / Zeile 1.968: @@
 == Packstückdaten aktualisieren (updateVersanddaten) ==
-Die Gatewayfunktion updateVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort die Daten von bestehende Packstücken zu verändern. Diese Anfrage wird zum Beispiel gesendet, wenn der Warenwert für ein Packstück erst zu einem späteren Zeitpunkt bekannt ist. Aktualisiert werden können Daten innerhalb der Tabellen Versandeinheit, Abrechnungseinheit und Lieferung. Dabei wird stets über das Feld PackstueckID und bei Belegung auch über das Feld TrackingNr gesucht. Bei dieser Anfrage werden allerdings die zu aktualisierenden Felder und Inhalte nicht mehr nach den Richtlinien des Frachtführers geprüft (z.B. Gewichtsgrenzen, etc.). Es muss somit vom Vorsystem sichergestellt werden, dass die aktualisierenden Werte mit den Richtlinien des Frachtführers übereinstimmen. Sollte dies nicht möglich sein, kann diese Funktion nicht genutzt werden, sondern das Etikett muss storniert und neu verarbeitet werden. Außerdem können Felder, welche bereits auf einem Etikett angedruckt oder vom Versandsystem HVS32 in einer Frachtführerabwicklung ermittelt wurden (z.B. Adresse, Route, TrackingNr, Sonderdienste, etc.) nicht manipuliert werden. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Update wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.
+Die Gatewayfunktion updateVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort die Daten von bestehende Packstücken zu verändern. Diese Anfrage wird zum Beispiel gesendet, wenn der Warenwert für ein Packstück erst zu einem späteren Zeitpunkt bekannt ist. Aktualisiert werden können Daten innerhalb der Tabellen Versandeinheit, Abrechnungseinheit und Lieferung. Dabei wird stets über das Feld PackstueckID und bei Belegung auch über das Feld TrackingNr gesucht.<br><br>
 <br>
 {| class="wikitable"
@@ Zeile 2.457: / Zeile 2.462: @@
 <!-- ------------------------------------------------------------------------------- ENDE updateVersanddaten ------------------------------------------------------------------------------- -->
 <!-- ------------------------------------------------------------------------------- anonymisiereVersandDaten ------------------------------------------------------------------------------- -->
 == Packstückdaten anonymisieren (anonymisiereVersandDaten) ==
 Das Gateway sendet die anonymisiereVersandDaten an das Automatik-Polling des HVS32. Im HVS32 werden somit Kunden bezogene Daten für den entsprechenden Datensatz gemäß DSGVO anonymisiert. Diese Anonymisierung wird unwiderruflich und endgültig auf der Datenbankebene des Versandsystems durchgeführt. Eine Wiederherstellung der ursprünglichen Daten ist somit nicht mehr möglich. Log-Dateien, Rückmelde-Dateien, bereits übertragene Frachtführer DFÜs etc. sind hiervon nicht betroffen. Es können ausschließlich Packstücke und Sendungen anonymisiert werden, welche bereits Tages abgeschlossen sind.

@@ Zeile 2.918: / Zeile 2.918: @@
 	"rechnungsEmpfStrasse": "",
 	"rechnungsNr": "",
-	"RequestuestSPM": "",
+	"requestSPM": "",
 	"sendungsinhalt": "",
 	"sonderdienste": "",

@@ Zeile 10: / Zeile 10: @@
 |}
 <!-- ------------------------------------------------------------------------------- ENDE Voraussetzungen ------------------------------------------------------------------------------- -->
 <!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- -->

@@ Zeile 188: / Zeile 188: @@
 <!-- ------------------------------------------------------------------------------- ENDE edistatus ------------------------------------------------------------------------------- -->
 <!-- ------------------------------------------------------------------------------- packstueckDaten ------------------------------------------------------------------------------- -->
-== packstueckDaten ==
+== packStueckDaten ==
 <div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 <div style="font-weight:bold;line-height:1.6;">Packstückdaten</div>

@@ Zeile 2.613: / Zeile 2.613: @@
 | '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 |-
-| [[#packstueckDaten|packstueckDaten]] || [[#Datentypen|Sequence]] [[#packstueckDaten|<PackStueckDaten>]] || - || - || -
+| [[#packStueckDaten|packStueckDaten]] || [[#Datentypen|Sequence]] [[#packStueckDaten|<PackStueckDaten>]] || - || - || -
 |-
 | packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.

@@ Zeile 330: / Zeile 330: @@
 | avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 |-
-| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+| avisZusatz1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 |-
-| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+| avisZusatz2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 |-
 | barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
@@ Zeile 1.623: / Zeile 1.623: @@
 | avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 |-
-| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+| avisZusatz1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 |-
-| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+| avisZusatz2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 |-
 | bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
@@ Zeile 2.000: / Zeile 2.000: @@
 | avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 |-
-| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+| avisZusatz1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 |-
-| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+| avisZusatz2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 |-
 | barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
@@ Zeile 2.557: / Zeile 2.557: @@
 | avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 |-
-| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+| avisZusatz1 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 |-
-| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+| avisZusatz2 || [[#Datentypen|String]] || 60 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 |-
 | bestellNr || [[#Datentypen|String]] || 20 || - || -

@@ Zeile 89: / Zeile 89: @@
 |-
 | ursprungLand || [[#Datentypen|String]] || 2 || - || Ursprungsland des Artikels
 |}
 </div></div>
@@ Zeile 145: / Zeile 147: @@
 |-
 | '''gefahrgutVerpackungsart''' ||[[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes
 |}
 </div></div>

@@ Zeile 5: / Zeile 5: @@
 {| class="wikitable"
 |-
-| DGS-Version || 3.7.0.646 oder höher
+| DGS-Version || 3.8.23 oder höher
 |-
 | DGS-Plugins || HVS32Client, REST Server
@@ Zeile 288: / Zeile 288: @@
 |'''Funktion (POST) || /hvs32rest/versanddatenAnfrage'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 814: / Zeile 814: @@
 |'''Funktion (POST) || /hvs32rest/versanddatenNachdruckAnfrage'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 975: / Zeile 975: @@
 |'''Funktion (POST) || /hvs32rest/stornoVersanddaten'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 1.040: / Zeile 1.040: @@
 |'''Funktion (POST) || /hvs32rest/verladeVersanddaten'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 1.110: / Zeile 1.110: @@
 |'''Funktion (POST) || /hvs32rest/sperreVersanddaten'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 1.173: / Zeile 1.173: @@
 |'''Funktion (POST) || /hvs32rest/tagesabschluss'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 1.294: / Zeile 1.294: @@
 |'''Funktion (POST) || /hvs32rest/listenabschlussAnfrage'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 1.395: / Zeile 1.395: @@
 |'''Funktion (POST) || /hvs32rest/listenNachdruckAnfrage'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 1.489: / Zeile 1.489: @@
 |'''Funktion (POST) || /hvs32rest/ediabschlussAnfrage'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 1.592: / Zeile 1.592: @@
 |'''Funktion (POST) || /hvs32rest/versanddatenPruefAnfrage'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 1.967: / Zeile 1.967: @@
 |'''Funktion (POST) || /hvs32rest/updateVersanddaten'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 2.457: / Zeile 2.457: @@
 |'''Funktion (POST) || /hvs32rest/anonymisiereVersandDaten'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>
@@ Zeile 2.526: / Zeile 2.526: @@
 |'''Funktion (POST) || /hvs32rest/sendungsdatenAnfrage'''
 |-
-| '''MediaType || text/plain'''<br>
+| '''MediaType || application/json; text/plain'''<br>
 |-
 | '''Charset || UTF-8'''<br>

@@ Zeile 102: / Zeile 102: @@
 ! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 |-
-| gefahrgutBefoerdKat || [[#Datentypen|Integer]] || 1 || - || Beförderungskategorie, Pflicht (siehe ADR-Tabelle Spalte (15)), kann 0-4 sein. Achtung! Muss unbedingt korrekt sein.
+| '''gefahrgutBefoerdKat''' ||[[#Datentypen|Integer]] || 1 || - || Beförderungskategorie, Pflicht (siehe ADR-Tabelle Spalte (15)), kann 0-4 sein. Achtung! Muss unbedingt korrekt sein.
 |-
 | gefahrgutBegrenzteMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status LQ / Begrenzte Menge nach ADR 3.4 verschickt wird, ansonsten F, Pflicht
 |-
-| gefahrgutBezeichnung || [[#Datentypen|String]] || 110 || - || Pflicht (siehe ADR-Tabelle Spalte (2))
+| '''gefahrgutBezeichnung''' ||[[#Datentypen|String]] || 110 || - || Pflicht (siehe ADR-Tabelle Spalte (2))
 |-
 | gefahrgutBuchst640 || [[#Datentypen|String]] || 1 || - || Buchstabe für Sondervorschrift 640, bedingte Pflicht bei Stoffen, bei denen die Sondervorschrift 640 gilt (siehe ADR-Tabelle Spalte (6))
@@ Zeile 120: / Zeile 120: @@
 | gefahrgutKCode || [[#Datentypen|String]] || 10 || - || Klassifizierungscode, Pflicht (siehe ADR-Tabelle Spalte (3b))
 |-
-| gefahrgutKlasse || [[#Datentypen|String]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (3a))
+| '''gefahrgutKlasse''' ||[[#Datentypen|String]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (3a))
 |-
-| gefahrgutMenge || [[#Datentypen|Decimal]] || 8 || 3 || Stoff-Menge an Gefahrgut, die ADR-technisch zu deklarieren ist ( in Litern bei Flüssigkeiten und verdichteten Gasen, sonst in kg, bei LQ-Gefahrgut immer kg )
+| '''gefahrgutMenge''' ||[[#Datentypen|Decimal]] || 8 || 3 || Stoff-Menge an Gefahrgut, die ADR-technisch zu deklarieren ist ( in Litern bei Flüssigkeiten und verdichteten Gasen, sonst in kg, bei LQ-Gefahrgut immer kg )
 |-
-| gefahrgutMengenEinheit || [[#Datentypen|String]] || 2 || - || Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg
+| '''gefahrgutMengenEinheit''' ||[[#Datentypen|String]] || 2 || - || Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg
 |-
 | gefahrgutNebenGefahr || [[#Datentypen|String]] || 10 || - || bedingte Pflicht bei Stoffen, bei denen neben der Hauptgefahr-Klasse/Zettelnummer noch Nebengefahr-Zettelnummern vorhanden sind (siehe ADR-Tabelle Spalte (5), wenn dort z.B. 3+6.1+8 eingetragen ist, sind 6.1 und 8 die Nebengefahr-Zettelnummern und als (6.1)(8) im Feld Nebengefahr zu übermitteln )
@@ Zeile 136: / Zeile 136: @@
 | gefahrgutTunnelBCode || [[#Datentypen|String]] || 10 || - || Tunnelbeschränkungscode, Pflicht (siehe ADR-Tabelle Spalte (15))
 |-
-| gefahrgutUNNR || [[#Datentypen|String]] || 10 || - || Pflicht (siehe ADR-Tabelle Spalte (1))
+| '''gefahrgutUNNR''' ||[[#Datentypen|String]] || 10 || - || Pflicht (siehe ADR-Tabelle Spalte (1))
 |-
 | gefahrgutUmweltGef || [[#Datentypen|String]] || 1 || - || T wenn Stoff umweltgefährdend ist , ansonsten F, Pflicht bei umweltgefährdenden Stoffen
@@ Zeile 142: / Zeile 142: @@
 | gefahrgutVPG || [[#Datentypen|String]] || 3 || - || Verpackungsgruppe, bedingt Pflicht bei den Stoffen, bei denen diese in der ADR-Tabelle belegt ist, kann I,II oder III sein oder gar nicht belegt (letzteres z.B. bei Klasse 2)) (siehe ADR-Tabelle Spalte (4))
 |-
-| gefahrgutVerpAnzahl || [[#Datentypen|Integer]] || 4 || - || Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)
+| '''gefahrgutVerpAnzahl''' ||[[#Datentypen|Integer]] || 4 || - || Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)
 |-
-| gefahrgutVerpackungsart || [[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes
+| '''gefahrgutVerpackungsart''' ||[[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes
 |}
 </div></div>