HVS32 Standard Datei Schnittstelle: Unterschied zwischen den Versionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen
 
(6 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 1: Zeile 1:
 
= Funktionsbeschreibung =
 
= Funktionsbeschreibung =
 
   
 
   
Text anpassen an Dateischnittstelle
+
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.
  
<!-- ------------------------------------------------------------------------------- ENDE Funktionsbeschreibung ------------------------------------------------------------------------------- -->
+
Die weiteren Felder sind in der [[HVS32_Standard_Datei_Tabellenbeschreibung|Standardschnittstelle]] beschrieben.
<!-- ------------------------------------------------------------------------------- DATENTYPEN ------------------------------------------------------------------------------- -->
 
  
= Datentypen =
+
== Etikett nachdrucken ==
'''Integer''' - Zahl mit ausschließlich numerischen Zeichen (0-9).<br>
 
'''Decimal''' - Zahl mit Nachkommastellen<br>
 
'''Calendar''' - Datum. Das Format ist in der Regel TT.MM.JJJJ<br>
 
'''String''' - Beliebige Zeichen aus dem Zeichensatz ISO-8859-1. Maximale Länge darf nicht überschritten werden.<br>
 
'''Binary''' - Base64 kodierte Binärdaten<br>
 
<!-- ------------------------------------------------------------------------------- ENDE DATENTYPEN ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- ÜBERSICHT spezial Datentypen ------------------------------------------------------------------------------- -->
 
  
 +
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".
  
= Übersicht der Funktionen =
+
== Packstück stornieren ==
<!-- ------------------------------------------------------------------------------- echo ------------------------------------------------------------------------------- -->
+
<!--
== Packstück-Verarbeitung ==
+
Text anpassen
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>
 
<br>
Die einzelnen Felder sind unter (Link einfügen) beschrieben.
 
 
<br>
 
<br>
 
<br>
 
<br>
<!-- ------------------------------------------------------------------------------- Request ------------------------------------------------------------------------------- -->
 
 
<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;">'''Übergabe Parameter'''</div>
 
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
Zeile 34: Zeile 31:
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
+
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 
|-
 
|-
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
+
| '''packstueckID'''|| [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
 
|-
 
|-
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
+
| 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"
 
|-
 
|-
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
| auftragNr || [[#Datentypen|String]] || 20 || - || -
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
|-
 
|-
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
|-
+
|}
| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+
</div></div>
|-
+
<br>
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+
<div class="mw-collapsible-content">
|-
+
;Request
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
<source lang="json">
|-
+
{
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
"packplatz": "",
|-
+
"packstueckID": "",
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
"trackingNr": ""
|-
+
}
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
+
</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"
 
|-
 
|-
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
+
| 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.
 
|-
 
|-
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den die Listen gedruckt werden sollen.
 +
(Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
+
| 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.
 
|-
 
|-
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Listenabschluss ausführen soll.
 
|-
 
|-
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
+
| 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.
 
|-
 
|-
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
+
| 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"
 
|-
 
|-
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] [[#gefahrgut|<Gefahrgut>]] || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
|-
 
|-
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
 
|-
 
|-
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.
|-
+
|}
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
</div></div>
|-
+
<br>
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
<div class="mw-collapsible-content">
|-
+
;Request
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
<source lang="json">
|-
+
{
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"auftraggeberID": [
|-
+
""
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
],
|-
+
"druckername": "",
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"frachtfuehrerTyp": [
|-
+
""
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
],
|-
+
"packplatz": "",
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
+
"versandartID": [
|-
+
""
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
+
],
|-
+
"wechselbruecke": ""
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -
+
}
|-
+
</source>
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
+
;Response
|-
+
<source lang="json">
| lieferantenID || [[#Datentypen|Integer]] || - || - || -
+
{
|-
+
"assoc": {
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
+
"":""
 +
},
 +
"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"
 
|-
 
|-
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
+
| 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.
 
|-
 
|-
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den z.B. die UPS Summary gedruckt wird.<br>
 +
(Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
+
| 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.
 
|-
 
|-
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.
 
|-
 
|-
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
+
| 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.
 
|-
 
|-
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
+
| 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"
 
|-
 
|-
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] [[#edistatus|<EDIStatus>]] || - || - || Liste mit Statusinformationen für EDIs.
 
|-
 
|-
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
 
|-
 
|-
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
 
|-
 
|-
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der EDI-Listen (z.B. UPS Summary) als Key/Value Map.
|-
+
|}
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
+
</div></div>
|-
+
<br>
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
+
<div class="mw-collapsible-content">
|-
+
;Request
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
+
<source lang="json">
|-
+
{
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
+
"auftraggeberID": [
|-
+
""
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
+
],
|-
+
"druckername": "",
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
+
"frachtfuehrerTyp": [
|-
+
""
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
+
],
|-
+
"packplatz": "",
| '''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.
+
"versandartID": [
|-
+
""
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
+
],
|-
+
"wechselbruecke": ""
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
+
}
|-
+
</source>
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
+
;Response
|-
+
<source lang="json">
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
+
{
|-
+
"assoc": {
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
+
"":""
|-
+
},
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"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"
 
|-
 
|-
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
|-
 
|-
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
 
|-
 
|-
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
| auftragNr || [[#Datentypen|String]] || 20 || - || -
 
|-
 
|-
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
+
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
|-
 
|-
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
+
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
+
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
+
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 
|-
 
|-
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
+
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
|-
 
|-
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
+
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
 
|-
 
|-
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
+
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
 
|-
 
|-
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
+
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
|-
 
|-
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
+
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
 
|-
 
|-
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
+
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
 
|-
 
|-
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
+
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
 
|-
 
|-
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
+
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
 
|-
 
|-
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
+
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
 
|-
 
|-
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
+
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 
|-
 
|-
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird
+
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
|-
 
|-
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
+
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
+
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
+
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
+
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
+
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
+
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
 
|-
 
|-
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
+
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
 
|-
 
|-
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
|}
 
</div></div>
 
<!-- ------------------------------------------------------------------------------- ENDE Request ------------------------------------------------------------------------------- -->
 
<br>
 
<!-- ------------------------------------------------------------------------------- Response ------------------------------------------------------------------------------- -->
 
<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|
+
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
 
|-
 
|-
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
 
|-
 
|-
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
+
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
+
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
+
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
 
|-
 
|-
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
 
|-
 
|-
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
+
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
|-
 
|-
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
+
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 
|-
 
|-
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
+
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
 
|-
 
|-
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
 
|-
 
|-
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
+
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
 
|-
 
|-
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
+
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
 
|-
 
|-
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
+
| 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.
 
|-
 
|-
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
+
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
 
|-
 
|-
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
 
|-
 
|-
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
 
|-
 
|-
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
 
|-
 
|-
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
 
|-
 
|-
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 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
 
|-
 
|-
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
 
|-
 
|-
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
 
|-
 
|-
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
 
|-
 
|-
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
 
|-
 
|-
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
|}
+
|-
</div></div>
+
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
<!-- ------------------------------------------------------------------------------- ENDE Response ------------------------------------------------------------------------------- -->
+
|-
<br>
+
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
<!-- ------------------------------------------------------------------------------- Beispiel ------------------------------------------------------------------------------- -->
+
|-
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
<div style="font-weight:bold;line-height:1.6;">Beispiele</div>
+
|-
<div class="mw-collapsible-content">
+
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
;Request
+
|-
<source lang="json">
+
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
{
+
|-
"ansprechpartner": "",
+
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
"assoc": {
+
|-
"":""
+
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
},
+
|-
"artikelDaten": [
+
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
{
+
|-
"anzahlBuegel": 0,
+
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
"anzahlPosEtiketten": 0,
+
|-
"artikelBTNNr": "",
+
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
"artikelEAN": "",
+
|-
"artikelEinheit": "",
+
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
"artikelGewicht": 0,
+
|-
"artikelGruppe": "",
+
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
"artikelMenge": 0,
+
|-
"artikelServices": "",
+
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
"artikelSollMenge": 0,
+
|-
"artikelText1": "",
+
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
"artikelText2": "",
+
|-
"artikelText3": "",
+
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
"artikelText4": "",
+
|-
"artikelVolumen": 0,
+
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
"artikelWaehrung": "",
+
|-
"artikelWert": 0,
+
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
"chargeFlag": "",
+
|-
"kundenArtikelNr": "",
+
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
"kundenBestellNr": "",
+
|-
"posAuftragNr": "",
+
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
"posLieferNr": "",
+
|-
"positionNr": "",
+
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
"serienNr": "",
+
|}
"ursprungLand": ""
+
</div></div>
}
+
<br>
],
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
"auftragNr": "",
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
"auftraggeberID": "",
+
<div class="mw-collapsible-content">
"avisHinweis1": "",
+
{| class="wikitable sortable"
"avisHinweis2": "",
+
|-
"avisZusatz1": "",
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|-
"avisZusatz2": "",
+
|-
"bestellNr": "",
+
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
"druckername": "",
+
|-
"email": "",
+
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
"faxNr": "",
+
|-
"frachtBrief": "",
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
"frachtfuehrerKdNr": "",
+
|-
"frankaturKennung": "",
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
"gefahrgut": [
+
|}
 +
</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": "",
 +
"artikelDaten": [
 
{
 
{
"gefahrgutBefoerdKat": 0,
+
"anzahlBuegel": 0,
"gefahrgutBegrenzteMenge": "",
+
"anzahlPosEtiketten": 0,
"gefahrgutBezeichnung": "",
+
"artikelBTNNr": "",
"gefahrgutBuchst640": "",
+
"artikelEAN": "",
"gefahrgutFFCode": "",
+
"artikelEinheit": "",
"gefahrgutFaktor": 0,
+
"artikelGewicht": 0,
"gefahrgutFreigestMenge": "",
+
"artikelGruppe": "",
"gefahrgutKCode": "",
+
"artikelMenge": 0,
"gefahrgutKlasse": "",
+
"artikelServices": "",
"gefahrgutMenge": 0,
+
"artikelSollMenge": 0,
"gefahrgutMengenEinheit": "",
+
"artikelText1": "",
"gefahrgutNebenGefahr": "",
+
"artikelText2": "",
"gefahrgutNettoExplMasse": 0,
+
"artikelText3": "",
"gefahrgutTunnelBCode": "",
+
"artikelText4": "",
"gefahrgutUNNR": "",
+
"artikelVolumen": 0,
"gefahrgutUmweltGef": "",
+
"artikelWaehrung": "",
"gefahrgutVPG": "",
+
"artikelWert": 0,
"gefahrgutVerpAnzahl": 0,
+
"chargeFlag": "",
"gefahrgutVerpackungsart": ""
+
"kundenArtikelNr": "",
 +
"kundenBestellNr": "",
 +
"posAuftragNr": "",
 +
"posLieferNr": "",
 +
"positionNr": "",
 +
"serienNr": "",
 +
"ursprungLand": ""
 
}
 
}
 
],
 
],
"gewicht": 0,
+
"auftragNr": "",
"ilnNr": "",
+
"auftraggeberID": "",
"infotext1": "",
+
"avisHinweis1": "",
"infotext2": "",
+
"avisHinweis2": "",
"infotext3": "",
+
"avisZusatz1": "",
"infotext4": "",
+
"avisZusatz2": "",
"infotext5": "",
+
"bestellNr": "",
"infotext6": "",
+
"druckername": "",
"infotext7": "",
+
"email": "",
"infotext8": "",
+
"faxNr": "",
"infotext9": "",
+
"frachtBrief": "",
"infotext10": "",
+
"frachtfuehrerKdNr": "",
"kostenstelle": "",
+
"frankaturKennung": "",
"kundenNr": "",
+
"gefahrgut": [
"lieferscheinNr": "",
+
{
"nachnahme": 0,
+
"gefahrgutBefoerdKat": 0,
"nettoGewicht": 0,
+
"gefahrgutBegrenzteMenge": "",
"neutabsenderLKZ": "",
+
"gefahrgutBezeichnung": "",
"neutabsenderName1": "",
+
"gefahrgutBuchst640": "",
"neutabsenderName2": "",
+
"gefahrgutFFCode": "",
"neutabsenderName3": "",
+
"gefahrgutFaktor": 0,
"neutabsenderOrt": "",
+
"gefahrgutFreigestMenge": "",
"neutabsenderPLZ": "",
+
"gefahrgutKCode": "",
"neutabsenderStrasse": "",
+
"gefahrgutKlasse": "",
"nnVermerk": "",
+
"gefahrgutMenge": 0,
"nnVerwendung": "",
+
"gefahrgutMengenEinheit": "",
"nnWaehrung": "",
+
"gefahrgutNebenGefahr": "",
"packStkGes": 0,
+
"gefahrgutNettoExplMasse": 0,
"packStkNr": 0,
+
"gefahrgutTunnelBCode": "",
"packplatz": "",
+
"gefahrgutUNNR": "",
"packstueckBreite": 0,
+
"gefahrgutUmweltGef": "",
"packstueckHoehe": 0,
+
"gefahrgutVPG": "",
"packstueckID": "",
+
"gefahrgutVerpAnzahl": 0,
"packstueckLaenge": 0,
+
"gefahrgutVerpackungsart": ""
"paperlessInvoice": "",
+
}
"postLeitcode": "",
+
],
"postZielFrachtzent": "",
+
"gewicht": 0,
"rechnungsEmpfLKZ": "",
+
"ilnNr": "",
"rechnungsEmpfName1": "",
+
"infotext1": "",
"rechnungsEmpfName2": "",
+
"infotext2": "",
"rechnungsEmpfName3": "",
+
"infotext3": "",
"rechnungsEmpfOrt": "",
+
"infotext4": "",
"rechnungsEmpfPLZ": "",
+
"infotext5": "",
"rechnungsEmpfStrasse": "",
+
"infotext6": "",
"sendungsinhalt": "",
+
"infotext7": "",
"sonderdienste": "",
+
"infotext8": "",
"telefonNr": "",
+
"infotext9": "",
"terminArt": "",
+
"infotext10": "",
"terminDatum": "",
+
"kostenstelle": "",
"terminZeit": "",
+
"kundenNr": "",
"ustIDNr": "",
+
"lieferscheinNr": "",
"verpackungsart": "",
+
"nachnahme": 0,
"versandartID": "",
+
"nettoGewicht": 0,
"versicherungswert": 0,
+
"neutabsenderLKZ": "",
"vwWaehrung": "",
+
"neutabsenderName1": "",
"warenwert": 0,
+
"neutabsenderName2": "",
"wwWaehrung": "",
+
"neutabsenderName3": "",
"zahlungsbedingung": "",
+
"neutabsenderOrt": "",
"zbZoll": "",
+
"neutabsenderPLZ": "",
"zielAdrBahnhof": "",
+
"neutabsenderStrasse": "",
"zielAdrLKZ": "",
+
"nnVermerk": "",
"zielAdrName1": "",
+
"nnVerwendung": "",
"zielAdrName2": "",
+
"nnWaehrung": "",
"zielAdrName3": "",
+
"packStkGes": 0,
"zielAdrOrt": "",
+
"packStkNr": 0,
"zielAdrPLZ": "",
+
"packplatz": "",
"zielAdrRegion": "",
+
"packstueckBreite": 0,
"zielAdrStrasse": ""
+
"packstueckHoehe": 0,
}
+
"packstueckID": "",
</source>
+
"packstueckLaenge": 0,
;Response
+
"paperlessInvoice": "",
<source lang="json">
+
"postLeitcode": "",
{
+
"postZielFrachtzent": "",
"assoc": {
+
"rechnungsEmpfLKZ": "",
"":""
+
"rechnungsEmpfName1": "",
},
+
"rechnungsEmpfName2": "",
"packstueckID": "",
+
"rechnungsEmpfName3": "",
"trackingNr": "",
+
"rechnungsEmpfOrt": "",
"retourTrackingNr": "",
+
"rechnungsEmpfPLZ": "",
"versandSendungsNr": "",
+
"rechnungsEmpfStrasse": "",
"druckDateTime": "",
+
"sendungsinhalt": "",
"ausgangDateTime": "",
+
"sonderdienste": "",
"gebuehr": 0,
+
"telefonNr": "",
"gebuehrWaehrung": "",
+
"terminArt": "",
"fehlertext1": "",
+
"terminDatum": "",
"fehlertext2": "",
+
"terminZeit": "",
"etikettName": "",
+
"ustIDNr": "",
"etikettDaten": "",
+
"verpackungsart": "",
"zusatzEtikettenDaten": {
+
"versandartID": "",
"": ""
+
"versicherungswert": 0,
},
+
"vwWaehrung": "",
"trackingURL": "",
+
"warenwert": 0,
"zusatzfeld1": "",
+
"wwWaehrung": "",
"zusatzfeld2": "",
+
"zahlungsbedingung": "",
"zusatzfeld3": "",
+
"zbZoll": "",
"zusatzfeld4": "",
+
"zielAdrBahnhof": "",
"zusatzfeld5": "",
+
"zielAdrLKZ": "",
"zusatzfeld6": "",
+
"zielAdrName1": "",
"zusatzfeld7": "",
+
"zielAdrName2": "",
"zusatzfeld8": "",
+
"zielAdrName3": "",
"zusatzfeld9": "",
+
"zielAdrOrt": "",
"zusatzfeld10": ""
+
"zielAdrPLZ": "",
}
+
"zielAdrRegion": "",
 +
"zielAdrStrasse": ""
 +
}
 +
</source>
 +
;Response
 +
<source lang="json">
 +
{
 +
"druckDateTime": "",
 +
"fehlertext1": "",
 +
"fehlertext2": ""
 +
}
 
</source>
 
</source>
 
</div></div>
 
</div></div>
<!-- ------------------------------------------------------------------------------- ENDE Beispiel ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- ENDE versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
<!-- ------------------------------------------------------------------------------- ENDE versanddatenAnfrage ------------------------------------------------------------------------------- -->
+
<!-- ------------------------------------------------------------------------------- updateVersanddaten ------------------------------------------------------------------------------- -->
<!-- ------------------------------------------------------------------------------- versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- -->
 
  
== Etikett nachdrucken ==
+
== Packstückdaten aktualisieren ==
 +
<!--
 
Text anpassen
 
Text anpassen
 
<br>
 
<br>
Zeile 510: Zeile 643:
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird.
+
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
|-
 
|-
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
+
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
 
|-
 
|-
| '''packstueckID''' || [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
+
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
 
|-
 
|-
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
|}
 
</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|
+
| auftragNr || [[#Datentypen|String]] || 20 || - || -
 
|-
 
|-
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
|-
 
|-
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 
|-
 
|-
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
|-
 
|-
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
+
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
+
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
+
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
 
|-
 
|-
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
 
|-
 
|-
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
+
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
 
|-
 
|-
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
+
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
 
|-
 
|-
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
+
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
|-
 
|-
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
+
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
 
|-
 
|-
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
+
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
 
|-
 
|-
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
+
| 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)
 
|-
 
|-
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
+
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
 
|-
 
|-
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
+
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
 
|-
 
|-
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
 
|-
 
|-
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
 
|-
 
|-
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
|}
+
|-
</div></div>
+
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
<br>
+
|-
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
|-
<div class="mw-collapsible-content">
+
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
;Request
+
|-
<source lang="json">
+
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -
{
+
|-
"druckername": "",
+
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
"packplatz": "",
+
|-
"packstueckID": "",
+
| lieferantenID || [[#Datentypen|Integer]] || - || - || -
"trackingNr": ""
+
|-
}
+
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
</source>
+
|-
;Response
+
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
<source lang="json">
+
|-
{
+
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
"assoc": {
+
|-
"":""
+
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
},
+
|-
"packstueckID": "",
+
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
"trackingNr": "",
+
|-
"retourTrackingNr": "",
+
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt
"versandSendungsNr": "",
+
|-
"druckDateTime": "",
+
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
"ausgangDateTime": "",
+
|-
"gebuehr": 0,
+
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
"gebuehrWaehrung": "",
+
|-
"fehlertext1": "",
+
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
"fehlertext2": "",
 
"etikettName": "",
 
"etikettDaten": "",
 
"zusatzEtikettenDaten": {
 
"": ""
 
},
 
"trackingURL": "",
 
"zusatzfeld1": "",
 
"zusatzfeld2": "",
 
"zusatzfeld3": "",
 
"zusatzfeld4": "",
 
"zusatzfeld5": "",
 
"zusatzfeld6": "",
 
"zusatzfeld7": "",
 
"zusatzfeld8": "",
 
"zusatzfeld9": "",
 
"zusatzfeld10": ""
 
}
 
</source>
 
</div></div>
 
<!-- ------------------------------------------------------------------------------- ENDE versanddatenNachdruckAnfrage ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- stornoVersanddaten ------------------------------------------------------------------------------- -->
 
 
 
== 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
+
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
 
|-
 
|-
| packplatz|| [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
+
| 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
 
|-
 
|-
| '''packstueckID'''|| [[#Datentypen|String]] || 30 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
+
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
 
|-
 
|-
| trackingNr|| [[#Datentypen|String]] || 35 || - || Paketnummer
+
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
|}
 
</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
+
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
 
|-
 
|-
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
 
|-
 
|-
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
 
|-
 
|-
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
|}
+
|-
</div></div>
+
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
<br>
+
|-
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
|-
<div class="mw-collapsible-content">
+
| '''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.
;Request
+
|-
<source lang="json">
+
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
{
+
|-
"packplatz": "",
+
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
"packstueckID": "",
+
|-
"trackingNr": ""
+
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
}
+
|-
</source>
+
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
;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"
 
 
|-
 
|-
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
 
|-
 
|-
| auftraggeberID || [[#Datentypen|String]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
+
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
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.
+
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
(Benötigt Druckerspooler Erweiterungsmodul)
 
 
|-
 
|-
| frachtfuehrerTyp || [[#Datentypen|String]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".
+
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
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.
+
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
 +
|-
 +
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
 
|-
 
|-
| versandartID || [[#Datentypen|String]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.
+
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
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.
+
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
|}
 
</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
+
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
 
|-
 
|-
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
 
|-
 
|-
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
 
|-
 
|-
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
 
|-
 
|-
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
+
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
 
|-
 
|-
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Listen als Key/Value Map.
+
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
 
|-
 
|-
| etikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Etiketten als Key/Value Map.
+
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
|}
+
|-
</div></div>
+
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
<br>
+
|-
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
|-
<div class="mw-collapsible-content">
+
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
;Request
+
|-
<source lang="json">
+
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
{
+
|-
"auftraggeberID": [
+
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
""
+
|-
],
+
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
"druckername": "",
+
|-
"frachtfuehrerTyp": [
+
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
""
+
|-
],
+
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird
"packplatz": "",
+
|-
"versandartID": [
+
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
""
+
|-
],
+
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
"wechselbruecke": ""
+
|-
}
+
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
</source>
+
|-
;Response
+
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
<source lang="json">
+
|-
{
+
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
"assoc": {
+
|-
"":""
+
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
},
+
|-
"fehlercode": 0,
+
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
"fehlertext1": "",
+
|-
"listenDaten": {
+
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
"": ""
+
|-
}
+
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
}
+
|-
</source>
+
| '''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 Listenabschluss ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- ediabschlussAnfrage ------------------------------------------------------------------------------- -->
 
 
== Frachtführer DFÜ erzeugen ==
 
Text anpassen
 
<br>
 
<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;">'''Übergabe Parameter'''</div>
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe 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|
 
|-
 
|-
| auftraggeberID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste der Auftraggeber für die der Tagesabschluss durchgeführt wird.<br>
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
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>
+
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
(Benötigt Druckerspooler Erweiterungsmodul)
 
 
|-
 
|-
| frachtfuehrerTyp || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste mit Name des Frachtführertyps. Z.B.: "DPD", "GLS", etc. oder "ALLE".<br>
+
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
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.
+
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
| versandartID || [[#Datentypen|Sequence]] [[#Datentypen|<String>]] || 255 || - || Liste der Versandarten für die ein Tagesabschluss durchgeführt wird.<br>
+
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
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.
+
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
|}
 
</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
+
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
 
|-
 
|-
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
 
|-
 
|-
| [[#edistatus|edistatus]] || [[#Datentypen|Sequence]] [[#edistatus|<EDIStatus>]] || - || - || Liste mit Statusinformationen für EDIs.
+
| 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
 
|-
 
|-
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 = Erfolgreich
+
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
 
|-
 
|-
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
 
|-
 
|-
| listenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der EDI-Listen (z.B. UPS Summary) als Key/Value Map.
+
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
|}
+
|-
</div></div>
+
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
<br>
+
|-
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
|-
<div class="mw-collapsible-content">
+
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
;Request
+
|-
<source lang="json">
+
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
{
+
|-
"auftraggeberID": [
+
| 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
"druckername": "",
+
|-
"frachtfuehrerTyp": [
+
| 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
"packplatz": "",
+
|-
"versandartID": [
+
| 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
"wechselbruecke": ""
+
|}
}
+
</div></div>
</source>
+
<br>
;Response
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
<source lang="json">
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
{
+
<div class="mw-collapsible-content">
"assoc": {
+
;Request
"":""
+
<source lang="json">
},
+
{
"fehlercode": 0,
+
"ansprechpartner": "",
"fehlertext1": "",
+
"anzahlArtikel": 0,
"edistatus": [
+
"artikelDaten": [
 
{
 
{
"fehlercode": 0,
+
"anzahlBuegel": 0,
"statuscode": "",
+
"anzahlPosEtiketten": 0,
"statustext": "",
+
"artikelBTNNr": "",
"fftyp": "",
+
"artikelEAN": "",
"dateityp": "",
+
"artikelEinheit": "",
"auftraggeber": "",
+
"artikelGewicht": 0,
"ffdateinr": ""
+
"artikelGruppe": "",
 +
"artikelMenge": 0,
 +
"artikelServices": "",
 +
"artikelSollMenge": 0,
 +
"artikelText1": "",
 +
"artikelText2": "",
 +
"artikelText3": "",
 +
"artikelText4": "",
 +
"artikelVolumen": 0,
 +
"artikelWaehrung": "",
 +
"artikelWert": 0,
 +
"chargeFlag": "",
 +
"kundenArtikelNr": "",
 +
"kundenBestellNr": "",
 +
"posAuftragNr": "",
 +
"posLieferNr": "",
 +
"positionNr": "",
 +
"serienNr": "",
 +
"ursprungLand": ""
 
}
 
}
 
],
 
],
"listenDaten": {}
+
"auftragNr": "",
}
+
"auftraggeberID": "",
</source>
+
"avisHinweis1": "",
</div></div>
+
"avisHinweis2": "",
<!-- ------------------------------------------------------------------------------- ENDE ediabschlussAnfrage ------------------------------------------------------------------------------- -->
+
"avisZusatz1": "",
<!-- ------------------------------------------------------------------------------- versanddatenPruefAnfrage ------------------------------------------------------------------------------- -->
+
"avisZusatz2": "",
 
+
"barcodeID": "",
== Packstückdaten aktualisieren ==
+
"barcodeText": "",
Text anpassen
+
"barcodeTyp": "",
<br>
+
"bestellNr": "",
<br>
+
"druckername": "",
<br>
+
"email": "",
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"empfMobilfunkNr": "",
<div style="font-weight:bold;line-height:1.6;">'''Übergabe Parameter'''</div>
+
"faxNr": "",
<div class="mw-collapsible-content">
+
"flexZustellungEmailadResponsese": "",
<small>'''Fett''' dargestellte Felder müssen IMMER belegt sein</small>
+
"frachtBrief": "",
{| class="wikitable sortable"
+
"frachtfuehrerKdNr": "",
|-
+
"frankaturKennung": "",
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
"gefahrgut": [
|-
+
{
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
+
"gefahrgutBefoerdKat": 0,
|-
+
"gefahrgutBegrenzteMenge": "",
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
+
"gefahrgutBezeichnung": "",
|-
+
"gefahrgutBuchst640": "",
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
"gefahrgutFFCode": "",
|-
+
"gefahrgutFaktor": 0,
| auftragNr || [[#Datentypen|String]] || 20 || - || -
+
"gefahrgutFreigestMenge": "",
|-
+
"gefahrgutKCode": "",
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
+
"gefahrgutKlasse": "",
|-
+
"gefahrgutMenge": 0,
| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+
"gefahrgutMengenEinheit": "",
|-
+
"gefahrgutNebenGefahr": "",
| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+
"gefahrgutNettoExplMasse": 0,
|-
+
"gefahrgutTunnelBCode": "",
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+
"gefahrgutUNNR": "",
|-
+
"gefahrgutUmweltGef": "",
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+
"gefahrgutVPG": "",
|-
+
"gefahrgutVerpAnzahl": 0,
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
+
"gefahrgutVerpackungsart": ""
|-
+
}
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
+
],
|-
+
"gewicht": 0,
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
+
"hostTrackingNr": "",
|-
+
"ilnNr": "",
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
+
"infotext1": "",
|-
+
"infotext2": "",
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
+
"infotext3": "",
|-
+
"infotext4": "",
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
+
"infotext5": "",
|-
+
"infotext6": "",
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
+
"infotext7": "",
|-
+
"infotext8": "",
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
+
"infotext9": "",
|-
+
"infotext10": "",
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
+
"kostenstelle": "",
|-
+
"kundenNr": "",
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+
"lagerkennzeichen": 0,
|-
+
"letztesPackstueck": "",
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
+
"lieferantenID": 0,
|-
+
"lieferscheinNr": "",
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"nachnahme": 0,
|-
+
"nettoGewicht": 0,
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"neutBIC": "",
|-
+
"neutBankBezeichnung": "",
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"neutIBAN": "",
|-
+
"neutKontoInhaber": "",
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"neutabsenderLKZ": "",
|-
+
"neutabsenderName1": "",
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"neutabsenderName2": "",
|-
+
"neutabsenderName3": "",
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"neutabsenderOrt": "",
|-
+
"neutabsenderPLZ": "",
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"neutabsenderStrasse": "",
|-
+
"nnVermerk": "",
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"nnVerwendung": "",
|-
+
"nnWaehrung": "",
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"packStkGes": 0,
|-
+
"packStkNr": 0,
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"packplatz": "",
|-
+
"packstueckBreite": 0,
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
+
"packstueckHoehe": 0,
|-
+
"packstueckID": "",
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
+
"packstueckLaenge": 0,
|-
+
"paperlessInvoice": "",
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
+
"postLeitcode": "",
|-
+
"postZielFrachtzent": "",
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
+
"rechnungsEmpfLKZ": "",
|-
+
"rechnungsEmpfName1": "",
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
+
"rechnungsEmpfName2": "",
|-
+
"rechnungsEmpfName3": "",
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
+
"rechnungsEmpfOrt": "",
|-
+
"rechnungsEmpfPLZ": "",
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
"rechnungsEmpfStrasse": "",
|-
+
"rechnungsNr": "",
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
"sendungsinhalt": "",
|-
+
"sonderdienste": "",
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
"sperrFlag": "",
|-
+
"telefonNr": "",
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
"terminArt": "",
|-
+
"terminDatum": "",
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
+
"terminZeit": "",
|-
+
"ustIDNr": "",
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
"verpackungsart": "",
|-
+
"versandartID": "",
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
+
"versicherungswert": 0,
|-
+
"vorpackdatum": "",
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
+
"vwWaehrung": "",
|-
+
"warenwert": 0,
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
+
"wechselbruecke": "",
|-
+
"wwWaehrung": "",
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
+
"zahlungsbedingung": "",
|-
+
"zbZoll": "",
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
+
"zielAdrBahnhof": "",
|-
+
"zielAdrLKZ": "",
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
+
"zielAdrName1": "",
|-
+
"zielAdrName2": "",
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
+
"zielAdrName3": "",
|-
+
"zielAdrName4": "",
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
+
"zielAdrOrt": "",
|-
+
"zielAdrPLZ": "",
| 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.
+
"zielAdrRegion": "",
|-
+
"zielAdrStrasse": ""
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
+
}
|-
+
</source>
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
+
;Response
|-
+
<source lang="json">
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
+
{
|-
+
"packstueckID": "",
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
+
"trackingNr": "",
|-
+
"retourTrackingNr": "",
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
+
"versandSendungsNr": "",
|-
+
"druckDateTime": "",
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"ausgangDateTime": "",
|-
+
"gebuehrWaehrung": "",
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"fehlercode": 0,
|-
+
"fehlertext1": "",
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"fehlertext2": "",
|-
+
"etikettName": "",
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
"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"
 
|-
 
|-
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
+
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung
 
|-
 
|-
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
| auftragsNr || [[#Datentypen|String]] || 20 || - || -
 
|-
 
|-
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
+
| lieferscheinNr || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.
 
|-
 
|-
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
 
|-
 
|-
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
+
| packstueckID || [[#Datentypen|String]] || 20 || - || '''Eindeutige''' Nummer für das Paket im Vorsystem.
 
|-
 
|-
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
+
| 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"
 
|-
 
|-
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
+
! Feldname !! Typ !! Max Länge !! Nachkommastellen !! Belegung
 
|-
 
|-
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
|-
+
|}
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
+
</div></div>
|-
+
<br>
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
+
<div class="mw-collapsible-content">
|-
+
;Request
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
+
<source lang="json">
|-
+
{
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
+
"auftragNr": "",
|-
+
"lieferscheinNr": "",
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
+
"packplatz": "",
|-
+
"packstueckID": "",
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
+
"trackingNr": ""
|-
+
}
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
+
</source>
|-
+
;Response
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
+
<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"
 
|-
 
|-
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
 
|-
 
|-
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| ansprechpartner || [[#Datentypen|String]] || 20 || - || Empfänger Ansprechpartner
 
|-
 
|-
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
 
|-
 
|-
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| auftragNr || [[#Datentypen|String]] || 20 || - || -
 
|-
 
|-
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
 
|-
 
|-
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| ausschlussFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Ausschluss-Frachtführer für SPM Anfrage
 +
|-
 +
| avisHinweis1 || [[#Datentypen|String]] || 100 || - || -
 +
|-
 +
| avisHinweis2 || [[#Datentypen|String]] || 100 || - || -
 
|-
 
|-
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
+
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
 
|-
 
|-
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
+
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
 
|-
 
|-
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
| bestellNr || [[#Datentypen|String]] || 20 || - || -
|}
 
</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|-
+
| email || [[#Datentypen|String]] || 100 || - || Für automatische Mailavisierung
 
|-
 
|-
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
 
|-
 
|-
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
 
|-
 
|-
| fehlertext1 || [[#Datentypen|String]] || 200 || - || -
+
| flexZustellungEmailadResponsese || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Email-Adresse
 
|-
 
|-
| fehlertext2 || [[#Datentypen|String]] || 200 || - || -
+
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer, falls Frachtbrief durch Vorsystem gedruckt wird.
|}
+
|-
</div></div>
+
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer.
<br>
+
|-
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
+
|-
<div class="mw-collapsible-content">
+
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
;Request
+
|-
<source lang="json">
+
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
{
+
|-
"ansprechpartner": "",
+
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
"artikelDaten": [
+
|-
{
+
 
"anzahlBuegel": 0,
+
|-
"anzahlPosEtiketten": 0,
+
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet.
"artikelBTNNr": "",
+
|-
"artikelEAN": "",
+
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
"artikelEinheit": "",
+
|-
"artikelGewicht": 0,
+
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
"artikelGruppe": "",
+
|-
"artikelMenge": 0,
+
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt
"artikelServices": "",
+
|-
"artikelSollMenge": 0,
+
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
"artikelText1": "",
+
|-
"artikelText2": "",
+
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
"artikelText3": "",
+
|-
"artikelText4": "",
+
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
"artikelVolumen": 0,
+
|-
"artikelWaehrung": "",
+
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
"artikelWert": 0,
+
|-
"chargeFlag": "",
+
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
"kundenArtikelNr": "",
+
|-
"kundenBestellNr": "",
+
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
"posAuftragNr": "",
+
|-
"posLieferNr": "",
+
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
"positionNr": "",
+
|-
"serienNr": "",
+
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
"ursprungLand": ""
+
|-
}
+
| '''packStkGes''' || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
],
+
|-
"auftragNr": "",
+
| [[#packstueckDaten|packstueckDaten]] || [[#Datentypen|Sequence]] [[#packstueckDaten|<PackStueckDaten>]] || - || - || -
"auftraggeberID": "",
+
|-
"avisHinweis1": "",
+
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
"avisHinweis2": "",
+
|-
"avisZusatz1": "",
+
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
"avisZusatz2": "",
+
|-
"bestellNr": "",
+
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
"druckername": "",
+
|-
"email": "",
+
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
"faxNr": "",
+
|-
"frachtBrief": "",
+
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
"frachtfuehrerKdNr": "",
+
|-
"frankaturKennung": "",
+
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
"gefahrgut": [
+
|-
{
+
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
"gefahrgutBefoerdKat": 0,
+
|-
"gefahrgutBegrenzteMenge": "",
+
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
"gefahrgutBezeichnung": "",
+
|-
"gefahrgutBuchst640": "",
+
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
"gefahrgutFFCode": "",
+
|-
"gefahrgutFaktor": 0,
+
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
"gefahrgutFreigestMenge": "",
+
|-
"gefahrgutKCode": "",
+
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
"gefahrgutKlasse": "",
+
|-
"gefahrgutMenge": 0,
+
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
"gefahrgutMengenEinheit": "",
+
|-
"gefahrgutNebenGefahr": "",
+
| requestSPM || [[#Datentypen|String]] || 5 || - || T/TRUE wenn die Entscheidungsmatrix angesprochen werden soll, sonst leer
"gefahrgutNettoExplMasse": 0,
+
|-
"gefahrgutTunnelBCode": "",
+
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
"gefahrgutUNNR": "",
+
|-
"gefahrgutUmweltGef": "",
+
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
"gefahrgutVPG": "",
+
|-
"gefahrgutVerpAnzahl": 0,
+
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
"gefahrgutVerpackungsart": ""
+
|-
}
+
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
],
+
|-
"gewicht": 0,
+
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
"ilnNr": "",
+
|-
"infotext1": "",
+
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
"infotext2": "",
+
|-
"infotext3": "",
+
| terminZeit || [[#Datentypen|String]] || 5 || - || HH:MM
"infotext4": "",
+
|-
"infotext5": "",
+
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
"infotext6": "",
+
|-
"infotext7": "",
+
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
"infotext8": "",
+
|-
"infotext9": "",
+
| vorgabeFrachtfuehrer || [[#Datentypen|String]] || 20 || - || Vorgabe-Frachtführer für [[Shipment_Policy_Manager_(Tarifwerk)|SPM]] Anfrage
"infotext10": "",
+
|-
"kostenstelle": "",
+
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
"kundenNr": "",
+
|-
"lieferscheinNr": "",
+
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen werden soll
"nachnahme": 0,
+
|-
"nettoGewicht": 0,
+
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
"neutabsenderLKZ": "",
+
|-
"neutabsenderName1": "",
+
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
"neutabsenderName2": "",
+
|-
"neutabsenderName3": "",
+
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort des Bahnhofs
"neutabsenderOrt": "",
+
|-
"neutabsenderPLZ": "",
+
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Länderkennzeichen (LKZ)
"neutabsenderStrasse": "",
+
|-
"nnVermerk": "",
+
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
"nnVerwendung": "",
+
|-
"nnWaehrung": "",
+
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
"packStkGes": 0,
+
|-
"packStkNr": 0,
+
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
"packplatz": "",
+
|-
"packstueckBreite": 0,
+
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
"packstueckHoehe": 0,
+
|-
"packstueckID": "",
+
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
"packstueckLaenge": 0,
+
|-
"paperlessInvoice": "",
+
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
"postLeitcode": "",
+
|-
"postZielFrachtzent": "",
+
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
"rechnungsEmpfLKZ": "",
+
|-
"rechnungsEmpfName1": "",
+
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
"rechnungsEmpfName2": "",
+
|}
"rechnungsEmpfName3": "",
+
</div></div>
"rechnungsEmpfOrt": "",
+
<br>
"rechnungsEmpfPLZ": "",
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
"rechnungsEmpfStrasse": "",
+
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
"sendungsinhalt": "",
+
<div class="mw-collapsible-content">
"sonderdienste": "",
+
{| class="wikitable sortable"
"telefonNr": "",
+
|-
"terminArt": "",
+
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
"terminDatum": "",
+
|-
"terminZeit": "",
+
| fehler || [[#Datentypen|String]] || - || - || Wird im Fehlerfall befüllt
"ustIDNr": "",
+
|-
"verpackungsart": "",
+
| sendungsGebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachkosten
"versandartID": "",
+
|-
"versicherungswert": 0,
+
| sendungsGebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
"vwWaehrung": "",
+
|-
"warenwert": 0,
+
| versandSendungsNr || [[#Datentypen|String]] || 20 || - || Sendungsnummer
"wwWaehrung": "",
+
|}
"zahlungsbedingung": "",
+
 
"zbZoll": "",
+
;Packstückdaten
"zielAdrBahnhof": "",
+
{| class="wikitable sortable"
"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"
 
 
|-
 
|-
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung
+
! 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)
 
|-
 
|-
| anzahlArtikel || [[#Datentypen|Integer]] || 6 || - || Anzahl Artikel (Druck auf Etikett)
+
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 
|-
 
|-
| [[#artikelDaten|artikelDaten]] || [[#Datentypen|Sequence]] '''[[#artikelDaten|<ArtikelDaten>]]''' || - || - || Eine Liste der [[#artikelDaten|Packstück-Artikel]] vom Typ '''[[#artikelDaten|ArtikelDaten]]''' (1:n)
+
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
 
|-
 
|-
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
| auftragNr || [[#Datentypen|String]] || 20 || - || -
+
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
 
|-
 
|-
| '''auftraggeberID''' || [[#Datentypen|String]] || 10 || - || Mandantenkennung aus dem HVS32
+
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
 
|-
 
|-
| avisHinweis1 || [[#Datentypen|String]] || 30 || - || -
+
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
 
|-
 
|-
| avisHinweis2 || [[#Datentypen|String]] || 30 || - || -
+
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
 
|-
 
|-
| avisZusatz1 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 1
+
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
| avisZusatz2 || [[#Datentypen|String]] || 20 || - || Zusatz zu Fest-AVIS-Schlüssel 2
+
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
 
|-
 
|-
| barcodeID || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
 
|-
 
|-
| barcodeText || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
 
|-
 
|-
| barcodeTyp || [[#Datentypen|String]] || - || - || Zusatzfeld für evtl. Erweiterungen
+
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
 
|-
 
|-
| bestellNr || [[#Datentypen|String]] || 20 || - || Metro-Bestellnr (Metro-Versand)
+
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
 
|-
 
|-
| druckername || [[#Datentypen|String]] || 30 || - || Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedruckt wird. (Benötigt Druckerspooler Erweiterungsmodul)
+
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
 
|-
 
|-
| email || [[#Datentypen|String]] || 100 || - || E-Mail Adresse des Empfängers (z.B.: für die Automatische E-Mail Avisierung)
+
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
 
|-
 
|-
| empfMobilfunkNr || [[#Datentypen|String]] || 20 || - || Mobilfunknummer des Empfängers
+
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
 
|-
 
|-
| faxNr || [[#Datentypen|String]] || 20 || - || Faxnummer des Empfängers
+
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
| flexZustellungEmailadresse || [[#Datentypen|String]] || 80 || - || Flex-Zustellung Emailadresse
+
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
| frachtBrief || [[#Datentypen|String]] || 20 || - || Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
+
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
| frachtfuehrerKdNr || [[#Datentypen|String]] || 10 || - || Kundennummer des Frachtzahlers beim Frachtführer
+
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
| frankaturKennung || [[#Datentypen|String]] || 10 || - || -
+
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
| [[#gefahrgut|gefahrgut]] || [[#Datentypen|Sequence]] '''[[#gefahrgut|<Gefahrgut>]]''' || - || - || Eine Liste der [[#gefahrgut|Gefahrgüter]] vom Typ '''[[#gefahrgut|Gefahrgut]]''' (1:n)
+
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
| gewicht || [[#Datentypen|Decimal]] || 8 || 3 || Bruttogewicht in KG
+
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
| hostTrackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer aus dem Hostsystem
+
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
| ilnNr || [[#Datentypen|String]] || 20 || - || ILN des Empfängers (Pflicht bei Metro-Versand)
+
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
 
|-
 
|-
| infotext1 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
|-
+
|}
| infotext2 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
</div></div>
|-
+
<br>
| infotext3 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
|-
+
<div style="font-weight:bold;line-height:1.6;">'''Beispiele'''</div>
| infotext4 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
<div class="mw-collapsible-content">
|-
+
;Request
| infotext5 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
<source lang="json">
|-
+
{
| infotext6 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"ansprechpartner": "",
|-
+
"assoc": {
| infotext7 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"":""
|-
+
},
| infotext8 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"auftragNr": "",
|-
+
"auftraggeberID": "",
| infotext9 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"ausschlussFrachtfuehrer": "",
|-
+
"avisHinweis1": "",
| infotext10 || [[#Datentypen|String]] || 150 || - || Zusatzfeld für evtl. Erweiterungen
+
"avisHinweis2": "",
|-
+
"avisZusatz1": "",
| kostenstelle || [[#Datentypen|String]] || 30 || - || -
+
"avisZusatz2": "",
|-
+
"bestellNr": "",
| kundenNr || [[#Datentypen|String]] || 20 || - || Kundennummer des Empfängers beim Versender
+
"email": "",
|-
+
"empfMobilfunkNr": "",
| lagerkennzeichen || [[#Datentypen|Integer]] || - || - || -
+
"faxNr": "",
|-
+
"flexZustellungEmailadResponsese": "",
| letztesPackstueck || [[#Datentypen|String]] || 1 || - || T/F: T=letztes Packstüeck der Sendung (wird bei Hängeversand zum Drucken der Sendungs-Hängekarte benötigt)
+
"frachtBrief": "",
|-
+
"frachtfuehrerKdNr": "",
| lieferantenID || [[#Datentypen|Integer]] || - || - || -
+
"frankaturKennung": "",
|-
+
"ilnNr": "",
| '''lieferscheinNr''' || [[#Datentypen|String]] || 40 || - || Wird im HVS32 als Such-Nummer verwendet
+
"kostenstelle": "",
|-
+
"kundenNr": "",
| nachnahme || [[#Datentypen|Decimal]] || 18 || 2 || -
+
"Lagerkennzeichen": 0,
|-
+
"LieferantenID": 0,
| nettoGewicht || [[#Datentypen|Decimal]] || 8 || 3 || Nettogewicht in KG
+
"lieferscheinNr": "",
|-
+
"neutBIC": "",
| neutBIC || [[#Datentypen|String]] || 11 || - || Nur bei Neutral-Absendern belegt
+
"neutBankBezeichnung": "",
|-
+
"neutIBAN": "",
| neutBankBezeichnung || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
+
"neutKontoInhaber": "",
|-
+
"neutabsenderLKZ": "",
| neutIBAN || [[#Datentypen|String]] || 31 || - || Nur bei Neutral-Absendern belegt
+
"neutabsenderName1": "",
|-
+
"neutabsenderName2": "",
| neutKontoInhaber || [[#Datentypen|String]] || 40 || - || Nur bei Neutral-Absendern belegt
+
"neutabsenderName3": "",
|-
+
"neutabsenderOrt": "",
| neutabsenderLKZ || [[#Datentypen|String]] || 3 || - || Nur bei Neutral-Absendern belegt
+
"neutabsenderPLZ": "",
|-
+
"neutabsenderStrasse": "",
| neutabsenderName1 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
"packStkGes": 0,
|-
+
"packStueckDaten": [
| neutabsenderName2 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
{
|-
+
"anzahlArtikel": 0,
| neutabsenderName3 || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
"assoc": {
|-
+
"":""
| neutabsenderOrt || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
},
|-
+
"artikelDaten": [
| neutabsenderPLZ || [[#Datentypen|String]] || 10 || - || Nur bei Neutral-Absendern belegt
+
{
|-
+
"anzahlBuegel": 0,
| neutabsenderStrasse || [[#Datentypen|String]] || 50 || - || Nur bei Neutral-Absendern belegt
+
"anzahlPosEtiketten": 0,
|-
+
"artikelBTNNr": "",
| nnVermerk || [[#Datentypen|String]] || 1 || - || B': Bar / 'V': Verrechnungsscheck
+
"artikelEAN": "",
|-
+
"artikelEinheit": "",
| nnVerwendung || [[#Datentypen|String]] || 30 || - || Nachnahme Verwendungszweck
+
"artikelGewicht": 0,
|-
+
"artikelGruppe": "",
| nnWaehrung || [[#Datentypen|String]] || 3 || - || Nachnahme - ISO-Währungscode
+
"artikelMenge": 0,
|-
+
"artikelServices": "",
| packStkGes || [[#Datentypen|Integer]] || - || - || Gesamt-Anzahl Colli der Sendung
+
"artikelSollMenge": 0,
|-
+
"artikelText1": "",
| packStkNr || [[#Datentypen|Integer]] || - || - || Laufende Nr pro Sendung
+
"artikelText2": "",
|-
+
"artikelText3": "",
| packplatz || [[#Datentypen|String]] || 10 || - || HVS32-Packplatz-Client, der den Auftrag verarbeten soll.
+
"artikelText4": "",
|-
+
"artikelVolumen": 0,
| packstueckBreite || [[#Datentypen|Integer]] || - || - || Breite in cm
+
"artikelWaehrung": "",
|-
+
"artikelWert": 0,
| packstueckHoehe || [[#Datentypen|Integer]] || - || - || Höhe in cm
+
"chargeFlag": "",
|-
+
"kundenArtikelNr": "",
| '''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.
+
"kundenBestellNr": "",
|-
+
"posAuftragNr": "",
| packstueckLaenge || [[#Datentypen|Integer]] || - || - || Länge in cm
+
"posLieferNr": "",
|-
+
"positionNr": "",
| paperlessInvoice || [[#Datentypen|String]] || 1 || - || Nur im UPS PaperlessInvoice Fall (T=PaperlessInvoice / F=nicht PaperlessInvoice)
+
"serienNr": "",
|-
+
"ursprungLand": ""
| postLeitcode || [[#Datentypen|String]] || 15 || - || -
+
}
|-
+
],
| postZielFrachtzent || [[#Datentypen|String]] || 5 || - || -
+
"barcodeID": "",
|-
+
"barcodeText": "",
| rechnungsEmpfLKZ || [[#Datentypen|String]] || 5 || - || Rechnungsadresse
+
"barcodeTyp": "",
|-
+
"druckername": "",
| rechnungsEmpfName1 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"gefahrgut": [
|-
+
{
| rechnungsEmpfName2 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"gefahrgutBefoerdKat": 0,
|-
+
"gefahrgutBegrenzteMenge": "",
| rechnungsEmpfName3 || [[#Datentypen|String]] || 50 || - || Rechnungsempfänger
+
"gefahrgutBezeichnung": "",
|-
+
"gefahrgutBuchst640": "",
| rechnungsEmpfOrt || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
"gefahrgutFFCode": "",
|-
+
"gefahrgutFaktor": 0,
| rechnungsEmpfPLZ || [[#Datentypen|String]] || 10 || - || Rechnungsadresse
+
"gefahrgutFreigestMenge": "",
|-
+
"gefahrgutKCode": "",
| rechnungsEmpfStrasse || [[#Datentypen|String]] || 50 || - || Rechnungsadresse
+
"gefahrgutKlasse": "",
|-
+
"gefahrgutMenge": 0,
| rechnungsNr || [[#Datentypen|String]] || 20 || - || Rechnungsnummer
+
"gefahrgutMengenEinheit": "",
|-
+
"gefahrgutNebenGefahr": "",
| sendungsinhalt || [[#Datentypen|String]] || 30 || - || -
+
"gefahrgutNettoExplMasse": 0,
|-
+
"gefahrgutTunnelBCode": "",
| sonderdienste || [[#Datentypen|String]] || 30 || - || Versandart-spezifisch belegt
+
"gefahrgutUNNR": "",
|-
+
"gefahrgutUmweltGef": "",
| sperrFlag || [[#Datentypen|String]] || 1 || - || T/F: T=Sperren, sonst nicht sperren
+
"gefahrgutVPG": "",
|-
+
"gefahrgutVerpAnzahl": 0,
| telefonNr || [[#Datentypen|String]] || 20 || - || Telefonnummer des Empfängers
+
"gefahrgutVerpackungsart": ""
|-
+
}
| terminArt || [[#Datentypen|String]] || 1 || - || 'A'b / 'B'is / 'F'ix
+
],
|-
+
"gewicht": 0,
| terminDatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
+
"hostTrackingNr": "",
|-
+
"infotext1": "",
| terminZeit || [[#Datentypen|Calendar]] || 5 || - || HH:MM
+
"infotext10": "",
|-
+
"infotext2": "",
| ustIDNr || [[#Datentypen|String]] || 20 || - || UmsatzsteuerNr des Empfängers
+
"infotext3": "",
|-
+
"infotext4": "",
| verpackungsart || [[#Datentypen|String]] || 6 || - || -
+
"infotext5": "",
|-
+
"infotext6": "",
| '''versandartID''' || [[#Datentypen|String]] || 10 || - || Versandartkennung aus dem HVS32
+
"infotext7": "",
|-
+
"infotext8": "",
| versicherungswert || [[#Datentypen|Decimal]] || 18 || 2 || Höhe Versicherungswert
+
"infotext9": "",
|-
+
"letztesPackstueck": "",
| vorpackdatum || [[#Datentypen|String]] || 10 || - || TT.MM.JJJJ
+
"nachnahme": 0,
|-
+
"nettoGewicht": 0,
| vwWaehrung || [[#Datentypen|String]] || 3 || - || Versicherungswert - ISO-Währungscode
+
"nnVermerk": "",
|-
+
"nnVerwendung": "",
| warenwert || [[#Datentypen|Decimal]] || 18 || 2 || -
+
"nnWaehrung": "",
|-
+
"packStkNr": 0,
| wechselbruecke || [[#Datentypen|String]] || 20 || - || Wechselbrücke, die diesem Packstück zugewiesen wird
+
"packstueckBreite": 0,
|-
+
"packstueckHoehe": 0,
| wwWaehrung || [[#Datentypen|String]] || 3 || - || Warenwert - ISO-Währungscode
+
"packstueckID": "",
|-
+
"packstueckLaenge": 0,
| zahlungsbedingung || [[#Datentypen|String]] || 10 || - || 'S' = Sender, 'R' = Empfänger
+
"verpackungsart": "",
|-
+
"versicherungswert": 0,
| zbZoll || [[#Datentypen|String]] || 1 || - || Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
+
"vwWaehrung": "",
|-
+
"warenwert": 0,
| zielAdrBahnhof || [[#Datentypen|String]] || 30 || - || PLZ und Ort
+
"wwWaehrung": ""
|-
+
}
| '''zielAdrLKZ''' || [[#Datentypen|String]] || 5 || - || Lieferadresse
+
],
|-
+
"packplatz": "",
| '''zielAdrName1''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"paperlessInvoice": "",
|-
+
"postLeitcode": "",
| zielAdrName2 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"postZielFrachtzent": "",
|-
+
"rechnungsEmpfLKZ": "",
| zielAdrName3 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"rechnungsEmpfName1": "",
|-
+
"rechnungsEmpfName2": "",
| zielAdrName4 || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"rechnungsEmpfName3": "",
|-
+
"rechnungsEmpfOrt": "",
| '''zielAdrOrt''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"rechnungsEmpfPLZ": "",
|-
+
"rechnungsEmpfStrasse": "",
| '''zielAdrPLZ''' || [[#Datentypen|String]] || 10 || - || Lieferadresse
+
"rechnungsNr": "",
|-
+
"RequestuestSPM": "",
| zielAdrRegion || [[#Datentypen|String]] || 20 || - || Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
+
"sendungsinhalt": "",
|-
+
"sonderdienste": "",
| '''zielAdrStrasse''' || [[#Datentypen|String]] || 50 || - || Lieferadresse
+
"sperrFlag": "",
|}
+
"telefonNr": "",
</div></div>
+
"terminArt": "",
<br>
+
"terminDatum": "",
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;">
+
"terminZeit": "",
<div style="font-weight:bold;line-height:1.6;">'''Rückgabe Parameter'''</div>
+
"ustIDNr": "",
<div class="mw-collapsible-content">
+
"versandartID": "",
{| class="wikitable sortable"
+
"vorgabeFrachtfuehrer": "",
|-
+
"vorpackdatum": "",
! Feldname !! Typ !! Max Länge !! Dezimalstellen !! Belegung|
+
"wechselbruecke": "",
|-
+
"zahlungsbedingung": "",
| assoc || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Zusatzfeld für evtl. Erweiterungen (Key=Feldname / Value=Wert)
+
"zbZoll": "",
|-
+
"zielAdrBahnhof": "",
| ausgangDateTime || [[#Datentypen|Calendar]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
"zielAdrLKZ": "",
|-
+
"zielAdrName1": "",
| ausgangDateTimeString || [[#Datentypen|String]] || 10 || - || Datum, wann das Etikett an den Frachtführer übermittelt worden ist (TT.MM.JJJJ)
+
"zielAdrName2": "",
|-
+
"zielAdrName3": "",
| druckDateTime || [[#Datentypen|Calendar]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
"zielAdrName4": "",
|-
+
"zielAdrOrt": "",
| druckDateTimeString || [[#Datentypen|String]] || 19 || - || Datum, wann das Etikett im HVS32 gedruckt worden ist (TT.MM.JJJJ HH:mm:SS)
+
"zielAdrPLZ": "",
|-
+
"zielAdrRegion": "",
| etikettDaten || [[#Datentypen|String]] || - || - || Binärdaten des Etiketts
+
"zielAdrStrasse": ""
|-
+
}
| etikettName || [[#Datentypen|String]] || - || - || Vorlagenname des Etiketts
+
</source>
|-
+
;Response
| fehlercode || [[#Datentypen|Integer]] || - || - || 0 wenn Erfolgreich
+
<source lang="json">
|-
+
{
| fehlertext1 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
"versandSendungsNr": "",
|-
+
"sendungsGebuehrWaehrung": "",
| fehlertext2 || [[#Datentypen|String]] || 200 || - || Wird im Fehlerfall befüllt
+
"fehler": "",
|-
+
"packStueckDaten": [
| gebuehr || [[#Datentypen|Decimal]] || 18 || 2 || Frachtkosten
+
{
|-
+
"assoc": {
| gebuehrWaehrung || [[#Datentypen|String]] || 3 || - || Frachkosten ISO-Währungscode
+
"":""
|-
+
},
| packstueckID || [[#Datentypen|String]] || 20 || - || PackstueckID aus der Anfrage
+
"packstueckID": "",
|-
+
"trackingNr": "",
| retourTrackingNr || [[#Datentypen|String]] || 50 || - || Paketnummer für die Retoure
+
"retourTrackingNr": "",
|-
+
"druckDateTime": "",
| trackingNr || [[#Datentypen|String]] || 35 || - || Paketnummer
+
"gebuehrWaehrung": "",
|-
+
"fehlertext1": "",
| trackingURL || [[#Datentypen|String]] || 255 || - || URL des Trackinglinks zur Sendungsverfolgung
+
"fehlertext2": "",
|-
+
"etikettName": "",
| versandSendungsNr || [[#Datentypen|String]] || - || - || -
+
"etikettDaten": "",
|-
+
"zusatzEtikettenDaten": {
| zusatzEtikettenDaten || [[#Datentypen|Map]] ([[#Datentypen|String]], [[#Datentypen|String]]) || - || - || Name und Binärdaten der Zusatzetiketten als Key/Value Map
+
"": ""
 +
},
 +
"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"
 
|-
 
|-
| zusatzfeld1 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
! Nr !! Feldname !! Von !! Bis !! Typ !! Länge !! Dezimalstellen !! Pflicht !! HVS-Feld !! Belegung !! Feldname
 
|-
 
|-
| zusatzfeld2 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 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
 
|-
 
|-
| zusatzfeld3 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 5 || Artikel-Nr || 27 || 76 || A || 50 || || O ||  || || Artikel-Nr
 
|-
 
|-
| zusatzfeld4 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 6 || Artikel-Bezeichnung1 || 77 || 176 || A || 100 || || M ||  || || Artikel-Bezeichnung1
 
|-
 
|-
| zusatzfeld5 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 7 || Artikel-Bezeichnung2 || 177 || 276 || A || 100 || || O ||  || || Artikel-Bezeichnung2
 
|-
 
|-
| zusatzfeld6 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 8 || Artikel-Netto-Gewicht (je Maßeinheit) || 277 || 285 || N || 9 || 3 || M || || || Artikel-Netto-Gewicht (je Maßeinheit)
 
|-
 
|-
| zusatzfeld7 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 9 || BTN-Nummer || 286 || 310 || A || 25 || || O ||  || || BTN-Nummer
 
|-
 
|-
| zusatzfeld8 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 10 || Artikel-Anzahl (je Maßeinheit) || 311 || 319 || N || 9 || 0 || M ||  || || Artikel-Anzahl (je Maßeinheit)
 
|-
 
|-
| zusatzfeld9 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 11 || Ursprungsland || 320 || 321 || A || 2 ||  || O ||  || || Ursprungsland
 
|-
 
|-
| zusatzfeld10 || [[#Datentypen|String]] || 200 || - || Zusatzfeld – kann optional im HVS32 gemapped werden um zusätzliche Informationen zurück zu melden
+
| 12 || Artikel-Wert (je Maßeinheit) || 322 || 330 || N || 9 || 2 || O ||  || || Artikel-Wert (je Maßeinheit)
|}
 
</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>
 
<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 ==
 
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]] || 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>
 
<!-- ------------------------------------------------------------------------------- ENDE sendungsdatenAnfrage ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- ENDE ÜBERSICHT DER FUNTKIONEN ------------------------------------------------------------------------------- -->
 
 
 
= Zusätzliche Datentypen =
 
Spezielle Datentypen können 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 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
 
| 13 || Artikelwert-Währung || 331 || 333 || A || 3 ||  || O ||  || ISO-Währung z.B. 'EUR' || Artikelwert-Währung
Zeile 2.292: Zeile 1.679:
 
|}
 
|}
 
M = Muss eingetragen werden, O = Optimal einzutragen, C = Conditional abhängig von anderen Feldern
 
M = Muss eingetragen werden, O = Optimal einzutragen, C = Conditional abhängig von anderen Feldern
 +
 
</div></div>
 
</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 ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- ENDE artikelDaten ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- gefahrgut ------------------------------------------------------------------------------- -->
  
== 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;">Gefahrgut-Daten</div>
Zeile 2.349: Zeile 1.738:
 
|}
 
|}
 
</div></div>
 
</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 ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- ENDE gefahrgut ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- -->
 
<!-- ------------------------------------------------------------------------------- edistatus ------------------------------------------------------------------------------- -->
  
 
= Beispiele =
 
= 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