HVS32 SOAP Schnittstelle (Automatik-Polling): Unterschied zwischen den Versionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen
(31 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
−
DataGatewayServer Versionsstand: DGS-3_6_0_586
+
<!-- ------------------------------------------------------------------------------- Voraussetzungen ------------------------------------------------------------------------------- -->
 +
= Voraussetzungen =
 +
{| class="wikitable"
 +
|-
 +
| DGS-Version || 3.7.0.646 oder höher
 +
|-
 +
| DGS-Plugins || HVS32Client, SOAP Server
 +
|}
 +
<!-- ------------------------------------------------------------------------------- ENDE Voraussetzungen ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- -->
 +
= Funktionsbeschreibung =
 +
Bei der SOAP-Schnittstelle stellt der DataGatewayServer (DGS) einen SOAP Server mit folgenden [[#Übersicht der Funktionen|Funktionen]] zur Verfügung.
 +
Dieser ist in der Standardkonfiguration unter '''http://<Servername>:<Port>/hvs32soap''' erreichbar. Dabei wird der Port 8080 verwendet, welcher bei Bedarf geändert werden kann.
 +
 
 +
Die WSDL / XSD finden Sie hier:<br>
 +
'''[[SOAP_WSDL|SOAP WSDL]]'''<br>
 +
'''[[SOAP_XSD|SOAP XSD]]'''
 +
<!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- DATENTYPEN ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- DATENTYPEN ------------------------------------------------------------------------------- -->
 +
 
= Datentypen =
 
= Datentypen =
 
'''Integer''' - Zahl mit ausschließlich numerischen Zeichen (0-9).<br>
 
'''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>
 
'''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>
 
'''String''' - Beliebige Zeichen aus dem Zeichensatz ISO-8859-1. Maximale Länge darf nicht überschritten werden.<br>
Zeile 10: Zeile 28:
 
'''Map''' - Key/Value Map<br>
 
'''Map''' - Key/Value Map<br>
 
<!-- ------------------------------------------------------------------------------- ENDE DATENTYPEN ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- ENDE DATENTYPEN ------------------------------------------------------------------------------- -->
−
<!-- ------------------------------------------------------------------------------- ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- Übersicht Zusätzliche Datentypen ------------------------------------------------------------------------------- -->
−
= Übersicht der Funktionen =
+
= Zusätzliche Datentypen =
−
'''Fett''' dargestellte Felder müssen IMMER belegt sein.
+
Zusätzliche Datentypen, welche in der Beschreibung vorkommen, stehen in einer 1:n Relation zu den Packstücken.
−
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- artikelDaten ------------------------------------------------------------------------------- -->
−
<!-- ------------------------------------------------------------------------------- anonymisiereVersandDaten ------------------------------------------------------------------------------- -->
+
== artikelDaten ==
−
== anonymisiereVersandDaten ==
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
Anonymisiert personenbezogene Daten, wie zum Beispiel Anschrift, Telefonnr., usw.<br><br>
+
<div style="font-weight:bold;line-height:1.6;">Artikel-Daten</div>
−
;AnonymisiereVersandDatenRequest.
+
<div class="mw-collapsible-content">
−
:Anfrage vom Hostsystem zur Anonymisierung personenbezogener Daten.<br>
 
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| anzahlBuegel || [[#Datentypen|Integer]] || - || - || Nur für Hängeversand: Anzahl der Bügel auf welche die Artikelgruppe aufgeteilt ist
 +
|-
 +
| anzahlPosEtiketten || [[#Datentypen|Integer]] || - || - || Anzahl Artikeletiketten, welche gedruckt werden sollen
 +
|-
 +
| artikelBTNNr || [[#Datentypen|String]] || 25 || - || BTN Nummer / Zolltarifnummer
 +
|-
 +
| artikelEAN || [[#Datentypen|String]] || 20 || - || EAN Nummer
 +
|-
 +
| artikelEinheit || [[#Datentypen|String]] || 10 || - || Einheit der Artikelmenge
 +
|-
 +
| artikelGewicht || [[#Datentypen|Decimal]] || 9 || 3 || Gewicht des Arikels
 +
|-
 +
| artikelGruppe || [[#Datentypen|String]] || 50 || - || Artikelgruppe
 +
|-
 +
| artikelMenge || [[#Datentypen|Decimal]] || 9 || 3 || Menge des Artikels
 +
|-
 +
| artikelServices || [[#Datentypen|String]] || 100 || - || Pipe getrennte Services für diesen Artikel
 +
|-
 +
| artikelSollMenge || [[#Datentypen|Decimal]] || 9 || 3 || -
 +
|-
 +
| artikelText1 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
 +
|-
 +
| artikelText2 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
 +
|-
 +
| artikelText3 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
 +
|-
 +
| artikelText4 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
 +
|-
 +
| artikelVolumen || [[#Datentypen|Decimal]] || 9 || 3 || Volumen des Artikels
 +
|-
 +
| artikelWaehrung || [[#Datentypen|String]] || 3 || - || Währung in welcher der Wert des Artikels angegeben wird
 +
|-
 +
| artikelWert || [[#Datentypen|Decimal]] || 18 || 2 || Wert des Artikels
 
|-
 
|-
−
| auftragsNr || [[#Datentypen|String]] || 20 || - || -
+
| chargeFlag || [[#Datentypen|String]] || 1 || - ||  
 
|-
 
|-
−
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.
+
| kundenArtikelNr || [[#Datentypen|String]] || 50 || - || Artikelnummer
 
|-
 
|-
−
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
+
| kundenBestellNr || [[#Datentypen|String]] || 50 || - || Bestellnummer
 
|-
 
|-
−
| packstueckID || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
+
| posAuftragNr || [[#Datentypen|String]] || 50 || - || Auftragsnummer
 
|-
 
|-
−
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
+
| posLieferNr || [[#Datentypen|String]] || 40 || - || Lieferscheinnummer
−
|}
 
−
<br>
 
−
;AnonymisiereVersandDatenResponse.
 
−
:Rückmeldung vom HVS32 nachdem der Datensatz anonymisiert worden ist.
 
−
{| class="wikitable sortable"
 
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung
+
| positionNr || [[#Datentypen|String]] || 50 || - || Laufende Nummer innerhalb des Packstücks
 
|-
 
|-
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| serienNr || [[#Datentypen|String]] || 30 || - || Seriennummer
 
|-
 
|-
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| ursprungLand || [[#Datentypen|String]] || 2 || - || Ursprungsland des Artikels
 
|}
 
|}
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE anonymisiereVersandDaten ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- -->
−
<!-- ------------------------------------------------------------------------------- echo ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- -->
−
== echo ==
+
== gefahrgut ==
−
Zum Testen der SOAP-Schnittstelle. Liefert die übergebene Nachricht unverändert zurück.<br><br>
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
<!-- ------------------------------------------------------------------------------- ENDE echo ------------------------------------------------------------------------------- -->
+
<div style="font-weight:bold;line-height:1.6;">Gefahrgut-Daten</div>
−
<!-- ------------------------------------------------------------------------------- ediabschlussAnfrage ------------------------------------------------------------------------------- -->
+
<div class="mw-collapsible-content">
−
== ediabschlussAnfrage ==
 
−
Zum Erzeugen der Frachtführer DFÜ ([[#ListenabschlussAnfrage|AusgangsListe]] muss zuvor erzeugt worden sein!)<br><br>
 
−
;EDIabschlussAnfrage.
 
−
:Anfrage vom Hostsystem zum Abschließen der EDI (muss nach der [[#ListenabschlussAnfrage|ListenabschlussAnfrage]] erfolgen)
 
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| auftraggeberID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
+
| gefahrgutBefoerdKat || [[#Datentypen|Integer]] || 1 || - || Beförderungskategorie, Pflicht (siehe ADR-Tabelle Spalte (15)), kann 0-4 sein. Achtung! Muss unbedingt korrekt sein.
−
Wenn leer, werden alle Auftraggeber abgeschlossen, welche am betreffenden Packplatz freigegeben sind.<br>
+
|-
−
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiAGTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt 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))
 +
|-
 +
| gefahrgutBuchst640 || [[#Datentypen|String]] || 1 || - || Buchstabe für Sondervorschrift 640, bedingte Pflicht bei Stoffen, bei denen die Sondervorschrift 640 gilt (siehe ADR-Tabelle Spalte (6))
 +
|-
 +
| gefahrgutFFCode || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
 +
|-
 +
| gefahrgutFaktor || [[#Datentypen|Integer]] || 3 || - || Bewertungsfaktor für Punktesummation auf dem Beförderungspapier,  (kann 0, 1, 3, 50 oder 999 sein), eigentlich Pflicht, kann aber eindeutig aus der Beförderungskategorie geschlossen werden, daher muss es nicht unbedingt belegt sein
 +
|-
 +
| gefahrgutFreigestMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status EQ / Excepted Quantities nach ADR 3.5 verschickt wird, ansonsten F, Pflicht
 +
|-
 +
| gefahrgutID || [[#Datentypen|String]] || 8 || - || Eindeutige Suchnummer für Gefahrgut-Stammdaten
 +
|-
 +
| gefahrgutKCode || [[#Datentypen|String]] || 10 || - || Klassifizierungscode, Pflicht (siehe ADR-Tabelle Spalte (3b))
 +
|-
 +
| 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 )
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den z.B. die UPS Summary gedruckt wird.<br>
+
| gefahrgutMengenEinheit || [[#Datentypen|String]] || 2 || - || Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg
−
(Benötigt Druckerspooler Erweiterungsmodul)
 
 
|-
 
|-
−
| frachtfuehrerTyp || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".<br>
+
| 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 )
−
Wenn leer, werden alle Frachtführer abgeschlossen.<br>
 
−
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiFFTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.
 
 
|-
 
|-
−
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.
+
| gefahrgutNettoExplMasse || [[#Datentypen|Decimal]] || 8 || 3 || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
 
|-
 
|-
−
| versandartID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.<br>
+
| gefahrgutPositionNr || [[#Datentypen|Integer]] || - || - || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
−
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiVATagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.
 
 
|-
 
|-
−
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
+
| gefahrgutTechBenennung || [[#Datentypen|String]] || 150 || - || bedingt Pflicht bei N.A.G. Gefahrgut (d.h. wenn die Bezeichnung mit N.A.G. endet)
−
|}
 
−
<br>
 
−
;EDIabschlussAntwort.
 
−
:Rückmeldung vom HVS32 nach einer EDIabschlussAnfrage
 
−
{| class="wikitable sortable"
 
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
| gefahrgutTunnelBCode || [[#Datentypen|String]] || 10 || - || Tunnelbeschränkungscode, Pflicht (siehe ADR-Tabelle Spalte (15))
 
|-
 
|-
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| gefahrgutUNNR || [[#Datentypen|String]] || 10 || - || Pflicht (siehe ADR-Tabelle Spalte (1))
 
|-
 
|-
−
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] [[#edistatus|<EDIStatus>]] || - || - || Liste mit Statusinformationen für EDIs.
+
| gefahrgutUmweltGef || [[#Datentypen|String]] || 1 || - || T wenn Stoff umweltgefährdend ist , ansonsten F, Pflicht bei umweltgefährdenden Stoffen
 
|-
 
|-
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
| 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))
 
|-
 
|-
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| gefahrgutVerpAnzahl || [[#Datentypen|Integer]] || 4 || - || Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)
 
|-
 
|-
−
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der EDI-Listen (z.B. UPS Summary) als Key/Value Map.
+
| gefahrgutVerpackungsart || [[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes
 
|}
 
|}
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE ediabschlussAnfrage ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- -->
−
<!-- ------------------------------------------------------------------------------- ListenabschlussAnfrage ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- -->
  
−
== ListenabschlussAnfrage ==
+
== edistatus ==
−
Zum Erzeugen einer AusgangsListe.<br><br>
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
;ListenabschlussAnfrage.
+
<div style="font-weight:bold;line-height:1.6;">EDIStatus</div>
−
:Anfrage vom Hostsystem zum Abschließen der Listen (muss vor dem [[#ediabschlussAnfrage|ediabschlussAnfrage]] erfolgen)
+
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| auftraggeberID || [[#Datentypen|Sequence<String>]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
−
Wenn leer, werden alle Auftraggeber abgeschlossen, welche am betreffenden Packplatz freigegeben sind.<br>
+
|-
−
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiAGTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.
+
| statuscode || [[#Datentypen|String]] || 2 || - ||
 +
01 = FFDatei wurde erzeugt.<br>
 +
02 = FFDatei wurde geschrieben.<br>
 +
03 = FFDatei wurde verschickt.<br>
 +
11 = FFDatei konnte nicht erzeugt werden!<br>
 +
12 = FFDatei konnte nicht geschrieben werden!<br>
 +
13 = FFDatei konnte nicht verschickt werden!<br>
 +
 
 +
Es ist zu beachten, dass nicht jede FFDatei verschickt wird, dies hängt ab von der HVS32 Konfiguration.<br>
 +
D.h. solange kein Status „1x“ enthalten ist, wurde mit der FFDatei gemäß der HVS32 Konfiguration verfahren.
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
+
| statustext || [[#Datentypen|String]] || 200 || - || Klartext des Statuscodes
−
(Benötigt Druckerspooler Erweiterungsmodul)
 
 
|-
 
|-
−
| frachtfuehrerTyp || [[#Datentypen|Sequence<String>]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".
+
| fftyp || [[#Datentypen|String]] || 50 || - || Frachtführertyo (z.B. UPS, GLS, DPD)
−
Wenn leer, werden alle Frachtführer abgeschlossen.<br>
 
−
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiFFTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.
 
 
|-
 
|-
−
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.
+
| dateityp || [[#Datentypen|String]] || 50 || - || FFDateityp (z.B.: Standard, Express, etc.)
 
|-
 
|-
−
| versandartID || [[#Datentypen|Sequence<String>]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.
+
| auftraggeber || [[#Datentypen|String]] || 10 || - || Auftraggebernummer ('''ACHTUNG!''' Nicht die AuftraggeberID)
−
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiVATagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.
 
 
|-
 
|-
−
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
+
| ffdateinr || [[#Datentypen|String]] || 10 || - || Nummer der FF-Datei (ggf. im Fehlerfall nicht gefüllt)
 
|}
 
|}
−
<br>
+
</div></div>
−
;ListenabschlussAntwort.
+
<!-- ------------------------------------------------------------------------------- ENDE edistatus ------------------------------------------------------------------------------- -->
−
:Rückmeldung vom HVS32 nach einer ListenabschlussAnfrage
+
<!-- ------------------------------------------------------------------------------- packstueckDaten ------------------------------------------------------------------------------- -->
 +
== packstueckDaten ==
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">Packstückdaten</div>
 +
<div class="mw-collapsible-content">
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
 +
|-
 +
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#ArtikelDaten|Packstück-Artikel]] vom Typ '''[[#ArtikelDaten|ArtikelDaten]]''' (1:n)
 
|-
 
|-
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
 +
|-
 +
| [[#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
 +
|-
 +
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Falls die Paketnummer aus dem Vorsystem verwendet werden soll.
 +
|-
 +
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstück der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
 +
|-
 +
| nachnahme || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 +
|-
 +
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 +
|-
 +
| nnVermerk || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 +
|-
 +
| nnVerwendung || [[#Datentypen|String]] || 1 || - || 'B' = Bar, 'V' = Verrechnungsscheck
 +
|-
 +
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 +
|-
 +
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Laufende Nummer pro Sendung
 +
|-
 +
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
 +
|-
 +
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
 +
|-
 +
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.
 +
|-
 +
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
 +
|-
 +
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
 +
|-
 +
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe-Versicherungswert
 
|-
 
|-
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 
|-
 
|-
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
+
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
−
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
+
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 
|}
 
|}
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE Listenabschluss ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- ENDE packstueckDaten ------------------------------------------------------------------------------- -->
−
<!-- ------------------------------------------------------------------------------- sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
+
<!--.--------------------------------------------------------------------------------ENDE Übersicht Zusätzliche Datentypen ---------------------------------------------------------.-->
−
 
+
<!-- ------------------------------------------------------------------------------- ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
−
== sendungsdatenAnfrage ==
+
= Übersicht der Funktionen =
−
HVS32-Sendungsdaten Anfrage – wird zur Laufzeit in einzelne [[#versandDatenAnfragen|versandDatenAnfragen]] unterteilt. Muss bei einer Anfrage für das [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] genutzt werden (requestSPM=TRUE).<br><br>
+
<!-- ------------------------------------------------------------------------------- echo ------------------------------------------------------------------------------- -->
−
;sendungsdatenAnfrage.
+
== Schnittstelle testen (echo) ==
−
:Anfrage vom Hostsystem zum Drucken einer Sendung mit mehreren Packstücken.
+
Zum Testen der SOAP-Schnittstelle. Liefert die übergebene Nachricht unverändert zurück.<br><br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
 +
<div class="mw-collapsible-content">
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:echo>
 +
        <arg0></arg0>
 +
      </std:echo>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE echo ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- versanddatenAnfrage ------------------------------------------------------------------------------- -->
 +
== Packstück-Verarbeitung (versanddatenAnfrage) ==
 +
Die Gatewayfunktion versanddatenAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück zu erzeugen und verbuchen. Ein Etikett wird für alle weiteren Funktionen wir Storno, Verladefreigabe, etc. anhand der hostseitigen Packstück-ID identifiziert. Diese wird im Feld PackstueckID übergeben und muss dementsprechend innerhalb des Versandsystems eindeutig sein.
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
|absenderAdresseID
 +
|[[#Datentypen|String]]
 +
|10
 +
|
 +
| Eindeutige ID um eine Neutrale-Absenderadresse aus dem HVS32 zu verwenden
 
|-
 
|-
 
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 +
|-
 +
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
 +
|-
 +
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#ArtikelDaten|Packstück-Artikel]] vom Typ '''[[#ArtikelDaten|ArtikelDaten]]''' (1:n)
 
|-
 
|-
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
Zeile 161: Zeile 317:
 
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
|-
 
|-
−
| ausschlussFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Ausschluss-Frachtführer für SPM Anfrage
+
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
−
|-
 
−
| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
 
 
|-
 
|-
−
| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
 
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
Zeile 171: Zeile 325:
 
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
|-
 
|-
−
| bestellNr || [[#Datentypen|String]] || 20 || - || -
+
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
 +
|-
 +
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
−
| email || [[#Datentypen|String]] || 100 || - || Für automatische Mailavisierung
+
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
 
|-
 
|-
 
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
 
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
Zeile 179: Zeile 341:
 
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
|-
 
|-
−
| flexZustellungEmailadResponsese || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Email-Adresse
+
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
 +
|-
 +
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
 +
|-
 +
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
 
|-
 
|-
−
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer, falls Frachtbrief durch Vorsystem gedruckt wird.
+
|freiAvis1
 +
|[[#Datentypen|String]]
 +
| -
 +
|
 +
| -
 
|-
 
|-
−
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer.
+
|freiAvis2
 +
|[[#Datentypen|String]]
 +
| -
 +
|
 +
| -
 
|-
 
|-
 
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 +
|-
 +
| [[#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
 +
|-
 +
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
 
|-
 
|-
 
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 +
|-
 +
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
 
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
 
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
Zeile 193: Zeile 393:
 
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
|-
 
|-
−
| Lagerkennzeichen || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
+
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -
 +
|-
 +
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
 +
|-
 +
| lieferantenID || [[#Datentypen|Integer]] || - || - || -
 +
|-
 +
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
 
|-
 
|-
−
| LieferantenID || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
+
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
−
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.
+
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 
|-
 
|-
 
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
 
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
Zeile 220: Zeile 426:
 
|-
 
|-
 
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 +
|-
 +
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
 +
|-
 +
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
 +
|-
 +
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
|-
 
|-
 
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 
|-
 
|-
−
| [[#packstueckDaten|packstueckDaten]] || [[#Datentypen|Sequence]] [[#packstueckDaten|<PackStueckDaten>]] || - || - || -
+
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
 
|-
 
|-
 
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
 
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
 +
|-
 +
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
 +
|-
 +
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
 +
|-
 +
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.
 +
|-
 +
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
 
|-
 
|-
 
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
 
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
Zeile 248: Zeile 468:
 
|-
 
|-
 
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
 
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
−
|-
 
−
| requestSPM || [[#Datentypen|String]] || 5 || - || T/TRUE wenn die Entscheidungsmatrix angesprochen werden soll, sonst leer
 
 
|-
 
|-
 
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
 
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
Zeile 259: Zeile 477:
 
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
 
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
 
|-
 
|-
−
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
+
| terminArt || [[#Datentypen|String]] || 1 || - || 'A' = ab diesem Tag liefern
 +
'B' = bis zu diesem Tag liefern
 +
 
 +
'F' = an diesem Tag liefern
 
|-
 
|-
 
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
−
| terminZeit || [[#Datentypen|String]] || 5 || - || HH:MM
+
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
 
|-
 
|-
 
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
 
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
 +
|-
 +
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
 
|-
 
|-
 
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
 
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
 
|-
 
|-
−
| vorgabeFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Vorgabe-Frachtführer für [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] Anfrage
+
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
 
|-
 
|-
 
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
−
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen werden soll
+
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 +
|-
 +
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 +
|-
 +
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird
 +
|-
 +
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 
|-
 
|-
 
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
 
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
Zeile 299: Zeile 528:
 
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|}
 
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|
 +
|-
 +
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 +
|-
 +
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 +
|-
 +
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 +
|-
 +
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 +
|-
 +
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 +
|-
 +
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
 +
|-
 +
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
 +
|-
 +
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
 +
|-
 +
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 +
|-
 +
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 +
|-
 +
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
 +
|-
 +
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
 +
|-
 +
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
 +
|-
 +
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
 +
|-
 +
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
 +
|-
 +
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
 +
|-
 +
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
 +
|-
 +
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
 +
|-
 +
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|-
 +
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|-
 +
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|-
 +
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|-
 +
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|-
 +
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|-
 +
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|-
 +
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|-
 +
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|-
 +
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
 +
<div class="mw-collapsible-content">
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
<soapenv:Header/>
 +
<soapenv:Body>
 +
<std:versanddatenAnfrage>
 +
<arg0>
 +
<absenderAdresseID></absenderAdresseID>
 +
<ansprechpartner></ansprechpartner>
 +
<anzahlArtikel></anzahlArtikel>
 +
<artikelDaten>
 +
<anzahlBuegel></anzahlBuegel>
 +
<anzahlPosEtiketten></anzahlPosEtiketten>
 +
<artikelBTNNr></artikelBTNNr>
 +
<artikelEAN></artikelEAN>
 +
<artikelEinheit></artikelEinheit>
 +
<artikelGewicht></artikelGewicht>
 +
<artikelGruppe></artikelGruppe>
 +
<artikelMenge></artikelMenge>
 +
<artikelServices></artikelServices>
 +
<artikelSollMenge></artikelSollMenge>
 +
<artikelText1></artikelText1>
 +
<artikelText2></artikelText2>
 +
<artikelText3></artikelText3>
 +
<artikelText4></artikelText4>
 +
<artikelVolumen></artikelVolumen>
 +
<artikelWaehrung></artikelWaehrung>
 +
<artikelWert></artikelWert>
 +
<chargeFlag></chargeFlag>
 +
<kundenArtikelNr></kundenArtikelNr>
 +
<kundenBestellNr></kundenBestellNr>
 +
<posAuftragNr></posAuftragNr>
 +
<posLieferNr></posLieferNr>
 +
<positionNr></positionNr>
 +
<serienNr></serienNr>
 +
<ursprungLand></ursprungLand>
 +
</artikelDaten>
 +
<assoc>
 +
<entry>
 +
<key></key>
 +
<value></value>
 +
</entry>
 +
</assoc>
 +
<auftragNr></auftragNr>
 +
<auftraggeberID></auftraggeberID>
 +
<avisHinweis1></avisHinweis1>
 +
<avisHinweis2></avisHinweis2>
 +
<avisZusatz1></avisZusatz1>
 +
<avisZusatz2></avisZusatz2>
 +
<barcodeID></barcodeID>
 +
<barcodeText></barcodeText>
 +
<barcodeTyp></barcodeTyp>
 +
<bestellNr></bestellNr>
 +
<druckername></druckername>
 +
<email></email>
 +
<empfMobilfunkNr></empfMobilfunkNr>
 +
<faxNr></faxNr>
 +
<fehlertext></fehlertext>
 +
<flexZustellungEmailadresse></flexZustellungEmailadresse>
 +
<frachtBrief></frachtBrief>
 +
<frachtfuehrerKdNr></frachtfuehrerKdNr>
 +
<frankaturKennung></frankaturKennung>
 +
<freiAvis1></freiAvis1>
 +
<freiAvis2></freiAvis2>
 +
<gefahrgut>
 +
<gefahrgutBefoerdKat></gefahrgutBefoerdKat>
 +
<gefahrgutBegrenzteMenge></gefahrgutBegrenzteMenge>
 +
<gefahrgutBezeichnung></gefahrgutBezeichnung>
 +
<gefahrgutBuchst640></gefahrgutBuchst640>
 +
<gefahrgutFFCode></gefahrgutFFCode>
 +
<gefahrgutFaktor></gefahrgutFaktor>
 +
<gefahrgutFreigestMenge></gefahrgutFreigestMenge>
 +
<gefahrgutID></gefahrgutID>
 +
<gefahrgutKCode></gefahrgutKCode>
 +
<gefahrgutKlasse></gefahrgutKlasse>
 +
<gefahrgutMenge></gefahrgutMenge>
 +
<gefahrgutMengenEinheit></gefahrgutMengenEinheit>
 +
<gefahrgutNebenGefahr></gefahrgutNebenGefahr>
 +
<gefahrgutNettoExplMasse></gefahrgutNettoExplMasse>
 +
<gefahrgutPositionNr></gefahrgutPositionNr>
 +
<gefahrgutTechBenennung></gefahrgutTechBenennung>
 +
<gefahrgutTunnelBCode></gefahrgutTunnelBCode>
 +
<gefahrgutUNNR></gefahrgutUNNR>
 +
<gefahrgutUmweltGef></gefahrgutUmweltGef>
 +
<gefahrgutVPG></gefahrgutVPG>
 +
<gefahrgutVerpAnzahl></gefahrgutVerpAnzahl>
 +
<gefahrgutVerpackungsart></gefahrgutVerpackungsart>
 +
</gefahrgut>
 +
<gewicht></gewicht>
 +
<hostTrackingNr></hostTrackingNr>
 +
<ilnNr></ilnNr>
 +
<infotext1></infotext1>
 +
<infotext10></infotext10>
 +
<infotext2></infotext2>
 +
<infotext3></infotext3>
 +
<infotext4></infotext4>
 +
<infotext5></infotext5>
 +
<infotext6></infotext6>
 +
<infotext7></infotext7>
 +
<infotext8></infotext8>
 +
<infotext9></infotext9>
 +
<kostenstelle></kostenstelle>
 +
<kundenNr></kundenNr>
 +
<lagerkennzeichen></lagerkennzeichen>
 +
<letztesPackstueck></letztesPackstueck>
 +
<lieferantenID></lieferantenID>
 +
<lieferscheinNr></lieferscheinNr>
 +
<nachnahme></nachnahme>
 +
<nettoGewicht></nettoGewicht>
 +
<neutBIC></neutBIC>
 +
<neutBankBezeichnung></neutBankBezeichnung>
 +
<neutIBAN></neutIBAN>
 +
<neutKontoInhaber></neutKontoInhaber>
 +
<neutabsenderLKZ></neutabsenderLKZ>
 +
<neutabsenderName1></neutabsenderName1>
 +
<neutabsenderName2></neutabsenderName2>
 +
<neutabsenderName3></neutabsenderName3>
 +
<neutabsenderOrt></neutabsenderOrt>
 +
<neutabsenderPLZ></neutabsenderPLZ>
 +
<neutabsenderStrasse></neutabsenderStrasse>
 +
<nnVermerk></nnVermerk>
 +
<nnVerwendung></nnVerwendung>
 +
<nnWaehrung></nnWaehrung>
 +
<packStkGes></packStkGes>
 +
<packStkNr></packStkNr>
 +
<packplatz></packplatz>
 +
<packstueckBreite></packstueckBreite>
 +
<packstueckHoehe></packstueckHoehe>
 +
<packstueckID></packstueckID>
 +
<packstueckLaenge></packstueckLaenge>
 +
<paperlessInvoice></paperlessInvoice>
 +
<postLeitcode></postLeitcode>
 +
<postZielFrachtzent></postZielFrachtzent>
 +
<rechnungsEmpfLKZ></rechnungsEmpfLKZ>
 +
<rechnungsEmpfName1></rechnungsEmpfName1>
 +
<rechnungsEmpfName2></rechnungsEmpfName2>
 +
<rechnungsEmpfName3></rechnungsEmpfName3>
 +
<rechnungsEmpfOrt></rechnungsEmpfOrt>
 +
<rechnungsEmpfPLZ></rechnungsEmpfPLZ>
 +
<rechnungsEmpfStrasse></rechnungsEmpfStrasse>
 +
<rechnungsNr></rechnungsNr>
 +
<sendungsinhalt></sendungsinhalt>
 +
<sonderdienste></sonderdienste>
 +
<sperrFlag></sperrFlag>
 +
<telefonNr></telefonNr>
 +
<terminArt></terminArt>
 +
<terminDatum></terminDatum>
 +
<terminZeit></terminZeit>
 +
<ustIDNr></ustIDNr>
 +
<verpackungsart></verpackungsart>
 +
<versandartID></versandartID>
 +
<versicherungswert></versicherungswert>
 +
<vorpackdatum></vorpackdatum>
 +
<vwWaehrung></vwWaehrung>
 +
<warenwert></warenwert>
 +
<wechselbruecke></wechselbruecke>
 +
<wwWaehrung></wwWaehrung>
 +
<zahlungsbedingung></zahlungsbedingung>
 +
<zbZoll></zbZoll>
 +
<zielAdrBahnhof></zielAdrBahnhof>
 +
<zielAdrLKZ></zielAdrLKZ>
 +
<zielAdrName1></zielAdrName1>
 +
<zielAdrName2></zielAdrName2>
 +
<zielAdrName3></zielAdrName3>
 +
<zielAdrName4></zielAdrName4>
 +
<zielAdrOrt></zielAdrOrt>
 +
<zielAdrPLZ></zielAdrPLZ>
 +
<zielAdrRegion></zielAdrRegion>
 +
<zielAdrStrasse></zielAdrStrasse>
 +
</arg0>
 +
</std:versanddatenAnfrage>
 +
</soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE versanddatenAnfrage ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- -->
 +
 +
== Etikett nachdrucken (versanddatenNachdruckAnfrage) ==
 +
Die Gatewayfunktion versanddatenNachdruckAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück nachzudrucken. Ein Etikett wird anhand der hostseitigen Packstück-ID nachgedruckt. Diese wird im Feld PackstueckID übergeben. Bei manchen Frachtführern (z.B. DPD) werden beim Nachdruck neue Trackingnummern vergeben. Somit ist die alte Trackingnummer nicht mehr gültig und das alte Versandetikett muss vernichtet werden. Die neue Trackingnummer kann in der Rückmeldung zurückgemeldet werden.
 
<br>
 
<br>
−
;SendungsdatenAntwort.
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
:Rückmeldung vom HVS32 nach einer sendungsdatenAnfrage.<br>
+
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
−
;Sendungsdaten
+
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| fehler || [[#Datentypen|String]] || - || - || Wird im Fehlerfall befüllt
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird.
 
|-
 
|-
−
| sendungsGebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachkosten
+
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 
|-
 
|-
−
| sendungsGebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
+
| '''packstueckID''' || [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
 
|-
 
|-
−
| versandSendungsNr || [[#Datentypen|String]] || 20 || - || Sendungsnummer
+
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer
 
|}
 
|}
−
 
+
</div></div>
−
;Packstückdaten
+
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
Zeile 352: Zeile 834:
 
|-
 
|-
 
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
 
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
 +
|-
 +
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
 
|-
 
|-
 
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
 
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
Zeile 375: Zeile 859:
 
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|}
 
|}
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- sperreVersanddaten ------------------------------------------------------------------------------- -->
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
== sperreVersanddaten ==
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
HVS32-Sperre-VersandDaten zum Sperren von bereits freigegebenen Versandeinheiten<br><br>
+
<div class="mw-collapsible-content">
−
;SperrAnfrage.
+
<source lang="xml">
−
:Anfrage vom Hostsystem zum Sperren von Packstücken im HVS32.
+
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:versanddatenNachdruckAnfrage>
 +
        <arg0>
 +
            <druckername></druckername>
 +
            <packplatz></packplatz>
 +
            <packstueckID></packstueckID>
 +
            <trackingNr></trackingNr>
 +
        </arg0>
 +
      </std:versanddatenNachdruckAnfrage>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- stornoVersanddaten ------------------------------------------------------------------------------- -->
 +
== Packstück stornieren (stornoVersanddaten) ==
 +
Die Gatewayfunktion stornoVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort bestehende Packstücke zu stornieren, die noch nicht auf einer Ausgangsliste sind. In der Regel wird ein Packstück anhand der hostseitigen Packstück-ID storniert. Diese wird im Feld PackstueckID übergeben. Zusätzlich zur hostseitigen Packstück-ID kann auch die TrackingNr zur Identifikation des Packstücks beitragen, für den Fall, dass die hostseitige Packstück-ID keine Eindeutigkeit garantieren kann. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Storno wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
Zeile 388: Zeile 895:
 
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 
|-
 
|-
−
| packstueckID|| [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
+
| '''packstueckID'''|| [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
 +
|-
 +
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer
 
|}
 
|}
 +
</div></div>
 
<br>
 
<br>
−
;SperrAntwort.
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
:Rückmeldung vom HVS32 nach einer sperreVersanddaten
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
Zeile 403: Zeile 914:
 
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 
|}
 
|}
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE sperreversanddaten ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- stornoVersanddaten ------------------------------------------------------------------------------- -->
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
== stornoVersanddaten ==
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
HVS32-StornoVersandDaten zum Stornieren von erzeugten Versandeinheiten<br><br>
+
<div class="mw-collapsible-content">
−
;StornoAnfrage.
+
<source lang="xml">
−
:Anfrage vom Hostsystem zum Stornieren/Löschen eines zuvor etikettierten Packstücks.
+
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:stornoVersanddaten>
 +
        <arg0>
 +
            <packplatz></packplatz>
 +
            <packstueckID></packstueckID>
 +
            <trackingNr></trackingNr>
 +
        </arg0>
 +
      </std:stornoVersanddaten>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE stornoversanddaten ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- verladeVersandaten ------------------------------------------------------------------------------- -->
 +
== Packstück verladen / freigeben (verladeVersanddaten) ==
 +
Die Gatewayfunktion verladeVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang frei zu geben. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreicher Freigabe wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 +
{| class="wikitable sortable"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| hostFreigabeNr || [[#Datentypen|String]] || 20 || - || Hostseitige Freigabenummer die für dieses Packstück gesetzt wird.
 +
|-
 +
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 +
|-
 +
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. <br>
 +
Beim Etikettendruck zuvor muss die gleiche ID übergeben worden sein, damit das HVS32 das zu verladene Packstück eindeutig identifizieren kann.
 +
|-
 +
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird.
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 +
|-
 +
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 +
|-
 +
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
 +
<div class="mw-collapsible-content">
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:verladeVersanddaten>
 +
        <arg0>
 +
            <hostFreigabeNr></hostFreigabeNr>
 +
            <packplatz></packplatz>
 +
            <packstueckID></packstueckID>
 +
            <wechselbruecke></wechselbruecke>
 +
        </arg0>
 +
      </std:verladeVersanddaten>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE verladeVersandaten ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- sperreVersanddaten ------------------------------------------------------------------------------- -->
 +
== Packstück sperren (sperreVersanddaten) ==
 +
Die Gatewayfunktion sperreVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang zu sperren. Gesperrte Packstücke, werden für den Tagesabschluss nicht berücksichtigt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreicher Sperrung wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
Zeile 416: Zeile 1.007:
 
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 
|-
 
|-
−
| '''packstueckID'''|| [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
+
| '''packstueckID'''|| [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
−
|-
 
−
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer
 
 
|}
 
|}
 +
</div></div>
 
<br>
 
<br>
−
;StornoAntwort.
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
:Rückmeldung vom HVS32 nach einer stornoVersanddaten
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
Zeile 433: Zeile 1.024:
 
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 
|}
 
|}
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE stornoversanddaten ------------------------------------------------------------------------------- -->
+
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
 +
<div class="mw-collapsible-content">
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:sperreVersanddaten>
 +
        <arg0>
 +
            <packplatz></packplatz>
 +
            <packstueckID></packstueckID>
 +
        </arg0>
 +
      </std:sperreVersanddaten>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE sperreversanddaten ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- tagesabschluss ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- tagesabschluss ------------------------------------------------------------------------------- -->
−
== tagesabschluss ==
+
== Tagesabschluss (tagesabschluss) ==
−
Generiert den HVS32 Tagesabschluss ([[#ListenabschlussAnfrage|Listenabschluss]] + [[#ediabschlussAnfrage|EDI Übertragung]])<br><br>
+
Das Gateway sendet die tagesabschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit ein Tagesabschluss anhand der zusätzlich übergebenen Parameter ausgelöst. Der Tagesabschluss setzt sich aus den Punkten Ausgangsliste erzeugen und Frachtführer DFÜ erzeugen zusammen. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt. Die Rückmeldung im HVS32 findet nach dem Ausführen des Tagesabschluss statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Tagesabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.
−
;TagesabschlussAnfrage.
+
<br>
−
:Anfrage vom Hostsystem zum Abschließen der Listen + EDI
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| auftraggeberID || [[#Datentypen|Sequence<String>]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
+
| 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.
−
Wenn leer, werden alle Auftraggeber abgeschlossen, welche am betreffenden Packplatz freigegeben sind.<br>
+
(Option MultiAGTagesabschluss muss im HVS32 aktiv sein)
−
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiAGTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.
+
|-
 +
|assoc
 +
|[[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]])
 +
| -
 +
| -
 +
|Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
 
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
 
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
 
(Benötigt Druckerspooler Erweiterungsmodul)
 
(Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
−
| frachtfuehrerTyp || [[#Datentypen|Sequence<String>]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".
+
| frachtfuehrerTyp || [[#Datentypen|Sequence<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.
−
Wenn leer, werden alle Frachtführer abgeschlossen.<br>
+
(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)
−
Bei mehr als einem Eintrag, muss zusätzlich der HVS32-Schalter 'MultiFFTagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.
 
 
|-
 
|-
 
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.
 
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.
 
|-
 
|-
−
| versandartID || [[#Datentypen|Sequence<String>]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.
+
| versandartID || [[#Datentypen|Sequence<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.
−
Es muss zusätzlich der HVS32-Schalter 'MultiVATagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.
+
(Option MultiVATagesabschluss muss im HVS32 aktiv sein)
 
|-
 
|-
 
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
 
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
 
|}
 
|}
 +
</div></div>
 
<br>
 
<br>
−
;TagesabschlussAntwort.
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
:Rückmeldung vom HVS32 nach einer tagesabschluss
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
Zeile 471: Zeile 1.089:
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] [[#edistatus|<EDIStatus>]] || - || - || -
+
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] '''[[#edistatus|<EDIStatus>]]''' || - || - || -
 
|-
 
|-
 
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
Zeile 480: Zeile 1.098:
 
|-
 
|-
 
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
 
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
 +
|-
 +
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.
 +
|-
 +
| ausgangsListeNr|| [[#Datentypen|Sequence<String>]] || - || - || Ausgangslisten-Nummer(n) der erzeugten Ausgangsliste(n).
 
|}
 
|}
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
 +
<div class="mw-collapsible-content">
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:tagesabschluss>
 +
        <arg0>
 +
            <auftraggeberID></auftraggeberID>
 +
            <assoc>
 +
                <entry>
 +
                    <key></key>
 +
                    <value></value>
 +
                </entry>
 +
            </assoc>
 +
            <druckername></druckername>
 +
            <frachtfuehrerTyp></frachtfuehrerTyp>
 +
            <packplatz></packplatz>
 +
            <versandartID></versandartID>
 +
            <wechselbruecke></wechselbruecke>
 +
        </arg0>
 +
      </std:tagesabschluss>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 
<!-- ------------------------------------------------------------------------------- ENDE tagesabschluss ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- ENDE tagesabschluss ------------------------------------------------------------------------------- -->
−
<!-- ------------------------------------------------------------------------------- updateVersanddaten ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- ListenabschlussAnfrage ------------------------------------------------------------------------------- -->
  
−
== updateVersanddaten ==
+
== Ausgangsliste erzeugen (listenabschlussAnfrage) ==
−
HVS32-UpdateVersandDaten zur Aktualisierung von Feldinhalten bei einer bereits erzeugten Versandeinheit. Zur Identifizierung der Versandeinheit dient das Feld PackstueckID. Tatsächlich zu aktualisierende Felder müssen zusätzlich im HVS32 unter den Sektionen GW_UpdateFieldList_VE / AE / AssocMemo / Lieferung<br><br>
+
Das Gateway sendet die listenabschlussAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Ausgangsliste anhand der zusätzlich übergebenen Parameter erzeugt. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Listenabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt. Die Rückmeldung im HVS32 findet nach dem Erzeugen der Ausgangsliste statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Listenabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.
−
;[[#versanddatenAnfrage|VersandDatenAnfrage]].
+
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 +
{| class="wikitable sortable"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| 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.
 +
(Benötigt Druckerspooler Erweiterungsmodul)
 +
|-
 +
| frachtfuehrerTyp || [[#Datentypen|Sequence<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.
 +
(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)
 +
|-
 +
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.
 +
|-
 +
| versandartID || [[#Datentypen|Sequence<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.
 +
(Option MultiVATagesabschluss muss im HVS32 aktiv sein)
 +
|-
 +
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 +
|-
 +
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 +
|-
 +
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 +
|-
 +
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 +
|-
 +
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
 +
|-
 +
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.
 +
|-
 +
| ausgangsListeNr|| [[#Datentypen|Sequence<String>]] || - || - || Ausgangslisten-Nummer(n) der erzeugten Ausgangsliste(n).
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
 +
<div class="mw-collapsible-content">
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:listenabschlussAnfrage>
 +
        <arg0>
 +
            <auftraggeberID></auftraggeberID>
 +
            <druckername></druckername>
 +
            <frachtfuehrerTyp></frachtfuehrerTyp>
 +
            <packplatz></packplatz>
 +
            <versandartID></versandartID>
 +
            <wechselbruecke></wechselbruecke>
 +
        </arg0>
 +
      </std:listenabschlussAnfrage>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE Listenabschluss ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- ListenNachdruck------------------------------------------------------------------------------- -->
  
 +
== Ausgangsliste nachdrucken (listenNachdruckAnfrage) ==
 +
Das Gateway sendet die listenNachdruckAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine bereits erstellte Ausgangsliste anhand der übergebenen ausgangsListeNr nachgedruckt. Eine Liste kann nur nachgedruckt werden, wenn diese bereits über die Funktionen tagesabschluss, listenabschlussAnfrage oder manuell über die HVS32 Maske erzeugt wurde. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Listenabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 +
{| class="wikitable sortable"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| ausgangsListeNr || [[#Datentypen|Sequence<String>]] || - || - || Liste der Ausgangslisten-Nr. der Listen, die nachgedruckt werden sollen.
 +
|-
 +
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
 +
(Benötigt Druckerspooler Erweiterungsmodul)
 +
|-
 +
| auftraggeberID || [[#Datentypen|Sequence<String>]] || - || - || Liste der Auftraggerber-ID's, für welche die Listen nachgedruckt werden sollen.
 +
|-
 +
| frachtFuehrerTyp || [[#Datentypen|Sequence<String>]] || - || - || Liste der Frachtführertypen, für welche die Listen nachgedruckt werden sollen.
 +
|-
 +
| erstellDatum || [[#Datentypen|String]] || 10 || - || Erstelldatum der Ausgangslisten, die nachgedruckt werden sollen. Im Format "dd.mm.yyyy", z.B. 01.01.2001
 +
|-
 +
| druckDatum || [[#Datentypen|String]] || 10 || - || Druckdatum der Ausgangslisten, die nachgedruckt werden sollen. Im Format "dd.mm.yyyy", z.B. 01.01.2001 oder null wenn nur Listen nachgedruckt werden sollen, die noch nicht gedruckt wurden
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| ausgangsListeNr || [[#Datentypen|Sequence<String>]] || - || - || Liste der Ausgangslisten-Nr. der Listen, die nachgedruckt wurden.
 +
|-
 +
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 +
|-
 +
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 +
|-
 +
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 +
|-
 +
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 +
|-
 +
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
 +
|-
 +
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.
 +
|}
 +
</div></div>
 
<br>
 
<br>
−
;[[#versanddatenAnfrage|VersanddatenAntwort]].
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
 +
<div class="mw-collapsible-content">
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:listenNachdruckAnfrage>
 +
        <arg0>
 +
            <ausgangsListeNr>75</ausgangsListeNr>
 +
            <druckername></druckername>
 +
            <auftraggeberID></auftraggeberID>
 +
            <frachtFuehrerTyp></frachtFuehrerTyp>
 +
            <erstellDatum></erstellDatum>
 +
            <druckDatum></druckDatum>
 +
        </arg0>
 +
      </std:listenNachdruckAnfrage>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE ListenNachdruck ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- ediabschlussAnfrage ------------------------------------------------------------------------------- -->
  
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
== Frachtführer DFÜ erzeugen (ediabschlussAnfrage) ==
−
<!-- ------------------------------------------------------------------------------- ENDE updateVersanddaten ------------------------------------------------------------------------------- -->
+
Das Gateway sendet die ediabschlussAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Frachtführer DFÜ anhand der zusätzlich übergebenen Parameter erzeugt und (falls konfiguriert) an den Frachtführer übertragen. Nur Packstücke, für welche zuvor eine Ausgangsliste erzeugt wurde, werden für eine Frachtführer DFÜ berücksichtigt. Die Rückmeldung im HVS32 findet nach dem Erzeugen der Frachtführer DFÜ statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem EDIAbschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.
−
<!-- ------------------------------------------------------------------------------- verladeVersandaten ------------------------------------------------------------------------------- -->
+
<br>
−
== verladeVersanddaten ==
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
HVS32-VerladeVersandDaten zur Ausgangsfreigabe von erzeugten Versandeinheiten<br><br>
+
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
−
;VerladeAnfrage.
+
<div class="mw-collapsible-content">
−
:Anfrage vom Hostsystem zur Ausgangsverladung eines zuvor etikettierten Packstücks.
+
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| hostFreigabeNr || [[#Datentypen|String]] || 20 || - || Hostseitige Freigabenummer die für dieses Packstück gesetzt wird.
+
| auftraggeberID || [[#Datentypen|Sequence]] [[#Datentypen|<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 z.B. die UPS Summary gedruckt wird.<br>
 +
(Benötigt Druckerspooler Erweiterungsmodul)
 +
|-
 +
| frachtfuehrerTyp || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.
 +
(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)
 
|-
 
|-
−
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.
 
|-
 
|-
−
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. <br>
+
| versandartID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.
−
Beim Etikettendruck zuvor muss die gleiche ID übergeben worden sein, damit das HVS32 das zu verladene Packstück eindeutig identifizieren kann.
+
(Option MultiVATagesabschluss muss im HVS32 aktiv sein)
 
|-
 
|-
−
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird.
+
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
 
|}
 
|}
 +
</div></div>
 
<br>
 
<br>
−
;VerladeAntwort.
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
:Rückmeldung vom HVS32 nach einer VerladeAnfrage
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 +
|-
 +
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] '''[[#edistatus|<EDIStatus>]]''' || - || - || Liste mit Statusinformationen für EDIs.
 
|-
 
|-
 
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
Zeile 523: Zeile 1.328:
 
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der EDI-Listen (z.B. UPS Summary) als Key/Value Map.
 
|}
 
|}
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE verladeVersandaten ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- versanddatenAnfrage ------------------------------------------------------------------------------- -->
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
== versanddatenAnfrage ==
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
HVS32-VersandDatenAnfrage zum Erzeugen von Versandeinheiten und anschließendem Druck der zugehörigen Etiketten.<br><br>
+
<div class="mw-collapsible-content">
−
;VersanddatenAnfrage.
+
<source lang="xml">
−
:Anfrage vom Hostsystem zum Drucken eines Versandetiketts für ein Packstück.
+
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:ediabschlussAnfrage>
 +
        <arg0>
 +
            <auftraggeberID></auftraggeberID>
 +
            <druckername></druckername>
 +
            <frachtfuehrerTyp></frachtfuehrerTyp>
 +
            <packplatz></packplatz>
 +
            <versandartID></versandartID>
 +
            <wechselbruecke></wechselbruecke>
 +
        </arg0>
 +
      </std:ediabschlussAnfrage>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE ediabschlussAnfrage ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
 +
== Packstückdaten prüfen (versanddatenPruefAnfrage) ==
 +
Das Gateway sendet die versanddatenPruefAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine VersandDatenAnfrage simuliert. Dabei werden keine Etiketten gedruckt und das Packstück bzw. das Etikett wird nicht verbucht, jedoch sind alle weiteren Prozesse identisch zur VersandDatenAnfrage (Routenermittlung, Trackingnummer-Ermittlung, Adressprüfung, etc.) Diese Funktion dient dazu im Vorfeld alle Versand-Daten zu validieren.
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
Zeile 538: Zeile 1.368:
 
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
|-
 
|-
−
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
+
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#ArtikelDaten|Packstück-Artikel]] vom Typ '''[[#ArtikelDaten|ArtikelDaten]]''' (1:n)
−
|-
 
−
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] [[#artikelDaten|<ArtikelDaten>]] || - || - || -
 
 
|-
 
|-
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
Zeile 548: Zeile 1.376:
 
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
| '''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
 
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 
|-
 
|-
 
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
−
|-
 
−
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 
−
|-
 
−
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 
−
|-
 
−
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 
 
|-
 
|-
 
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
 
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
Zeile 567: Zeile 1.389:
 
|-
 
|-
 
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
 
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
−
|-
 
−
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
 
 
|-
 
|-
 
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
Zeile 580: Zeile 1.400:
 
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 
|-
 
|-
−
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] [[#gefahrgut|<Gefahrgut>]] || - || - || -
+
| [[#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
 
 
|-
 
|-
−
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
+
| '''gewicht''' ||[[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 
|-
 
|-
 
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
Zeile 612: Zeile 1.430:
 
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
|-
 
|-
−
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -
+
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
−
|-
 
−
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
 
−
|-
 
−
| lieferantenID || [[#Datentypen|Integer]] || - || - || -
 
−
|-
 
−
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
 
 
|-
 
|-
 
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
 
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
−
|-
 
−
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
 
 
|-
 
|-
 
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
 
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
Zeile 652: Zeile 1.456:
 
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
|-
 
|-
−
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
+
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 
|-
 
|-
−
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
+
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
 
|-
 
|-
 
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
 
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
Zeile 687: Zeile 1.491:
 
|-
 
|-
 
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
 
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
−
|-
 
−
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
 
 
|-
 
|-
 
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
 
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
−
|-
 
−
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
 
 
|-
 
|-
 
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
 
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
Zeile 709: Zeile 1.509:
 
|-
 
|-
 
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
 
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
−
|-
 
−
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
 
|-
 
|-
 
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 
|-
 
|-
 
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
−
|-
 
−
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird
 
 
|-
 
|-
 
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
Zeile 744: Zeile 1.540:
 
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|}
 
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|-
 +
|-
 +
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 +
|-
 +
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 +
|-
 +
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 +
|-
 +
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
 +
<div class="mw-collapsible-content">
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:versanddatenPruefAnfrage>
 +
        <arg0>
 +
            <ansprechpartner></ansprechpartner>
 +
            <artikelDaten>
 +
              <anzahlBuegel></anzahlBuegel>
 +
              <anzahlPosEtiketten></anzahlPosEtiketten>
 +
              <artikelBTNNr></artikelBTNNr>
 +
              <artikelEAN></artikelEAN>
 +
              <artikelEinheit></artikelEinheit>
 +
              <artikelGewicht></artikelGewicht>
 +
              <artikelGruppe></artikelGruppe>
 +
              <artikelMenge></artikelMenge>
 +
              <artikelServices></artikelServices>
 +
              <artikelSollMenge></artikelSollMenge>
 +
              <artikelText1></artikelText1>
 +
              <artikelText2></artikelText2>
 +
              <artikelText3></artikelText3>
 +
              <artikelText4></artikelText4>
 +
              <artikelVolumen></artikelVolumen>
 +
              <artikelWaehrung></artikelWaehrung>
 +
              <artikelWert></artikelWert>
 +
              <chargeFlag></chargeFlag>
 +
              <kundenArtikelNr></kundenArtikelNr>
 +
              <kundenBestellNr></kundenBestellNr>
 +
              <posAuftragNr></posAuftragNr>
 +
              <posLieferNr></posLieferNr>
 +
              <positionNr></positionNr>
 +
              <serienNr></serienNr>
 +
              <ursprungLand></ursprungLand>
 +
            </artikelDaten>
 +
            <assoc>
 +
              <entry>
 +
                  <key></key>
 +
                  <value></value>
 +
              </entry>
 +
            </assoc>
 +
            <auftragNr></auftragNr>
 +
            <auftraggeberID></auftraggeberID>
 +
            <avisHinweis1></avisHinweis1>
 +
            <avisHinweis2></avisHinweis2>
 +
            <avisZusatz1></avisZusatz1>
 +
            <avisZusatz2></avisZusatz2>
 +
            <bestellNr></bestellNr>
 +
            <druckername></druckername>
 +
            <email></email>
 +
            <faxNr></faxNr>
 +
            <frachtBrief></frachtBrief>
 +
            <frachtfuehrerKdNr></frachtfuehrerKdNr>
 +
            <frankaturKennung></frankaturKennung>
 +
            <gefahrgut>
 +
              <gefahrgutBefoerdKat></gefahrgutBefoerdKat>
 +
              <gefahrgutBegrenzteMenge></gefahrgutBegrenzteMenge>
 +
              <gefahrgutBezeichnung></gefahrgutBezeichnung>
 +
              <gefahrgutBuchst640></gefahrgutBuchst640>
 +
              <gefahrgutFFCode></gefahrgutFFCode>
 +
              <gefahrgutFaktor></gefahrgutFaktor>
 +
              <gefahrgutFreigestMenge></gefahrgutFreigestMenge>
 +
              <gefahrgutKCode></gefahrgutKCode>
 +
              <gefahrgutKlasse></gefahrgutKlasse>
 +
              <gefahrgutMenge></gefahrgutMenge>
 +
              <gefahrgutMengenEinheit></gefahrgutMengenEinheit>
 +
              <gefahrgutNebenGefahr></gefahrgutNebenGefahr>
 +
              <gefahrgutNettoExplMasse></gefahrgutNettoExplMasse>
 +
              <gefahrgutTunnelBCode></gefahrgutTunnelBCode>
 +
              <gefahrgutUNNR></gefahrgutUNNR>
 +
              <gefahrgutUmweltGef></gefahrgutUmweltGef>
 +
              <gefahrgutVPG></gefahrgutVPG>
 +
              <gefahrgutVerpAnzahl></gefahrgutVerpAnzahl>
 +
              <gefahrgutVerpackungsart></gefahrgutVerpackungsart>
 +
            </gefahrgut>
 +
            <gewicht></gewicht>
 +
            <ilnNr></ilnNr>
 +
            <infotext1></infotext1>
 +
            <infotext10></infotext10>
 +
            <infotext2></infotext2>
 +
            <infotext3></infotext3>
 +
            <infotext4></infotext4>
 +
            <infotext5></infotext5>
 +
            <infotext6></infotext6>
 +
            <infotext7></infotext7>
 +
            <infotext8></infotext8>
 +
            <infotext9></infotext9>
 +
            <kostenstelle></kostenstelle>
 +
            <kundenNr></kundenNr>
 +
            <lieferscheinNr></lieferscheinNr>
 +
            <nachnahme></nachnahme>
 +
            <nettoGewicht></nettoGewicht>
 +
            <neutabsenderLKZ></neutabsenderLKZ>
 +
            <neutabsenderName1></neutabsenderName1>
 +
            <neutabsenderName2></neutabsenderName2>
 +
            <neutabsenderName3></neutabsenderName3>
 +
            <neutabsenderOrt></neutabsenderOrt>
 +
            <neutabsenderPLZ></neutabsenderPLZ>
 +
            <neutabsenderStrasse></neutabsenderStrasse>
 +
            <nnVermerk></nnVermerk>
 +
            <nnVerwendung></nnVerwendung>
 +
            <nnWaehrung></nnWaehrung>
 +
            <packStkGes></packStkGes>
 +
            <packStkNr></packStkNr>
 +
            <packplatz></packplatz>
 +
            <packstueckBreite></packstueckBreite>
 +
            <packstueckHoehe></packstueckHoehe>
 +
            <packstueckID></packstueckID>
 +
            <packstueckLaenge></packstueckLaenge>
 +
            <paperlessInvoice></paperlessInvoice>
 +
            <postLeitcode></postLeitcode>
 +
            <postZielFrachtzent></postZielFrachtzent>
 +
            <rechnungsEmpfLKZ></rechnungsEmpfLKZ>
 +
            <rechnungsEmpfName1></rechnungsEmpfName1>
 +
            <rechnungsEmpfName2></rechnungsEmpfName2>
 +
            <rechnungsEmpfName3></rechnungsEmpfName3>
 +
            <rechnungsEmpfOrt></rechnungsEmpfOrt>
 +
            <rechnungsEmpfPLZ></rechnungsEmpfPLZ>
 +
            <rechnungsEmpfStrasse></rechnungsEmpfStrasse>
 +
            <sendungsinhalt></sendungsinhalt>
 +
            <sonderdienste></sonderdienste>
 +
            <telefonNr></telefonNr>
 +
            <terminArt></terminArt>
 +
            <terminDatum></terminDatum>
 +
            <terminZeit></terminZeit>
 +
            <ustIDNr></ustIDNr>
 +
            <verpackungsart></verpackungsart>
 +
            <versandartID></versandartID>
 +
            <versicherungswert></versicherungswert>
 +
            <vwWaehrung></vwWaehrung>
 +
            <warenwert></warenwert>
 +
            <wwWaehrung></wwWaehrung>
 +
            <zahlungsbedingung></zahlungsbedingung>
 +
            <zbZoll></zbZoll>
 +
            <zielAdrBahnhof></zielAdrBahnhof>
 +
            <zielAdrLKZ></zielAdrLKZ>
 +
            <zielAdrName1></zielAdrName1>
 +
            <zielAdrName2></zielAdrName2>
 +
            <zielAdrName3></zielAdrName3>
 +
            <zielAdrOrt></zielAdrOrt>
 +
            <zielAdrPLZ></zielAdrPLZ>
 +
            <zielAdrRegion></zielAdrRegion>
 +
            <zielAdrStrasse></zielAdrStrasse>
 +
        </arg0>
 +
      </std:versanddatenPruefAnfrage>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- updateVersanddaten ------------------------------------------------------------------------------- -->
 +
 +
== 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.
 
<br>
 
<br>
−
;VersanddatenAntwort.
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
:Rückmeldung vom HVS32 nach einer sendungsdatenAnfrage.
+
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um den Datensatz zu identifizieren.
 +
|-
 +
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
 +
|-
 +
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
|-
 
|-
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 +
|-
 +
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 +
|-
 +
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 +
|-
 +
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 +
|-
 +
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
 +
|-
 +
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
 +
|-
 +
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
 +
|-
 +
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 +
|-
 +
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
 +
|-
 +
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 +
|-
 +
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 +
|-
 +
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 +
|-
 +
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
 +
|-
 +
| lieferantenID || [[#Datentypen|Integer]] || - || - || -
 +
|-
 +
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
−
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
 
|-
 
|-
−
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
 
|-
 
|-
−
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
|-
 
|-
−
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
+
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
 
|-
 
|-
−
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
+
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
 
|-
 
|-
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
+
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
 
|-
 
|-
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
 
|-
 
|-
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
|-
 
|-
−
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
+
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
|-
 
|-
−
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
+
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
|-
 
|-
−
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
+
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
 
|-
 
|-
−
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
+
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
 
|-
 
|-
−
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
+
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
 
|-
 
|-
−
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
+
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
 
|-
 
|-
−
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
+
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
 
|-
 
|-
−
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
+
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
 
|-
 
|-
−
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
−
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
 
|-
 
|-
−
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 
|-
 
|-
−
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird
 
|-
 
|-
−
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
−
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 
|-
 
|-
−
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|
 
|-
 
|-
−
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
 
|-
 
|-
−
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
−
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|}
 
|}
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE versanddatenAnfrage ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- -->
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
== versanddatenNachdruckAnfrage ==
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
Dient dem Nachdruck von Versandetiketten (Schalter in Sektion AutomatikPolling: NachdruckBeiVersanddatenanfrage=“ON“ muss gesetzt sein)<br><br>
+
<div class="mw-collapsible-content">
−
;VersanddatenNachdruckAnfrage.
+
<source lang="xml">
−
:Anfrage vom Hostsystem zum Nachdruck eines zuvor erstellten Versandetiketts. Schalter NachdruckBeiVersanddatenanfrage=“ON“ in Sektion AutomatikPolling muss gesetzt sein.
+
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
−
 
+
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:updateVersanddaten>
 +
        <arg0>
 +
            <ansprechpartner></ansprechpartner>
 +
            <anzahlArtikel></anzahlArtikel>
 +
            <artikelDaten>
 +
              <anzahlBuegel></anzahlBuegel>
 +
              <anzahlPosEtiketten></anzahlPosEtiketten>
 +
              <artikelBTNNr></artikelBTNNr>
 +
              <artikelEAN></artikelEAN>
 +
              <artikelEinheit></artikelEinheit>
 +
              <artikelGewicht></artikelGewicht>
 +
              <artikelGruppe></artikelGruppe>
 +
              <artikelMenge></artikelMenge>
 +
              <artikelServices></artikelServices>
 +
              <artikelSollMenge></artikelSollMenge>
 +
              <artikelText1></artikelText1>
 +
              <artikelText2></artikelText2>
 +
              <artikelText3></artikelText3>
 +
              <artikelText4></artikelText4>
 +
              <artikelVolumen></artikelVolumen>
 +
              <artikelWaehrung></artikelWaehrung>
 +
              <artikelWert></artikelWert>
 +
              <chargeFlag></chargeFlag>
 +
              <kundenArtikelNr></kundenArtikelNr>
 +
              <kundenBestellNr></kundenBestellNr>
 +
              <posAuftragNr></posAuftragNr>
 +
              <posLieferNr></posLieferNr>
 +
              <positionNr></positionNr>
 +
              <serienNr></serienNr>
 +
              <ursprungLand></ursprungLand>
 +
            </artikelDaten>
 +
            <assoc>
 +
              <entry>
 +
                  <key></key>
 +
                  <value></value>
 +
              </entry>
 +
            </assoc>
 +
            <auftragNr></auftragNr>
 +
            <auftraggeberID></auftraggeberID>
 +
            <avisHinweis1></avisHinweis1>
 +
            <avisHinweis2></avisHinweis2>
 +
            <avisZusatz1></avisZusatz1>
 +
            <avisZusatz2></avisZusatz2>
 +
            <barcodeID></barcodeID>
 +
            <barcodeText></barcodeText>
 +
            <barcodeTyp></barcodeTyp>
 +
            <bestellNr></bestellNr>
 +
            <druckername></druckername>
 +
            <email></email>
 +
            <empfMobilfunkNr></empfMobilfunkNr>
 +
            <faxNr></faxNr>
 +
            <fehlertext></fehlertext>
 +
            <flexZustellungEmailadresse></flexZustellungEmailadresse>
 +
            <frachtBrief></frachtBrief>
 +
            <frachtfuehrerKdNr></frachtfuehrerKdNr>
 +
            <frankaturKennung></frankaturKennung>
 +
            <gefahrgut>
 +
              <gefahrgutBefoerdKat></gefahrgutBefoerdKat>
 +
              <gefahrgutBegrenzteMenge></gefahrgutBegrenzteMenge>
 +
              <gefahrgutBezeichnung></gefahrgutBezeichnung>
 +
              <gefahrgutBuchst640></gefahrgutBuchst640>
 +
              <gefahrgutFFCode></gefahrgutFFCode>
 +
              <gefahrgutFaktor></gefahrgutFaktor>
 +
              <gefahrgutFreigestMenge></gefahrgutFreigestMenge>
 +
              <gefahrgutKCode></gefahrgutKCode>
 +
              <gefahrgutKlasse></gefahrgutKlasse>
 +
              <gefahrgutMenge></gefahrgutMenge>
 +
              <gefahrgutMengenEinheit></gefahrgutMengenEinheit>
 +
              <gefahrgutNebenGefahr></gefahrgutNebenGefahr>
 +
              <gefahrgutNettoExplMasse></gefahrgutNettoExplMasse>
 +
              <gefahrgutTunnelBCode></gefahrgutTunnelBCode>
 +
              <gefahrgutUNNR></gefahrgutUNNR>
 +
              <gefahrgutUmweltGef></gefahrgutUmweltGef>
 +
              <gefahrgutVPG></gefahrgutVPG>
 +
              <gefahrgutVerpAnzahl></gefahrgutVerpAnzahl>
 +
              <gefahrgutVerpackungsart></gefahrgutVerpackungsart>
 +
            </gefahrgut>
 +
            <gewicht></gewicht>
 +
            <hostTrackingNr></hostTrackingNr>
 +
            <ilnNr></ilnNr>
 +
            <infotext1></infotext1>
 +
            <infotext10></infotext10>
 +
            <infotext2></infotext2>
 +
            <infotext3></infotext3>
 +
            <infotext4></infotext4>
 +
            <infotext5></infotext5>
 +
            <infotext6></infotext6>
 +
            <infotext7></infotext7>
 +
            <infotext8></infotext8>
 +
            <infotext9></infotext9>
 +
            <kostenstelle></kostenstelle>
 +
            <kundenNr></kundenNr>
 +
            <lagerkennzeichen></lagerkennzeichen>
 +
            <letztesPackstueck></letztesPackstueck>
 +
            <lieferantenID></lieferantenID>
 +
            <lieferscheinNr></lieferscheinNr>
 +
            <nachnahme></nachnahme>
 +
            <nettoGewicht></nettoGewicht>
 +
            <neutBIC></neutBIC>
 +
            <neutBankBezeichnung></neutBankBezeichnung>
 +
            <neutIBAN></neutIBAN>
 +
            <neutKontoInhaber></neutKontoInhaber>
 +
            <neutabsenderLKZ></neutabsenderLKZ>
 +
            <neutabsenderName1></neutabsenderName1>
 +
            <neutabsenderName2></neutabsenderName2>
 +
            <neutabsenderName3></neutabsenderName3>
 +
            <neutabsenderOrt></neutabsenderOrt>
 +
            <neutabsenderPLZ></neutabsenderPLZ>
 +
            <neutabsenderStrasse></neutabsenderStrasse>
 +
            <nnVermerk></nnVermerk>
 +
            <nnVerwendung></nnVerwendung>
 +
            <nnWaehrung></nnWaehrung>
 +
            <packStkGes></packStkGes>
 +
            <packStkNr></packStkNr>
 +
            <packplatz></packplatz>
 +
            <packstueckBreite></packstueckBreite>
 +
            <packstueckHoehe></packstueckHoehe>
 +
            <packstueckID></packstueckID>
 +
            <packstueckLaenge></packstueckLaenge>
 +
            <paperlessInvoice></paperlessInvoice>
 +
            <postLeitcode></postLeitcode>
 +
            <postZielFrachtzent></postZielFrachtzent>
 +
            <rechnungsEmpfLKZ></rechnungsEmpfLKZ>
 +
            <rechnungsEmpfName1></rechnungsEmpfName1>
 +
            <rechnungsEmpfName2></rechnungsEmpfName2>
 +
            <rechnungsEmpfName3></rechnungsEmpfName3>
 +
            <rechnungsEmpfOrt></rechnungsEmpfOrt>
 +
            <rechnungsEmpfPLZ></rechnungsEmpfPLZ>
 +
            <rechnungsEmpfStrasse></rechnungsEmpfStrasse>
 +
            <rechnungsNr></rechnungsNr>
 +
            <sendungsinhalt></sendungsinhalt>
 +
            <sonderdienste></sonderdienste>
 +
            <sperrFlag></sperrFlag>
 +
            <telefonNr></telefonNr>
 +
            <terminArt></terminArt>
 +
            <terminDatum></terminDatum>
 +
            <terminZeit></terminZeit>
 +
            <ustIDNr></ustIDNr>
 +
            <verpackungsart></verpackungsart>
 +
            <versandartID></versandartID>
 +
            <versicherungswert></versicherungswert>
 +
            <vorpackdatum></vorpackdatum>
 +
            <vwWaehrung></vwWaehrung>
 +
            <warenwert></warenwert>
 +
            <wechselbruecke></wechselbruecke>
 +
            <wwWaehrung></wwWaehrung>
 +
            <zahlungsbedingung></zahlungsbedingung>
 +
            <zbZoll></zbZoll>
 +
            <zielAdrBahnhof></zielAdrBahnhof>
 +
            <zielAdrLKZ></zielAdrLKZ>
 +
            <zielAdrName1></zielAdrName1>
 +
            <zielAdrName2></zielAdrName2>
 +
            <zielAdrName3></zielAdrName3>
 +
            <zielAdrName4></zielAdrName4>
 +
            <zielAdrOrt></zielAdrOrt>
 +
            <zielAdrPLZ></zielAdrPLZ>
 +
            <zielAdrRegion></zielAdrRegion>
 +
            <zielAdrStrasse></zielAdrStrasse>
 +
        </arg0>
 +
      </std:updateVersanddaten>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- 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.
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung
 +
|-
 +
| auftragsNr || [[#Datentypen|String]] || 20 || - || -
 +
|-
 +
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.
 +
|-
 +
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 +
|-
 +
| packstueckID || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird.
+
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 
|-
 
|-
−
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
+
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung
 
|-
 
|-
−
| '''packstueckID''' || [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
−
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|}
 
|}
 +
</div></div>
 
<br>
 
<br>
−
;[[#versanddatenAnfrage|VersanddatenAntwort]].
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
 +
<div class="mw-collapsible-content">
 +
<source lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
 +
  <soapenv:Header/>
 +
  <soapenv:Body>
 +
      <std:anonymisiereVersandDaten>
 +
        <arg0>
 +
            <auftragsNr></auftragsNr>
 +
            <lieferscheinNr></lieferscheinNr>
 +
            <packplatz></packplatz>
 +
            <packstueckID></packstueckID>
 +
            <trackingNr></trackingNr>
 +
        </arg0>
 +
      </std:anonymisiereVersandDaten>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE anonymisiereVersandDaten ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
  
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
+
== Sendungs-Verarbeitung (sendungsdatenAnfrage) ==
−
<!-- ------------------------------------------------------------------------------- ENDE versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- -->
+
HVS32-Sendungsdaten Anfrage – wird zur Laufzeit in einzelne [[#versandDatenAnfragen|versandDatenAnfragen]] unterteilt. Muss bei einer Anfrage für das [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] genutzt werden (requestSPM=TRUE).
−
<!-- ------------------------------------------------------------------------------- versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
+
<br>
−
== versanddatenPruefAnfrage ==
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
HVS32-VersandDatenAnfrage zum Prüfen der Versanddaten.<br><br>
+
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
−
;VersanddatenPruefAnfrage.
+
<div class="mw-collapsible-content">
−
:Anfrage vom Hostsystem zum Drucken eines Versandetiketts für ein Packstück.
+
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
Zeile 842: Zeile 2.067:
 
|-
 
|-
 
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
−
|-
 
−
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] [[#artikelDaten|<ArtikelDaten>]] || - || - || -
 
 
|-
 
|-
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
Zeile 851: Zeile 2.074:
 
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
|-
 
|-
−
| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+
| ausschlussFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Ausschluss-Frachtführer für SPM Anfrage
 +
|-
 +
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
−
| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
 
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
Zeile 859: Zeile 2.084:
 
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
|-
 
|-
−
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
+
| bestellNr || [[#Datentypen|String]] || 20 || - || -
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
+
| email || [[#Datentypen|String]] || 100 || - || Für automatische Mailavisierung
 
|-
 
|-
−
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
+
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
 
|-
 
|-
 
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
|-
 
|-
−
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
+
| flexZustellungEmailadResponsese || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Email-Adresse
 
|-
 
|-
−
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
+
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer, falls Frachtbrief durch Vorsystem gedruckt wird.
 
|-
 
|-
−
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
+
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer.
 
|-
 
|-
 
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
−
|-
 
−
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] [[#gefahrgut|<Gefahrgut>]] || - || - || -
 
−
|-
 
−
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 
 
|-
 
|-
 
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
|-
 
|-
−
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
 
|-
 
|-
−
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
|-
 
|-
−
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| Lagerkennzeichen || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
 
|-
 
|-
−
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| LieferantenID || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
 
|-
 
|-
−
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.
 
|-
 
|-
−
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
−
|-
 
−
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
−
|-
 
−
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
 
−
|-
 
−
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
−
|-
 
−
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
 
−
|-
 
−
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 
−
|-
 
−
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 
 
|-
 
|-
 
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
 
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
Zeile 925: Zeile 2.134:
 
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
+
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 
|-
 
|-
−
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
+
| [[#packstueckDaten|packstueckDaten]] || [[#Datentypen|Sequence]] [[#packstueckDaten|<PackStueckDaten>]] || - || - || -
−
|-
 
−
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
−
|-
 
−
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 
−
|-
 
−
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
 
 
|-
 
|-
 
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
 
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
−
|-
 
−
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
 
−
|-
 
−
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
 
−
|-
 
−
| packstueckID || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.
 
−
|-
 
−
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
 
 
|-
 
|-
 
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
 
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
Zeile 966: Zeile 2.161:
 
|-
 
|-
 
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
 
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
 +
|-
 +
| requestSPM || [[#Datentypen|String]] || 5 || - || T/TRUE wenn die Entscheidungsmatrix angesprochen werden soll, sonst leer
 +
|-
 +
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
 
|-
 
|-
 
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
 
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
 +
|-
 +
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
 
|-
 
|-
 
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
 
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
Zeile 975: Zeile 2.176:
 
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
−
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
+
| terminZeit || [[#Datentypen|String]] || 5 || - || HH:MM
 
|-
 
|-
 
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
 
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
−
|-
 
−
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
 
 
|-
 
|-
 
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
 
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
 
|-
 
|-
−
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
+
| vorgabeFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Vorgabe-Frachtführer für [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] Anfrage
 
|-
 
|-
−
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
+
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
−
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
+
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen werden soll
−
|-
 
−
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 
 
|-
 
|-
 
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
 
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
Zeile 1.015: Zeile 2.212:
 
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|}
 
|}
 +
</div></div>
 
<br>
 
<br>
−
;VersanddatenPruefAntwort.
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
:Rückmeldung vom HVS32 nach einer sendungsdatenAnfrage.
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|-
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| fehler || [[#Datentypen|String]] || - || - || Wird im Fehlerfall befüllt
 
|-
 
|-
−
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| sendungsGebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachkosten
 
|-
 
|-
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| sendungsGebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
 
|-
 
|-
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
+
| versandSendungsNr || [[#Datentypen|String]] || 20 || - || Sendungsnummer
 +
|}
  
−
|}
+
;Packstückdaten
−
;<big><big>'''[[SOAP_Beispiel|XML Beispiele]]'''</big></big>
 
−
<!-- ------------------------------------------------------------------------------- ENDE versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
 
−
<!-- ------------------------------------------------------------------------------- ÜBERSICHT UNTERFUNKTIONEN ------------------------------------------------------------------------------- -->
 
−
= Übersicht der Unterfunktionen =
 
−
Eine Unterfunktion kann innerhalb der Anfrage / Rückmeldung einer [[#Übersicht der Funktionen|Funktion]] auftreten.
 
−
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT UNTERFUNKTIONEN ------------------------------------------------------------------------------- -->
 
−
<!-- ------------------------------------------------------------------------------- packstueckDaten ------------------------------------------------------------------------------- -->
 
−
== packstueckDaten ==
 
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|
−
|-
 
−
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
 
−
|-
 
−
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] [[#artikelDaten|<ArtikelDaten>]] || - || - || -
 
 
|-
 
|-
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 
|-
 
|-
−
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 
|-
 
|-
−
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
+
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
−
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] [[#gefahrgut|<Gefahrgut>]] || - || - || -
+
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
 
|-
 
|-
−
| '''gewicht''' || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
 
|-
 
|-
−
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Falls die Paketnummer aus dem Vorsystem verwendet werden soll.
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
 
|-
 
|-
−
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
−
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
−
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
 
|-
 
|-
−
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
 
|-
 
|-
−
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
 
|-
 
|-
−
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
 
|-
 
|-
−
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
 
|-
 
|-
−
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
 
|-
 
|-
−
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
 
|-
 
|-
−
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstück der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
+
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| nachnahme || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
+
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
+
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| nnVermerk || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
+
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| nnVerwendung || [[#Datentypen|String]] || 1 || - || 'B' = Bar, 'V' = Verrechnungsscheck
+
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
+
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Laufende Nummer pro Sendung
+
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
+
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
+
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
|-
 
−
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.
 
−
|-
 
−
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
 
−
|-
 
−
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
 
−
|-
 
−
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe-Versicherungswert
 
−
|-
 
−
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 
−
|-
 
−
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 
−
|-
 
−
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 
 
|}
 
|}
−
<!-- ------------------------------------------------------------------------------- ENDE packstueckDaten ------------------------------------------------------------------------------- -->
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- artikelDaten ------------------------------------------------------------------------------- -->
+
<br>
−
== artikelDaten ==
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
{| class="wikitable sortable"
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
|-
+
<div class="mw-collapsible-content">
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
<source lang="xml">
−
|-
+
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
−
| anzahlBuegel || [[#Datentypen|Integer]] || - || - || Nur für Hängeversand: Anzahl der Bügel auf welche die Artikelgruppe aufgeteilt ist
+
  <soapenv:Header/>
−
|-
+
  <soapenv:Body>
−
| anzahlPosEtiketten || [[#Datentypen|Integer]] || - || - || Anzahl Artikeletiketten, welche gedruckt werden sollen
+
      <std:sendungsdatenAnfrage>
−
|-
+
        <arg0>
−
| artikelBTNNr || [[#Datentypen|String]] || 25 || - || BTN Nummer / Zolltarifnummer
+
            <ansprechpartner></ansprechpartner>
−
|-
+
            <assoc>
−
| artikelEAN || [[#Datentypen|String]] || 20 || - || EAN Nummer
+
              <entry>
−
|-
+
                  <key></key>
−
| artikelEinheit || [[#Datentypen|String]] || 10 || - || Einheit der Artikelmenge
+
                  <value></value>
−
|-
+
              </entry>
−
| artikelGewicht || [[#Datentypen|Decimal]] || 9 || 3 || Gewicht des Arikels
+
            </assoc>
−
|-
+
            <auftragNr></auftragNr>
−
| artikelGruppe || [[#Datentypen|String]] || 50 || - || Artikelgruppe
+
            <auftraggeberID></auftraggeberID>
−
|-
+
            <ausschlussFrachtfuehrer></ausschlussFrachtfuehrer>
−
| artikelMenge || [[#Datentypen|Decimal]] || 9 || 3 || Menge des Artikels
+
            <avisHinweis1></avisHinweis1>
−
|-
+
            <avisHinweis2></avisHinweis2>
−
| artikelServices || [[#Datentypen|String]] || 100 || - || Pipe getrennte Services für diesen Artikel
+
            <avisZusatz1></avisZusatz1>
−
|-
+
            <avisZusatz2></avisZusatz2>
−
| artikelSollMenge || [[#Datentypen|Decimal]] || 9 || 3 || -
+
            <bestellNr></bestellNr>
−
|-
+
            <email></email>
−
| artikelText1 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
+
            <empfMobilfunkNr></empfMobilfunkNr>
−
|-
+
            <faxNr></faxNr>
−
| artikelText2 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
+
            <flexZustellungEmailadresse></flexZustellungEmailadresse>
−
|-
+
            <frachtBrief></frachtBrief>
−
| artikelText3 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
+
            <frachtfuehrerKdNr></frachtfuehrerKdNr>
−
|-
+
            <frankaturKennung></frankaturKennung>
−
| artikelText4 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
+
            <ilnNr></ilnNr>
−
|-
+
            <kostenstelle></kostenstelle>
−
| artikelVolumen || [[#Datentypen|Decimal]] || 9 || 3 || Volumen des Artikels
+
            <kundenNr></kundenNr>
−
|-
+
            <lagerkennzeichen></lagerkennzeichen>
−
| artikelWaehrung || [[#Datentypen|String]] || 3 || - || Währung in welcher der Wert des Artikels angegeben wird
+
            <lieferantenID></lieferantenID>
−
|-
+
            <lieferscheinNr></lieferscheinNr>
−
| artikelWert || [[#Datentypen|Decimal]] || 18 || 2 || Wert des Artikels
+
            <neutBIC></neutBIC>
−
|-
+
            <neutBankBezeichnung></neutBankBezeichnung>
−
| chargeFlag || [[#Datentypen|String]] || 1 || - ||
+
            <neutIBAN></neutIBAN>
−
|-
+
            <neutKontoInhaber></neutKontoInhaber>
−
| kundenArtikelNr || [[#Datentypen|String]] || 50 || - || Artikelnummer
+
            <neutabsenderLKZ></neutabsenderLKZ>
−
|-
+
            <neutabsenderName1></neutabsenderName1>
−
| kundenBestellNr || [[#Datentypen|String]] || 50 || - || Bestellnummer
+
            <neutabsenderName2></neutabsenderName2>
−
|-
+
            <neutabsenderName3></neutabsenderName3>
−
| posAuftragNr || [[#Datentypen|String]] || 50 || - || Auftragsnummer
+
            <neutabsenderOrt></neutabsenderOrt>
−
|-
+
            <neutabsenderPLZ></neutabsenderPLZ>
−
| posLieferNr || [[#Datentypen|String]] || 40 || - || Lieferscheinnummer
+
            <neutabsenderStrasse></neutabsenderStrasse>
−
|-
+
            <packStkGes></packStkGes>
−
| positionNr || [[#Datentypen|String]] || 50 || - || Laufende Nummer innerhalb des Packstücks
+
            <packStueckDaten>
−
|-
+
              <anzahlArtikel></anzahlArtikel>
−
| serienNr || [[#Datentypen|String]] || 30 || - || Seriennummer
+
              <artikelDaten>
−
|-
+
                  <anzahlBuegel></anzahlBuegel>
−
| ursprungLand || [[#Datentypen|String]] || 2 || - || Ursprungsland des Artikels
+
                  <anzahlPosEtiketten></anzahlPosEtiketten>
−
|}
+
                  <artikelBTNNr></artikelBTNNr>
−
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- -->
+
                  <artikelEAN></artikelEAN>
−
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- -->
+
                  <artikelEinheit></artikelEinheit>
−
== gefahrgut ==
+
                  <artikelGewicht></artikelGewicht>
−
{| class="wikitable sortable"
+
                  <artikelGruppe></artikelGruppe>
−
|-
+
                  <artikelMenge></artikelMenge>
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
                  <artikelServices></artikelServices>
−
|-
+
                  <artikelSollMenge></artikelSollMenge>
−
| gefahrgutBefoerdKat || [[#Datentypen|Integer]] || 1 || - || Beförderungskategorie, Pflicht (siehe ADR-Tabelle Spalte (15)), kann 0-4 sein. Achtung! Muss unbedingt korrekt sein.
+
                  <artikelText1></artikelText1>
−
|-
+
                  <artikelText2></artikelText2>
−
| gefahrgutBegrenzteMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status LQ / Begrenzte Menge nach ADR 3.4 verschickt wird, ansonsten F, Pflicht
+
                  <artikelText3></artikelText3>
−
|-
+
                  <artikelText4></artikelText4>
−
| gefahrgutBezeichnung || [[#Datentypen|String]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (2))
+
                  <artikelVolumen></artikelVolumen>
−
|-
+
                  <artikelWaehrung></artikelWaehrung>
−
| gefahrgutBuchst640 || [[#Datentypen|String]] || 1 || - || Buchstabe für Sondervorschrift 640, bedingte Pflicht bei Stoffen, bei denen die Sondervorschrift 640 gilt (siehe ADR-Tabelle Spalte (6))
+
                  <artikelWert></artikelWert>
−
|-
+
                  <chargeFlag></chargeFlag>
−
| gefahrgutFFCode || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
+
                  <kundenArtikelNr></kundenArtikelNr>
−
|-
+
                  <kundenBestellNr></kundenBestellNr>
−
| gefahrgutFaktor || [[#Datentypen|Integer]] || 3 || - || Bewertungsfaktor für Punktesummation auf dem Beförderungspapier,  (kann 0, 1, 3, 50 oder 999 sein), eigentlich Pflicht, kann aber eindeutig aus der Beförderungskategorie geschlossen werden, daher muss es nicht unbedingt belegt sein
+
                  <posAuftragNr></posAuftragNr>
−
|-
+
                  <posLieferNr></posLieferNr>
−
| gefahrgutFreigestMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status EQ / Excepted Quantities nach ADR 3.5 verschickt wird, ansonsten F, Pflicht
+
                  <positionNr></positionNr>
−
|-
+
                  <serienNr></serienNr>
−
| gefahrgutKCode || [[#Datentypen|String]] || 10 || - || Klassifizierungscode, Pflicht (siehe ADR-Tabelle Spalte (3b))
+
                  <ursprungLand></ursprungLand>
−
|-
+
              </artikelDaten>
−
| gefahrgutKlasse || [[#Datentypen|String]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (3a))
+
              <assoc>
−
|-
+
                  <entry>
−
| 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 )
+
                    <key></key>
−
|-
+
                    <value></value>
−
| gefahrgutMengenEinheit || [[#Datentypen|String]] || 2 || - || Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg
+
                  </entry>
−
|-
+
              </assoc>
−
| 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 )
+
              <barcodeID></barcodeID>
−
|-
+
              <barcodeText></barcodeText>
−
| gefahrgutNettoExplMasse || [[#Datentypen|Decimal]] || 8 || 3 || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
+
              <barcodeTyp></barcodeTyp>
−
|-
+
              <druckername></druckername>
−
| gefahrgutTunnelBCode || [[#Datentypen|String]] || 10 || - || Tunnelbeschränkungscode, Pflicht (siehe ADR-Tabelle Spalte (15))
+
              <fehlertext></fehlertext>
−
|-
+
              <gefahrgut>
−
| gefahrgutUNNR || [[#Datentypen|String]] || 10 || - || Pflicht (siehe ADR-Tabelle Spalte (1))
+
                  <gefahrgutBefoerdKat></gefahrgutBefoerdKat>
−
|-
+
                  <gefahrgutBegrenzteMenge></gefahrgutBegrenzteMenge>
−
| gefahrgutUmweltGef || [[#Datentypen|String]] || 1 || - || T wenn Stoff umweltgefährdend ist , ansonsten F, Pflicht bei umweltgefährdenden Stoffen
+
                  <gefahrgutBezeichnung></gefahrgutBezeichnung>
−
|-
+
                  <gefahrgutBuchst640></gefahrgutBuchst640>
−
| 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))
+
                  <gefahrgutFFCode></gefahrgutFFCode>
−
|-
+
                  <gefahrgutFaktor></gefahrgutFaktor>
−
| gefahrgutVerpAnzahl || [[#Datentypen|Integer]] || 4 || - || Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)
+
                  <gefahrgutFreigestMenge></gefahrgutFreigestMenge>
−
|-
+
                  <gefahrgutKCode></gefahrgutKCode>
−
| gefahrgutVerpackungsart || [[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes
+
                  <gefahrgutKlasse></gefahrgutKlasse>
−
|}
+
                  <gefahrgutMenge></gefahrgutMenge>
−
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- -->
+
                  <gefahrgutMengenEinheit></gefahrgutMengenEinheit>
−
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- -->
+
                  <gefahrgutNebenGefahr></gefahrgutNebenGefahr>
−
== edistatus ==
+
                  <gefahrgutNettoExplMasse></gefahrgutNettoExplMasse>
−
{| class="wikitable sortable"
+
                  <gefahrgutTunnelBCode></gefahrgutTunnelBCode>
−
|-
+
                  <gefahrgutUNNR></gefahrgutUNNR>
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
                  <gefahrgutUmweltGef></gefahrgutUmweltGef>
−
|-
+
                  <gefahrgutVPG></gefahrgutVPG>
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
                  <gefahrgutVerpAnzahl></gefahrgutVerpAnzahl>
−
|-
+
                  <gefahrgutVerpackungsart></gefahrgutVerpackungsart>
−
| statuscode || [[#Datentypen|String]] || 2 || - || 
+
              </gefahrgut>
−
01 = FFDatei wurde erzeugt.<br>
+
              <gewicht></gewicht>
−
02 = FFDatei wurde geschrieben.<br>
+
              <hostTrackingNr></hostTrackingNr>
−
03 = FFDatei wurde verschickt.<br>
+
              <infotext1></infotext1>
−
11 = FFDatei konnte nicht erzeugt werden!<br>
+
              <infotext10></infotext10>
−
12 = FFDatei konnte nicht geschrieben werden!<br>
+
              <infotext2></infotext2>
−
13 = FFDatei konnte nicht verschickt werden!<br>
+
              <infotext3></infotext3>
 +
              <infotext4></infotext4>
 +
              <infotext5></infotext5>
 +
              <infotext6></infotext6>
 +
              <infotext7></infotext7>
 +
              <infotext8></infotext8>
 +
              <infotext9></infotext9>
 +
              <letztesPackstueck></letztesPackstueck>
 +
              <nachnahme></nachnahme>
 +
              <nettoGewicht></nettoGewicht>
 +
              <nnVermerk></nnVermerk>
 +
              <nnVerwendung></nnVerwendung>
 +
              <nnWaehrung></nnWaehrung>
 +
              <packStkNr></packStkNr>
 +
              <packstueckBreite></packstueckBreite>
 +
              <packstueckHoehe></packstueckHoehe>
 +
              <packstueckID></packstueckID>
 +
              <packstueckLaenge></packstueckLaenge>
 +
              <verpackungsart></verpackungsart>
 +
              <versicherungswert></versicherungswert>
 +
              <vwWaehrung></vwWaehrung>
 +
              <warenwert></warenwert>
 +
              <wwWaehrung></wwWaehrung>
 +
            </packStueckDaten>
 +
            <packplatz></packplatz>
 +
            <paperlessInvoice></paperlessInvoice>
 +
            <postLeitcode></postLeitcode>
 +
            <postZielFrachtzent></postZielFrachtzent>
 +
            <rechnungsEmpfLKZ></rechnungsEmpfLKZ>
 +
            <rechnungsEmpfName1></rechnungsEmpfName1>
 +
            <rechnungsEmpfName2></rechnungsEmpfName2>
 +
            <rechnungsEmpfName3></rechnungsEmpfName3>
 +
            <rechnungsEmpfOrt></rechnungsEmpfOrt>
 +
            <rechnungsEmpfPLZ></rechnungsEmpfPLZ>
 +
            <rechnungsEmpfStrasse></rechnungsEmpfStrasse>
 +
            <rechnungsNr></rechnungsNr>
 +
            <requestSPM></requestSPM>
 +
            <sendungsinhalt></sendungsinhalt>
 +
            <sonderdienste></sonderdienste>
 +
            <sperrFlag></sperrFlag>
 +
            <telefonNr></telefonNr>
 +
            <terminArt></terminArt>
 +
            <terminDatum></terminDatum>
 +
            <terminZeit></terminZeit>
 +
            <ustIDNr></ustIDNr>
 +
            <versandartID></versandartID>
 +
            <vorgabeFrachtfuehrer></vorgabeFrachtfuehrer>
 +
            <vorpackdatum></vorpackdatum>
 +
            <wechselbruecke></wechselbruecke>
 +
            <zahlungsbedingung></zahlungsbedingung>
 +
            <zbZoll></zbZoll>
 +
            <zielAdrBahnhof></zielAdrBahnhof>
 +
            <zielAdrLKZ></zielAdrLKZ>
 +
            <zielAdrName1></zielAdrName1>
 +
            <zielAdrName2></zielAdrName2>
 +
            <zielAdrName3></zielAdrName3>
 +
            <zielAdrName4></zielAdrName4>
 +
            <zielAdrOrt></zielAdrOrt>
 +
            <zielAdrPLZ></zielAdrPLZ>
 +
            <zielAdrRegion></zielAdrRegion>
 +
            <zielAdrStrasse></zielAdrStrasse>
 +
        </arg0>
 +
      </std:sendungsdatenAnfrage>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
  
−
Es ist zu beachten, dass nicht jede FFDatei verschickt wird, dies hängt ab von der HVS32 Konfiguration.<br>
+
= Beispiele =
−
D.h. solange kein Status „1x“ enthalten ist, wurde mit der FFDatei gemäß der HVS32 Konfiguration verfahren.
+
Alle XML Beispiele finden Sie auch hier: [[SOAP_Beispiel|SOAP SERVER XML Beispiele]]
−
|-
 
−
| statustext || [[#Datentypen|String]] || 200 || - || Klartext des Statuscodes
 
−
|-
 
−
| fftyp || [[#Datentypen|String]] || 50 || - || Frachtführertyo (z.B. UPS, GLS, DPD)
 
−
|-
 
−
| dateityp || [[#Datentypen|String]] || 50 || - || FFDateityp (z.B.: Standard, Express, etc.)
 
−
|-
 
−
| auftraggeber || [[#Datentypen|String]] || 10 || - || Auftraggebernummer ('''ACHTUNG!''' Nicht die AuftraggeberID)
 
−
|-
 
−
| ffdateinr || [[#Datentypen|String]] || 10 || - || Nummer der FF-Datei (ggf. im Fehlerfall nicht gefüllt)
 
−
|}
 
−
<!-- ------------------------------------------------------------------------------- ENDE edistatus ------------------------------------------------------------------------------- -->
 

Version vom 10. August 2022, 16:06 Uhr

Voraussetzungen

DGS-Version 3.7.0.646 oder höher
DGS-Plugins HVS32Client, SOAP Server

Funktionsbeschreibung

Bei der SOAP-Schnittstelle stellt der DataGatewayServer (DGS) einen SOAP Server mit folgenden Funktionen zur Verfügung. Dieser ist in der Standardkonfiguration unter http://<Servername>:<Port>/hvs32soap erreichbar. Dabei wird der Port 8080 verwendet, welcher bei Bedarf geändert werden kann.

Die WSDL / XSD finden Sie hier:
SOAP WSDL
SOAP XSD

Datentypen

Integer - Zahl mit ausschließlich numerischen Zeichen (0-9).
Decimal - Zahl mit Nachkommastellen (Dezimaltrennzeichen mit Punkt, anstelle von Komma)
Calendar - Datum. Monat ist dabei 0-basierend (0 = Januar, 11 = Dezember)
String - Beliebige Zeichen aus dem Zeichensatz ISO-8859-1. Maximale Länge darf nicht überschritten werden.
Binary - Base64 kodierte Binärdaten
Sequence - Eine Liste von Elementen
Map - Key/Value Map

Zusätzliche Datentypen

Zusätzliche Datentypen, welche in der Beschreibung vorkommen, stehen in einer 1:n Relation zu den Packstücken.

artikelDaten

Artikel-Daten
Feldname Typ Max Länge Dezimalstellen Belegung
anzahlBuegel Integer - - Nur für Hängeversand: Anzahl der Bügel auf welche die Artikelgruppe aufgeteilt ist
anzahlPosEtiketten Integer - - Anzahl Artikeletiketten, welche gedruckt werden sollen
artikelBTNNr String 25 - BTN Nummer / Zolltarifnummer
artikelEAN String 20 - EAN Nummer
artikelEinheit String 10 - Einheit der Artikelmenge
artikelGewicht Decimal 9 3 Gewicht des Arikels
artikelGruppe String 50 - Artikelgruppe
artikelMenge Decimal 9 3 Menge des Artikels
artikelServices String 100 - Pipe getrennte Services für diesen Artikel
artikelSollMenge Decimal 9 3 -
artikelText1 String 100 - Artikelbezeichnung
artikelText2 String 100 - Artikelbezeichnung
artikelText3 String 100 - Artikelbezeichnung
artikelText4 String 100 - Artikelbezeichnung
artikelVolumen Decimal 9 3 Volumen des Artikels
artikelWaehrung String 3 - Währung in welcher der Wert des Artikels angegeben wird
artikelWert Decimal 18 2 Wert des Artikels
chargeFlag String 1 -
kundenArtikelNr String 50 - Artikelnummer
kundenBestellNr String 50 - Bestellnummer
posAuftragNr String 50 - Auftragsnummer
posLieferNr String 40 - Lieferscheinnummer
positionNr String 50 - Laufende Nummer innerhalb des Packstücks
serienNr String 30 - Seriennummer
ursprungLand String 2 - Ursprungsland des Artikels

gefahrgut

Gefahrgut-Daten
Feldname Typ Max Länge Dezimalstellen Belegung
gefahrgutBefoerdKat Integer 1 - Beförderungskategorie, Pflicht (siehe ADR-Tabelle Spalte (15)), kann 0-4 sein. Achtung! Muss unbedingt korrekt sein.
gefahrgutBegrenzteMenge String 1 - T wenn der Stoff mit Status LQ / Begrenzte Menge nach ADR 3.4 verschickt wird, ansonsten F, Pflicht
gefahrgutBezeichnung String 100 - Pflicht (siehe ADR-Tabelle Spalte (2))
gefahrgutBuchst640 String 1 - Buchstabe für Sondervorschrift 640, bedingte Pflicht bei Stoffen, bei denen die Sondervorschrift 640 gilt (siehe ADR-Tabelle Spalte (6))
gefahrgutFFCode String
gefahrgutFaktor Integer 3 - Bewertungsfaktor für Punktesummation auf dem Beförderungspapier, (kann 0, 1, 3, 50 oder 999 sein), eigentlich Pflicht, kann aber eindeutig aus der Beförderungskategorie geschlossen werden, daher muss es nicht unbedingt belegt sein
gefahrgutFreigestMenge String 1 - T wenn der Stoff mit Status EQ / Excepted Quantities nach ADR 3.5 verschickt wird, ansonsten F, Pflicht
gefahrgutID String 8 - Eindeutige Suchnummer für Gefahrgut-Stammdaten
gefahrgutKCode String 10 - Klassifizierungscode, Pflicht (siehe ADR-Tabelle Spalte (3b))
gefahrgutKlasse String 100 - Pflicht (siehe ADR-Tabelle Spalte (3a))
gefahrgutMenge 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 String 2 - Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg
gefahrgutNebenGefahr 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 )
gefahrgutNettoExplMasse Decimal 8 3 Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
gefahrgutPositionNr Integer - - Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
gefahrgutTechBenennung String 150 - bedingt Pflicht bei N.A.G. Gefahrgut (d.h. wenn die Bezeichnung mit N.A.G. endet)
gefahrgutTunnelBCode String 10 - Tunnelbeschränkungscode, Pflicht (siehe ADR-Tabelle Spalte (15))
gefahrgutUNNR String 10 - Pflicht (siehe ADR-Tabelle Spalte (1))
gefahrgutUmweltGef String 1 - T wenn Stoff umweltgefährdend ist , ansonsten F, Pflicht bei umweltgefährdenden Stoffen
gefahrgutVPG 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 Integer 4 - Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)
gefahrgutVerpackungsart String 5 - ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes

edistatus

EDIStatus
Feldname Typ Max Länge Dezimalstellen Belegung
fehlercode Integer - - 0 = Erfolgreich
statuscode String 2 -

01 = FFDatei wurde erzeugt.
02 = FFDatei wurde geschrieben.
03 = FFDatei wurde verschickt.
11 = FFDatei konnte nicht erzeugt werden!
12 = FFDatei konnte nicht geschrieben werden!
13 = FFDatei konnte nicht verschickt werden!

Es ist zu beachten, dass nicht jede FFDatei verschickt wird, dies hängt ab von der HVS32 Konfiguration.
D.h. solange kein Status „1x“ enthalten ist, wurde mit der FFDatei gemäß der HVS32 Konfiguration verfahren.

statustext String 200 - Klartext des Statuscodes
fftyp String 50 - Frachtführertyo (z.B. UPS, GLS, DPD)
dateityp String 50 - FFDateityp (z.B.: Standard, Express, etc.)
auftraggeber String 10 - Auftraggebernummer (ACHTUNG! Nicht die AuftraggeberID)
ffdateinr String 10 - Nummer der FF-Datei (ggf. im Fehlerfall nicht gefüllt)

packstueckDaten

Packstückdaten
Feldname Typ Max Länge Dezimalstellen Belegung
anzahlArtikel Integer 6 - Anzahl Artikel (Druck auf Etikett)
artikelDaten Sequence <ArtikelDaten> - - Eine Liste der Packstück-Artikel vom Typ ArtikelDaten (1:n)
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
barcodeID String - - Zusatzfeld für evtl. Erweiterungen
barcodeText String - - Zusatzfeld für evtl. Erweiterungen
barcodeTyp String - - Zusatzfeld für evtl. Erweiterungen
druckername String 30 - Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
gefahrgut Sequence <Gefahrgut> - - Eine Liste der Gefahrgüter vom Typ Gefahrgut (1:n)
gewicht Decimal 8 3 Bruttogewicht in KG
hostTrackingNr String 35 - Falls die Paketnummer aus dem Vorsystem verwendet werden soll.
infotext1 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext2 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext3 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext4 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext5 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext6 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext7 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext8 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext9 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext10 String 150 - Zusatzfeld für evtl. Erweiterungen
letztesPackstueck String 1 - T/F: T=letztes Packstück der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
nachnahme String 3 - Warenwert - ISO-Währungscode
nettoGewicht Decimal 8 3 Nettogewicht in KG
nnVermerk String 3 - Nachnahme - ISO-Währungscode
nnVerwendung String 1 - 'B' = Bar, 'V' = Verrechnungsscheck
nnWaehrung String 3 - Nachnahme - ISO-Währungscode
packStkNr Integer - - Laufende Nummer pro Sendung
packstueckBreite Integer - - Breite in cm
packstueckHoehe Integer - - Höhe in cm
packstueckID String 20 - Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.
packstueckLaenge Integer - - Länge in cm
verpackungsart String 6 - -
versicherungswert Decimal 18 2 Höhe-Versicherungswert
vwWaehrung String 3 - Versicherungswert - ISO-Währungscode
warenwert Decimal 18 2 -
wwWaehrung String 3 - Warenwert - ISO-Währungscode

Übersicht der Funktionen

Schnittstelle testen (echo)

Zum Testen der SOAP-Schnittstelle. Liefert die übergebene Nachricht unverändert zurück.

Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:echo>
         <arg0></arg0>
      </std:echo>
   </soapenv:Body>
</soapenv:Envelope>

Packstück-Verarbeitung (versanddatenAnfrage)

Die Gatewayfunktion versanddatenAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück zu erzeugen und verbuchen. Ein Etikett wird für alle weiteren Funktionen wir Storno, Verladefreigabe, etc. anhand der hostseitigen Packstück-ID identifiziert. Diese wird im Feld PackstueckID übergeben und muss dementsprechend innerhalb des Versandsystems eindeutig sein.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
absenderAdresseID String 10 Eindeutige ID um eine Neutrale-Absenderadresse aus dem HVS32 zu verwenden
ansprechpartner String 20 - Empfänger Ansprechpartner
anzahlArtikel Integer 6 - Anzahl Artikel (Druck auf Etikett)
artikelDaten Sequence <ArtikelDaten> - - Eine Liste der Packstück-Artikel vom Typ ArtikelDaten (1:n)
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
auftragNr String 20 - -
auftraggeberID String 10 - Mandantenkennung aus dem HVS32
avisHinweis1 String 100 - -
avisHinweis2 String 100 - -
avisZusatz1 String 20 - Zusatz zu Fest-AVIS-Schlüssel 1
avisZusatz2 String 20 - Zusatz zu Fest-AVIS-Schlüssel 2
barcodeID String - - Zusatzfeld für evtl. Erweiterungen
barcodeText String - - Zusatzfeld für evtl. Erweiterungen
barcodeTyp String - - Zusatzfeld für evtl. Erweiterungen
bestellNr String 20 - Metro-Bestellnr (Metro-Versand)
druckername String 30 - Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
email String 100 - E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
empfMobilfunkNr String 20 - Mobilfunknummer des Empfängers
faxNr String 20 - Faxnummer des Empfängers
flexZustellungEmailadresse String 80 - Flex-Zustellung Emailadresse
frachtBrief String 20 - Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
frachtfuehrerKdNr String 10 - Kundennummer des Frachtzahlers beim Frachtführer
freiAvis1 String - -
freiAvis2 String - -
frankaturKennung String 10 - -
gefahrgut Sequence <Gefahrgut> - - Eine Liste der Gefahrgüter vom Typ Gefahrgut (1:n)
gewicht Decimal 8 3 Bruttogewicht in KG
hostTrackingNr String 35 - Paketnummer aus dem Hostsystem
ilnNr String 20 - ILN des Empfängers (Pflicht bei Metro-Versand)
infotext1 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext2 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext3 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext4 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext5 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext6 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext7 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext8 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext9 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext10 String 150 - Zusatzfeld für evtl. Erweiterungen
kostenstelle String 30 - -
kundenNr String 20 - Kundennummer des Empfängers beim Versender
lagerkennzeichen Integer - - -
letztesPackstueck String 1 - T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
lieferantenID Integer - - -
lieferscheinNr String 40 - Wird im HVS32 als Such-Nummer verwendet
nachnahme Decimal 18 2 -
nettoGewicht Decimal 8 3 Nettogewicht in KG
neutBIC String 11 - Nur bei Neutral-Absendern belegt
neutBankBezeichnung String 40 - Nur bei Neutral-Absendern belegt
neutIBAN String 31 - Nur bei Neutral-Absendern belegt
neutKontoInhaber String 40 - Nur bei Neutral-Absendern belegt
neutabsenderLKZ String 3 - Nur bei Neutral-Absendern belegt
neutabsenderName1 String 50 - Nur bei Neutral-Absendern belegt
neutabsenderName2 String 50 - Nur bei Neutral-Absendern belegt
neutabsenderName3 String 50 - Nur bei Neutral-Absendern belegt
neutabsenderOrt String 50 - Nur bei Neutral-Absendern belegt
neutabsenderPLZ String 10 - Nur bei Neutral-Absendern belegt
neutabsenderStrasse String 50 - Nur bei Neutral-Absendern belegt
nnVermerk String 1 - B': Bar / 'V': Verrechnungsscheck
nnVerwendung String 30 - Nachnahme Verwendungszweck
nnWaehrung String 3 - Nachnahme - ISO-Währungscode
packStkGes Integer - - Gesamt-Anzahl Colli der Sendung
packStkNr Integer - - Laufende Nr pro Sendung
packplatz String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
packstueckBreite Integer - - Breite in cm
packstueckHoehe Integer - - Höhe in cm
packstueckID String 20 - Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.
packstueckLaenge Integer - - Länge in cm
paperlessInvoice String 1 - Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
postLeitcode String 15 - -
postZielFrachtzent String 5 - -
rechnungsEmpfLKZ String 5 - Rechnungsadresse
rechnungsEmpfName1 String 50 - Rechnungsempfänger
rechnungsEmpfName2 String 50 - Rechnungsempfänger
rechnungsEmpfName3 String 50 - Rechnungsempfänger
rechnungsEmpfOrt String 50 - Rechnungsadresse
rechnungsEmpfPLZ String 10 - Rechnungsadresse
rechnungsEmpfStrasse String 50 - Rechnungsadresse
rechnungsNr String 20 - Rechnungsnummer
sendungsinhalt String 30 - -
sonderdienste String 30 - Versandart-spezifisch belegt
sperrFlag String 1 - T/F: T=Sperren, sonst nicht sperren
telefonNr String 20 - Telefonnummer des Empfängers
terminArt String 1 - 'A' = ab diesem Tag liefern

'B' = bis zu diesem Tag liefern

'F' = an diesem Tag liefern

terminDatum String 10 - TT.MM.JJJJ
terminZeit Calendar 5 - HH:MM
ustIDNr String 20 - UmsatzsteuerNr des Empfängers
verpackungsart String 6 - -
versandartID String 10 - Versandartkennung aus dem HVS32
versicherungswert Decimal 18 2 Höhe Versicherungswert
vorpackdatum String 10 - TT.MM.JJJJ
vwWaehrung String 3 - Versicherungswert - ISO-Währungscode
warenwert Decimal 18 2 -
wechselbruecke String 20 - Wechselbrücke, die diesem Packstück zugewiesen wird
wwWaehrung String 3 - Warenwert - ISO-Währungscode
zahlungsbedingung String 10 - 'S' = Sender, 'R' = Empfänger
zbZoll String 1 - Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
zielAdrBahnhof String 30 - PLZ und Ort
zielAdrLKZ String 5 - Lieferadresse
zielAdrName1 String 50 - Lieferadresse
zielAdrName2 String 50 - Lieferadresse
zielAdrName3 String 50 - Lieferadresse
zielAdrName4 String 50 - Lieferadresse
zielAdrOrt String 50 - Lieferadresse
zielAdrPLZ String 10 - Lieferadresse
zielAdrRegion String 20 - Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
zielAdrStrasse String 50 - Lieferadresse


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
ausgangDateTime Calendar 10 - Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
ausgangDateTimeString String 10 - Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
druckDateTime Calendar 19 - Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
druckDateTimeString String 19 - Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
etikettDaten String - - Binärdaten des Etiketts
etikettName String - - Vorlagenname des Etiketts
fehlercode Integer - - 0 wenn Erfolgreich
fehlertext1 String 200 - Wird im Fehlerfall befüllt
fehlertext2 String 200 - Wird im Fehlerfall befüllt
gebuehr Decimal 18 2 Frachtkosten
gebuehrWaehrung String 3 - Frachkosten ISO-Währungscode
packstueckID String 20 - PackstueckID aus der Anfrage
retourTrackingNr String 50 - Paketnummer für die Retoure
trackingNr String 35 - Paketnummer
trackingURL String 255 - URL des Trackinglinks zur Sendungsverfolgung
versandSendungsNr String - - -
zusatzEtikettenDaten Map (String, String) - - Name und Binärdaten der Zusatzetiketten als Key/Value Map
zusatzfeld1 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld2 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld3 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld4 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld5 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld6 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld7 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld8 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld9 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld10 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
	<soapenv:Header/>
	<soapenv:Body>
		<std:versanddatenAnfrage>
			<arg0>
				<absenderAdresseID></absenderAdresseID>
				<ansprechpartner></ansprechpartner>
				<anzahlArtikel></anzahlArtikel>
				<artikelDaten>
					<anzahlBuegel></anzahlBuegel>
					<anzahlPosEtiketten></anzahlPosEtiketten>
					<artikelBTNNr></artikelBTNNr>
					<artikelEAN></artikelEAN>
					<artikelEinheit></artikelEinheit>
					<artikelGewicht></artikelGewicht>
					<artikelGruppe></artikelGruppe>
					<artikelMenge></artikelMenge>
					<artikelServices></artikelServices>
					<artikelSollMenge></artikelSollMenge>
					<artikelText1></artikelText1>
					<artikelText2></artikelText2>
					<artikelText3></artikelText3>
					<artikelText4></artikelText4>
					<artikelVolumen></artikelVolumen>
					<artikelWaehrung></artikelWaehrung>
					<artikelWert></artikelWert>
					<chargeFlag></chargeFlag>
					<kundenArtikelNr></kundenArtikelNr>
					<kundenBestellNr></kundenBestellNr>
					<posAuftragNr></posAuftragNr>
					<posLieferNr></posLieferNr>
					<positionNr></positionNr>
					<serienNr></serienNr>
					<ursprungLand></ursprungLand>
				</artikelDaten>
				<assoc>
					<entry>
						<key></key>
						<value></value>
					</entry>
				</assoc>
				<auftragNr></auftragNr>
				<auftraggeberID></auftraggeberID>
 				<avisHinweis1></avisHinweis1>
				<avisHinweis2></avisHinweis2>
				<avisZusatz1></avisZusatz1>
				<avisZusatz2></avisZusatz2>
				<barcodeID></barcodeID>
				<barcodeText></barcodeText>
				<barcodeTyp></barcodeTyp>
				<bestellNr></bestellNr>
				<druckername></druckername>
				<email></email>
				<empfMobilfunkNr></empfMobilfunkNr>
				<faxNr></faxNr>
				<fehlertext></fehlertext>
				<flexZustellungEmailadresse></flexZustellungEmailadresse>
				<frachtBrief></frachtBrief>
				<frachtfuehrerKdNr></frachtfuehrerKdNr>
				<frankaturKennung></frankaturKennung>
				<freiAvis1></freiAvis1>
				<freiAvis2></freiAvis2>
				<gefahrgut>
					<gefahrgutBefoerdKat></gefahrgutBefoerdKat>
					<gefahrgutBegrenzteMenge></gefahrgutBegrenzteMenge>
					<gefahrgutBezeichnung></gefahrgutBezeichnung>
					<gefahrgutBuchst640></gefahrgutBuchst640>
					<gefahrgutFFCode></gefahrgutFFCode>
					<gefahrgutFaktor></gefahrgutFaktor>
					<gefahrgutFreigestMenge></gefahrgutFreigestMenge>
					<gefahrgutID></gefahrgutID>
					<gefahrgutKCode></gefahrgutKCode>
					<gefahrgutKlasse></gefahrgutKlasse>
					<gefahrgutMenge></gefahrgutMenge>
					<gefahrgutMengenEinheit></gefahrgutMengenEinheit>
					<gefahrgutNebenGefahr></gefahrgutNebenGefahr>
					<gefahrgutNettoExplMasse></gefahrgutNettoExplMasse>
					<gefahrgutPositionNr></gefahrgutPositionNr>
					<gefahrgutTechBenennung></gefahrgutTechBenennung>
					<gefahrgutTunnelBCode></gefahrgutTunnelBCode>
					<gefahrgutUNNR></gefahrgutUNNR>
					<gefahrgutUmweltGef></gefahrgutUmweltGef>
					<gefahrgutVPG></gefahrgutVPG>
					<gefahrgutVerpAnzahl></gefahrgutVerpAnzahl>
					<gefahrgutVerpackungsart></gefahrgutVerpackungsart>
				</gefahrgut>
				<gewicht></gewicht>
				<hostTrackingNr></hostTrackingNr>
				<ilnNr></ilnNr>
				<infotext1></infotext1>
				<infotext10></infotext10>
				<infotext2></infotext2>
				<infotext3></infotext3>
				<infotext4></infotext4>
				<infotext5></infotext5>
				<infotext6></infotext6>
				<infotext7></infotext7>
				<infotext8></infotext8>
				<infotext9></infotext9>
				<kostenstelle></kostenstelle>
				<kundenNr></kundenNr>
				<lagerkennzeichen></lagerkennzeichen>
				<letztesPackstueck></letztesPackstueck>
				<lieferantenID></lieferantenID>
				<lieferscheinNr></lieferscheinNr>
				<nachnahme></nachnahme>
				<nettoGewicht></nettoGewicht>
				<neutBIC></neutBIC>
				<neutBankBezeichnung></neutBankBezeichnung>
				<neutIBAN></neutIBAN>
				<neutKontoInhaber></neutKontoInhaber>
				<neutabsenderLKZ></neutabsenderLKZ>
				<neutabsenderName1></neutabsenderName1>
				<neutabsenderName2></neutabsenderName2>
				<neutabsenderName3></neutabsenderName3>
				<neutabsenderOrt></neutabsenderOrt>
				<neutabsenderPLZ></neutabsenderPLZ>
				<neutabsenderStrasse></neutabsenderStrasse>
				<nnVermerk></nnVermerk>
				<nnVerwendung></nnVerwendung>
				<nnWaehrung></nnWaehrung>
				<packStkGes></packStkGes>
				<packStkNr></packStkNr>
				<packplatz></packplatz>
				<packstueckBreite></packstueckBreite>
				<packstueckHoehe></packstueckHoehe>
				<packstueckID></packstueckID>
				<packstueckLaenge></packstueckLaenge>
				<paperlessInvoice></paperlessInvoice>
				<postLeitcode></postLeitcode>
				<postZielFrachtzent></postZielFrachtzent>
				<rechnungsEmpfLKZ></rechnungsEmpfLKZ>
				<rechnungsEmpfName1></rechnungsEmpfName1>
				<rechnungsEmpfName2></rechnungsEmpfName2>
				<rechnungsEmpfName3></rechnungsEmpfName3>
				<rechnungsEmpfOrt></rechnungsEmpfOrt>
				<rechnungsEmpfPLZ></rechnungsEmpfPLZ>
				<rechnungsEmpfStrasse></rechnungsEmpfStrasse>
				<rechnungsNr></rechnungsNr>
				<sendungsinhalt></sendungsinhalt>
				<sonderdienste></sonderdienste>
				<sperrFlag></sperrFlag>
				<telefonNr></telefonNr>
				<terminArt></terminArt>
				<terminDatum></terminDatum>
				<terminZeit></terminZeit>
				<ustIDNr></ustIDNr>
				<verpackungsart></verpackungsart>
				<versandartID></versandartID>
				<versicherungswert></versicherungswert>
				<vorpackdatum></vorpackdatum>
				<vwWaehrung></vwWaehrung>
				<warenwert></warenwert>
				<wechselbruecke></wechselbruecke>
				<wwWaehrung></wwWaehrung>
				<zahlungsbedingung></zahlungsbedingung>
				<zbZoll></zbZoll>
				<zielAdrBahnhof></zielAdrBahnhof>
				<zielAdrLKZ></zielAdrLKZ>
				<zielAdrName1></zielAdrName1>
				<zielAdrName2></zielAdrName2>
				<zielAdrName3></zielAdrName3>
				<zielAdrName4></zielAdrName4>
				<zielAdrOrt></zielAdrOrt>
				<zielAdrPLZ></zielAdrPLZ>
				<zielAdrRegion></zielAdrRegion>
				<zielAdrStrasse></zielAdrStrasse>
			</arg0>
		</std:versanddatenAnfrage>
	</soapenv:Body>
</soapenv:Envelope>

Etikett nachdrucken (versanddatenNachdruckAnfrage)

Die Gatewayfunktion versanddatenNachdruckAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück nachzudrucken. Ein Etikett wird anhand der hostseitigen Packstück-ID nachgedruckt. Diese wird im Feld PackstueckID übergeben. Bei manchen Frachtführern (z.B. DPD) werden beim Nachdruck neue Trackingnummern vergeben. Somit ist die alte Trackingnummer nicht mehr gültig und das alte Versandetikett muss vernichtet werden. Die neue Trackingnummer kann in der Rückmeldung zurückgemeldet werden.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
druckername String 30 - Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird.
packplatz String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
packstueckID String 30 - Eindeutige Nummer für das Paket im Vorsystem.
trackingNr String 35 - Paketnummer


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
ausgangDateTime Calendar 10 - Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
ausgangDateTimeString String 10 - Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
druckDateTime Calendar 19 - Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
druckDateTimeString String 19 - Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
etikettDaten String - - Binärdaten des Etiketts
etikettName String - - Vorlagenname des Etiketts
fehlercode Integer - - 0 wenn Erfolgreich
fehlertext1 String 200 - Wird im Fehlerfall befüllt
fehlertext2 String 200 - Wird im Fehlerfall befüllt
gebuehr Decimal 18 2 Frachtkosten
gebuehrWaehrung String 3 - Frachkosten ISO-Währungscode
packstueckID String 20 - PackstueckID aus der Anfrage
retourTrackingNr String 50 - Paketnummer für die Retoure
trackingNr String 35 - Paketnummer
trackingURL String 255 - URL des Trackinglinks zur Sendungsverfolgung
versandSendungsNr String - - -
zusatzEtikettenDaten Map (String, String) - - Name und Binärdaten der Zusatzetiketten als Key/Value Map
zusatzfeld1 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld2 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld3 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld4 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld5 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld6 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld7 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld8 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld9 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld10 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:versanddatenNachdruckAnfrage>
         <arg0>
            <druckername></druckername>
            <packplatz></packplatz>
            <packstueckID></packstueckID>
            <trackingNr></trackingNr>
         </arg0>
      </std:versanddatenNachdruckAnfrage>
   </soapenv:Body>
</soapenv:Envelope>

Packstück stornieren (stornoVersanddaten)

Die Gatewayfunktion stornoVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort bestehende Packstücke zu stornieren, die noch nicht auf einer Ausgangsliste sind. In der Regel wird ein Packstück anhand der hostseitigen Packstück-ID storniert. Diese wird im Feld PackstueckID übergeben. Zusätzlich zur hostseitigen Packstück-ID kann auch die TrackingNr zur Identifikation des Packstücks beitragen, für den Fall, dass die hostseitige Packstück-ID keine Eindeutigkeit garantieren kann. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Storno wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
packplatz String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
packstueckID String 30 - Eindeutige Nummer für das Paket im Vorsystem.
trackingNr String 35 - Paketnummer


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen Belegung
fehlercode Integer - - 0 = Erfolgreich
fehlertext1 String 200 - -
fehlertext2 String 200 - -


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:stornoVersanddaten>
         <arg0>
            <packplatz></packplatz>
            <packstueckID></packstueckID>
            <trackingNr></trackingNr>
         </arg0>
      </std:stornoVersanddaten>
   </soapenv:Body>
</soapenv:Envelope>

Packstück verladen / freigeben (verladeVersanddaten)

Die Gatewayfunktion verladeVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang frei zu geben. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreicher Freigabe wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
hostFreigabeNr String 20 - Hostseitige Freigabenummer die für dieses Packstück gesetzt wird.
packplatz String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
packstueckID String 20 - Eindeutige Nummer für das Paket im Vorsystem.

Beim Etikettendruck zuvor muss die gleiche ID übergeben worden sein, damit das HVS32 das zu verladene Packstück eindeutig identifizieren kann.

wechselbruecke String 20 - Wechselbrücke, die diesem Packstück zugewiesen wird.


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen Belegung
fehlercode Integer - - 0 = Erfolgreich
fehlertext1 String 200 - -
fehlertext1 String 200 - -


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:verladeVersanddaten>
         <arg0>
            <hostFreigabeNr></hostFreigabeNr>
            <packplatz></packplatz>
            <packstueckID></packstueckID>
            <wechselbruecke></wechselbruecke>
         </arg0>
      </std:verladeVersanddaten>
   </soapenv:Body>
</soapenv:Envelope>

Packstück sperren (sperreVersanddaten)

Die Gatewayfunktion sperreVersanddaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang zu sperren. Gesperrte Packstücke, werden für den Tagesabschluss nicht berücksichtigt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreicher Sperrung wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
packplatz String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
packstueckID String 20 - Eindeutige Nummer für das Paket im Vorsystem.


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen Belegung
fehlercode Integer - - 0 = Erfolgreich
fehlertext1 String 200 - -
fehlertext2 String 200 - -


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:sperreVersanddaten>
         <arg0>
            <packplatz></packplatz>
            <packstueckID></packstueckID>
         </arg0>
      </std:sperreVersanddaten>
   </soapenv:Body>
</soapenv:Envelope>

Tagesabschluss (tagesabschluss)

Das Gateway sendet die tagesabschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit ein Tagesabschluss anhand der zusätzlich übergebenen Parameter ausgelöst. Der Tagesabschluss setzt sich aus den Punkten Ausgangsliste erzeugen und Frachtführer DFÜ erzeugen zusammen. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt. Die Rückmeldung im HVS32 findet nach dem Ausführen des Tagesabschluss statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Tagesabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
auftraggeberID 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)

assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
druckername String 30 - Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.

(Benötigt Druckerspooler Erweiterungsmodul)

frachtfuehrerTyp Sequence<String> 255 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.

(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)

packplatz String 10 - HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.
versandartID Sequence<String> 255 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.

(Option MultiVATagesabschluss muss im HVS32 aktiv sein)

wechselbruecke String 10 - Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen Belegung
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
edistatus Sequence <EDIStatus> - - -
fehlercode Integer - - 0 = Erfolgreich
fehlertext1 String 200 - -
fehlertext2 String 200 - -
listenDaten Map (String, String) - - Name und Binärdaten der Listen als Key/Value Map.
etikettenDaten Map (String, String) - - Name und Binärdaten der Etiketten als Key/Value Map.
ausgangsListeNr Sequence<String> - - Ausgangslisten-Nummer(n) der erzeugten Ausgangsliste(n).


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:tagesabschluss>
         <arg0>
            <auftraggeberID></auftraggeberID>
            <assoc>
                <entry>
                    <key></key>
                    <value></value>
                </entry>
            </assoc>
            <druckername></druckername>
            <frachtfuehrerTyp></frachtfuehrerTyp>
            <packplatz></packplatz>
            <versandartID></versandartID>
            <wechselbruecke></wechselbruecke>
         </arg0>
      </std:tagesabschluss>
   </soapenv:Body>
</soapenv:Envelope>

Ausgangsliste erzeugen (listenabschlussAnfrage)

Das Gateway sendet die listenabschlussAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Ausgangsliste anhand der zusätzlich übergebenen Parameter erzeugt. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Listenabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt. Die Rückmeldung im HVS32 findet nach dem Erzeugen der Ausgangsliste statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Listenabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
auftraggeberID 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 String 30 - Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.

(Benötigt Druckerspooler Erweiterungsmodul)

frachtfuehrerTyp Sequence<String> 255 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.

(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)

packplatz String 10 - HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.
versandartID Sequence<String> 255 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.

(Option MultiVATagesabschluss muss im HVS32 aktiv sein)

wechselbruecke String 10 - Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen Belegung
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
fehlercode Integer - - 0 = Erfolgreich
fehlertext1 String 200 - -
fehlertext2 String 200 - -
listenDaten Map (String, String) - - Name und Binärdaten der Listen als Key/Value Map.
etikettenDaten Map (String, String) - - Name und Binärdaten der Etiketten als Key/Value Map.
ausgangsListeNr Sequence<String> - - Ausgangslisten-Nummer(n) der erzeugten Ausgangsliste(n).


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:listenabschlussAnfrage>
         <arg0>
            <auftraggeberID></auftraggeberID>
            <druckername></druckername>
            <frachtfuehrerTyp></frachtfuehrerTyp>
            <packplatz></packplatz>
            <versandartID></versandartID>
            <wechselbruecke></wechselbruecke>
         </arg0>
      </std:listenabschlussAnfrage>
   </soapenv:Body>
</soapenv:Envelope>

Ausgangsliste nachdrucken (listenNachdruckAnfrage)

Das Gateway sendet die listenNachdruckAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine bereits erstellte Ausgangsliste anhand der übergebenen ausgangsListeNr nachgedruckt. Eine Liste kann nur nachgedruckt werden, wenn diese bereits über die Funktionen tagesabschluss, listenabschlussAnfrage oder manuell über die HVS32 Maske erzeugt wurde. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Listenabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
ausgangsListeNr Sequence<String> - - Liste der Ausgangslisten-Nr. der Listen, die nachgedruckt werden sollen.
druckername String 30 - Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.

(Benötigt Druckerspooler Erweiterungsmodul)

auftraggeberID Sequence<String> - - Liste der Auftraggerber-ID's, für welche die Listen nachgedruckt werden sollen.
frachtFuehrerTyp Sequence<String> - - Liste der Frachtführertypen, für welche die Listen nachgedruckt werden sollen.
erstellDatum String 10 - Erstelldatum der Ausgangslisten, die nachgedruckt werden sollen. Im Format "dd.mm.yyyy", z.B. 01.01.2001
druckDatum String 10 - Druckdatum der Ausgangslisten, die nachgedruckt werden sollen. Im Format "dd.mm.yyyy", z.B. 01.01.2001 oder null wenn nur Listen nachgedruckt werden sollen, die noch nicht gedruckt wurden


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen Belegung
ausgangsListeNr Sequence<String> - - Liste der Ausgangslisten-Nr. der Listen, die nachgedruckt wurden.
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
fehlercode Integer - - 0 = Erfolgreich
fehlertext1 String 200 - -
fehlertext2 String 200 - -
listenDaten Map (String, String) - - Name und Binärdaten der Listen als Key/Value Map.
etikettenDaten Map (String, String) - - Name und Binärdaten der Etiketten als Key/Value Map.


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:listenNachdruckAnfrage>
         <arg0>
            <ausgangsListeNr>75</ausgangsListeNr>
            <druckername></druckername>
            <auftraggeberID></auftraggeberID>
            <frachtFuehrerTyp></frachtFuehrerTyp>
            <erstellDatum></erstellDatum>
            <druckDatum></druckDatum>
         </arg0>
      </std:listenNachdruckAnfrage>
   </soapenv:Body>
</soapenv:Envelope>

Frachtführer DFÜ erzeugen (ediabschlussAnfrage)

Das Gateway sendet die ediabschlussAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Frachtführer DFÜ anhand der zusätzlich übergebenen Parameter erzeugt und (falls konfiguriert) an den Frachtführer übertragen. Nur Packstücke, für welche zuvor eine Ausgangsliste erzeugt wurde, werden für eine Frachtführer DFÜ berücksichtigt. Die Rückmeldung im HVS32 findet nach dem Erzeugen der Frachtführer DFÜ statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem EDIAbschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
auftraggeberID 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 String 30 - Name eines Ausgabekanals (Drucker) im HVS32 über den z.B. die UPS Summary gedruckt wird.

(Benötigt Druckerspooler Erweiterungsmodul)

frachtfuehrerTyp Sequence <String> 255 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. Es können n-Frachtführer abgeschlossen werden.

(Option MultiFFTagesabschluss muss im HVS32 aktiv sein)

packplatz String 10 - HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.
versandartID Sequence <String> 255 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. Es können n-Versandarten abgeschlossen werden.

(Option MultiVATagesabschluss muss im HVS32 aktiv sein)

wechselbruecke String 10 - Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen Belegung
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
edistatus Sequence <EDIStatus> - - Liste mit Statusinformationen für EDIs.
fehlercode Integer - - 0 = Erfolgreich
fehlertext1 String 200 - -
listenDaten Map (String, String) - - Name und Binärdaten der EDI-Listen (z.B. UPS Summary) als Key/Value Map.


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:ediabschlussAnfrage>
         <arg0>
            <auftraggeberID></auftraggeberID>
            <druckername></druckername>
            <frachtfuehrerTyp></frachtfuehrerTyp>
            <packplatz></packplatz>
            <versandartID></versandartID>
            <wechselbruecke></wechselbruecke>
         </arg0>
      </std:ediabschlussAnfrage>
   </soapenv:Body>
</soapenv:Envelope>

Packstückdaten prüfen (versanddatenPruefAnfrage)

Das Gateway sendet die versanddatenPruefAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine VersandDatenAnfrage simuliert. Dabei werden keine Etiketten gedruckt und das Packstück bzw. das Etikett wird nicht verbucht, jedoch sind alle weiteren Prozesse identisch zur VersandDatenAnfrage (Routenermittlung, Trackingnummer-Ermittlung, Adressprüfung, etc.) Diese Funktion dient dazu im Vorfeld alle Versand-Daten zu validieren.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
ansprechpartner String 20 - Empfänger Ansprechpartner
artikelDaten Sequence <ArtikelDaten> - - Eine Liste der Packstück-Artikel vom Typ ArtikelDaten (1:n)
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
auftragNr String 20 - -
auftraggeberID String 10 - Mandantenkennung aus dem HVS32
avisHinweis1 String 100 - -
avisHinweis2 String 100 - -
avisZusatz1 String 20 - Zusatz zu Fest-AVIS-Schlüssel 1
avisZusatz2 String 20 - Zusatz zu Fest-AVIS-Schlüssel 2
bestellNr String 20 - Metro-Bestellnr (Metro-Versand)
druckername String 30 - Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
email String 100 - E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
faxNr String 20 - Faxnummer des Empfängers
flexZustellungEmailadresse String 80 - Flex-Zustellung Emailadresse
frachtBrief String 20 - Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
frachtfuehrerKdNr String 10 - Kundennummer des Frachtzahlers beim Frachtführer
frankaturKennung String 10 - -
gefahrgut Sequence <Gefahrgut> - - Eine Liste der Gefahrgüter vom Typ Gefahrgut (1:n)
gewicht Decimal 8 3 Bruttogewicht in KG
ilnNr String 20 - ILN des Empfängers (Pflicht bei Metro-Versand)
infotext1 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext2 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext3 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext4 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext5 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext6 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext7 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext8 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext9 String 150 - Zusatzfeld für evtl. Erweiterungen
infotext10 String 150 - Zusatzfeld für evtl. Erweiterungen
kostenstelle String 30 - -
kundenNr String 20 - Kundennummer des Empfängers beim Versender
lieferscheinNr String 40 - Wird im HVS32 als Such-Nummer verwendet
nachnahme Decimal 18 2 -
nettoGewicht Decimal 8 3 Nettogewicht in KG
neutabsenderLKZ String 3 - Nur bei Neutral-Absendern belegt
neutabsenderName1 String 50 - Nur bei Neutral-Absendern belegt
neutabsenderName2 String 50 - Nur bei Neutral-Absendern belegt
neutabsenderName3 String 50 - Nur bei Neutral-Absendern belegt
neutabsenderOrt String 50 - Nur bei Neutral-Absendern belegt
neutabsenderPLZ String 10 - Nur bei Neutral-Absendern belegt
neutabsenderStrasse String 50 - Nur bei Neutral-Absendern belegt
nnVermerk String 1 - B': Bar / 'V': Verrechnungsscheck
nnVerwendung String 30 - Nachnahme Verwendungszweck
nnWaehrung String 3 - Nachnahme - ISO-Währungscode
packStkGes Integer - - Gesamt-Anzahl Colli der Sendung
packStkNr Integer - - Laufende Nr pro Sendung
packplatz String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
packstueckBreite Integer - - Breite in cm
packstueckHoehe Integer - - Höhe in cm
packstueckID String 20 - Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.
packstueckLaenge Integer - - Länge in cm
paperlessInvoice String 1 - Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
postLeitcode String 15 - -
postZielFrachtzent String 5 - -
rechnungsEmpfLKZ String 5 - Rechnungsadresse
rechnungsEmpfName1 String 50 - Rechnungsempfänger
rechnungsEmpfName2 String 50 - Rechnungsempfänger
rechnungsEmpfName3 String 50 - Rechnungsempfänger
rechnungsEmpfOrt String 50 - Rechnungsadresse
rechnungsEmpfPLZ String 10 - Rechnungsadresse
rechnungsEmpfStrasse String 50 - Rechnungsadresse
rechnungsNr String 20 - Rechnungsnummer
sonderdienste String 30 - Versandart-spezifisch belegt
telefonNr String 20 - Telefonnummer des Empfängers
terminArt String 1 - 'A'b / 'B'is / 'F'ix
terminDatum String 10 - TT.MM.JJJJ
terminZeit Calendar 5 - HH:MM
ustIDNr String 20 - UmsatzsteuerNr des Empfängers
verpackungsart String 6 - -
versandartID String 10 - Versandartkennung aus dem HVS32
versicherungswert Decimal 18 2 Höhe Versicherungswert
vwWaehrung String 3 - Versicherungswert - ISO-Währungscode
warenwert Decimal 18 2 -
wwWaehrung String 3 - Warenwert - ISO-Währungscode
zahlungsbedingung String 10 - 'S' = Sender, 'R' = Empfänger
zbZoll String 1 - Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
zielAdrBahnhof String 30 - PLZ und Ort
zielAdrLKZ String 5 - Lieferadresse
zielAdrName1 String 50 - Lieferadresse
zielAdrName2 String 50 - Lieferadresse
zielAdrName3 String 50 - Lieferadresse
zielAdrName4 String 50 - Lieferadresse
zielAdrOrt String 50 - Lieferadresse
zielAdrPLZ String 10 - Lieferadresse
zielAdrRegion String 20 - Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
zielAdrStrasse String 50 - Lieferadresse


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen -
druckDateTime Calendar 19 - Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
druckDateTimeString String 19 - Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
fehlertext1 String 200 - -
fehlertext2 String 200 - -


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:versanddatenPruefAnfrage>
         <arg0>
            <ansprechpartner></ansprechpartner>
            <artikelDaten>
               <anzahlBuegel></anzahlBuegel>
               <anzahlPosEtiketten></anzahlPosEtiketten>
               <artikelBTNNr></artikelBTNNr>
               <artikelEAN></artikelEAN>
               <artikelEinheit></artikelEinheit>
               <artikelGewicht></artikelGewicht>
               <artikelGruppe></artikelGruppe>
               <artikelMenge></artikelMenge>
               <artikelServices></artikelServices>
               <artikelSollMenge></artikelSollMenge>
               <artikelText1></artikelText1>
               <artikelText2></artikelText2>
               <artikelText3></artikelText3>
               <artikelText4></artikelText4>
               <artikelVolumen></artikelVolumen>
               <artikelWaehrung></artikelWaehrung>
               <artikelWert></artikelWert>
               <chargeFlag></chargeFlag>
               <kundenArtikelNr></kundenArtikelNr>
               <kundenBestellNr></kundenBestellNr>
               <posAuftragNr></posAuftragNr>
               <posLieferNr></posLieferNr>
               <positionNr></positionNr>
               <serienNr></serienNr>
               <ursprungLand></ursprungLand>
            </artikelDaten>
            <assoc>
               <entry>
                  <key></key>
                  <value></value>
               </entry>
            </assoc>
            <auftragNr></auftragNr>
            <auftraggeberID></auftraggeberID>
            <avisHinweis1></avisHinweis1>
            <avisHinweis2></avisHinweis2>
            <avisZusatz1></avisZusatz1>
            <avisZusatz2></avisZusatz2>
            <bestellNr></bestellNr>
            <druckername></druckername>
            <email></email>
            <faxNr></faxNr>
            <frachtBrief></frachtBrief>
            <frachtfuehrerKdNr></frachtfuehrerKdNr>
            <frankaturKennung></frankaturKennung>
            <gefahrgut>
               <gefahrgutBefoerdKat></gefahrgutBefoerdKat>
               <gefahrgutBegrenzteMenge></gefahrgutBegrenzteMenge>
               <gefahrgutBezeichnung></gefahrgutBezeichnung>
               <gefahrgutBuchst640></gefahrgutBuchst640>
               <gefahrgutFFCode></gefahrgutFFCode>
               <gefahrgutFaktor></gefahrgutFaktor>
               <gefahrgutFreigestMenge></gefahrgutFreigestMenge>
               <gefahrgutKCode></gefahrgutKCode>
               <gefahrgutKlasse></gefahrgutKlasse>
               <gefahrgutMenge></gefahrgutMenge>
               <gefahrgutMengenEinheit></gefahrgutMengenEinheit>
               <gefahrgutNebenGefahr></gefahrgutNebenGefahr>
               <gefahrgutNettoExplMasse></gefahrgutNettoExplMasse>
               <gefahrgutTunnelBCode></gefahrgutTunnelBCode>
               <gefahrgutUNNR></gefahrgutUNNR>
               <gefahrgutUmweltGef></gefahrgutUmweltGef>
               <gefahrgutVPG></gefahrgutVPG>
               <gefahrgutVerpAnzahl></gefahrgutVerpAnzahl>
               <gefahrgutVerpackungsart></gefahrgutVerpackungsart>
            </gefahrgut>
            <gewicht></gewicht>
            <ilnNr></ilnNr>
            <infotext1></infotext1>
            <infotext10></infotext10>
            <infotext2></infotext2>
            <infotext3></infotext3>
            <infotext4></infotext4>
            <infotext5></infotext5>
            <infotext6></infotext6>
            <infotext7></infotext7>
            <infotext8></infotext8>
            <infotext9></infotext9>
            <kostenstelle></kostenstelle>
            <kundenNr></kundenNr>
            <lieferscheinNr></lieferscheinNr>
            <nachnahme></nachnahme>
            <nettoGewicht></nettoGewicht>
            <neutabsenderLKZ></neutabsenderLKZ>
            <neutabsenderName1></neutabsenderName1>
            <neutabsenderName2></neutabsenderName2>
            <neutabsenderName3></neutabsenderName3>
            <neutabsenderOrt></neutabsenderOrt>
            <neutabsenderPLZ></neutabsenderPLZ>
            <neutabsenderStrasse></neutabsenderStrasse>
            <nnVermerk></nnVermerk>
            <nnVerwendung></nnVerwendung>
            <nnWaehrung></nnWaehrung>
            <packStkGes></packStkGes>
            <packStkNr></packStkNr>
            <packplatz></packplatz>
            <packstueckBreite></packstueckBreite>
            <packstueckHoehe></packstueckHoehe>
            <packstueckID></packstueckID>
            <packstueckLaenge></packstueckLaenge>
            <paperlessInvoice></paperlessInvoice>
            <postLeitcode></postLeitcode>
            <postZielFrachtzent></postZielFrachtzent>
            <rechnungsEmpfLKZ></rechnungsEmpfLKZ>
            <rechnungsEmpfName1></rechnungsEmpfName1>
            <rechnungsEmpfName2></rechnungsEmpfName2>
            <rechnungsEmpfName3></rechnungsEmpfName3>
            <rechnungsEmpfOrt></rechnungsEmpfOrt>
            <rechnungsEmpfPLZ></rechnungsEmpfPLZ>
            <rechnungsEmpfStrasse></rechnungsEmpfStrasse>
            <sendungsinhalt></sendungsinhalt>
            <sonderdienste></sonderdienste>
            <telefonNr></telefonNr>
            <terminArt></terminArt>
            <terminDatum></terminDatum>
            <terminZeit></terminZeit>
            <ustIDNr></ustIDNr>
            <verpackungsart></verpackungsart>
            <versandartID></versandartID>
            <versicherungswert></versicherungswert>
            <vwWaehrung></vwWaehrung>
            <warenwert></warenwert>
            <wwWaehrung></wwWaehrung>
            <zahlungsbedingung></zahlungsbedingung>
            <zbZoll></zbZoll>
            <zielAdrBahnhof></zielAdrBahnhof>
            <zielAdrLKZ></zielAdrLKZ>
            <zielAdrName1></zielAdrName1>
            <zielAdrName2></zielAdrName2>
            <zielAdrName3></zielAdrName3>
            <zielAdrOrt></zielAdrOrt>
            <zielAdrPLZ></zielAdrPLZ>
            <zielAdrRegion></zielAdrRegion>
            <zielAdrStrasse></zielAdrStrasse>
         </arg0>
      </std:versanddatenPruefAnfrage>
   </soapenv:Body>
</soapenv:Envelope>

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.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
packstueckID String 20 - Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um den Datensatz zu identifizieren.
packplatz String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
ansprechpartner String 20 - Empfänger Ansprechpartner
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
avisHinweis1 String 100 - -
avisHinweis2 String 100 - -
avisZusatz1 String 20 - Zusatz zu Fest-AVIS-Schlüssel 1
avisZusatz2 String 20 - Zusatz zu Fest-AVIS-Schlüssel 2
bestellNr String 20 - Metro-Bestellnr (Metro-Versand)
email String 100 - E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
empfMobilfunkNr String 20 - Mobilfunknummer des Empfängers
faxNr String 20 - Faxnummer des Empfängers
flexZustellungEmailadresse String 80 - Flex-Zustellung Emailadresse
gewicht Decimal 8 3 Bruttogewicht in KG
nettoGewicht Decimal 8 3 Nettogewicht in KG
ilnNr String 20 - ILN des Empfängers (Pflicht bei Metro-Versand)
kostenstelle String 30 - -
lieferantenID Integer - - -
nachnahme Decimal 18 2 -
nnVermerk String 1 - B': Bar / 'V': Verrechnungsscheck
nnVerwendung String 30 - Nachnahme Verwendungszweck
nnWaehrung String 3 - Nachnahme - ISO-Währungscode
packstueckBreite Integer - - Breite in cm
packstueckHoehe Integer - - Höhe in cm
packstueckLaenge Integer - - Länge in cm
rechnungsEmpfLKZ String 5 - Rechnungsadresse
rechnungsEmpfName1 String 50 - Rechnungsempfänger
rechnungsEmpfName2 String 50 - Rechnungsempfänger
rechnungsEmpfName3 String 50 - Rechnungsempfänger
rechnungsEmpfOrt String 50 - Rechnungsadresse
rechnungsEmpfPLZ String 10 - Rechnungsadresse
rechnungsEmpfStrasse String 50 - Rechnungsadresse
rechnungsNr String 20 - Rechnungsnummer
sendungsinhalt String 30 - -
telefonNr String 20 - Telefonnummer des Empfängers
vorpackdatum String 10 - TT.MM.JJJJ
versicherungswert Decimal 18 2 Höhe Versicherungswert
vwWaehrung String 3 - Versicherungswert - ISO-Währungscode
wechselbruecke String 20 - Wechselbrücke, die diesem Packstück zugewiesen wird
warenwert Decimal 18 2 -
wwWaehrung String 3 - Warenwert - ISO-Währungscode


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen
fehlercode Integer - - 0 wenn Erfolgreich
fehlertext1 String 200 - Wird im Fehlerfall befüllt
fehlertext2 String 200 - Wird im Fehlerfall befüllt


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:updateVersanddaten>
         <arg0>
            <ansprechpartner></ansprechpartner>
            <anzahlArtikel></anzahlArtikel>
            <artikelDaten>
               <anzahlBuegel></anzahlBuegel>
               <anzahlPosEtiketten></anzahlPosEtiketten>
               <artikelBTNNr></artikelBTNNr>
               <artikelEAN></artikelEAN>
               <artikelEinheit></artikelEinheit>
               <artikelGewicht></artikelGewicht>
               <artikelGruppe></artikelGruppe>
               <artikelMenge></artikelMenge>
               <artikelServices></artikelServices>
               <artikelSollMenge></artikelSollMenge>
               <artikelText1></artikelText1>
               <artikelText2></artikelText2>
               <artikelText3></artikelText3>
               <artikelText4></artikelText4>
               <artikelVolumen></artikelVolumen>
               <artikelWaehrung></artikelWaehrung>
               <artikelWert></artikelWert>
               <chargeFlag></chargeFlag>
               <kundenArtikelNr></kundenArtikelNr>
               <kundenBestellNr></kundenBestellNr>
               <posAuftragNr></posAuftragNr>
               <posLieferNr></posLieferNr>
               <positionNr></positionNr>
               <serienNr></serienNr>
               <ursprungLand></ursprungLand>
            </artikelDaten>
            <assoc>
               <entry>
                  <key></key>
                  <value></value>
               </entry>
            </assoc>
            <auftragNr></auftragNr>
            <auftraggeberID></auftraggeberID>
            <avisHinweis1></avisHinweis1>
            <avisHinweis2></avisHinweis2>
            <avisZusatz1></avisZusatz1>
            <avisZusatz2></avisZusatz2>
            <barcodeID></barcodeID>
            <barcodeText></barcodeText>
            <barcodeTyp></barcodeTyp>
            <bestellNr></bestellNr>
            <druckername></druckername>
            <email></email>
            <empfMobilfunkNr></empfMobilfunkNr>
            <faxNr></faxNr>
            <fehlertext></fehlertext>
            <flexZustellungEmailadresse></flexZustellungEmailadresse>
            <frachtBrief></frachtBrief>
            <frachtfuehrerKdNr></frachtfuehrerKdNr>
            <frankaturKennung></frankaturKennung>
            <gefahrgut>
               <gefahrgutBefoerdKat></gefahrgutBefoerdKat>
               <gefahrgutBegrenzteMenge></gefahrgutBegrenzteMenge>
               <gefahrgutBezeichnung></gefahrgutBezeichnung>
               <gefahrgutBuchst640></gefahrgutBuchst640>
               <gefahrgutFFCode></gefahrgutFFCode>
               <gefahrgutFaktor></gefahrgutFaktor>
               <gefahrgutFreigestMenge></gefahrgutFreigestMenge>
               <gefahrgutKCode></gefahrgutKCode>
               <gefahrgutKlasse></gefahrgutKlasse>
               <gefahrgutMenge></gefahrgutMenge>
               <gefahrgutMengenEinheit></gefahrgutMengenEinheit>
               <gefahrgutNebenGefahr></gefahrgutNebenGefahr>
               <gefahrgutNettoExplMasse></gefahrgutNettoExplMasse>
               <gefahrgutTunnelBCode></gefahrgutTunnelBCode>
               <gefahrgutUNNR></gefahrgutUNNR>
               <gefahrgutUmweltGef></gefahrgutUmweltGef>
               <gefahrgutVPG></gefahrgutVPG>
               <gefahrgutVerpAnzahl></gefahrgutVerpAnzahl>
               <gefahrgutVerpackungsart></gefahrgutVerpackungsart>
            </gefahrgut>
            <gewicht></gewicht>
            <hostTrackingNr></hostTrackingNr>
            <ilnNr></ilnNr>
            <infotext1></infotext1>
            <infotext10></infotext10>
            <infotext2></infotext2>
            <infotext3></infotext3>
            <infotext4></infotext4>
            <infotext5></infotext5>
            <infotext6></infotext6>
            <infotext7></infotext7>
            <infotext8></infotext8>
            <infotext9></infotext9>
            <kostenstelle></kostenstelle>
            <kundenNr></kundenNr>
            <lagerkennzeichen></lagerkennzeichen>
            <letztesPackstueck></letztesPackstueck>
            <lieferantenID></lieferantenID>
            <lieferscheinNr></lieferscheinNr>
            <nachnahme></nachnahme>
            <nettoGewicht></nettoGewicht>
            <neutBIC></neutBIC>
            <neutBankBezeichnung></neutBankBezeichnung>
            <neutIBAN></neutIBAN>
            <neutKontoInhaber></neutKontoInhaber>
            <neutabsenderLKZ></neutabsenderLKZ>
            <neutabsenderName1></neutabsenderName1>
            <neutabsenderName2></neutabsenderName2>
            <neutabsenderName3></neutabsenderName3>
            <neutabsenderOrt></neutabsenderOrt>
            <neutabsenderPLZ></neutabsenderPLZ>
            <neutabsenderStrasse></neutabsenderStrasse>
            <nnVermerk></nnVermerk>
            <nnVerwendung></nnVerwendung>
            <nnWaehrung></nnWaehrung>
            <packStkGes></packStkGes>
            <packStkNr></packStkNr>
            <packplatz></packplatz>
            <packstueckBreite></packstueckBreite>
            <packstueckHoehe></packstueckHoehe>
            <packstueckID></packstueckID>
            <packstueckLaenge></packstueckLaenge>
            <paperlessInvoice></paperlessInvoice>
            <postLeitcode></postLeitcode>
            <postZielFrachtzent></postZielFrachtzent>
            <rechnungsEmpfLKZ></rechnungsEmpfLKZ>
            <rechnungsEmpfName1></rechnungsEmpfName1>
            <rechnungsEmpfName2></rechnungsEmpfName2>
            <rechnungsEmpfName3></rechnungsEmpfName3>
            <rechnungsEmpfOrt></rechnungsEmpfOrt>
            <rechnungsEmpfPLZ></rechnungsEmpfPLZ>
            <rechnungsEmpfStrasse></rechnungsEmpfStrasse>
            <rechnungsNr></rechnungsNr>
            <sendungsinhalt></sendungsinhalt>
            <sonderdienste></sonderdienste>
            <sperrFlag></sperrFlag>
            <telefonNr></telefonNr>
            <terminArt></terminArt>
            <terminDatum></terminDatum>
            <terminZeit></terminZeit>
            <ustIDNr></ustIDNr>
            <verpackungsart></verpackungsart>
            <versandartID></versandartID>
            <versicherungswert></versicherungswert>
            <vorpackdatum></vorpackdatum>
            <vwWaehrung></vwWaehrung>
            <warenwert></warenwert>
            <wechselbruecke></wechselbruecke>
            <wwWaehrung></wwWaehrung>
            <zahlungsbedingung></zahlungsbedingung>
            <zbZoll></zbZoll>
            <zielAdrBahnhof></zielAdrBahnhof>
            <zielAdrLKZ></zielAdrLKZ>
            <zielAdrName1></zielAdrName1>
            <zielAdrName2></zielAdrName2>
            <zielAdrName3></zielAdrName3>
            <zielAdrName4></zielAdrName4>
            <zielAdrOrt></zielAdrOrt>
            <zielAdrPLZ></zielAdrPLZ>
            <zielAdrRegion></zielAdrRegion>
            <zielAdrStrasse></zielAdrStrasse>
         </arg0>
      </std:updateVersanddaten>
   </soapenv:Body>
</soapenv:Envelope>

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.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
auftragsNr String 20 - -
lieferscheinNr String 40 - Wird im HVS32 als Such-Nummer verwendet.
packplatz String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
packstueckID String 20 - Eindeutige Nummer für das Paket im Vorsystem.
trackingNr String 35 - Paketnummer


Rückgabe Parameter
Feldname Typ Max Länge Nachkommastellen Belegung
fehlertext1 String 200 - Wird im Fehlerfall befüllt
fehlertext2 String 200 - Wird im Fehlerfall befüllt


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:anonymisiereVersandDaten>
         <arg0>
            <auftragsNr></auftragsNr>
            <lieferscheinNr></lieferscheinNr>
            <packplatz></packplatz>
            <packstueckID></packstueckID>
            <trackingNr></trackingNr>
         </arg0>
      </std:anonymisiereVersandDaten>
   </soapenv:Body>
</soapenv:Envelope>

Sendungs-Verarbeitung (sendungsdatenAnfrage)

HVS32-Sendungsdaten Anfrage – wird zur Laufzeit in einzelne versandDatenAnfragen unterteilt. Muss bei einer Anfrage für das SPM genutzt werden (requestSPM=TRUE).

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Dezimalstellen Belegung
ansprechpartner String 20 - Empfänger Ansprechpartner
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
auftragNr String 20 - -
auftraggeberID String 10 - Mandantenkennung aus dem HVS32
ausschlussFrachtfuehrer String 20 - Ausschluss-Frachtführer für SPM Anfrage
avisHinweis1 String 100 - -
avisHinweis2 String 100 - -
avisZusatz1 String 20 - Zusatz zu Fest-AVIS-Schlüssel 1
avisZusatz2 String 20 - Zusatz zu Fest-AVIS-Schlüssel 2
bestellNr String 20 - -
email String 100 - Für automatische Mailavisierung
empfMobilfunkNr String 20 - Mobilfunknummer des Empfängers
faxNr String 20 - Faxnummer des Empfängers
flexZustellungEmailadResponsese String 80 - Flex-Zustellung Email-Adresse
frachtBrief String 20 - Frachtbrief Nummer, falls Frachtbrief durch Vorsystem gedruckt wird.
frachtfuehrerKdNr String 10 - Kundennummer des Frachtzahlers beim Frachtführer.
frankaturKennung String 10 - -
ilnNr String 20 - ILN des Empfängers (Pflicht bei Metro-Versand)
kostenstelle String 30 - -
kundenNr String 20 - Kundennummer des Empfängers beim Versender
Lagerkennzeichen String
LieferantenID String
lieferscheinNr String 40 - Wird im HVS32 als Such-Nummer verwendet.
neutBIC String 11 - Nur bei Neutral-Absendern belegt
neutBankBezeichnung String 40 - Nur bei Neutral-Absendern belegt
neutIBAN String 31 - Nur bei Neutral-Absendern belegt
neutKontoInhaber String 40 - Nur bei Neutral-Absendern belegt
neutabsenderLKZ String 3 - Nur bei Neutral-Absendern belegt
neutabsenderName1 String 50 - Nur bei Neutral-Absendern belegt
neutabsenderName2 String 50 - Nur bei Neutral-Absendern belegt
neutabsenderName3 String 50 - Nur bei Neutral-Absendern belegt
neutabsenderOrt String 50 - Nur bei Neutral-Absendern belegt
neutabsenderPLZ String 10 - Nur bei Neutral-Absendern belegt
neutabsenderStrasse String 50 - Nur bei Neutral-Absendern belegt
packStkGes Integer - - Gesamt-Anzahl Colli der Sendung
packstueckDaten Sequence <PackStueckDaten> - - -
packplatz String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
paperlessInvoice String 1 - Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
postLeitcode String 15 - -
postZielFrachtzent String 5 - -
rechnungsEmpfLKZ String 5 - Rechnungsadresse
rechnungsEmpfName1 String 50 - Rechnungsempfänger
rechnungsEmpfName2 String 50 - Rechnungsempfänger
rechnungsEmpfName3 String 50 - Rechnungsempfänger
rechnungsEmpfOrt String 50 - Rechnungsadresse
rechnungsEmpfPLZ String 10 - Rechnungsadresse
rechnungsEmpfStrasse String 50 - Rechnungsadresse
rechnungsNr String 20 - Rechnungsnummer
requestSPM String 5 - T/TRUE wenn die Entscheidungsmatrix angesprochen werden soll, sonst leer
sendungsinhalt String 30 - -
sonderdienste String 30 - Versandart-spezifisch belegt
sperrFlag String 1 - T/F: T=Sperren, sonst nicht sperren
telefonNr String 20 - Telefonnummer des Empfängers
terminArt String 1 - 'A'b / 'B'is / 'F'ix
terminDatum String 10 - TT.MM.JJJJ
terminZeit String 5 - HH:MM
ustIDNr String 20 - UmsatzsteuerNr des Empfängers
versandartID String 10 - Versandartkennung aus dem HVS32
vorgabeFrachtfuehrer String 20 - Vorgabe-Frachtführer für SPM Anfrage
vorpackdatum String 10 - TT.MM.JJJJ
wechselbruecke String 20 - Wechselbrücke, die diesem Packstück zugewiesen werden soll
zahlungsbedingung String 10 - 'S' = Sender, 'R' = Empfänger
zbZoll String 1 - Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
zielAdrBahnhof String 30 - PLZ und Ort
zielAdrLKZ String 5 - Lieferadresse
zielAdrName1 String 50 - Lieferadresse
zielAdrName2 String 50 - Lieferadresse
zielAdrName3 String 50 - Lieferadresse
zielAdrName4 String 50 - Lieferadresse
zielAdrOrt String 50 - Lieferadresse
zielAdrPLZ String 10 - Lieferadresse
zielAdrRegion String 20 - Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
zielAdrStrasse String 50 - Lieferadresse


Rückgabe Parameter
Feldname Typ Max Länge Dezimalstellen Belegung
fehler String - - Wird im Fehlerfall befüllt
sendungsGebuehr Decimal 18 2 Frachkosten
sendungsGebuehrWaehrung String 3 - Frachkosten ISO-Währungscode
versandSendungsNr String 20 - Sendungsnummer
Packstückdaten
Feldname Typ Max Länge Dezimalstellen
assoc Map (String, String) - - Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
ausgangDateTime Calendar 10 - Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
ausgangDateTimeString String 10 - Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
druckDateTime Calendar 19 - Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
druckDateTimeString String 19 - Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
etikettDaten String - - Binärdaten des Etiketts
etikettName String - - Vorlagenname des Etiketts
fehlercode Integer - - 0 wenn Erfolgreich
fehlertext1 String 200 - Wird im Fehlerfall befüllt
fehlertext2 String 200 - Wird im Fehlerfall befüllt
gebuehr Decimal 18 2 Frachtkosten
gebuehrWaehrung String 3 - Frachkosten ISO-Währungscode
packstueckID String 20 - PackstueckID aus der Anfrage
retourTrackingNr String 50 - Paketnummer für die Retoure
trackingNr String 35 - Paketnummer
trackingURL String 255 - URL des Trackinglinks zur Sendungsverfolgung
zusatzEtikettenDaten Map (String, String) - - Name und Binärdaten der Zusatzetiketten als Key/Value Map
zusatzfeld1 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld2 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld3 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld4 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld5 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld6 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld7 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld8 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld9 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
zusatzfeld10 String 200 - Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden


Beispiele
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:std="http://std.soap.server.dgs/">
   <soapenv:Header/>
   <soapenv:Body>
      <std:sendungsdatenAnfrage>
         <arg0>
            <ansprechpartner></ansprechpartner>
            <assoc>
               <entry>
                  <key></key>
                  <value></value>
               </entry>
            </assoc>
            <auftragNr></auftragNr>
            <auftraggeberID></auftraggeberID>
            <ausschlussFrachtfuehrer></ausschlussFrachtfuehrer>
            <avisHinweis1></avisHinweis1>
            <avisHinweis2></avisHinweis2>
            <avisZusatz1></avisZusatz1>
            <avisZusatz2></avisZusatz2>
            <bestellNr></bestellNr>
            <email></email>
            <empfMobilfunkNr></empfMobilfunkNr>
            <faxNr></faxNr>
            <flexZustellungEmailadresse></flexZustellungEmailadresse>
            <frachtBrief></frachtBrief>
            <frachtfuehrerKdNr></frachtfuehrerKdNr>
            <frankaturKennung></frankaturKennung>
            <ilnNr></ilnNr>
            <kostenstelle></kostenstelle>
            <kundenNr></kundenNr>
            <lagerkennzeichen></lagerkennzeichen>
            <lieferantenID></lieferantenID>
            <lieferscheinNr></lieferscheinNr>
            <neutBIC></neutBIC>
            <neutBankBezeichnung></neutBankBezeichnung>
            <neutIBAN></neutIBAN>
            <neutKontoInhaber></neutKontoInhaber>
            <neutabsenderLKZ></neutabsenderLKZ>
            <neutabsenderName1></neutabsenderName1>
            <neutabsenderName2></neutabsenderName2>
            <neutabsenderName3></neutabsenderName3>
            <neutabsenderOrt></neutabsenderOrt>
            <neutabsenderPLZ></neutabsenderPLZ>
            <neutabsenderStrasse></neutabsenderStrasse>
            <packStkGes></packStkGes>
            <packStueckDaten>
               <anzahlArtikel></anzahlArtikel>
               <artikelDaten>
                  <anzahlBuegel></anzahlBuegel>
                  <anzahlPosEtiketten></anzahlPosEtiketten>
                  <artikelBTNNr></artikelBTNNr>
                  <artikelEAN></artikelEAN>
                  <artikelEinheit></artikelEinheit>
                  <artikelGewicht></artikelGewicht>
                  <artikelGruppe></artikelGruppe>
                  <artikelMenge></artikelMenge>
                  <artikelServices></artikelServices>
                  <artikelSollMenge></artikelSollMenge>
                  <artikelText1></artikelText1>
                  <artikelText2></artikelText2>
                  <artikelText3></artikelText3>
                  <artikelText4></artikelText4>
                  <artikelVolumen></artikelVolumen>
                  <artikelWaehrung></artikelWaehrung>
                  <artikelWert></artikelWert>
                  <chargeFlag></chargeFlag>
                  <kundenArtikelNr></kundenArtikelNr>
                  <kundenBestellNr></kundenBestellNr>
                  <posAuftragNr></posAuftragNr>
                  <posLieferNr></posLieferNr>
                  <positionNr></positionNr>
                  <serienNr></serienNr>
                  <ursprungLand></ursprungLand>
               </artikelDaten>
               <assoc>
                  <entry>
                     <key></key>
                     <value></value>
                  </entry>
               </assoc>
               <barcodeID></barcodeID>
               <barcodeText></barcodeText>
               <barcodeTyp></barcodeTyp>
               <druckername></druckername>
               <fehlertext></fehlertext>
               <gefahrgut>
                  <gefahrgutBefoerdKat></gefahrgutBefoerdKat>
                  <gefahrgutBegrenzteMenge></gefahrgutBegrenzteMenge>
                  <gefahrgutBezeichnung></gefahrgutBezeichnung>
                  <gefahrgutBuchst640></gefahrgutBuchst640>
                  <gefahrgutFFCode></gefahrgutFFCode>
                  <gefahrgutFaktor></gefahrgutFaktor>
                  <gefahrgutFreigestMenge></gefahrgutFreigestMenge>
                  <gefahrgutKCode></gefahrgutKCode>
                  <gefahrgutKlasse></gefahrgutKlasse>
                  <gefahrgutMenge></gefahrgutMenge>
                  <gefahrgutMengenEinheit></gefahrgutMengenEinheit>
                  <gefahrgutNebenGefahr></gefahrgutNebenGefahr>
                  <gefahrgutNettoExplMasse></gefahrgutNettoExplMasse>
                  <gefahrgutTunnelBCode></gefahrgutTunnelBCode>
                  <gefahrgutUNNR></gefahrgutUNNR>
                  <gefahrgutUmweltGef></gefahrgutUmweltGef>
                  <gefahrgutVPG></gefahrgutVPG>
                  <gefahrgutVerpAnzahl></gefahrgutVerpAnzahl>
                  <gefahrgutVerpackungsart></gefahrgutVerpackungsart>
               </gefahrgut>
               <gewicht></gewicht>
               <hostTrackingNr></hostTrackingNr>
               <infotext1></infotext1>
               <infotext10></infotext10>
               <infotext2></infotext2>
               <infotext3></infotext3>
               <infotext4></infotext4>
               <infotext5></infotext5>
               <infotext6></infotext6>
               <infotext7></infotext7>
               <infotext8></infotext8>
               <infotext9></infotext9>
               <letztesPackstueck></letztesPackstueck>
               <nachnahme></nachnahme>
               <nettoGewicht></nettoGewicht>
               <nnVermerk></nnVermerk>
               <nnVerwendung></nnVerwendung>
               <nnWaehrung></nnWaehrung>
               <packStkNr></packStkNr>
               <packstueckBreite></packstueckBreite>
               <packstueckHoehe></packstueckHoehe>
               <packstueckID></packstueckID>
               <packstueckLaenge></packstueckLaenge>
               <verpackungsart></verpackungsart>
               <versicherungswert></versicherungswert>
               <vwWaehrung></vwWaehrung>
               <warenwert></warenwert>
               <wwWaehrung></wwWaehrung>
            </packStueckDaten>
            <packplatz></packplatz>
            <paperlessInvoice></paperlessInvoice>
            <postLeitcode></postLeitcode>
            <postZielFrachtzent></postZielFrachtzent>
            <rechnungsEmpfLKZ></rechnungsEmpfLKZ>
            <rechnungsEmpfName1></rechnungsEmpfName1>
            <rechnungsEmpfName2></rechnungsEmpfName2>
            <rechnungsEmpfName3></rechnungsEmpfName3>
            <rechnungsEmpfOrt></rechnungsEmpfOrt>
            <rechnungsEmpfPLZ></rechnungsEmpfPLZ>
            <rechnungsEmpfStrasse></rechnungsEmpfStrasse>
            <rechnungsNr></rechnungsNr>
            <requestSPM></requestSPM>
            <sendungsinhalt></sendungsinhalt>
            <sonderdienste></sonderdienste>
            <sperrFlag></sperrFlag>
            <telefonNr></telefonNr>
            <terminArt></terminArt>
            <terminDatum></terminDatum>
            <terminZeit></terminZeit>
            <ustIDNr></ustIDNr>
            <versandartID></versandartID>
            <vorgabeFrachtfuehrer></vorgabeFrachtfuehrer>
            <vorpackdatum></vorpackdatum>
            <wechselbruecke></wechselbruecke>
            <zahlungsbedingung></zahlungsbedingung>
            <zbZoll></zbZoll>
            <zielAdrBahnhof></zielAdrBahnhof>
            <zielAdrLKZ></zielAdrLKZ>
            <zielAdrName1></zielAdrName1>
            <zielAdrName2></zielAdrName2>
            <zielAdrName3></zielAdrName3>
            <zielAdrName4></zielAdrName4>
            <zielAdrOrt></zielAdrOrt>
            <zielAdrPLZ></zielAdrPLZ>
            <zielAdrRegion></zielAdrRegion>
            <zielAdrStrasse></zielAdrStrasse>
         </arg0>
      </std:sendungsdatenAnfrage>
   </soapenv:Body>
</soapenv:Envelope>

Beispiele

Alle XML Beispiele finden Sie auch hier: SOAP SERVER XML Beispiele

Abgerufen von „https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_SOAP_Schnittstelle_(Automatik-Polling)&oldid=4458“