HVS32 SOAP Schnittstelle (Automatik-Polling) - Versionsgeschichte

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

2024-04-22T06:38:50Z

Packstückdaten aktualisieren (updateVersanddaten)

Ddang am 18. August 2023 um 14:46 Uhr

2023-08-18T14:46:22Z

Bhauser: /* Zusätzliche Datentypen */

2023-07-07T10:53:37Z

Zusätzliche Datentypen

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

2023-03-30T10:52:38Z

Odelice am 23. September 2022 um 13:41 Uhr

2022-09-23T13:41:01Z

Änderungen zeigen

Odelice: /* Datentypen */

2022-08-10T14:06:51Z

Datentypen

Odelice am 18. Mai 2022 um 10:32 Uhr

2022-05-18T10:32:44Z

Odelice am 23. März 2022 um 13:33 Uhr

2022-03-23T13:33:55Z

Odelice am 25. November 2021 um 14:24 Uhr

2021-11-25T14:24:19Z

Odelice am 23. November 2021 um 14:16 Uhr

2021-11-23T14:16:43Z

@@ Zeile 1.719: / Zeile 1.719: @@
 == 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>
 <div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
@@ Zeile 2.088: / Zeile 2.094: @@
 <!-- ------------------------------------------------------------------------------- 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 326: / Zeile 326: @@
 | 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.385: / Zeile 1.385: @@
 | 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 1.743: / Zeile 1.743: @@
 | 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.172: / Zeile 2.172: @@
 | 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 144: / Zeile 146: @@
 |-
 | '''gefahrgutVerpackungsart''' ||[[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes
 |}
 </div></div>
@@ Zeile 268: / Zeile 272: @@
 <!--.--------------------------------------------------------------------------------ENDE Übersicht Zusätzliche Datentypen ---------------------------------------------------------.-->
 <!-- ------------------------------------------------------------------------------- ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
 = Übersicht der Funktionen =
 <!-- ------------------------------------------------------------------------------- echo ------------------------------------------------------------------------------- -->

@@ Zeile 101: / Zeile 101: @@
 ! 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]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (2))
+| '''gefahrgutBezeichnung''' ||[[#Datentypen|String]] || 100 || - || 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 119: / Zeile 119: @@
 | 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 135: / Zeile 135: @@
 | 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 141: / Zeile 141: @@
 | 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>

@@ Zeile 21: / Zeile 21: @@
 = Datentypen =
 '''Integer''' - Zahl mit ausschließlich numerischen Zeichen (0-9).<br>
-'''Decimal''' - Zahl mit Nachkommastellen<br>
+'''Decimal''' - Zahl mit Nachkommastellen (Dezimaltrennzeichen mit Punkt, anstelle von Komma)<br>
 '''Calendar''' - Datum. Monat ist dabei 0-basierend (0 = Januar, 11 = Dezember)<br>
 '''String''' - Beliebige Zeichen aus dem Zeichensatz ISO-8859-1. Maximale Länge darf nicht überschritten werden.<br>

@@ Zeile 317: / Zeile 317: @@
 | '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 |-
-| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 |-
-| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 |-
 | avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
@@ Zeile 642: / Zeile 642: @@
 				<auftragNr></auftragNr>
 				<auftraggeberID></auftraggeberID>
-				<avisHinweis1></avisHinweis1>
+ 				<avisHinweis1></avisHinweis1>
 				<avisHinweis2></avisHinweis2>
 				<avisZusatz1></avisZusatz1>
@@ Zeile 1.376: / Zeile 1.376: @@
 | '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 |-
-| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 |-
-| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 |-
 | avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
@@ Zeile 1.732: / Zeile 1.732: @@
 | assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 |-
-| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 |-
-| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 |-
 | avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
@@ Zeile 2.076: / Zeile 2.076: @@
 | ausschlussFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Ausschluss-Frachtführer für SPM Anfrage
 |-
-| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 |-
-| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 |-
 | avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1

@@ Zeile 1.058: / Zeile 1.058: @@
 | auftraggeberID || [[#Datentypen|Sequence<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. Es können n-Auftraggeber abgeschlossen werden.
 (Option MultiAGTagesabschluss muss im HVS32 aktiv sein)
 |-
 | druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
@@ Zeile 1.109: / Zeile 1.115: @@
           <arg0>
              <auftraggeberID></auftraggeberID>
              <druckername></druckername>
              <frachtfuehrerTyp></frachtfuehrerTyp>

@@ Zeile 363: / Zeile 363: @@
 | [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
 |-
-| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+| '''gewicht''' ||[[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 |-
 | hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
@@ Zeile 1.390: / Zeile 1.390: @@
 | [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
 |-
-| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+| '''gewicht''' ||[[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 |-
 | ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)

@@ Zeile 303: / Zeile 303: @@
 |10
+|
-| -
+| Eindeutige ID um eine Neutrale-Absenderadresse aus dem HVS32 zu verwenden
 |-
 | ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner