HVS32 Standard Datei Schnittstelle: Unterschied zwischen den Versionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen
 
(57 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
= Funktionsbeschreibung =
 
= Funktionsbeschreibung =
−
Bei der REST-Schnittstelle stellt der DataGatewayServer (DGS) einen REST Server mit folgenden [[#Übersicht der Funktionen|Funktionen]] zur Verfügung.
+
−
Dieser ist in der Standardkonfiguration unter '''http://<Servername>:<Port>/hvs32rest''' erreichbar. Dabei wird der Port 8081 verwendet, welcher bei Bedarf geändert werden kann.
+
Die Dateischnittstelle ist sehr flexibel und kann an nahezu alle Eingangsdaten angepasst werden. Es ist möglich mehrere Datensätze in einer Datei zu übergeben, aber auch ein Datensatz pro Datei ist möglich.
−
<!-- ------------------------------------------------------------------------------- ENDE Funktionsbeschreibung ------------------------------------------------------------------------------- -->
+
In der Regel belegt ein Packstück eine Zeile, eventuell gefolgt von Zusatzinformationen wie Artikeldaten oder Gefahrgutsätzen.
−
<!-- ------------------------------------------------------------------------------- DATENTYPEN ------------------------------------------------------------------------------- -->
+
<br>
 +
Die einzelnen Felder sind unter [[HVS32_Standard_Datei_Tabellenbeschreibung|Standard Datei Tabellenbeschreibung (CSV, SDF, etc.)]] beschrieben.
 +
 
 +
= Übersicht der Funktionen =
 +
<!-- ------------------------------------------------------------------------------- echo ------------------------------------------------------------------------------- -->
 +
== Packstück-Verarbeitung ==
 +
Ein neues Packstück wird durch eine Zeile gekennzeichnet die mit der Kennung "IMP" beginnt.
  
−
= Datentypen =
+
Die weiteren Felder sind in der [[HVS32_Standard_Datei_Tabellenbeschreibung|Standardschnittstelle]] beschrieben.
−
'''Integer''' - Zahl mit ausschließlich numerischen Zeichen (0-9).<br>
 
−
'''Decimal''' - Zahl mit Nachkommastellen<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>
 
−
'''Binary''' - Base64 kodierte Binärdaten<br>
 
−
'''Sequence''' - Eine Liste von Elementen<br>
 
−
'''Map''' - Key/Value Map<br>
 
−
<!-- ------------------------------------------------------------------------------- ENDE DATENTYPEN ------------------------------------------------------------------------------- -->
 
−
<!-- ------------------------------------------------------------------------------- ÜBERSICHT spezial Datentypen ------------------------------------------------------------------------------- -->
 
  
−
= Zusätzliche Datentypen =
+
== Etikett nachdrucken ==
−
Ein spezial Datentyp kann innerhalb der Anfrage / Rückmeldung einer [[#Übersicht der Funktionen|Funktion]] genutzt werden.
 
−
<!-- ------------------------------------------------------------------------------- artikelDaten ------------------------------------------------------------------------------- -->
 
−
== artikelDaten ==
 
  
−
Nr, Feldname, Von, Bis, Typ, Länge, Dez, Pflicht, HVS-Feld, Belegung, Feldname
+
Ein Nachdruck wird ausgelöst indem ein bereits übergebener Satz erneut erfasst wird. Je nach Einstellungen kann es dabei zu einer Warnung oder einer Verhinderung des Nachdrucks kommen - die zugehörigen Wahlmöglichkeiten befinden sich im Allgemein-Konfigurator, Bereich "Lieferschein-Verarbeitung".
  
 +
== Packstück stornieren ==
 +
<!--
 +
Text anpassen
 +
<br>
 +
<br>
 +
<br>
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
<div style="font-weight:bold;line-height:1.6;">Artikel-Daten</div>
+
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
−
! Nr !! Feldname !! Von !! Bis !! Typ !! Länge !! Dezimalstellen !! Pflicht !! HVS-Feld !! Belegung !! Feldname
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| 1 || Satz-Kennung || 1 || 3 || A || 3 ||  || M ||  || Festeintrag "ART" || Satz-Kennung
+
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 
|-
 
|-
−
| 2 || Lieferschein-Nr || 4 || 13 || A || 10 ||  || M || ||  || Lieferschein-Nr
+
| '''packstueckID'''|| [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
 
|-
 
|-
−
| 3 || Packstück-Nr || 14 || 16 || N || 3 ||  || C ||  || Pflicht bei AutomatikPolling || Packstück-Nr
+
| 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"
 
|-
 
|-
−
| 4 || Positions-Nr || 17 || 26 || N || 10 || 0 || M ||  || || Positions-Nr
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| 5 || Artikel-Nr || 27 || 76 || A || 50 || || O ||  || || Artikel-Nr
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
|-
 
|-
−
| 6 || Artikel-Bezeichnung1 || 77 || 176 || A || 100 || || M ||  || || Artikel-Bezeichnung1
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| 7 || Artikel-Bezeichnung2 || 177 || 276 || A || 100 || || O ||  || || Artikel-Bezeichnung2
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
−
|-
+
|}
−
| 8 || Artikel-Netto-Gewicht (je Maßeinheit) || 277 || 285 || N || 9 || 3 || M ||  || || Artikel-Netto-Gewicht (je Maßeinheit)
+
</div></div>
−
|-
+
<br>
−
| 9 || BTN-Nummer || 286 || 310 || A || 25 ||  || O ||  || || BTN-Nummer
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
| 10 || Artikel-Anzahl (je Maßeinheit) || 311 || 319 || N || 9 || 0 || M ||  || || Artikel-Anzahl (je Maßeinheit)
+
<div class="mw-collapsible-content">
−
|-
+
;Request
−
| 11 || Ursprungsland || 320 || 321 || A || 2 ||  || O ||  || || Ursprungsland
+
<source lang="json">
−
|-
+
{
−
| 12 || Artikel-Wert (je Maßeinheit) || 322 || 330 || N || 9 || 2 || O ||  || || Artikel-Wert (je Maßeinheit)
+
"packplatz": "",
−
|-
+
"packstueckID": "",
−
| 13 || Artikelwert-Währung || 331 || 333 || A || 3 ||  || O ||  || ISO-Währung z.B. 'EUR' || Artikelwert-Währung
+
"trackingNr": ""
−
|-
+
}
−
| 14 || Artikel-Maßeinheit || 334 || 343 || A || 10 ||  || O ||  || || Artikel-Maßeinheit
+
</source>
 +
;Response
 +
<source lang="json">
 +
{
 +
"fehlercode": 0,
 +
"fehlertext1": "",
 +
"fehlertext2": ""
 +
}
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE stornoversanddaten ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- verladeVersandaten ------------------------------------------------------------------------------- -->
 +
 
 +
== Ausgangsliste erzeugen ==
 +
<!--
 +
Text anpassen
 +
<br>
 +
<br>
 +
<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"
 
|-
 
|-
−
| 15 || Artikel-BestellNr || 344 || 393 || A || 50 ||  || M ||  || || Artikel-BestellNr
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| 16 || Artikel-Volumen || 394 || 402 || N || 9 || 3 || M ||  || || Artikel-Volumen
+
| auftraggeberID || [[#Datentypen|String]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
 +
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.
 
|-
 
|-
−
| 17 || Artikel-Services || 403 || 452 || A || 50 ||  || O || || || Artikel-Services
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
 +
(Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
−
| 18 || Artikel-Gruppe || 453 || 502 || A || 50 ||  || O ||  || || Artikel-Gruppe
+
| frachtfuehrerTyp || [[#Datentypen|String]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".
 +
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.
 
|-
 
|-
−
| 19 || CR/LF || 503 || 504 || || 2 ||  ||  ||  || Carriage Return/Line Feed || CR/LF
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.
 
|-
 
|-
−
| 20 || kundenBestellNr || [[#Datentypen|String]] || 50 || - || Bestellnummer
+
| versandartID || [[#Datentypen|String]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.
 +
Bei Nutzung muss zusätzlich der HVS32-Schalter 'MultiVATagesabschluss' in der Sektion 'AutomatikPolling' auf 'ON' gesetzt sein.
 
|-
 
|-
−
| 21 || posAuftragNr || [[#Datentypen|String]] || 50 || - || Auftragsnummer
+
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
−
|-
 
−
| 22 || posLieferNr || [[#Datentypen|String]] || 40 || - || Lieferscheinnummer
 
−
|-
 
−
| 23 || positionNr || [[#Datentypen|String]] || 50 || - || Laufende Nummer innerhalb des Packstücks
 
−
|-
 
−
| 24 || serienNr || [[#Datentypen|String]] || 30 || - || Seriennummer
 
−
|-
 
−
| 25 || ursprungLand || [[#Datentypen|String]] || 2 || - || Ursprungsland des Artikels
 
 
|}
 
|}
 
</div></div>
 
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- -->
 
−
 
 
−
== gefahrgut ==
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
<div style="font-weight:bold;line-height:1.6;">Gefahrgut-Daten</div>
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
Zeile 92: Zeile 118:
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| gefahrgutBefoerdKat || [[#Datentypen|Integer]] || 1 || - || Beförderungskategorie, Pflicht (siehe ADR-Tabelle Spalte (15)), kann 0-4 sein. Achtung! Muss unbedingt korrekt sein.
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| gefahrgutBegrenzteMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status LQ / Begrenzte Menge nach ADR 3.4 verschickt wird, ansonsten F, Pflicht
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
|-
 
|-
−
| gefahrgutBezeichnung || [[#Datentypen|String]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (2))
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| gefahrgutBuchst640 || [[#Datentypen|String]] || 1 || - || Buchstabe für Sondervorschrift 640, bedingte Pflicht bei Stoffen, bei denen die Sondervorschrift 640 gilt (siehe ADR-Tabelle Spalte (6))
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| gefahrgutFFCode || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
+
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
 
|-
 
|-
−
| 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
+
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.
−
|-
+
|}
−
| gefahrgutFreigestMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status EQ / Excepted Quantities nach ADR 3.5 verschickt wird, ansonsten F, Pflicht
+
</div></div>
−
|-
+
<br>
−
| gefahrgutID || [[#Datentypen|String]] || 8 || - || Eindeutige Suchnummer für Gefahrgut-Stammdaten
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
| 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 )
 
−
|-
 
−
| gefahrgutMengenEinheit || [[#Datentypen|String]] || 2 || - || Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg
 
−
|-
 
−
| gefahrgutNebenGefahr || [[#Datentypen|String]] || 10 || - || bedingte Pflicht bei Stoffen, bei denen neben der Hauptgefahr-Klasse/Zettelnummer noch Nebengefahr-Zettelnummern vorhanden sind (siehe ADR-Tabelle Spalte (5), wenn dort z.B. 3+6.1+8 eingetragen ist, sind 6.1 und 8 die Nebengefahr-Zettelnummern und als (6.1)(8) im Feld Nebengefahr zu übermitteln )
 
−
|-
 
−
| gefahrgutNettoExplMasse || [[#Datentypen|Decimal]] || 8 || 3 || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
 
−
|-
 
−
| gefahrgutPositionNr || [[#Datentypen|Integer]] || - || - || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
 
−
|-
 
−
| gefahrgutTechBenennung || [[#Datentypen|String]] || 150 || - || bedingt Pflicht bei N.A.G. Gefahrgut (d.h. wenn die Bezeichnung mit N.A.G. endet)
 
−
|-
 
−
| gefahrgutTunnelBCode || [[#Datentypen|String]] || 10 || - || Tunnelbeschränkungscode, Pflicht (siehe ADR-Tabelle Spalte (15))
 
−
|-
 
−
| gefahrgutUNNR || [[#Datentypen|String]] || 10 || - || Pflicht (siehe ADR-Tabelle Spalte (1))
 
−
|-
 
−
| gefahrgutUmweltGef || [[#Datentypen|String]] || 1 || - || T wenn Stoff umweltgefährdend ist , ansonsten F, Pflicht bei umweltgefährdenden Stoffen
 
−
|-
 
−
| gefahrgutVPG || [[#Datentypen|String]] || 3 || - || Verpackungsgruppe, bedingt Pflicht bei den Stoffen, bei denen diese in der ADR-Tabelle belegt ist, kann I,II oder III sein oder gar nicht belegt (letzteres z.B. bei Klasse 2)) (siehe ADR-Tabelle Spalte (4))
 
−
|-
 
−
| gefahrgutVerpAnzahl || [[#Datentypen|Integer]] || 4 || - || Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)
 
−
|-
 
−
| gefahrgutVerpackungsart || [[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes
 
−
|}
 
−
</div></div>
 
−
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- -->
 
−
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- -->
 
−
 
 
−
== edistatus ==
 
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 
−
<div style="font-weight:bold;line-height:1.6;">EDIStatus</div>
 
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
−
{| class="wikitable sortable"
+
;Request
−
|-
+
<source lang="json">
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
{
−
|-
+
"auftraggeberID": [
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
""
−
|-
+
],
−
| statuscode || [[#Datentypen|String]] || 2 || - || 
+
"druckername": "",
−
01 = FFDatei wurde erzeugt.<br>
+
"frachtfuehrerTyp": [
−
02 = FFDatei wurde geschrieben.<br>
+
""
−
03 = FFDatei wurde verschickt.<br>
+
],
−
11 = FFDatei konnte nicht erzeugt werden!<br>
+
"packplatz": "",
−
12 = FFDatei konnte nicht geschrieben werden!<br>
+
"versandartID": [
−
13 = FFDatei konnte nicht verschickt werden!<br>
+
""
 +
],
 +
"wechselbruecke": ""
 +
}
 +
</source>
 +
;Response
 +
<source lang="json">
 +
{
 +
"assoc": {
 +
"":""
 +
},
 +
"fehlercode": 0,
 +
"fehlertext1": "",
 +
"listenDaten": {
 +
"": ""
 +
}
 +
}
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE Listenabschluss ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- ediabschlussAnfrage ------------------------------------------------------------------------------- -->
  
−
Es ist zu beachten, dass nicht jede FFDatei verschickt wird, dies hängt ab von der HVS32 Konfiguration.<br>
+
== Frachtführer DFÜ erzeugen ==
−
D.h. solange kein Status „1x“ enthalten ist, wurde mit der FFDatei gemäß der HVS32 Konfiguration verfahren.
+
<!--
−
|-
+
Text anpassen
−
| statustext || [[#Datentypen|String]] || 200 || - || Klartext des Statuscodes
+
<br>
−
|-
+
<br>
−
| fftyp || [[#Datentypen|String]] || 50 || - || Frachtführertyp (z.B. UPS, GLS, DPD)
+
<br>
−
|-
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
| dateityp || [[#Datentypen|String]] || 50 || - || FFDateityp (z.B.: Standard, Express, etc.)
+
<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]] [[#Datentypen|<String>]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
 +
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.
 
|-
 
|-
−
| auftraggeber || [[#Datentypen|String]] || 10 || - || Auftraggebernummer ('''ACHTUNG!''' Nicht die AuftraggeberID)
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den z.B. die UPS Summary gedruckt wird.<br>
 +
(Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
−
| ffdateinr || [[#Datentypen|String]] || 10 || - || Nummer der FF-Datei (ggf. im Fehlerfall nicht gefüllt)
+
| frachtfuehrerTyp || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".<br>
 +
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.
 +
|-
 +
| versandartID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.<br>
 +
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.
 
|}
 
|}
 
</div></div>
 
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE edistatus ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- packstueckDaten ------------------------------------------------------------------------------- -->
 
−
== packstueckDaten ==
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
<div style="font-weight:bold;line-height:1.6;">Packstückdaten</div>
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
Zeile 182: Zeile 210:
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
+
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] [[#edistatus|<EDIStatus>]] || - || - || Liste mit Statusinformationen für EDIs.
 
|-
 
|-
−
| 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
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der EDI-Listen (z.B. UPS Summary) als Key/Value Map.
−
|-
+
|}
−
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
</div></div>
−
|-
+
<br>
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
+
<div class="mw-collapsible-content">
−
|-
+
;Request
−
| '''gewicht''' || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+
<source lang="json">
−
|-
+
{
−
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Falls die Paketnummer aus dem Vorsystem verwendet werden soll.
+
"auftraggeberID": [
−
|-
+
""
−
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
],
−
|-
+
"druckername": "",
−
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"frachtfuehrerTyp": [
−
|-
+
""
−
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
],
−
|-
+
"packplatz": "",
−
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"versandartID": [
−
|-
+
""
−
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
],
−
|-
+
"wechselbruecke": ""
−
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
}
−
|-
+
</source>
−
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
;Response
−
|-
+
<source lang="json">
−
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
{
−
|-
+
"assoc": {
−
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"":""
−
|-
+
},
−
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"fehlercode": 0,
 +
"fehlertext1": "",
 +
"edistatus": [
 +
{
 +
"fehlercode": 0,
 +
"statuscode": "",
 +
"statustext": "",
 +
"fftyp": "",
 +
"dateityp": "",
 +
"auftraggeber": "",
 +
"ffdateinr": ""
 +
}
 +
],
 +
"listenDaten": {}
 +
}
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE ediabschlussAnfrage ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
 +
 
 +
== Packstückdaten aktualisieren ==
 +
<!--
 +
Text anpassen
 +
<br>
 +
<br>
 +
<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"
 
|-
 
|-
−
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstück der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| nachnahme || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
+
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
|-
 
|-
−
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
+
| [[#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)
 +
|-
 +
| auftragNr || [[#Datentypen|String]] || 20 || - || -
 +
|-
 +
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
|-
 
|-
−
| nnVermerk || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
+
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
−
| nnVerwendung || [[#Datentypen|String]] || 1 || - || 'B' = Bar, 'V' = Verrechnungsscheck
+
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
−
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
+
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 
|-
 
|-
−
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Laufende Nummer pro Sendung
+
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
|-
 
|-
−
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
+
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
 
|-
 
|-
−
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
−
| '''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.
+
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
 
|-
 
|-
−
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
+
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
|-
 
|-
−
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
+
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
 
|-
 
|-
−
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe-Versicherungswert
+
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
 
|-
 
|-
−
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
+
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
 
|-
 
|-
−
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
+
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 
|-
 
|-
−
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
+
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
−
|}
 
−
</div></div>
 
−
<!-- ------------------------------------------------------------------------------- ENDE packstueckDaten ------------------------------------------------------------------------------- -->
 
−
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT spezial Datentypen ------------------------------------------------------------------------------- -->
 
−
<!-- ------------------------------------------------------------------------------- ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
 
−
 
 
−
= Übersicht der Funktionen =
 
−
<!-- ------------------------------------------------------------------------------- echo ------------------------------------------------------------------------------- -->
 
−
== Schnittstelle testen (echo) ==
 
−
Zum Testen der REST-Schnittstelle. Liefert die übergebene Nachricht unverändert zurück.<br><br>
 
−
'''Funktion (GET): /hvs32rest/echo/<Nachricht>'''<br>
 
−
<Nachricht> wird zurück gegeben.
 
−
<!-- ------------------------------------------------------------------------------- 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>
 
−
<br>
 
−
'''Funktion (POST): /hvs32rest/versanddatenAnfrage'''<br>
 
−
'''MediaType: text/plain'''<br>
 
−
<br>
 
−
<!-- ------------------------------------------------------------------------------- Request ------------------------------------------------------------------------------- -->
 
−
<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
+
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 
|-
 
|-
−
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
+
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
|-
 
|-
−
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
+
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
+
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| auftragNr || [[#Datentypen|String]] || 20 || - || -
+
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
+
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
 
|-
 
|-
−
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
|-
 
|-
−
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
+
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
+
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
−
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
+
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 
|-
 
|-
−
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
+
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
+
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
+
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
+
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
+
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
+
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] [[#gefahrgut|<Gefahrgut>]] || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
+
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
 
|-
 
|-
−
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
+
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
 
|-
 
|-
−
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
+
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
|-
 
|-
−
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 
|-
 
|-
−
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
 
|-
 
|-
−
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
 
|-
 
|-
−
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
 
|-
 
|-
−
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
 
|-
 
|-
−
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| 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.
 
|-
 
|-
−
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
 
|-
 
|-
−
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
 
|-
 
|-
−
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
 
|-
 
|-
−
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
 
|-
 
|-
−
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
+
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
 
|-
 
|-
−
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
+
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
|-
 
|-
−
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -
+
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
|-
 
|-
−
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
+
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
|-
 
|-
−
| lieferantenID || [[#Datentypen|Integer]] || - || - || -
+
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
 
|-
 
|-
−
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
+
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
 
|-
 
|-
−
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
+
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
 
|-
 
|-
−
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
+
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
 
|-
 
|-
−
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
+
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
 
|-
 
|-
−
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
+
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
 
|-
 
|-
−
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt
+
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
 
|-
 
|-
−
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
+
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
−
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
+
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
 
|-
 
|-
−
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
 
|-
 
|-
−
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
 
|-
 
|-
−
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
 
|-
 
|-
−
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
 
|-
 
|-
−
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
+
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 
|-
 
|-
−
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
−
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
+
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 
|-
 
|-
−
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
+
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
 
|-
 
|-
−
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
+
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
 
|-
 
|-
−
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
+
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
 
|-
 
|-
−
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
+
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
 
|-
 
|-
−
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
+
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
+
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
+
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| '''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.
+
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
+
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
+
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
 
|-
 
|-
−
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
+
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
 
|-
 
|-
−
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
+
| '''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"
 
|-
 
|-
−
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|-
 
|-
 
|-
−
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
−
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
−
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
−
|-
+
|}
−
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
+
</div></div>
−
|-
+
<br>
−
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
+
<div class="mw-collapsible-content">
−
|-
+
;Request
−
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
+
<source lang="json">
−
|-
+
{
−
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
+
"ansprechpartner": "",
−
|-
+
"artikelDaten": [
−
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
+
{
−
|-
+
"anzahlBuegel": 0,
−
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
+
"anzahlPosEtiketten": 0,
−
|-
+
"artikelBTNNr": "",
−
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
+
"artikelEAN": "",
−
|-
+
"artikelEinheit": "",
−
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
+
"artikelGewicht": 0,
−
|-
+
"artikelGruppe": "",
−
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
+
"artikelMenge": 0,
−
|-
+
"artikelServices": "",
−
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
+
"artikelSollMenge": 0,
−
|-
+
"artikelText1": "",
−
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
+
"artikelText2": "",
−
|-
+
"artikelText3": "",
−
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
+
"artikelText4": "",
−
|-
+
"artikelVolumen": 0,
−
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
+
"artikelWaehrung": "",
−
|-
+
"artikelWert": 0,
−
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
+
"chargeFlag": "",
−
|-
+
"kundenArtikelNr": "",
−
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
+
"kundenBestellNr": "",
−
|-
+
"posAuftragNr": "",
−
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
+
"posLieferNr": "",
−
|-
+
"positionNr": "",
−
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird
+
"serienNr": "",
−
|-
+
"ursprungLand": ""
−
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
+
}
−
|-
+
],
−
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
+
"auftragNr": "",
−
|-
+
"auftraggeberID": "",
−
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
+
"avisHinweis1": "",
−
|-
+
"avisHinweis2": "",
−
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
+
"avisZusatz1": "",
−
|-
+
"avisZusatz2": "",
−
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
+
"bestellNr": "",
−
|-
+
"druckername": "",
−
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"email": "",
−
|-
+
"faxNr": "",
−
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"frachtBrief": "",
−
|-
+
"frachtfuehrerKdNr": "",
−
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"frankaturKennung": "",
−
|-
+
"gefahrgut": [
−
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
{
−
|-
+
"gefahrgutBefoerdKat": 0,
−
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"gefahrgutBegrenzteMenge": "",
−
|-
+
"gefahrgutBezeichnung": "",
−
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
+
"gefahrgutBuchst640": "",
−
|-
+
"gefahrgutFFCode": "",
−
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
+
"gefahrgutFaktor": 0,
−
|-
+
"gefahrgutFreigestMenge": "",
−
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"gefahrgutKCode": "",
−
|}
+
"gefahrgutKlasse": "",
−
</div></div>
+
"gefahrgutMenge": 0,
−
<!-- ------------------------------------------------------------------------------- ENDE Request ------------------------------------------------------------------------------- -->
+
"gefahrgutMengenEinheit": "",
−
<br>
+
"gefahrgutNebenGefahr": "",
−
<!-- ------------------------------------------------------------------------------- Response ------------------------------------------------------------------------------- -->
+
"gefahrgutNettoExplMasse": 0,
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"gefahrgutTunnelBCode": "",
−
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
+
"gefahrgutUNNR": "",
−
<div class="mw-collapsible-content">
+
"gefahrgutUmweltGef": "",
−
{| class="wikitable sortable"
+
"gefahrgutVPG": "",
−
|-
+
"gefahrgutVerpAnzahl": 0,
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|
+
"gefahrgutVerpackungsart": ""
−
|-
+
}
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
],
−
|-
+
"gewicht": 0,
−
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
"ilnNr": "",
−
|-
+
"infotext1": "",
−
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
"infotext2": "",
−
|-
+
"infotext3": "",
−
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
"infotext4": "",
−
|-
+
"infotext5": "",
−
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
"infotext6": "",
−
|-
+
"infotext7": "",
−
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
+
"infotext8": "",
−
|-
+
"infotext9": "",
−
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
+
"infotext10": "",
−
|-
+
"kostenstelle": "",
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
+
"kundenNr": "",
−
|-
+
"lieferscheinNr": "",
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
"nachnahme": 0,
−
|-
+
"nettoGewicht": 0,
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
"neutabsenderLKZ": "",
−
|-
+
"neutabsenderName1": "",
−
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
+
"neutabsenderName2": "",
−
|-
+
"neutabsenderName3": "",
−
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
+
"neutabsenderOrt": "",
−
|-
+
"neutabsenderPLZ": "",
−
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
+
"neutabsenderStrasse": "",
−
|-
+
"nnVermerk": "",
−
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
+
"nnVerwendung": "",
−
|-
+
"nnWaehrung": "",
−
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
+
"packStkGes": 0,
−
|-
+
"packStkNr": 0,
−
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
+
"packplatz": "",
−
|-
+
"packstueckBreite": 0,
−
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
+
"packstueckHoehe": 0,
−
|-
+
"packstueckID": "",
−
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
+
"packstueckLaenge": 0,
−
|-
+
"paperlessInvoice": "",
−
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"postLeitcode": "",
−
|-
+
"postZielFrachtzent": "",
−
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"rechnungsEmpfLKZ": "",
−
|-
+
"rechnungsEmpfName1": "",
−
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"rechnungsEmpfName2": "",
−
|-
+
"rechnungsEmpfName3": "",
−
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"rechnungsEmpfOrt": "",
−
|-
+
"rechnungsEmpfPLZ": "",
−
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"rechnungsEmpfStrasse": "",
−
|-
+
"sendungsinhalt": "",
−
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"sonderdienste": "",
−
|-
+
"telefonNr": "",
−
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"terminArt": "",
−
|-
+
"terminDatum": "",
−
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"terminZeit": "",
−
|-
+
"ustIDNr": "",
−
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"verpackungsart": "",
−
|-
+
"versandartID": "",
−
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
"versicherungswert": 0,
−
|}
+
"vwWaehrung": "",
−
</div></div>
+
"warenwert": 0,
−
<!-- ------------------------------------------------------------------------------- ENDE Response ------------------------------------------------------------------------------- -->
+
"wwWaehrung": "",
−
<br>
+
"zahlungsbedingung": "",
−
<!-- ------------------------------------------------------------------------------- Beispiel ------------------------------------------------------------------------------- -->
+
"zbZoll": "",
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"zielAdrBahnhof": "",
−
<div style="font-weight:bold;line-height:1.6;">Beispiele</div>
+
"zielAdrLKZ": "",
−
<div class="mw-collapsible-content">
+
"zielAdrName1": "",
−
;Request
+
"zielAdrName2": "",
 +
"zielAdrName3": "",
 +
"zielAdrOrt": "",
 +
"zielAdrPLZ": "",
 +
"zielAdrRegion": "",
 +
"zielAdrStrasse": ""
 +
}
 +
</source>
 +
;Response
 
<source lang="json">
 
<source lang="json">
 
{
 
{
−
"ansprechpartner": "",
+
"druckDateTime": "",
−
"assoc": {
+
"fehlertext1": "",
−
"":""
+
"fehlertext2": ""
−
},
+
}
−
"artikelDaten": [
+
</source>
−
{
+
</div></div>
−
"anzahlBuegel": 0,
+
<!-- ------------------------------------------------------------------------------- ENDE versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
−
"anzahlPosEtiketten": 0,
+
<!-- ------------------------------------------------------------------------------- updateVersanddaten ------------------------------------------------------------------------------- -->
−
"artikelBTNNr": "",
+
 
−
"artikelEAN": "",
+
== Packstückdaten aktualisieren ==
−
"artikelEinheit": "",
+
<!--
−
"artikelGewicht": 0,
+
Text anpassen
−
"artikelGruppe": "",
+
<br>
−
"artikelMenge": 0,
+
<br>
−
"artikelServices": "",
+
<br>
−
"artikelSollMenge": 0,
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
"artikelText1": "",
+
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
−
"artikelText2": "",
+
<div class="mw-collapsible-content">
−
"artikelText3": "",
+
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
−
"artikelText4": "",
+
{| class="wikitable sortable"
−
"artikelVolumen": 0,
+
|-
−
"artikelWaehrung": "",
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
−
"artikelWert": 0,
+
|-
−
"chargeFlag": "",
+
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
−
"kundenArtikelNr": "",
+
|-
−
"kundenBestellNr": "",
+
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
−
"posAuftragNr": "",
+
|-
−
"posLieferNr": "",
+
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
−
"positionNr": "",
+
|-
−
"serienNr": "",
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
−
"ursprungLand": ""
+
|-
−
}
+
| auftragNr || [[#Datentypen|String]] || 20 || - || -
−
],
+
|-
−
"auftragNr": "",
+
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
−
"auftraggeberID": "",
+
|-
−
"avisHinweis1": "",
+
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
−
"avisHinweis2": "",
+
|-
−
"avisZusatz1": "",
+
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
−
"avisZusatz2": "",
+
|-
−
"bestellNr": "",
+
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
−
"druckername": "",
+
|-
−
"email": "",
+
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
−
"faxNr": "",
+
|-
−
"frachtBrief": "",
+
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
−
"frachtfuehrerKdNr": "",
+
|-
−
"frankaturKennung": "",
+
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
−
"gefahrgut": [
+
|-
−
{
+
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
−
"gefahrgutBefoerdKat": 0,
+
|-
−
"gefahrgutBegrenzteMenge": "",
+
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
−
"gefahrgutBezeichnung": "",
+
|-
−
"gefahrgutBuchst640": "",
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
−
"gefahrgutFFCode": "",
+
|-
−
"gefahrgutFaktor": 0,
+
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
−
"gefahrgutFreigestMenge": "",
+
|-
−
"gefahrgutKCode": "",
+
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
−
"gefahrgutKlasse": "",
+
|-
−
"gefahrgutMenge": 0,
+
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
−
"gefahrgutMengenEinheit": "",
+
|-
−
"gefahrgutNebenGefahr": "",
+
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
−
"gefahrgutNettoExplMasse": 0,
+
|-
−
"gefahrgutTunnelBCode": "",
+
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
−
"gefahrgutUNNR": "",
+
|-
−
"gefahrgutUmweltGef": "",
+
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
−
"gefahrgutVPG": "",
+
|-
−
"gefahrgutVerpAnzahl": 0,
+
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
−
"gefahrgutVerpackungsart": ""
+
|-
−
}
+
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
−
],
+
|-
−
"gewicht": 0,
+
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
−
"ilnNr": "",
+
|-
−
"infotext1": "",
+
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
−
"infotext2": "",
+
|-
−
"infotext3": "",
+
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
−
"infotext4": "",
+
|-
−
"infotext5": "",
+
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"infotext6": "",
+
|-
−
"infotext7": "",
+
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"infotext8": "",
+
|-
−
"infotext9": "",
+
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"infotext10": "",
+
|-
−
"kostenstelle": "",
+
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"kundenNr": "",
+
|-
−
"lieferscheinNr": "",
+
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"nachnahme": 0,
+
|-
−
"nettoGewicht": 0,
+
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"neutabsenderLKZ": "",
+
|-
−
"neutabsenderName1": "",
+
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"neutabsenderName2": "",
+
|-
−
"neutabsenderName3": "",
+
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"neutabsenderOrt": "",
+
|-
−
"neutabsenderPLZ": "",
+
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"neutabsenderStrasse": "",
+
|-
−
"nnVermerk": "",
+
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
−
"nnVerwendung": "",
+
|-
−
"nnWaehrung": "",
+
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
−
"packStkGes": 0,
+
|-
−
"packStkNr": 0,
+
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
−
"packplatz": "",
+
|-
−
"packstueckBreite": 0,
+
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -
−
"packstueckHoehe": 0,
+
|-
−
"packstueckID": "",
+
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
−
"packstueckLaenge": 0,
+
|-
−
"paperlessInvoice": "",
+
| lieferantenID || [[#Datentypen|Integer]] || - || - || -
−
"postLeitcode": "",
+
|-
−
"postZielFrachtzent": "",
+
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
−
"rechnungsEmpfLKZ": "",
+
|-
−
"rechnungsEmpfName1": "",
+
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
−
"rechnungsEmpfName2": "",
+
|-
−
"rechnungsEmpfName3": "",
+
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
−
"rechnungsEmpfOrt": "",
+
|-
−
"rechnungsEmpfPLZ": "",
+
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
−
"rechnungsEmpfStrasse": "",
+
|-
−
"sendungsinhalt": "",
+
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
−
"sonderdienste": "",
+
|-
−
"telefonNr": "",
+
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt
−
"terminArt": "",
+
|-
−
"terminDatum": "",
+
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
−
"terminZeit": "",
+
|-
−
"ustIDNr": "",
+
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
−
"verpackungsart": "",
+
|-
−
"versandartID": "",
+
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
−
"versicherungswert": 0,
+
|-
−
"vwWaehrung": "",
+
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
−
"warenwert": 0,
+
|-
−
"wwWaehrung": "",
+
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
−
"zahlungsbedingung": "",
+
|-
−
"zbZoll": "",
+
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
−
"zielAdrBahnhof": "",
+
|-
−
"zielAdrLKZ": "",
+
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
−
"zielAdrName1": "",
+
|-
−
"zielAdrName2": "",
+
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
−
"zielAdrName3": "",
+
|-
−
"zielAdrOrt": "",
+
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
−
"zielAdrPLZ": "",
+
|-
−
"zielAdrRegion": "",
+
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
−
"zielAdrStrasse": ""
+
|-
−
}
+
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
−
</source>
+
|-
−
;Response
+
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
−
<source lang="json">
+
|-
−
{
+
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
−
"assoc": {
+
|-
−
"":""
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
−
},
+
|-
−
"packstueckID": "",
+
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
−
"trackingNr": "",
+
|-
−
"retourTrackingNr": "",
+
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
−
"versandSendungsNr": "",
+
|-
−
"druckDateTime": "",
+
| '''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.
−
"ausgangDateTime": "",
+
|-
−
"gebuehr": 0,
+
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
−
"gebuehrWaehrung": "",
+
|-
−
"fehlertext1": "",
+
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
−
"fehlertext2": "",
+
|-
−
"etikettName": "",
+
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
−
"etikettDaten": "",
+
|-
−
"zusatzEtikettenDaten": {
+
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
−
"": ""
+
|-
−
},
+
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
−
"trackingURL": "",
+
|-
−
"zusatzfeld1": "",
+
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
−
"zusatzfeld2": "",
+
|-
−
"zusatzfeld3": "",
+
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
−
"zusatzfeld4": "",
+
|-
−
"zusatzfeld5": "",
+
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
−
"zusatzfeld6": "",
+
|-
−
"zusatzfeld7": "",
+
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
−
"zusatzfeld8": "",
+
|-
−
"zusatzfeld9": "",
+
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
−
"zusatzfeld10": ""
+
|-
−
}
+
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
−
</source>
+
|-
−
</div></div>
+
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
−
<!-- ------------------------------------------------------------------------------- ENDE Beispiel ------------------------------------------------------------------------------- -->
+
|-
−
<!-- ------------------------------------------------------------------------------- ENDE versanddatenAnfrage ------------------------------------------------------------------------------- -->
+
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
−
<!-- ------------------------------------------------------------------------------- versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- -->
+
|-
−
 
+
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
−
== 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.
+
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
−
<br>
+
|-
−
<br>
+
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
−
'''Funktion (POST): /hvs32rest/versanddatenNachdruckAnfrage'''<br>
 
−
'''MediaType: text/plain'''<br>
 
−
<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
+
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird.
+
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
−
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
+
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
 
|-
 
|-
−
| '''packstueckID''' || [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
+
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
 
|-
 
|-
−
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer
+
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
−
|}
 
−
</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|
+
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
 
|-
 
|-
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
 
|-
 
|-
−
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
−
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 
|-
 
|-
−
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
−
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird
 
|-
 
|-
−
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
+
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 
|-
 
|-
−
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
+
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
 
|-
 
|-
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
+
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
 
|-
 
|-
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
 
|-
 
|-
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
 
|-
 
|-
−
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
+
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
+
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
+
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
+
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
+
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
+
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
 
|-
 
|-
−
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
+
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
 
|-
 
|-
−
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
+
| '''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"
 
|-
 
|-
−
| zusatzfeld1 || [[#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|
 
|-
 
|-
−
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 
|-
 
|-
−
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 
|-
 
|-
−
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
−
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 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
 
|-
 
|-
−
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
 
|-
 
|-
−
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
 
|-
 
|-
−
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
 
|-
 
|-
−
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
−
|}
+
|-
−
</div></div>
+
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
−
<br>
+
|-
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
−
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
|-
−
<div class="mw-collapsible-content">
+
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
−
;Request
+
|-
−
<source lang="json">
+
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
{
+
|-
−
"druckername": "",
+
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
"packplatz": "",
+
|-
−
"packstueckID": "",
+
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
"trackingNr": ""
+
|-
−
}
+
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
</source>
+
|-
−
;Response
+
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
<source lang="json">
+
|-
−
{
+
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
"assoc": {
+
|-
−
"":""
+
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
},
+
|-
−
"packstueckID": "",
+
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
"trackingNr": "",
+
|-
−
"retourTrackingNr": "",
+
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
"versandSendungsNr": "",
+
|-
−
"druckDateTime": "",
+
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
"ausgangDateTime": "",
+
|}
−
"gebuehr": 0,
+
</div></div>
−
"gebuehrWaehrung": "",
+
<br>
−
"fehlertext1": "",
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
"fehlertext2": "",
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
"etikettName": "",
 
−
"etikettDaten": "",
 
−
"zusatzEtikettenDaten": {
 
−
"": ""
 
−
},
 
−
"trackingURL": "",
 
−
"zusatzfeld1": "",
 
−
"zusatzfeld2": "",
 
−
"zusatzfeld3": "",
 
−
"zusatzfeld4": "",
 
−
"zusatzfeld5": "",
 
−
"zusatzfeld6": "",
 
−
"zusatzfeld7": "",
 
−
"zusatzfeld8": "",
 
−
"zusatzfeld9": "",
 
−
"zusatzfeld10": ""
 
−
}
 
−
</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>
 
−
<br>
 
−
'''Funktion (POST): /hvs32rest/stornoVersanddaten'''<br>
 
−
'''MediaType: text/plain'''<br>
 
−
<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">
 
<div class="mw-collapsible-content">
−
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
+
;Request
−
{| class="wikitable sortable"
+
<source lang="json">
−
|-
+
{
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
"ansprechpartner": "",
−
|-
+
"anzahlArtikel": 0,
−
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
+
"artikelDaten": [
−
|-
+
{
−
| '''packstueckID'''|| [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
+
"anzahlBuegel": 0,
−
|-
+
"anzahlPosEtiketten": 0,
−
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer
+
"artikelBTNNr": "",
−
|}
+
"artikelEAN": "",
−
</div></div>
+
"artikelEinheit": "",
−
<br>
+
"artikelGewicht": 0,
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"artikelGruppe": "",
−
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
+
"artikelMenge": 0,
−
<div class="mw-collapsible-content">
+
"artikelServices": "",
−
{| class="wikitable sortable"
+
"artikelSollMenge": 0,
−
|-
+
"artikelText1": "",
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
"artikelText2": "",
−
|-
+
"artikelText3": "",
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
"artikelText4": "",
−
|-
+
"artikelVolumen": 0,
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
"artikelWaehrung": "",
−
|-
+
"artikelWert": 0,
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
+
"chargeFlag": "",
−
|}
+
"kundenArtikelNr": "",
−
</div></div>
+
"kundenBestellNr": "",
−
<br>
+
"posAuftragNr": "",
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"posLieferNr": "",
−
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
"positionNr": "",
−
<div class="mw-collapsible-content">
+
"serienNr": "",
−
;Request
+
"ursprungLand": ""
−
<source lang="json">
+
}
−
{
+
],
−
"packplatz": "",
+
"auftragNr": "",
−
"packstueckID": "",
+
"auftraggeberID": "",
−
"trackingNr": ""
+
"avisHinweis1": "",
−
}
+
"avisHinweis2": "",
−
</source>
+
"avisZusatz1": "",
−
;Response
+
"avisZusatz2": "",
−
<source lang="json">
+
"barcodeID": "",
−
{
+
"barcodeText": "",
−
"fehlercode": 0,
+
"barcodeTyp": "",
−
"fehlertext1": "",
+
"bestellNr": "",
−
"fehlertext2": ""
+
"druckername": "",
−
}
+
"email": "",
−
</source>
+
"empfMobilfunkNr": "",
−
</div></div>
+
"faxNr": "",
−
<!-- ------------------------------------------------------------------------------- ENDE stornoversanddaten ------------------------------------------------------------------------------- -->
+
"flexZustellungEmailadResponsese": "",
−
<!-- ------------------------------------------------------------------------------- verladeVersandaten ------------------------------------------------------------------------------- -->
+
"frachtBrief": "",
−
== Packstück verladen / freigeben (verladeVersanddaten) ==
+
"frachtfuehrerKdNr": "",
−
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.
+
"frankaturKennung": "",
−
<br>
+
"gefahrgut": [
−
<br>
+
{
−
'''Funktion (POST): /hvs32rest/verladeVersanddaten'''<br>
+
"gefahrgutBefoerdKat": 0,
−
'''MediaType: text/plain'''<br>
+
"gefahrgutBegrenzteMenge": "",
−
<br>
+
"gefahrgutBezeichnung": "",
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"gefahrgutBuchst640": "",
−
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
+
"gefahrgutFFCode": "",
−
<div class="mw-collapsible-content">
+
"gefahrgutFaktor": 0,
−
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
+
"gefahrgutFreigestMenge": "",
−
{| class="wikitable sortable"
+
"gefahrgutKCode": "",
−
|-
+
"gefahrgutKlasse": "",
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
"gefahrgutMenge": 0,
−
|-
+
"gefahrgutMengenEinheit": "",
−
| hostFreigabeNr || [[#Datentypen|String]] || 20 || - || Hostseitige Freigabenummer die für dieses Packstück gesetzt wird.
+
"gefahrgutNebenGefahr": "",
−
|-
+
"gefahrgutNettoExplMasse": 0,
−
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
+
"gefahrgutTunnelBCode": "",
−
|-
+
"gefahrgutUNNR": "",
−
| '''packstueckID''' || [[#Datentypen|String]] || 20 || - || Eindeutige Nummer für das Paket im Vorsystem. <br>
+
"gefahrgutUmweltGef": "",
−
Beim Etikettendruck zuvor muss die gleiche ID übergeben worden sein, damit das HVS32 das zu verladene Packstück eindeutig identifizieren kann.
+
"gefahrgutVPG": "",
−
|-
+
"gefahrgutVerpAnzahl": 0,
−
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird.
+
"gefahrgutVerpackungsart": ""
−
|}
+
}
−
</div></div>
+
],
−
<br>
+
"gewicht": 0,
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"hostTrackingNr": "",
−
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
+
"ilnNr": "",
−
<div class="mw-collapsible-content">
+
"infotext1": "",
−
{| class="wikitable sortable"
+
"infotext2": "",
−
|-
+
"infotext3": "",
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
"infotext4": "",
−
|-
+
"infotext5": "",
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
"infotext6": "",
−
|-
+
"infotext7": "",
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
"infotext8": "",
−
|-
+
"infotext9": "",
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
"infotext10": "",
−
|}
+
"kostenstelle": "",
−
</div></div>
+
"kundenNr": "",
−
<br>
+
"lagerkennzeichen": 0,
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"letztesPackstueck": "",
−
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
"lieferantenID": 0,
−
<div class="mw-collapsible-content">
+
"lieferscheinNr": "",
−
;Request
+
"nachnahme": 0,
−
<source lang="json">
+
"nettoGewicht": 0,
−
{
+
"neutBIC": "",
−
"hostFreigabeNr": "",
+
"neutBankBezeichnung": "",
 +
"neutIBAN": "",
 +
"neutKontoInhaber": "",
 +
"neutabsenderLKZ": "",
 +
"neutabsenderName1": "",
 +
"neutabsenderName2": "",
 +
"neutabsenderName3": "",
 +
"neutabsenderOrt": "",
 +
"neutabsenderPLZ": "",
 +
"neutabsenderStrasse": "",
 +
"nnVermerk": "",
 +
"nnVerwendung": "",
 +
"nnWaehrung": "",
 +
"packStkGes": 0,
 +
"packStkNr": 0,
 
"packplatz": "",
 
"packplatz": "",
 +
"packstueckBreite": 0,
 +
"packstueckHoehe": 0,
 
"packstueckID": "",
 
"packstueckID": "",
−
"wechselbruecke": ""
+
"packstueckLaenge": 0,
−
}
+
"paperlessInvoice": "",
−
</source>
+
"postLeitcode": "",
−
;Response
+
"postZielFrachtzent": "",
−
<source lang="json">
+
"rechnungsEmpfLKZ": "",
−
{
+
"rechnungsEmpfName1": "",
−
"fehlercode": 0,
+
"rechnungsEmpfName2": "",
−
"fehlertext1": "",
+
"rechnungsEmpfName3": "",
−
"fehlertext2": ""
+
"rechnungsEmpfOrt": "",
−
}
+
"rechnungsEmpfPLZ": "",
−
</source>
+
"rechnungsEmpfStrasse": "",
−
</div></div>
+
"rechnungsNr": "",
−
<!-- ------------------------------------------------------------------------------- ENDE verladeVersandaten ------------------------------------------------------------------------------- -->
+
"sendungsinhalt": "",
−
<!-- ------------------------------------------------------------------------------- sperreVersanddaten ------------------------------------------------------------------------------- -->
+
"sonderdienste": "",
−
 
+
"sperrFlag": "",
−
== Packstück sperren (sperreVersanddaten) ==
+
"telefonNr": "",
−
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.
+
"terminArt": "",
−
<br>
+
"terminDatum": "",
−
<br>
+
"terminZeit": "",
−
'''Funktion (POST): /hvs32rest/sperreVersanddaten'''<br>
+
"ustIDNr": "",
−
'''MediaType: text/plain'''<br>
+
"verpackungsart": "",
−
<br>
+
"versandartID": "",
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"versicherungswert": 0,
−
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
+
"vorpackdatum": "",
−
<div class="mw-collapsible-content">
+
"vwWaehrung": "",
−
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
+
"warenwert": 0,
−
{| class="wikitable sortable"
+
"wechselbruecke": "",
−
|-
+
"wwWaehrung": "",
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
"zahlungsbedingung": "",
−
|-
+
"zbZoll": "",
−
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
+
"zielAdrBahnhof": "",
−
|-
+
"zielAdrLKZ": "",
−
| '''packstueckID'''|| [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
+
"zielAdrName1": "",
−
|}
+
"zielAdrName2": "",
−
</div></div>
+
"zielAdrName3": "",
−
<br>
+
"zielAdrName4": "",
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"zielAdrOrt": "",
−
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
+
"zielAdrPLZ": "",
−
<div class="mw-collapsible-content">
+
"zielAdrRegion": "",
−
{| class="wikitable sortable"
+
"zielAdrStrasse": ""
−
|-
 
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
−
|-
 
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
−
|-
 
−
| 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">
 
−
;Request
 
−
<source lang="json">
 
−
{
 
−
"packplatz": "",
 
−
"packstueckID": ""
 
 
}
 
}
 
</source>
 
</source>
Zeile 1.060: Zeile 1.082:
 
<source lang="json">
 
<source lang="json">
 
{
 
{
−
"fehlercode": 0,
+
"packstueckID": "",
 +
"trackingNr": "",
 +
"retourTrackingNr": "",
 +
"versandSendungsNr": "",
 +
"druckDateTime": "",
 +
"ausgangDateTime": "",
 +
"gebuehrWaehrung": "",
 +
"fehlercode": 0,
 
"fehlertext1": "",
 
"fehlertext1": "",
−
"fehlertext2": ""
+
"fehlertext2": "",
 +
"etikettName": "",
 +
"etikettDaten": "",
 +
"trackingURL": "",
 +
"zusatzfeld1": "",
 +
"zusatzfeld2": "",
 +
"zusatzfeld3": "",
 +
"zusatzfeld4": "",
 +
"zusatzfeld5": "",
 +
"zusatzfeld6": "",
 +
"zusatzfeld7": "",
 +
"zusatzfeld8": "",
 +
"zusatzfeld9": "",
 +
"zusatzfeld10": ""
 
}
 
}
 
</source>
 
</source>
 
</div></div>
 
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE sperreversanddaten ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- ENDE updateVersanddaten ------------------------------------------------------------------------------- -->
−
<!-- ------------------------------------------------------------------------------- tagesabschluss ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- anonymisiereVersandDaten ------------------------------------------------------------------------------- -->
  
−
== Tagesabschluss (tagesabschluss) ==
+
== Packstückdaten anonymisieren ==
−
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.
+
<!--
 +
Text anpassen
 
<br>
 
<br>
 
<br>
 
<br>
−
'''Funktion (POST): /hvs32rest/tagesabschluss'''<br>
 
−
'''MediaType: text/plain'''<br>
 
 
<br>
 
<br>
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
Zeile 1.082: Zeile 1.123:
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung
 
|-
 
|-
−
| auftraggeberID || [[#Datentypen|Sequence<String>]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
+
| auftragsNr || [[#Datentypen|String]] || 20 || - || -
−
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.
 
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
+
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.
−
(Benötigt Druckerspooler Erweiterungsmodul)
 
 
|-
 
|-
−
| frachtfuehrerTyp || [[#Datentypen|Sequence<String>]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
−
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.
+
| packstueckID || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
 
|-
 
|-
−
| versandartID || [[#Datentypen|Sequence<String>]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.
+
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
−
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.
 
 
|}
 
|}
 
</div></div>
 
</div></div>
Zeile 1.109: Zeile 1.142:
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung
 
|-
 
|-
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
−
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] '''[[#Sequence|<EDIStatus>]]''' || - || - || -
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
−
|-
 
−
| 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>
 
</div></div>
Zeile 1.133: Zeile 1.156:
 
<source lang="json">
 
<source lang="json">
 
{
 
{
−
"auftraggeberID": [
+
"auftragNr": "",
−
""
+
"lieferscheinNr": "",
−
],
+
"packplatz": "",
−
"druckername": "",
+
"packstueckID": "",
−
"frachtfuehrerTyp": [
+
"trackingNr": ""
−
""
 
−
],
 
−
"packplatz": "",
 
−
"versandartID": [
 
−
""
 
−
],
 
−
"wechselbruecke": ""
 
 
}
 
}
 
</source>
 
</source>
Zeile 1.150: Zeile 1.166:
 
<source lang="json">
 
<source lang="json">
 
{
 
{
−
"assoc": {
 
−
"":""
 
−
},
 
−
"fehlercode": 0,
 
 
"fehlertext1": "",
 
"fehlertext1": "",
−
"edistatus": [
+
"fehlertext2": ""
−
{
 
−
"fehlercode": 0,
 
−
"statuscode": "",
 
−
"statustext": "",
 
−
"fftyp": "",
 
−
"dateityp": "",
 
−
"auftraggeber": "",
 
−
"ffdateinr": ""
 
−
}
 
−
],
 
−
"listenDaten": {}
 
 
}
 
}
 
</source>
 
</source>
 
</div></div>
 
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE tagesabschluss ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- ENDE anonymisiereVersandDaten ------------------------------------------------------------------------------- -->
−
<!-- ------------------------------------------------------------------------------- listenabschlussAnfrage ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
  
−
== Ausgangsliste erzeugen (listenabschlussAnfrage) ==
+
== Sendungs-Verarbeitung ==
−
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.
+
<!--
 +
Text anpassen
 
<br>
 
<br>
 
<br>
 
<br>
−
'''Funktion (POST): /hvs32rest/listenabschlussAnfrage'''<br>
 
−
'''MediaType: text/plain'''<br>
 
 
<br>
 
<br>
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
Zeile 1.188: Zeile 1.188:
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| auftraggeberID || [[#Datentypen|String]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
+
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
−
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.
 
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
−
(Benötigt Druckerspooler Erweiterungsmodul)
 
 
|-
 
|-
−
| frachtfuehrerTyp || [[#Datentypen|String]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".
+
| auftragNr || [[#Datentypen|String]] || 20 || - || -
−
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.
+
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
|-
 
|-
−
| versandartID || [[#Datentypen|String]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.
+
| ausschlussFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Ausschluss-Frachtführer für SPM Anfrage
−
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.
+
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
−
|}
 
−
</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
+
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 
|-
 
|-
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
|-
 
|-
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| bestellNr || [[#Datentypen|String]] || 20 || - || -
 
|-
 
|-
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
+
| email || [[#Datentypen|String]] || 100 || - || Für automatische Mailavisierung
 
|-
 
|-
−
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
+
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
 +
|-
 +
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 +
|-
 +
| flexZustellungEmailadResponsese || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Email-Adresse
 +
|-
 +
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer, falls Frachtbrief durch Vorsystem gedruckt wird.
 +
|-
 +
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer.
 +
|-
 +
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 +
|-
 +
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 +
|-
 +
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
 +
|-
 +
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
|-
 
|-
−
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.
 
−
|}
 
−
</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">
 
−
;Request
 
−
<source lang="json">
 
−
{
 
−
"auftraggeberID": [
 
−
""
 
−
],
 
−
"druckername": "",
 
−
"frachtfuehrerTyp": [
 
−
""
 
−
],
 
−
"packplatz": "",
 
−
"versandartID": [
 
−
""
 
−
],
 
−
"wechselbruecke": ""
 
−
}
 
−
</source>
 
−
;Response
 
−
<source lang="json">
 
−
{
 
−
"assoc": {
 
−
"":""
 
−
},
 
−
"fehlercode": 0,
 
−
"fehlertext1": "",
 
−
"listenDaten": {
 
−
"": ""
 
−
}
 
−
}
 
−
</source>
 
−
</div></div>
 
−
<!-- ------------------------------------------------------------------------------- ENDE Listenabschluss ------------------------------------------------------------------------------- -->
 
−
<!-- ------------------------------------------------------------------------------- ediabschlussAnfrage ------------------------------------------------------------------------------- -->
 
  
−
== 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.
 
−
<br>
 
−
<br>
 
−
'''Funktion (POST): /hvs32rest/ediabschlussAnfrage'''<br>
 
−
'''MediaType: text/plain'''<br>
 
−
<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
+
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.
 +
|-
 +
| 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
 
|-
 
|-
−
| auftraggeberID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
+
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
−
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.
 
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den z.B. die UPS Summary gedruckt wird.<br>
+
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
−
(Benötigt Druckerspooler Erweiterungsmodul)
 
 
|-
 
|-
−
| frachtfuehrerTyp || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".<br>
+
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
−
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.
+
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
−
| versandartID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.<br>
+
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
−
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.
+
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
−
|}
+
|-
−
</div></div>
+
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
−
<br>
+
|-
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
−
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
+
|-
−
<div class="mw-collapsible-content">
+
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
−
{| class="wikitable sortable"
+
|-
 +
| [[#packstueckDaten|packstueckDaten]] || [[#Datentypen|Sequence]] [[#packstueckDaten|<PackStueckDaten>]] || - || - || -
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
 
|-
 
|-
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
 
|-
 
|-
−
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] [[#edistatus|<EDIStatus>]] || - || - || Liste mit Statusinformationen für EDIs.
+
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
 
|-
 
|-
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
 
|-
 
|-
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
 
|-
 
|-
−
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der EDI-Listen (z.B. UPS Summary) als Key/Value Map.
+
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
−
|}
+
|-
−
</div></div>
+
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
−
<br>
+
|-
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
−
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
|-
−
<div class="mw-collapsible-content">
+
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
−
;Request
+
|-
−
<source lang="json">
+
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
−
{
+
|-
−
"auftraggeberID": [
+
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
−
""
+
|-
−
],
+
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
−
"druckername": "",
+
|-
−
"frachtfuehrerTyp": [
+
| requestSPM || [[#Datentypen|String]] || 5 || - || T/TRUE wenn die Entscheidungsmatrix angesprochen werden soll, sonst leer
−
""
+
|-
−
],
+
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
−
"packplatz": "",
+
|-
−
"versandartID": [
+
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
−
""
+
|-
−
],
+
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
−
"wechselbruecke": ""
+
|-
−
}
+
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
−
</source>
+
|-
−
;Response
+
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
−
<source lang="json">
+
|-
−
{
+
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
−
"assoc": {
+
|-
−
"":""
+
| terminZeit || [[#Datentypen|String]] || 5 || - || HH:MM
−
},
+
|-
−
"fehlercode": 0,
+
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
−
"fehlertext1": "",
+
|-
−
"edistatus": [
+
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
−
{
 
−
"fehlercode": 0,
 
−
"statuscode": "",
 
−
"statustext": "",
 
−
"fftyp": "",
 
−
"dateityp": "",
 
−
"auftraggeber": "",
 
−
"ffdateinr": ""
 
−
}
 
−
],
 
−
"listenDaten": {}
 
−
}
 
−
</source>
 
−
</div></div>
 
−
<!-- ------------------------------------------------------------------------------- ENDE ediabschlussAnfrage ------------------------------------------------------------------------------- -->
 
−
<!-- ------------------------------------------------------------------------------- versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
 
−
 
 
−
== Packstückdaten aktualisieren (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>
 
−
<br>
 
−
'''Funktion (POST): /hvs32rest/versanddatenPruefAnfrage'''<br>
 
−
'''MediaType: text/plain'''<br>
 
−
<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
+
| vorgabeFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Vorgabe-Frachtführer für [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] Anfrage
 
|-
 
|-
−
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
+
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
−
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
+
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen werden soll
 
|-
 
|-
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
 
|-
 
|-
−
| auftragNr || [[#Datentypen|String]] || 20 || - || -
+
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
 
|-
 
|-
−
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
+
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort des Bahnhofs
 
|-
 
|-
−
| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Länderkennzeichen (LKZ)
 
|-
 
|-
−
| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
+
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
+
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
|-
 
|-
−
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
+
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
 
|-
 
|-
−
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
+
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
 
|-
 
|-
−
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
+
| '''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"
 
|-
 
|-
−
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
+
| fehler || [[#Datentypen|String]] || - || - || Wird im Fehlerfall befüllt
 
|-
 
|-
−
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
+
| sendungsGebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachkosten
 
|-
 
|-
−
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
+
| sendungsGebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
 
|-
 
|-
−
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+
| versandSendungsNr || [[#Datentypen|String]] || 20 || - || Sendungsnummer
 +
|}
 +
 
 +
;Packstückdaten
 +
{| class="wikitable sortable"
 
|-
 
|-
−
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|
 
|-
 
|-
−
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 
|-
 
|-
−
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 
|-
 
|-
−
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
−
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
−
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
 
|-
 
|-
−
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
 
|-
 
|-
−
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
 
|-
 
|-
−
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
−
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
−
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
+
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
 
|-
 
|-
−
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
+
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
 
|-
 
|-
−
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
+
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
 
|-
 
|-
−
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
+
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
 
|-
 
|-
−
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
+
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
 
|-
 
|-
−
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
+
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
 
|-
 
|-
−
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
 
|-
 
|-
−
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
+
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| nnVermerk || [[#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
 
|-
 
|-
−
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
+
| zusatzfeld7 || [[#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
+
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
+
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
−
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
+
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
−
|-
+
|}
−
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
+
</div></div>
−
|-
+
<br>
−
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
−
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
+
<div class="mw-collapsible-content">
−
|-
+
;Request
−
| 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.
+
<source lang="json">
−
|-
+
{
−
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
+
"ansprechpartner": "",
−
|-
+
"assoc": {
−
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
+
"":""
−
|-
+
},
−
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
+
"auftragNr": "",
−
|-
+
"auftraggeberID": "",
−
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
+
"ausschlussFrachtfuehrer": "",
−
|-
+
"avisHinweis1": "",
−
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
+
"avisHinweis2": "",
−
|-
+
"avisZusatz1": "",
−
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"avisZusatz2": "",
−
|-
+
"bestellNr": "",
−
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"email": "",
−
|-
+
"empfMobilfunkNr": "",
−
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"faxNr": "",
−
|-
+
"flexZustellungEmailadResponsese": "",
−
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
"frachtBrief": "",
−
|-
+
"frachtfuehrerKdNr": "",
−
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
+
"frankaturKennung": "",
−
|-
+
"ilnNr": "",
−
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
"kostenstelle": "",
−
|-
+
"kundenNr": "",
−
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
+
"Lagerkennzeichen": 0,
−
|-
+
"LieferantenID": 0,
−
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
+
"lieferscheinNr": "",
−
|-
+
"neutBIC": "",
−
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
+
"neutBankBezeichnung": "",
−
|-
+
"neutIBAN": "",
−
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
+
"neutKontoInhaber": "",
−
|-
+
"neutabsenderLKZ": "",
−
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
+
"neutabsenderName1": "",
−
|-
+
"neutabsenderName2": "",
−
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
+
"neutabsenderName3": "",
−
|-
+
"neutabsenderOrt": "",
−
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
+
"neutabsenderPLZ": "",
−
|-
+
"neutabsenderStrasse": "",
−
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
+
"packStkGes": 0,
−
|-
+
"packStueckDaten": [
−
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
+
{
−
|-
+
"anzahlArtikel": 0,
−
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
+
"assoc": {
−
|-
+
"":""
−
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
+
},
−
|-
+
"artikelDaten": [
−
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
+
{
−
|-
+
"anzahlBuegel": 0,
−
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
+
"anzahlPosEtiketten": 0,
−
|-
+
"artikelBTNNr": "",
−
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
+
"artikelEAN": "",
−
|-
+
"artikelEinheit": "",
−
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
+
"artikelGewicht": 0,
−
|-
+
"artikelGruppe": "",
−
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
+
"artikelMenge": 0,
−
|-
+
"artikelServices": "",
−
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
+
"artikelSollMenge": 0,
−
|-
+
"artikelText1": "",
−
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"artikelText2": "",
−
|-
+
"artikelText3": "",
−
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"artikelText4": "",
−
|-
+
"artikelVolumen": 0,
−
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"artikelWaehrung": "",
−
|-
+
"artikelWert": 0,
−
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"chargeFlag": "",
−
|-
+
"kundenArtikelNr": "",
−
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"kundenBestellNr": "",
−
|-
+
"posAuftragNr": "",
−
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
+
"posLieferNr": "",
−
|-
+
"positionNr": "",
−
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
+
"serienNr": "",
−
|-
+
"ursprungLand": ""
−
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
}
−
|}
+
],
−
</div></div>
+
"barcodeID": "",
−
<br>
+
"barcodeText": "",
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"barcodeTyp": "",
−
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
+
"druckername": "",
−
<div class="mw-collapsible-content">
+
"gefahrgut": [
−
{| class="wikitable sortable"
+
{
−
|-
+
"gefahrgutBefoerdKat": 0,
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|-
+
"gefahrgutBegrenzteMenge": "",
−
|-
+
"gefahrgutBezeichnung": "",
−
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
"gefahrgutBuchst640": "",
−
|-
+
"gefahrgutFFCode": "",
−
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
"gefahrgutFaktor": 0,
−
|-
+
"gefahrgutFreigestMenge": "",
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
"gefahrgutKCode": "",
−
|-
+
"gefahrgutKlasse": "",
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
+
"gefahrgutMenge": 0,
−
|}
+
"gefahrgutMengenEinheit": "",
−
</div></div>
+
"gefahrgutNebenGefahr": "",
−
<br>
+
"gefahrgutNettoExplMasse": 0,
−
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"gefahrgutTunnelBCode": "",
−
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
"gefahrgutUNNR": "",
−
<div class="mw-collapsible-content">
+
"gefahrgutUmweltGef": "",
−
;Request
+
"gefahrgutVPG": "",
−
<source lang="json">
+
"gefahrgutVerpAnzahl": 0,
−
{
+
"gefahrgutVerpackungsart": ""
−
"ansprechpartner": "",
+
}
−
"artikelDaten": [
+
],
−
{
+
"gewicht": 0,
−
"anzahlBuegel": 0,
+
"hostTrackingNr": "",
−
"anzahlPosEtiketten": 0,
+
"infotext1": "",
−
"artikelBTNNr": "",
+
"infotext10": "",
−
"artikelEAN": "",
+
"infotext2": "",
−
"artikelEinheit": "",
+
"infotext3": "",
−
"artikelGewicht": 0,
+
"infotext4": "",
−
"artikelGruppe": "",
+
"infotext5": "",
−
"artikelMenge": 0,
+
"infotext6": "",
−
"artikelServices": "",
+
"infotext7": "",
−
"artikelSollMenge": 0,
+
"infotext8": "",
−
"artikelText1": "",
+
"infotext9": "",
−
"artikelText2": "",
+
"letztesPackstueck": "",
−
"artikelText3": "",
+
"nachnahme": 0,
−
"artikelText4": "",
+
"nettoGewicht": 0,
−
"artikelVolumen": 0,
+
"nnVermerk": "",
−
"artikelWaehrung": "",
+
"nnVerwendung": "",
−
"artikelWert": 0,
+
"nnWaehrung": "",
−
"chargeFlag": "",
+
"packStkNr": 0,
−
"kundenArtikelNr": "",
+
"packstueckBreite": 0,
−
"kundenBestellNr": "",
+
"packstueckHoehe": 0,
−
"posAuftragNr": "",
+
"packstueckID": "",
−
"posLieferNr": "",
+
"packstueckLaenge": 0,
−
"positionNr": "",
+
"verpackungsart": "",
−
"serienNr": "",
+
"versicherungswert": 0,
−
"ursprungLand": ""
+
"vwWaehrung": "",
 +
"warenwert": 0,
 +
"wwWaehrung": ""
 
}
 
}
 
],
 
],
−
"auftragNr": "",
+
"packplatz": "",
−
"auftraggeberID": "",
+
"paperlessInvoice": "",
−
"avisHinweis1": "",
+
"postLeitcode": "",
−
"avisHinweis2": "",
+
"postZielFrachtzent": "",
−
"avisZusatz1": "",
+
"rechnungsEmpfLKZ": "",
−
"avisZusatz2": "",
+
"rechnungsEmpfName1": "",
−
"bestellNr": "",
+
"rechnungsEmpfName2": "",
−
"druckername": "",
+
"rechnungsEmpfName3": "",
−
"email": "",
+
"rechnungsEmpfOrt": "",
−
"faxNr": "",
+
"rechnungsEmpfPLZ": "",
−
"frachtBrief": "",
+
"rechnungsEmpfStrasse": "",
−
"frachtfuehrerKdNr": "",
+
"rechnungsNr": "",
−
"frankaturKennung": "",
+
"RequestuestSPM": "",
−
"gefahrgut": [
+
"sendungsinhalt": "",
−
{
+
"sonderdienste": "",
−
"gefahrgutBefoerdKat": 0,
+
"sperrFlag": "",
−
"gefahrgutBegrenzteMenge": "",
+
"telefonNr": "",
−
"gefahrgutBezeichnung": "",
+
"terminArt": "",
−
"gefahrgutBuchst640": "",
+
"terminDatum": "",
−
"gefahrgutFFCode": "",
+
"terminZeit": "",
−
"gefahrgutFaktor": 0,
+
"ustIDNr": "",
−
"gefahrgutFreigestMenge": "",
+
"versandartID": "",
−
"gefahrgutKCode": "",
+
"vorgabeFrachtfuehrer": "",
−
"gefahrgutKlasse": "",
+
"vorpackdatum": "",
−
"gefahrgutMenge": 0,
+
"wechselbruecke": "",
−
"gefahrgutMengenEinheit": "",
+
"zahlungsbedingung": "",
−
"gefahrgutNebenGefahr": "",
+
"zbZoll": "",
−
"gefahrgutNettoExplMasse": 0,
+
"zielAdrBahnhof": "",
−
"gefahrgutTunnelBCode": "",
+
"zielAdrLKZ": "",
−
"gefahrgutUNNR": "",
+
"zielAdrName1": "",
−
"gefahrgutUmweltGef": "",
+
"zielAdrName2": "",
−
"gefahrgutVPG": "",
+
"zielAdrName3": "",
−
"gefahrgutVerpAnzahl": 0,
+
"zielAdrName4": "",
−
"gefahrgutVerpackungsart": ""
+
"zielAdrOrt": "",
−
}
+
"zielAdrPLZ": "",
−
],
+
"zielAdrRegion": "",
−
"gewicht": 0,
+
"zielAdrStrasse": ""
−
"ilnNr": "",
+
}
−
"infotext1": "",
+
</source>
−
"infotext2": "",
+
;Response
−
"infotext3": "",
+
<source lang="json">
−
"infotext4": "",
+
{
−
"infotext5": "",
+
"versandSendungsNr": "",
−
"infotext6": "",
+
"sendungsGebuehrWaehrung": "",
−
"infotext7": "",
+
"fehler": "",
−
"infotext8": "",
+
"packStueckDaten": [
−
"infotext9": "",
+
{
−
"infotext10": "",
+
"assoc": {
−
"kostenstelle": "",
+
"":""
−
"kundenNr": "",
+
},
−
"lieferscheinNr": "",
+
"packstueckID": "",
−
"nachnahme": 0,
+
"trackingNr": "",
−
"nettoGewicht": 0,
+
"retourTrackingNr": "",
−
"neutabsenderLKZ": "",
+
"druckDateTime": "",
−
"neutabsenderName1": "",
+
"gebuehrWaehrung": "",
−
"neutabsenderName2": "",
+
"fehlertext1": "",
−
"neutabsenderName3": "",
+
"fehlertext2": "",
−
"neutabsenderOrt": "",
+
"etikettName": "",
−
"neutabsenderPLZ": "",
+
"etikettDaten": "",
−
"neutabsenderStrasse": "",
+
"zusatzEtikettenDaten": {
−
"nnVermerk": "",
+
"": ""
−
"nnVerwendung": "",
+
},
−
"nnWaehrung": "",
+
"trackingURL": "",
−
"packStkGes": 0,
+
"zusatzfeld1": "",
−
"packStkNr": 0,
+
"zusatzfeld2": "",
−
"packplatz": "",
+
"zusatzfeld3": "",
−
"packstueckBreite": 0,
+
"zusatzfeld4": "",
−
"packstueckHoehe": 0,
+
"zusatzfeld5": "",
−
"packstueckID": "",
+
"zusatzfeld6": "",
−
"packstueckLaenge": 0,
+
"zusatzfeld7": "",
−
"paperlessInvoice": "",
+
"zusatzfeld8": "",
−
"postLeitcode": "",
+
"zusatzfeld9": "",
−
"postZielFrachtzent": "",
+
"zusatzfeld10": "",
−
"rechnungsEmpfLKZ": "",
+
"ausgangDateTime": ""
−
"rechnungsEmpfName1": "",
+
}
−
"rechnungsEmpfName2": "",
+
]
−
"rechnungsEmpfName3": "",
+
}
−
"rechnungsEmpfOrt": "",
+
</source>
−
"rechnungsEmpfPLZ": "",
+
</div></div>
−
"rechnungsEmpfStrasse": "",
+
<!-- ------------------------------------------------------------------------------- ENDE sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
−
"sendungsinhalt": "",
+
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
−
"sonderdienste": "",
+
 
−
"telefonNr": "",
+
= Zusätzliche Datentypen =
−
"terminArt": "",
+
Je nach Frachtführer und Einsatzzweck kann es notwendig werden weitere Informationen zur Sendung zu übergeben.
−
"terminDatum": "",
+
HVS verarbeitet spezielle Kennungen für Daten von im Packstück enthaltenen Artikel oder Gefahrgütern. In beiden Fällen ist es möglich mehrere Zusatzdaten pro Packstück zu übergeben, zum Beispiel wenn mehrere Artikel in einem  Packstück enthalten sind.
−
"terminZeit": "",
+
 
−
"ustIDNr": "",
+
== ArtikelDaten ==
−
"verpackungsart": "",
+
 
−
"versandartID": "",
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
"versicherungswert": 0,
+
<div style="font-weight:bold;line-height:1.6;">Artikel-Daten</div>
−
"vwWaehrung": "",
+
<div class="mw-collapsible-content">
−
"warenwert": 0,
+
{| class="wikitable sortable"
−
"wwWaehrung": "",
+
|-
−
"zahlungsbedingung": "",
+
! Nr !! Feldname !! Von !! Bis !! Typ !! Länge !! Dezimalstellen !! Pflicht !! HVS-Feld !! Belegung !! Feldname
−
"zbZoll": "",
+
|-
−
"zielAdrBahnhof": "",
+
| 1 || Satz-Kennung || 1 || 3 || A || 3 ||  || M ||  || Festeintrag "ART" || Satz-Kennung
−
"zielAdrLKZ": "",
+
|-
−
"zielAdrName1": "",
+
| 2 || Lieferschein-Nr || 4 || 13 || A || 10 ||  || M ||  ||  || Lieferschein-Nr
−
"zielAdrName2": "",
+
|-
−
"zielAdrName3": "",
+
| 3 || Packstück-Nr || 14 || 16 || N || 3 ||  || C ||  || Pflicht bei AutomatikPolling || Packstück-Nr
−
"zielAdrOrt": "",
+
|-
−
"zielAdrPLZ": "",
+
| 4 || Positions-Nr || 17 || 26 || N || 10 || 0 || M ||  || || Positions-Nr
−
"zielAdrRegion": "",
+
|-
−
"zielAdrStrasse": ""
+
| 5 || Artikel-Nr || 27 || 76 || A || 50 || || O ||  || || Artikel-Nr
−
}
+
|-
−
</source>
+
| 6 || Artikel-Bezeichnung1 || 77 || 176 || A || 100 || || M ||  || || Artikel-Bezeichnung1
−
;Response
+
|-
−
<source lang="json">
+
| 7 || Artikel-Bezeichnung2 || 177 || 276 || A || 100 || || O ||  || || Artikel-Bezeichnung2
−
{
+
|-
−
"druckDateTime": "",
+
| 8 || Artikel-Netto-Gewicht (je Maßeinheit) || 277 || 285 || N || 9 || 3 || M ||  || || Artikel-Netto-Gewicht (je Maßeinheit)
−
"fehlertext1": "",
+
|-
−
"fehlertext2": ""
+
| 9 || BTN-Nummer || 286 || 310 || A || 25 ||  || O ||  || || BTN-Nummer
−
}
+
|-
−
</source>
+
| 10 || Artikel-Anzahl (je Maßeinheit) || 311 || 319 || N || 9 || 0 || M ||  || || Artikel-Anzahl (je Maßeinheit)
−
</div></div>
+
|-
−
<!-- ------------------------------------------------------------------------------- ENDE versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
+
| 11 || Ursprungsland || 320 || 321 || A || 2 ||  || O ||  || || Ursprungsland
−
<!-- ------------------------------------------------------------------------------- updateVersanddaten ------------------------------------------------------------------------------- -->
+
|-
−
 
+
| 12 || Artikel-Wert (je Maßeinheit) || 322 || 330 || N || 9 || 2 || O ||  || || Artikel-Wert (je Maßeinheit)
−
== 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>
 
−
'''Funktion (POST): /hvs32rest/updateVersanddaten'''<br>
 
−
'''MediaType: text/plain'''<br>
 
−
<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
+
| 13 || Artikelwert-Währung || 331 || 333 || A || 3 ||  || O ||  || ISO-Währung z.B. 'EUR' || Artikelwert-Währung
 
|-
 
|-
−
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
+
| 14 || Artikel-Maßeinheit || 334 || 343 || A || 10 || || O ||  || || Artikel-Maßeinheit
 
|-
 
|-
−
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
+
| 15 || Artikel-BestellNr || 344 || 393 || A || 50 ||  || M ||  || || Artikel-BestellNr
 
|-
 
|-
−
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
+
| 16 || Artikel-Volumen || 394 || 402 || N || 9 || 3 || M || || || Artikel-Volumen
 
|-
 
|-
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| 17 || Artikel-Services || 403 || 452 || A || 50 ||  || O ||  || || Artikel-Services
 
|-
 
|-
−
| auftragNr || [[#Datentypen|String]] || 20 || - || -
+
| 18 || Artikel-Gruppe || 453 || 502 || A || 50 ||  || O ||  || || Artikel-Gruppe
 
|-
 
|-
−
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
+
|}
 +
M = Muss eingetragen werden, O = Optimal einzutragen, C = Conditional abhängig von anderen Feldern
 +
 
 +
</div></div>
 +
 
 +
Bitte klären Sie die übergebenen Parameter unbedingt im Vorfeld mit Ihrem Ansprechpartner bei Heidler Strichcode GmbH da diese stark von den verwendeten Frachtführern abhängen.
 +
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- -->
 +
 
 +
== Gefahrgut ==
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">Gefahrgut-Daten</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 
|-
 
|-
−
| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+
! Nr !! Name !! Feldname !! Von !! Bis !! Länge !! Dezimalstellen !! Typ !! Belegung !! Wichtig bei LQ
 
|-
 
|-
−
| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+
| 1 || Satzkennung || || 1 || 3 || 3 || || A || Fest 'GEF' ||
 
|-
 
|-
−
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+
| 2 || Gefahrgut-UNNR || GefahrgutUNNr || 4 || 7 || 4 || || A || || X
 
|-
 
|-
−
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+
| 3 || Gefahrgut-Klasse || GefahrgutKlasse || 8 || 11 || 4 || || A || || X
 
|-
 
|-
−
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| 4 || GG-Verpackungsgruppe || GefahrgutVPG || 12 || 14 || 3 || || A || I,II,III bzw. leer ||
 
|-
 
|-
−
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| 5 || GG-Klassifizierungscode || GefahrgutKCODE || 15 || 18 || 4 || || A || Pflicht bei Klasse 2 ||
 
|-
 
|-
−
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| 6 || Gefahrgut-Bezeichnung || GefahrgutBezeichnung || 19 || 128 || 110 || || A || Stoffbezeichnung It. ADR-Tabelle || X
 
|-
 
|-
−
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
+
| 7 || Gefahrgut-Stoffmenge || GefahrgutMenge || 129 || 139 || 11 || 3 || N || || X
 
|-
 
|-
−
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
+
| 8 || Kennung 'Begrenze Menge' || GefahrgutBegrenzteMenge || 140 || 140 || 1 || || A || '*' oder 'T': Status 'Begrenzte Menge' || X
 
|-
 
|-
−
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
+
| 9 || Anzahl Versandstücke GG || GefahrgutVerpAnzahl || 141 || 143 || 3 || || N || || X
 
|-
 
|-
−
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
+
| 10 || Versandstück-Art || GefahrgutVerpackungsart || 144 || 151 || 8 || || A || GG-konform, z.B. '4G', '6HG2' usw. || X
 
|-
 
|-
−
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
+
| 11 || GG-ID || GefahrgutID || 152 || 159 || 8 || || A || Eindeutige Suchnummer für Gefahrgut-Stammdaten ||
 
|-
 
|-
−
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
+
| 12 || GG-Nebengefahrklasse(n) || GefahrgutNebengefahr || 160 || 171 || 12 || || A || GG-Nebengefahrklasse(n) ||
 
|-
 
|-
−
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
+
| 13 || Buchst. Bei Sondervorschr. 640 || GefahrgutBuchst640 || 172 || 172 || 1 || || A || Buchst. Bei Sondervorschr. 640 (A-L) ||
 
|-
 
|-
−
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
+
| 14 || Maßeinheit GG-Stoffmenge || GefahrgutMengeneinheit || 173 || 173 || 1 || || A || 0' bzw. Blank: Kilogramm; "1": Liter || X
 
|-
 
|-
−
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
+
| 15 || Beförderungskategorie || GefahrgutBefoerdKat || 174 || 174 || 1 || || N || 0-4 It. ADR 1.1.3.6 || X
 
|-
 
|-
−
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
+
| 16 || GG-Faktor || GefahrgutFaktor || 175 || 178 || 4 || || N || Gewichtungsfaktor It. ADR 1.1.3.6 ||
 
|-
 
|-
−
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+
| 17 || Netto-Explosivmasse in kg || GefahrgutNettoExpiMasse || 179 || 189 || 11 || 3 || N || Nur bei Klasse 1, dann aber Pflicht ||
 
|-
 
|-
−
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
+
| 18 || Tunnel-Beschränkungscode || GefahrgutTunnelBCode || 190 || 199 || 10 || || A || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E) ||
 
|-
 
|-
−
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
+
| 19 || Kennung 'Freigestellte Menge' || GefahrgutFreigestMenge || 200 || 200 || 1 || || A || '*' oder 'T': Status 'Freigestellte Menge' (überstimmt Feld 8) ||
 
|-
 
|-
−
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| 20 || Kennung 'Umweltgefährdend' || GefahrgutUmweltgef || 201 || 201 || 1 || || A || '*' oder 'T': Status 'Umweltgefährdend' ||
 
|-
 
|-
−
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| 21 || Gefahrgut-Techn. Benennung || GefahrgutTechBenennung || 202 || 301 || 100 || || A || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut ||
 
|-
 
|-
−
| 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 || - || -
 
−
|-
 
−
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
−
|-
 
−
| 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
 
−
|-
 
−
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 
−
|-
 
−
| 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
 
−
|-
 
−
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || 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
 
−
|-
 
−
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
 
−
|-
 
−
| 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)
 
−
|-
 
−
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
 
−
|-
 
−
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
 
−
|-
 
−
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
 
−
|-
 
−
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
−
|-
 
−
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
−
|-
 
−
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
−
|-
 
−
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
 
−
|-
 
−
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
 
−
|-
 
−
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
 
−
|-
 
−
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
 
−
|-
 
−
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
 
−
|-
 
−
| 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
 
−
|-
 
−
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
 
−
|-
 
−
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
−
|-
 
−
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
 
−
|-
 
−
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
 
−
|-
 
−
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
 
−
|-
 
−
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
 
−
|-
 
−
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
 
−
|-
 
−
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
−
|-
 
−
| 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
 
−
|-
 
−
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
 
−
|-
 
−
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
 
−
|-
 
−
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
 
−
|-
 
−
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
 
−
|-
 
−
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
 
−
|-
 
−
| '''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">
 
−
;Request
 
−
<source lang="json">
 
−
{
 
−
"ansprechpartner": "",
 
−
"anzahlArtikel": 0,
 
−
"artikelDaten": [
 
−
{
 
−
"anzahlBuegel": 0,
 
−
"anzahlPosEtiketten": 0,
 
−
"artikelBTNNr": "",
 
−
"artikelEAN": "",
 
−
"artikelEinheit": "",
 
−
"artikelGewicht": 0,
 
−
"artikelGruppe": "",
 
−
"artikelMenge": 0,
 
−
"artikelServices": "",
 
−
"artikelSollMenge": 0,
 
−
"artikelText1": "",
 
−
"artikelText2": "",
 
−
"artikelText3": "",
 
−
"artikelText4": "",
 
−
"artikelVolumen": 0,
 
−
"artikelWaehrung": "",
 
−
"artikelWert": 0,
 
−
"chargeFlag": "",
 
−
"kundenArtikelNr": "",
 
−
"kundenBestellNr": "",
 
−
"posAuftragNr": "",
 
−
"posLieferNr": "",
 
−
"positionNr": "",
 
−
"serienNr": "",
 
−
"ursprungLand": ""
 
−
}
 
−
],
 
−
"auftragNr": "",
 
−
"auftraggeberID": "",
 
−
"avisHinweis1": "",
 
−
"avisHinweis2": "",
 
−
"avisZusatz1": "",
 
−
"avisZusatz2": "",
 
−
"barcodeID": "",
 
−
"barcodeText": "",
 
−
"barcodeTyp": "",
 
−
"bestellNr": "",
 
−
"druckername": "",
 
−
"email": "",
 
−
"empfMobilfunkNr": "",
 
−
"faxNr": "",
 
−
"flexZustellungEmailadResponsese": "",
 
−
"frachtBrief": "",
 
−
"frachtfuehrerKdNr": "",
 
−
"frankaturKennung": "",
 
−
"gefahrgut": [
 
−
{
 
−
"gefahrgutBefoerdKat": 0,
 
−
"gefahrgutBegrenzteMenge": "",
 
−
"gefahrgutBezeichnung": "",
 
−
"gefahrgutBuchst640": "",
 
−
"gefahrgutFFCode": "",
 
−
"gefahrgutFaktor": 0,
 
−
"gefahrgutFreigestMenge": "",
 
−
"gefahrgutKCode": "",
 
−
"gefahrgutKlasse": "",
 
−
"gefahrgutMenge": 0,
 
−
"gefahrgutMengenEinheit": "",
 
−
"gefahrgutNebenGefahr": "",
 
−
"gefahrgutNettoExplMasse": 0,
 
−
"gefahrgutTunnelBCode": "",
 
−
"gefahrgutUNNR": "",
 
−
"gefahrgutUmweltGef": "",
 
−
"gefahrgutVPG": "",
 
−
"gefahrgutVerpAnzahl": 0,
 
−
"gefahrgutVerpackungsart": ""
 
−
}
 
−
],
 
−
"gewicht": 0,
 
−
"hostTrackingNr": "",
 
−
"ilnNr": "",
 
−
"infotext1": "",
 
−
"infotext2": "",
 
−
"infotext3": "",
 
−
"infotext4": "",
 
−
"infotext5": "",
 
−
"infotext6": "",
 
−
"infotext7": "",
 
−
"infotext8": "",
 
−
"infotext9": "",
 
−
"infotext10": "",
 
−
"kostenstelle": "",
 
−
"kundenNr": "",
 
−
"lagerkennzeichen": 0,
 
−
"letztesPackstueck": "",
 
−
"lieferantenID": 0,
 
−
"lieferscheinNr": "",
 
−
"nachnahme": 0,
 
−
"nettoGewicht": 0,
 
−
"neutBIC": "",
 
−
"neutBankBezeichnung": "",
 
−
"neutIBAN": "",
 
−
"neutKontoInhaber": "",
 
−
"neutabsenderLKZ": "",
 
−
"neutabsenderName1": "",
 
−
"neutabsenderName2": "",
 
−
"neutabsenderName3": "",
 
−
"neutabsenderOrt": "",
 
−
"neutabsenderPLZ": "",
 
−
"neutabsenderStrasse": "",
 
−
"nnVermerk": "",
 
−
"nnVerwendung": "",
 
−
"nnWaehrung": "",
 
−
"packStkGes": 0,
 
−
"packStkNr": 0,
 
−
"packplatz": "",
 
−
"packstueckBreite": 0,
 
−
"packstueckHoehe": 0,
 
−
"packstueckID": "",
 
−
"packstueckLaenge": 0,
 
−
"paperlessInvoice": "",
 
−
"postLeitcode": "",
 
−
"postZielFrachtzent": "",
 
−
"rechnungsEmpfLKZ": "",
 
−
"rechnungsEmpfName1": "",
 
−
"rechnungsEmpfName2": "",
 
−
"rechnungsEmpfName3": "",
 
−
"rechnungsEmpfOrt": "",
 
−
"rechnungsEmpfPLZ": "",
 
−
"rechnungsEmpfStrasse": "",
 
−
"rechnungsNr": "",
 
−
"sendungsinhalt": "",
 
−
"sonderdienste": "",
 
−
"sperrFlag": "",
 
−
"telefonNr": "",
 
−
"terminArt": "",
 
−
"terminDatum": "",
 
−
"terminZeit": "",
 
−
"ustIDNr": "",
 
−
"verpackungsart": "",
 
−
"versandartID": "",
 
−
"versicherungswert": 0,
 
−
"vorpackdatum": "",
 
−
"vwWaehrung": "",
 
−
"warenwert": 0,
 
−
"wechselbruecke": "",
 
−
"wwWaehrung": "",
 
−
"zahlungsbedingung": "",
 
−
"zbZoll": "",
 
−
"zielAdrBahnhof": "",
 
−
"zielAdrLKZ": "",
 
−
"zielAdrName1": "",
 
−
"zielAdrName2": "",
 
−
"zielAdrName3": "",
 
−
"zielAdrName4": "",
 
−
"zielAdrOrt": "",
 
−
"zielAdrPLZ": "",
 
−
"zielAdrRegion": "",
 
−
"zielAdrStrasse": ""
 
−
}
 
−
</source>
 
−
;Response
 
−
<source lang="json">
 
−
{
 
−
"packstueckID": "",
 
−
"trackingNr": "",
 
−
"retourTrackingNr": "",
 
−
"versandSendungsNr": "",
 
−
"druckDateTime": "",
 
−
"ausgangDateTime": "",
 
−
"gebuehrWaehrung": "",
 
−
"fehlercode": 0,
 
−
"fehlertext1": "",
 
−
"fehlertext2": "",
 
−
"etikettName": "",
 
−
"etikettDaten": "",
 
−
"trackingURL": "",
 
−
"zusatzfeld1": "",
 
−
"zusatzfeld2": "",
 
−
"zusatzfeld3": "",
 
−
"zusatzfeld4": "",
 
−
"zusatzfeld5": "",
 
−
"zusatzfeld6": "",
 
−
"zusatzfeld7": "",
 
−
"zusatzfeld8": "",
 
−
"zusatzfeld9": "",
 
−
"zusatzfeld10": ""
 
−
}
 
−
</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>
 
−
<br>
 
−
'''Funktion (POST): /hvs32rest/anonymisiereVersandDaten'''<br>
 
−
'''MediaType: text/plain'''<br>
 
−
<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 !! 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.
 
−
|-
 
−
| 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"
 
−
|-
 
−
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung
 
−
|-
 
−
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
−
|-
 
−
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
−
|}
 
−
</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">
 
−
;Request
 
−
<source lang="json">
 
−
{
 
−
"auftragNr": "",
 
−
"lieferscheinNr": "",
 
−
"packplatz": "",
 
−
"packstueckID": "",
 
−
"trackingNr": ""
 
−
}
 
−
</source>
 
−
;Response
 
−
<source lang="json">
 
−
{
 
−
"fehlertext1": "",
 
−
"fehlertext2": ""
 
−
}
 
−
</source>
 
−
</div></div>
 
−
<!-- ------------------------------------------------------------------------------- ENDE anonymisiereVersandDaten ------------------------------------------------------------------------------- -->
 
−
<!-- ------------------------------------------------------------------------------- sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
 
−
 
 
−
== Sendungs-Verarbeitung (sendungsdatenAnfrage) ==
 
−
sendungsdatenAnfrage – 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>
 
−
'''Funktion (POST): /hvs32rest/sendungsdatenAnfrage'''<br>
 
−
'''MediaType: text/plain'''<br>
 
−
<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
 
−
|-
 
−
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
−
|-
 
−
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
−
|-
 
−
| auftragNr || [[#Datentypen|String]] || 20 || - || -
 
−
|-
 
−
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
−
|-
 
−
| ausschlussFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Ausschluss-Frachtführer für SPM Anfrage
 
−
|-
 
−
| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
 
−
|-
 
−
| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
 
−
|-
 
−
| 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 || - || -
 
−
|-
 
−
| email || [[#Datentypen|String]] || 100 || - || Für automatische Mailavisierung
 
−
|-
 
−
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
 
−
|-
 
−
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
−
|-
 
−
| flexZustellungEmailadResponsese || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Email-Adresse
 
−
|-
 
−
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer, falls Frachtbrief durch Vorsystem gedruckt wird.
 
−
|-
 
−
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer.
 
−
|-
 
−
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 
−
|-
 
−
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
−
|-
 
−
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
 
−
|-
 
−
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
−
|-
 
−
| Lagerkennzeichen || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
 
−
|-
 
−
| LieferantenID || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
 
−
|-
 
−
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.
 
−
|-
 
−
| 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
 
−
|-
 
−
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
−
|-
 
−
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 
−
|-
 
−
| [[#packstueckDaten|packstueckDaten]] || [[#Datentypen|Sequence]] [[#packstueckDaten|<PackStueckDaten>]] || - || - || -
 
−
|-
 
−
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
 
−
|-
 
−
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
 
−
|-
 
−
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
 
−
|-
 
−
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
 
−
|-
 
−
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
 
−
|-
 
−
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
−
|-
 
−
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
−
|-
 
−
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
 
−
|-
 
−
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
 
−
|-
 
−
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
 
−
|-
 
−
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
 
−
|-
 
−
| 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
 
−
|-
 
−
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
 
−
|-
 
−
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
 
−
|-
 
−
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
 
−
|-
 
−
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
−
|-
 
−
| terminZeit || [[#Datentypen|String]] || 5 || - || HH:MM
 
−
|-
 
−
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
 
−
|-
 
−
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
 
−
|-
 
−
| vorgabeFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Vorgabe-Frachtführer für [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] Anfrage
 
−
|-
 
−
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
−
|-
 
−
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen werden soll
 
−
|-
 
−
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
 
−
|-
 
−
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
 
−
|-
 
−
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort des Bahnhofs
 
−
|-
 
−
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Länderkennzeichen (LKZ)
 
−
|-
 
−
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
 
−
|-
 
−
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
 
−
|-
 
−
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
 
−
|-
 
−
| '''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
 
−
|-
 
−
| fehler || [[#Datentypen|String]] || - || - || Wird im Fehlerfall befüllt
 
−
|-
 
−
| sendungsGebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachkosten
 
−
|-
 
−
| sendungsGebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
 
−
|-
 
−
| versandSendungsNr || [[#Datentypen|String]] || 20 || - || Sendungsnummer
 
−
|}
 
−
 
 
−
;Packstückdaten
 
−
{| 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
 
−
|-
 
−
| 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">
 
−
;Request
 
−
<source lang="json">
 
−
{
 
−
"ansprechpartner": "",
 
−
"assoc": {
 
−
"":""
 
−
},
 
−
"auftragNr": "",
 
−
"auftraggeberID": "",
 
−
"ausschlussFrachtfuehrer": "",
 
−
"avisHinweis1": "",
 
−
"avisHinweis2": "",
 
−
"avisZusatz1": "",
 
−
"avisZusatz2": "",
 
−
"bestellNr": "",
 
−
"email": "",
 
−
"empfMobilfunkNr": "",
 
−
"faxNr": "",
 
−
"flexZustellungEmailadResponsese": "",
 
−
"frachtBrief": "",
 
−
"frachtfuehrerKdNr": "",
 
−
"frankaturKennung": "",
 
−
"ilnNr": "",
 
−
"kostenstelle": "",
 
−
"kundenNr": "",
 
−
"Lagerkennzeichen": 0,
 
−
"LieferantenID": 0,
 
−
"lieferscheinNr": "",
 
−
"neutBIC": "",
 
−
"neutBankBezeichnung": "",
 
−
"neutIBAN": "",
 
−
"neutKontoInhaber": "",
 
−
"neutabsenderLKZ": "",
 
−
"neutabsenderName1": "",
 
−
"neutabsenderName2": "",
 
−
"neutabsenderName3": "",
 
−
"neutabsenderOrt": "",
 
−
"neutabsenderPLZ": "",
 
−
"neutabsenderStrasse": "",
 
−
"packStkGes": 0,
 
−
"packStueckDaten": [
 
−
{
 
−
"anzahlArtikel": 0,
 
−
"assoc": {
 
−
"":""
 
−
},
 
−
"artikelDaten": [
 
−
{
 
−
"anzahlBuegel": 0,
 
−
"anzahlPosEtiketten": 0,
 
−
"artikelBTNNr": "",
 
−
"artikelEAN": "",
 
−
"artikelEinheit": "",
 
−
"artikelGewicht": 0,
 
−
"artikelGruppe": "",
 
−
"artikelMenge": 0,
 
−
"artikelServices": "",
 
−
"artikelSollMenge": 0,
 
−
"artikelText1": "",
 
−
"artikelText2": "",
 
−
"artikelText3": "",
 
−
"artikelText4": "",
 
−
"artikelVolumen": 0,
 
−
"artikelWaehrung": "",
 
−
"artikelWert": 0,
 
−
"chargeFlag": "",
 
−
"kundenArtikelNr": "",
 
−
"kundenBestellNr": "",
 
−
"posAuftragNr": "",
 
−
"posLieferNr": "",
 
−
"positionNr": "",
 
−
"serienNr": "",
 
−
"ursprungLand": ""
 
−
}
 
−
],
 
−
"barcodeID": "",
 
−
"barcodeText": "",
 
−
"barcodeTyp": "",
 
−
"druckername": "",
 
−
"gefahrgut": [
 
−
{
 
−
"gefahrgutBefoerdKat": 0,
 
−
"gefahrgutBegrenzteMenge": "",
 
−
"gefahrgutBezeichnung": "",
 
−
"gefahrgutBuchst640": "",
 
−
"gefahrgutFFCode": "",
 
−
"gefahrgutFaktor": 0,
 
−
"gefahrgutFreigestMenge": "",
 
−
"gefahrgutKCode": "",
 
−
"gefahrgutKlasse": "",
 
−
"gefahrgutMenge": 0,
 
−
"gefahrgutMengenEinheit": "",
 
−
"gefahrgutNebenGefahr": "",
 
−
"gefahrgutNettoExplMasse": 0,
 
−
"gefahrgutTunnelBCode": "",
 
−
"gefahrgutUNNR": "",
 
−
"gefahrgutUmweltGef": "",
 
−
"gefahrgutVPG": "",
 
−
"gefahrgutVerpAnzahl": 0,
 
−
"gefahrgutVerpackungsart": ""
 
−
}
 
−
],
 
−
"gewicht": 0,
 
−
"hostTrackingNr": "",
 
−
"infotext1": "",
 
−
"infotext10": "",
 
−
"infotext2": "",
 
−
"infotext3": "",
 
−
"infotext4": "",
 
−
"infotext5": "",
 
−
"infotext6": "",
 
−
"infotext7": "",
 
−
"infotext8": "",
 
−
"infotext9": "",
 
−
"letztesPackstueck": "",
 
−
"nachnahme": 0,
 
−
"nettoGewicht": 0,
 
−
"nnVermerk": "",
 
−
"nnVerwendung": "",
 
−
"nnWaehrung": "",
 
−
"packStkNr": 0,
 
−
"packstueckBreite": 0,
 
−
"packstueckHoehe": 0,
 
−
"packstueckID": "",
 
−
"packstueckLaenge": 0,
 
−
"verpackungsart": "",
 
−
"versicherungswert": 0,
 
−
"vwWaehrung": "",
 
−
"warenwert": 0,
 
−
"wwWaehrung": ""
 
−
}
 
−
],
 
−
"packplatz": "",
 
−
"paperlessInvoice": "",
 
−
"postLeitcode": "",
 
−
"postZielFrachtzent": "",
 
−
"rechnungsEmpfLKZ": "",
 
−
"rechnungsEmpfName1": "",
 
−
"rechnungsEmpfName2": "",
 
−
"rechnungsEmpfName3": "",
 
−
"rechnungsEmpfOrt": "",
 
−
"rechnungsEmpfPLZ": "",
 
−
"rechnungsEmpfStrasse": "",
 
−
"rechnungsNr": "",
 
−
"RequestuestSPM": "",
 
−
"sendungsinhalt": "",
 
−
"sonderdienste": "",
 
−
"sperrFlag": "",
 
−
"telefonNr": "",
 
−
"terminArt": "",
 
−
"terminDatum": "",
 
−
"terminZeit": "",
 
−
"ustIDNr": "",
 
−
"versandartID": "",
 
−
"vorgabeFrachtfuehrer": "",
 
−
"vorpackdatum": "",
 
−
"wechselbruecke": "",
 
−
"zahlungsbedingung": "",
 
−
"zbZoll": "",
 
−
"zielAdrBahnhof": "",
 
−
"zielAdrLKZ": "",
 
−
"zielAdrName1": "",
 
−
"zielAdrName2": "",
 
−
"zielAdrName3": "",
 
−
"zielAdrName4": "",
 
−
"zielAdrOrt": "",
 
−
"zielAdrPLZ": "",
 
−
"zielAdrRegion": "",
 
−
"zielAdrStrasse": ""
 
−
}
 
−
</source>
 
−
;Response
 
−
<source lang="json">
 
−
{
 
−
"versandSendungsNr": "",
 
−
"sendungsGebuehrWaehrung": "",
 
−
"fehler": "",
 
−
"packStueckDaten": [
 
−
{
 
−
"assoc": {
 
−
"":""
 
−
},
 
−
"packstueckID": "",
 
−
"trackingNr": "",
 
−
"retourTrackingNr": "",
 
−
"druckDateTime": "",
 
−
"gebuehrWaehrung": "",
 
−
"fehlertext1": "",
 
−
"fehlertext2": "",
 
−
"etikettName": "",
 
−
"etikettDaten": "",
 
−
"zusatzEtikettenDaten": {
 
−
"": ""
 
−
},
 
−
"trackingURL": "",
 
−
"zusatzfeld1": "",
 
−
"zusatzfeld2": "",
 
−
"zusatzfeld3": "",
 
−
"zusatzfeld4": "",
 
−
"zusatzfeld5": "",
 
−
"zusatzfeld6": "",
 
−
"zusatzfeld7": "",
 
−
"zusatzfeld8": "",
 
−
"zusatzfeld9": "",
 
−
"zusatzfeld10": "",
 
−
"ausgangDateTime": ""
 
−
}
 
−
]
 
−
}
 
−
</source>
 
 
</div></div>
 
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
+
Bitte klären Sie die übergebenen Parameter unbedingt im Vorfeld mit Ihrem Ansprechpartner bei Heidler Strichcode GmbH da diese stark von den verwendeten Frachtführern abhängen.
−
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- -->
  
 
= Beispiele =
 
= Beispiele =
−
Alle JSON Beispiele finden Sie auch hier: [[REST_Beispiel|REST SERVER JSON Beispiele]]
 

Aktuelle Version vom 18. Mai 2022, 12:29 Uhr

Funktionsbeschreibung

Die Dateischnittstelle ist sehr flexibel und kann an nahezu alle Eingangsdaten angepasst werden. Es ist möglich mehrere Datensätze in einer Datei zu übergeben, aber auch ein Datensatz pro Datei ist möglich. In der Regel belegt ein Packstück eine Zeile, eventuell gefolgt von Zusatzinformationen wie Artikeldaten oder Gefahrgutsätzen.
Die einzelnen Felder sind unter Standard Datei Tabellenbeschreibung (CSV, SDF, etc.) beschrieben.

Übersicht der Funktionen

Packstück-Verarbeitung

Ein neues Packstück wird durch eine Zeile gekennzeichnet die mit der Kennung "IMP" beginnt.

Die weiteren Felder sind in der Standardschnittstelle beschrieben.

Etikett nachdrucken

Ein Nachdruck wird ausgelöst indem ein bereits übergebener Satz erneut erfasst wird. Je nach Einstellungen kann es dabei zu einer Warnung oder einer Verhinderung des Nachdrucks kommen - die zugehörigen Wahlmöglichkeiten befinden sich im Allgemein-Konfigurator, Bereich "Lieferschein-Verarbeitung".

Packstück stornieren

Ausgangsliste erzeugen

Frachtführer DFÜ erzeugen

Packstückdaten aktualisieren

Packstückdaten aktualisieren

Packstückdaten anonymisieren

Sendungs-Verarbeitung

Zusätzliche Datentypen

Je nach Frachtführer und Einsatzzweck kann es notwendig werden weitere Informationen zur Sendung zu übergeben. HVS verarbeitet spezielle Kennungen für Daten von im Packstück enthaltenen Artikel oder Gefahrgütern. In beiden Fällen ist es möglich mehrere Zusatzdaten pro Packstück zu übergeben, zum Beispiel wenn mehrere Artikel in einem Packstück enthalten sind.

ArtikelDaten

Artikel-Daten
Nr Feldname Von Bis Typ Länge Dezimalstellen Pflicht HVS-Feld Belegung Feldname
1 Satz-Kennung 1 3 A 3 M Festeintrag "ART" Satz-Kennung
2 Lieferschein-Nr 4 13 A 10 M Lieferschein-Nr
3 Packstück-Nr 14 16 N 3 C Pflicht bei AutomatikPolling Packstück-Nr
4 Positions-Nr 17 26 N 10 0 M Positions-Nr
5 Artikel-Nr 27 76 A 50 O Artikel-Nr
6 Artikel-Bezeichnung1 77 176 A 100 M Artikel-Bezeichnung1
7 Artikel-Bezeichnung2 177 276 A 100 O Artikel-Bezeichnung2
8 Artikel-Netto-Gewicht (je Maßeinheit) 277 285 N 9 3 M Artikel-Netto-Gewicht (je Maßeinheit)
9 BTN-Nummer 286 310 A 25 O BTN-Nummer
10 Artikel-Anzahl (je Maßeinheit) 311 319 N 9 0 M Artikel-Anzahl (je Maßeinheit)
11 Ursprungsland 320 321 A 2 O Ursprungsland
12 Artikel-Wert (je Maßeinheit) 322 330 N 9 2 O Artikel-Wert (je Maßeinheit)
13 Artikelwert-Währung 331 333 A 3 O ISO-Währung z.B. 'EUR' Artikelwert-Währung
14 Artikel-Maßeinheit 334 343 A 10 O Artikel-Maßeinheit
15 Artikel-BestellNr 344 393 A 50 M Artikel-BestellNr
16 Artikel-Volumen 394 402 N 9 3 M Artikel-Volumen
17 Artikel-Services 403 452 A 50 O Artikel-Services
18 Artikel-Gruppe 453 502 A 50 O Artikel-Gruppe

M = Muss eingetragen werden, O = Optimal einzutragen, C = Conditional abhängig von anderen Feldern

Bitte klären Sie die übergebenen Parameter unbedingt im Vorfeld mit Ihrem Ansprechpartner bei Heidler Strichcode GmbH da diese stark von den verwendeten Frachtführern abhängen.

Gefahrgut

Gefahrgut-Daten
Nr Name Feldname Von Bis Länge Dezimalstellen Typ Belegung Wichtig bei LQ
1 Satzkennung 1 3 3 A Fest 'GEF'
2 Gefahrgut-UNNR GefahrgutUNNr 4 7 4 A X
3 Gefahrgut-Klasse GefahrgutKlasse 8 11 4 A X
4 GG-Verpackungsgruppe GefahrgutVPG 12 14 3 A I,II,III bzw. leer
5 GG-Klassifizierungscode GefahrgutKCODE 15 18 4 A Pflicht bei Klasse 2
6 Gefahrgut-Bezeichnung GefahrgutBezeichnung 19 128 110 A Stoffbezeichnung It. ADR-Tabelle X
7 Gefahrgut-Stoffmenge GefahrgutMenge 129 139 11 3 N X
8 Kennung 'Begrenze Menge' GefahrgutBegrenzteMenge 140 140 1 A '*' oder 'T': Status 'Begrenzte Menge' X
9 Anzahl Versandstücke GG GefahrgutVerpAnzahl 141 143 3 N X
10 Versandstück-Art GefahrgutVerpackungsart 144 151 8 A GG-konform, z.B. '4G', '6HG2' usw. X
11 GG-ID GefahrgutID 152 159 8 A Eindeutige Suchnummer für Gefahrgut-Stammdaten
12 GG-Nebengefahrklasse(n) GefahrgutNebengefahr 160 171 12 A GG-Nebengefahrklasse(n)
13 Buchst. Bei Sondervorschr. 640 GefahrgutBuchst640 172 172 1 A Buchst. Bei Sondervorschr. 640 (A-L)
14 Maßeinheit GG-Stoffmenge GefahrgutMengeneinheit 173 173 1 A 0' bzw. Blank: Kilogramm; "1": Liter X
15 Beförderungskategorie GefahrgutBefoerdKat 174 174 1 N 0-4 It. ADR 1.1.3.6 X
16 GG-Faktor GefahrgutFaktor 175 178 4 N Gewichtungsfaktor It. ADR 1.1.3.6
17 Netto-Explosivmasse in kg GefahrgutNettoExpiMasse 179 189 11 3 N Nur bei Klasse 1, dann aber Pflicht
18 Tunnel-Beschränkungscode GefahrgutTunnelBCode 190 199 10 A ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)
19 Kennung 'Freigestellte Menge' GefahrgutFreigestMenge 200 200 1 A '*' oder 'T': Status 'Freigestellte Menge' (überstimmt Feld 8)
20 Kennung 'Umweltgefährdend' GefahrgutUmweltgef 201 201 1 A '*' oder 'T': Status 'Umweltgefährdend'
21 Gefahrgut-Techn. Benennung GefahrgutTechBenennung 202 301 100 A Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut

Bitte klären Sie die übergebenen Parameter unbedingt im Vorfeld mit Ihrem Ansprechpartner bei Heidler Strichcode GmbH da diese stark von den verwendeten Frachtführern abhängen.

Beispiele

Abgerufen von „https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Standard_Datei_Schnittstelle&oldid=4253“