HVS32 Standard Datei Schnittstelle: Unterschied zwischen den Versionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen
 
(76 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
−
= Voraussetzungen =
+
= Funktionsbeschreibung =
−
{| class="wikitable"
+
 +
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.
 +
<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.
 +
 
 +
Die weiteren Felder sind in der [[HVS32_Standard_Datei_Tabellenbeschreibung|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 ==
 +
<!--
 +
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"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 
|-
 
|-
−
| DGS-Version || 3.6.0.595 oder höher
+
| '''packstueckID'''|| [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
 
|-
 
|-
−
| DGS-Plugins || HVS32Client, REST Server
+
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer
 
|}
 
|}
−
<!-- ------------------------------------------------------------------------------- ENDE Voraussetzungen ------------------------------------------------------------------------------- -->
+
</div></div>
−
<!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- -->
+
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 +
|-
 +
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 +
|-
 +
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 +
|-
 +
| 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": "",
 +
"trackingNr": ""
 +
}
 +
</source>
 +
;Response
 +
<source lang="json">
 +
{
 +
"fehlercode": 0,
 +
"fehlertext1": "",
 +
"fehlertext2": ""
 +
}
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE stornoversanddaten ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- verladeVersandaten ------------------------------------------------------------------------------- -->
  
−
= Funktionsbeschreibung =
+
== Ausgangsliste erzeugen ==
−
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.
+
Text anpassen
−
<!-- ------------------------------------------------------------------------------- ENDE Funktionsbeschreibung ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- DATENTYPEN ------------------------------------------------------------------------------- -->
+
<br>
−
 
+
<br>
−
= Datentypen =
 
−
'''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 =
 
−
Ein spezial Datentyp kann innerhalb der Anfrage / Rückmeldung einer [[#Übersicht der Funktionen|Funktion]] genutzt werden.
 
−
<!-- ------------------------------------------------------------------------------- artikelDaten ------------------------------------------------------------------------------- -->
 
−
== artikelDaten ==
 
 
<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"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| anzahlBuegel || [[#Datentypen|Integer]] || - || - || Nur für Hängeversand: Anzahl der Bügel auf welche die Artikelgruppe aufgeteilt ist
+
| 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.
 
|-
 
|-
−
| anzahlPosEtiketten || [[#Datentypen|Integer]] || - || - || Anzahl Artikeletiketten, welche gedruckt werden sollen
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
 +
(Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
−
| artikelBTNNr || [[#Datentypen|String]] || 25 || - || BTN Nummer / Zolltarifnummer
+
| 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.
 
|-
 
|-
−
| artikelEAN || [[#Datentypen|String]] || 20 || - || EAN Nummer
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.
 
|-
 
|-
−
| artikelEinheit || [[#Datentypen|String]] || 10 || - || Einheit der Artikelmenge
+
| 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.
 
|-
 
|-
−
| artikelGewicht || [[#Datentypen|Decimal]] || 9 || 3 || Gewicht des Arikels
+
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 
|-
 
|-
−
| artikelGruppe || [[#Datentypen|String]] || 50 || - || Artikelgruppe
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| artikelMenge || [[#Datentypen|Decimal]] || 9 || 3 || Menge des Artikels
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| artikelServices || [[#Datentypen|String]] || 100 || - || Pipe getrennte Services für diesen Artikel
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
|-
 
|-
−
| artikelSollMenge || [[#Datentypen|Decimal]] || 9 || 3 || -
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| artikelText1 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| artikelText2 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
+
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
 
|-
 
|-
−
| artikelText3 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
+
| 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 ==
 +
<!--
 +
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"
 
|-
 
|-
−
| artikelText4 || [[#Datentypen|String]] || 100 || - || Artikelbezeichnung
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
−
| artikelVolumen || [[#Datentypen|Decimal]] || 9 || 3 || Volumen des Artikels
+
| 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.
 
|-
 
|-
−
| artikelWaehrung || [[#Datentypen|String]] || 3 || - || Währung in welcher der Wert des Artikels angegeben wird
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den z.B. die UPS Summary gedruckt wird.<br>
 +
(Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
−
| artikelWert || [[#Datentypen|Decimal]] || 18 || 2 || Wert des Artikels
+
| 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.
 
|-
 
|-
−
| chargeFlag || [[#Datentypen|String]] || 1 || - ||  
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.
 
|-
 
|-
−
| kundenArtikelNr || [[#Datentypen|String]] || 50 || - || Artikelnummer
+
| 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.
 
|-
 
|-
−
| kundenBestellNr || [[#Datentypen|String]] || 50 || - || Bestellnummer
+
| wechselbruecke|| [[#Datentypen|String]] || 10 || - || Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
 +
|}
 +
</div></div>
 +
<br>
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 
|-
 
|-
−
| posAuftragNr || [[#Datentypen|String]] || 50 || - || Auftragsnummer
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
−
| posLieferNr || [[#Datentypen|String]] || 40 || - || Lieferscheinnummer
+
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] [[#edistatus|<EDIStatus>]] || - || - || Liste mit Statusinformationen für EDIs.
 
|-
 
|-
−
| positionNr || [[#Datentypen|String]] || 50 || - || Laufende Nummer innerhalb des Packstücks
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
|-
 
|-
−
| serienNr || [[#Datentypen|String]] || 30 || - || Seriennummer
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| ursprungLand || [[#Datentypen|String]] || 2 || - || Ursprungsland des Artikels
+
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der EDI-Listen (z.B. UPS Summary) als Key/Value Map.
 
|}
 
|}
 
</div></div>
 
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- -->
+
<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": "",
 +
"edistatus": [
 +
{
 +
"fehlercode": 0,
 +
"statuscode": "",
 +
"statustext": "",
 +
"fftyp": "",
 +
"dateityp": "",
 +
"auftraggeber": "",
 +
"ffdateinr": ""
 +
}
 +
],
 +
"listenDaten": {}
 +
}
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE ediabschlussAnfrage ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
  
−
== gefahrgut ==
+
== Packstückdaten aktualisieren ==
 +
<!--
 +
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;">Gefahrgut-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"
 
|-
 
|-
 
! 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.
+
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 +
|-
 +
| [[#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
 
|-
 
|-
−
| gefahrgutBegrenzteMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status LQ / Begrenzte Menge nach ADR 3.4 verschickt wird, ansonsten F, Pflicht
+
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
−
| gefahrgutBezeichnung || [[#Datentypen|String]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (2))
+
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
−
| gefahrgutBuchst640 || [[#Datentypen|String]] || 1 || - || Buchstabe für Sondervorschrift 640, bedingte Pflicht bei Stoffen, bei denen die Sondervorschrift 640 gilt (siehe ADR-Tabelle Spalte (6))
+
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 
|-
 
|-
−
| gefahrgutFFCode || [[#Datentypen|String]] || <!-- MAXLÄNGE --> || <!-- DEZ --> || <!-- BELEGUNG -->
+
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
|-
 
|-
−
| 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
+
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
 
|-
 
|-
−
| gefahrgutFreigestMenge || [[#Datentypen|String]] || 1 || - || T wenn der Stoff mit Status EQ / Excepted Quantities nach ADR 3.5 verschickt wird, ansonsten F, Pflicht
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
−
| gefahrgutID || [[#Datentypen|String]] || 8 || - || Eindeutige Suchnummer für Gefahrgut-Stammdaten
+
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
 
|-
 
|-
−
| gefahrgutKCode || [[#Datentypen|String]] || 10 || - || Klassifizierungscode, Pflicht (siehe ADR-Tabelle Spalte (3b))
+
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
|-
 
|-
−
| gefahrgutKlasse || [[#Datentypen|String]] || 100 || - || Pflicht (siehe ADR-Tabelle Spalte (3a))
+
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
 
|-
 
|-
−
| 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 )
+
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
 
|-
 
|-
−
| gefahrgutMengenEinheit || [[#Datentypen|String]] || 2 || - || Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg
+
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
 
|-
 
|-
−
| 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 )
+
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 
|-
 
|-
−
| gefahrgutNettoExplMasse || [[#Datentypen|Decimal]] || 8 || 3 || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
+
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
 
|-
 
|-
−
| gefahrgutPositionNr || [[#Datentypen|Integer]] || - || - || Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
+
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 
|-
 
|-
−
| gefahrgutTechBenennung || [[#Datentypen|String]] || 150 || - || bedingt Pflicht bei N.A.G. Gefahrgut (d.h. wenn die Bezeichnung mit N.A.G. endet)
+
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
|-
 
|-
−
| gefahrgutTunnelBCode || [[#Datentypen|String]] || 10 || - || Tunnelbeschränkungscode, Pflicht (siehe ADR-Tabelle Spalte (15))
+
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| gefahrgutUNNR || [[#Datentypen|String]] || 10 || - || Pflicht (siehe ADR-Tabelle Spalte (1))
+
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| gefahrgutUmweltGef || [[#Datentypen|String]] || 1 || - || T wenn Stoff umweltgefährdend ist , ansonsten F, Pflicht bei umweltgefährdenden Stoffen
+
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| 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))
+
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| gefahrgutVerpAnzahl || [[#Datentypen|Integer]] || 4 || - || Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)
+
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| gefahrgutVerpackungsart || [[#Datentypen|String]] || 5 || - || ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes
+
| 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
 +
|-
 +
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
 +
|-
 +
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 +
|-
 +
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 +
|-
 +
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
 +
|-
 +
| 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
 +
|-
 +
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
 +
|-
 +
| 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
 +
|-
 +
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 +
|-
 +
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 +
|-
 +
| 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>
 
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- -->
 
−
 
 
−
== edistatus ==
 
 
<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;">EDIStatus</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"
 
|-
 
|-
−
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|-
−
|-
 
−
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
−
|-
 
−
| statuscode || [[#Datentypen|String]] || 2 || - || 
 
−
01 = FFDatei wurde erzeugt.<br>
 
−
02 = FFDatei wurde geschrieben.<br>
 
−
03 = FFDatei wurde verschickt.<br>
 
−
11 = FFDatei konnte nicht erzeugt werden!<br>
 
−
12 = FFDatei konnte nicht geschrieben werden!<br>
 
−
13 = FFDatei konnte nicht verschickt werden!<br>
 
−
 
 
−
Es ist zu beachten, dass nicht jede FFDatei verschickt wird, dies hängt ab von der HVS32 Konfiguration.<br>
 
−
D.h. solange kein Status „1x“ enthalten ist, wurde mit der FFDatei gemäß der HVS32 Konfiguration verfahren.
 
−
|-
 
−
| statustext || [[#Datentypen|String]] || 200 || - || Klartext des Statuscodes
 
 
|-
 
|-
−
| fftyp || [[#Datentypen|String]] || 50 || - || Frachtführertyp (z.B. UPS, GLS, DPD)
+
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
−
| dateityp || [[#Datentypen|String]] || 50 || - || FFDateityp (z.B.: Standard, Express, etc.)
+
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
−
| auftraggeber || [[#Datentypen|String]] || 10 || - || Auftraggebernummer ('''ACHTUNG!''' Nicht die AuftraggeberID)
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
−
| ffdateinr || [[#Datentypen|String]] || 10 || - || Nummer der FF-Datei (ggf. im Fehlerfall nicht gefüllt)
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 
|}
 
|}
 
</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;">'''Beispiele'''</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
;Request
 +
<source lang="json">
 +
{
 +
"ansprechpartner": "",
 +
"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": "",
 +
"bestellNr": "",
 +
"druckername": "",
 +
"email": "",
 +
"faxNr": "",
 +
"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,
 +
"ilnNr": "",
 +
"infotext1": "",
 +
"infotext2": "",
 +
"infotext3": "",
 +
"infotext4": "",
 +
"infotext5": "",
 +
"infotext6": "",
 +
"infotext7": "",
 +
"infotext8": "",
 +
"infotext9": "",
 +
"infotext10": "",
 +
"kostenstelle": "",
 +
"kundenNr": "",
 +
"lieferscheinNr": "",
 +
"nachnahme": 0,
 +
"nettoGewicht": 0,
 +
"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": "",
 +
"sendungsinhalt": "",
 +
"sonderdienste": "",
 +
"telefonNr": "",
 +
"terminArt": "",
 +
"terminDatum": "",
 +
"terminZeit": "",
 +
"ustIDNr": "",
 +
"verpackungsart": "",
 +
"versandartID": "",
 +
"versicherungswert": 0,
 +
"vwWaehrung": "",
 +
"warenwert": 0,
 +
"wwWaehrung": "",
 +
"zahlungsbedingung": "",
 +
"zbZoll": "",
 +
"zielAdrBahnhof": "",
 +
"zielAdrLKZ": "",
 +
"zielAdrName1": "",
 +
"zielAdrName2": "",
 +
"zielAdrName3": "",
 +
"zielAdrOrt": "",
 +
"zielAdrPLZ": "",
 +
"zielAdrRegion": "",
 +
"zielAdrStrasse": ""
 +
}
 +
</source>
 +
;Response
 +
<source lang="json">
 +
{
 +
"druckDateTime": "",
 +
"fehlertext1": "",
 +
"fehlertext2": ""
 +
}
 +
</source>
 +
</div></div>
 +
<!-- ------------------------------------------------------------------------------- ENDE versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- updateVersanddaten ------------------------------------------------------------------------------- -->
 +
 +
== 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"
 
{| class="wikitable sortable"
 
|-
 
|-
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 +
|-
 +
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
|-
 
|-
 
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
 
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
Zeile 194: Zeile 650:
 
|-
 
|-
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 +
|-
 +
| auftragNr || [[#Datentypen|String]] || 20 || - || -
 +
|-
 +
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 +
|-
 +
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 +
|-
 +
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 +
|-
 +
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 +
|-
 +
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
|-
 
|-
 
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
Zeile 200: Zeile 668:
 
|-
 
|-
 
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 +
|-
 +
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
 
|-
 
|-
 
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
 
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
 +
|-
 +
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
 +
|-
 +
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
 +
|-
 +
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 +
|-
 +
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
 +
|-
 +
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
 +
|-
 +
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
 +
|-
 +
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 
|-
 
|-
 
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
 
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
 
|-
 
|-
−
| '''gewicht''' || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 
|-
 
|-
−
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Falls die Paketnummer aus dem Vorsystem verwendet werden soll.
+
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
 +
|-
 +
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
|-
 
|-
 
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
Zeile 229: Zeile 715:
 
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
−
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstück der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
+
| 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|String]] || 3 || - || Warenwert - ISO-Währungscode
+
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
 
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 
|-
 
|-
−
| nnVermerk || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
+
| 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]] || 1 || - || 'B' = Bar, 'V' = Verrechnungsscheck
+
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
 
|-
 
|-
 
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
|-
 
|-
−
| '''packStkNr''' || [[#Datentypen|Integer]] || - || - || Laufende Nummer pro Sendung
+
| 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
 
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
Zeile 247: Zeile 769:
 
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe 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.
+
| '''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
 
| 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 || - || -
 
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
 
|-
 
|-
−
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe-Versicherungswert
+
| '''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
 
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
 
|-
 
|-
 
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
 +
|-
 +
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird
 
|-
 
|-
 
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
 +
|-
 +
| 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 ==
 +
<!--
 +
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"
 +
|-
 +
! 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>
 
</div></div>
−
<!-- ------------------------------------------------------------------------------- ENDE packstueckDaten ------------------------------------------------------------------------------- -->
+
<br>
−
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT spezial Datentypen ------------------------------------------------------------------------------- -->
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
−
<!-- ------------------------------------------------------------------------------- ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
+
<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 ==
 +
<!--
 +
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"
 +
|-
 +
! 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]] || 100 || - || -
 +
|-
 +
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 +
|-
 +
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 +
|-
 +
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 +
|-
 +
| bestellNr || [[#Datentypen|String]] || 20 || - || -
 +
|-
 +
| 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
 +
|-
 +
 
 +
|-
 +
| '''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>
 +
<!-- ------------------------------------------------------------------------------- ENDE sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
 +
 
 +
= 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 ==
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">Artikel-Daten</div>
 +
<div class="mw-collapsible-content">
 +
{| class="wikitable sortable"
 +
|-
 +
! 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
 +
 
 +
</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"
 +
|-
 +
! 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 ||
 +
|-
 +
|}
 +
</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 gefahrgut ------------------------------------------------------------------------------- -->
 +
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- -->
 +
 
 +
= 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“