'''Kennzeichnungspflicht für Pakete ab Januar 2025'''
== Allgemeine Hinweise zur Kennzeichnungspflicht ==
Spätestens ab dem 1. Januar 2025 müssen Pakete, die schwerer als 10 kg oder schwerer als 20 kg sind, gemäß den deutschen Postgesetzes speziell gekennzeichnet werden. Hier sind die verschiedenen Paketdienstleister derzeit zugange, ihre Vorgaben zur Belabelung der Pakete entsprechend zu aktualisieren. Nach Bekanntmachung der Vorgaben vom Frachtführer setzen wir diese jeweils zeitnahe um und lassen die aktualisierten Versandlabel-Ausdrucke vom jeweiligen Frachtführer abnehmen.

Nach der erfolgten allgemeinen Abnahme und Freigabe durch die Frachtführer ist die Änderung im Zuge eines HVS32-Programm-Updates verfügbar. Projektweise kann es dabei notwendig sein, dass neben dem Programm-Update selbst, von unserem Support in Absprache noch individuelle Maßnahmen getroffen werden müssen. Folgende Informationen können Sie der Tabelle entnehmen.

== Übersicht der umgesetzten Carrier ==
Hinweis: Voraussetzung für den Andruck der Kennzeichnungen / Logos auf den Labels ist selbstverständlich die Eingabe / Übergabe der korrekten Gewichte an das Versandsystem. '''Sollten Sie das reale Versandgewicht pro Packstück derzeit nicht an das HVS32 übertragen oder ermitteln können, setzen Sie sich bitte umgehend mit uns in Verbindung, da zukünftig von Strafzahlungen / Nachberechnungen auszugehen ist, wenn kein reales Gewicht übergeben wird. Dies betrifft alle Carrier.'''
{| class="wikitable"
|+Schwergewichts-Kennzeichnung auf den Versandlabeln
!Frachtführer/ Modul
!aktiv ab
HVS32-Version
!Anmerkungen
!relevante Labelvorlagen
(*)(**)
!Konsequenzen bei Nichteinhaltung
!Zusatzinfo
|-
|Post (DHL Road)
|7.114.56
|Nur bei DHL Paket (National, Verfahren 01 oder NN) und DHL Paket International (Verfahren 53), NICHT bei DHL Europaket (Verfahren 54) und NICHT bei DHL Retoure
|post_common_v2013, post_bpi_common, post_bpiex_common
|
|'''Wichtig:''' Die Postgesetz Anpassung ist nur für neue aktuelle Label Layouts möglich. Sollten Sie noch alte Layouts verwenden müssen diese zuerst auf die neuste Label Version umgestellt werden, um dem Gesetz zu folgen. Über das Feld "Labelname" in der Auskunft kann dies bei einer entsprechenden Sendung überprüft werden. Ansonsten können keine Anpassungen bezüglich des Postgesetztes vorgenommen werden.
|-
|Post AT
|7.114.69
|Nur bei Sendungen mit Zieladresse in Deutschland
|PostAT
PostAT_Retoure
|
|
|-
|DHL (Express)
|7.114.59
|Nur bei Sendungen mit Zieladresse in Deutschland
|dhl_common_single
|
|
|-
|DPD
| 7.114.60
| -
|DPD_Aztec, DPD_Retouren_Aztec
|Vorerst keine Konsequenzen zum Jahreswechsel geplant. Spätere Einführung vorbehalten.
|Bei Verwendung des Webservice erfolgt der Andruck der Schwergewichts-Kennzeichnung am Ende November automatisch.
'''Wichtig:''' Die Postgesetz Anpassung ist nur für neue aktuelle Label Layouts möglich. Sollten Sie noch alte Layouts verwenden müssen diese zuerst auf die neuste Label Version umgestellt werden, um dem Gesetz zu folgen. Über das Feld "Labelname" in der Auskunft kann dies bei einer entsprechenden Sendung überprüft werden. Ansonsten können keine Anpassungen bezüglich des Postgesetztes vorgenommen werden.
|-
|DPD (EU)
| -
|Weitere europäische Länder werden nach und nach ausgerollt.
|
|
|
|-
|GLS
| 7.114.61
| -
|GLSBox_2D_GP_Standard.lbc
|
|
|-
|GO!
| -
|noch keine Vorgaben verfügbar
|
|
|
|-
|Hermes
| 7.114.63
| Nur bei Sendungen mit Zieladresse in Deutschland
|Hermes.lbc, Hermes_BC20.lbc
|
|
|-
|trans-o-flex
|7.114.63
|Nur bei Sendungen mit Zieladresse in Deutschland, TOF möchte das 10+-Logo bereits ab genau 10 kg und das 20+-Logo bereits ab genau 20 kg
|trans-o-flex_2DBusiness
|
|'''Wichtig:''' Die Postgesetz Anpassung ist nur für neue aktuelle Label Layouts möglich. Sollten Sie noch alte Layouts verwenden müssen diese zuerst auf die neuste Label Version umgestellt werden, um dem Gesetz zu folgen. Über das Feld "Labelname" in der Auskunft kann dies bei einer entsprechenden Sendung überprüft werden. Ansonsten können keine Anpassungen bezüglich des Postgesetztes vorgenommen werden.
|-
|Neutralspedition
|7.114.71
|Nur relevant falls die belabelten Pakete an Paketdienstleister übergeben werden, die in Deutschland zustellen.
|Neutralspedition, Neutralspedition_NVE
|
|
|-
|Night Star Express
| 7.114.63
| NightStar möchte das 10+-Logo bereits ab genau 10 kg und das 20+-Logo bereits ab genau 20 kg
|NightStar_2D, NightStar
|
|
|-
|nox
|7.114.64
|nox möchte das >10-Logo bereits ab genau 10 kg und das >20-Logo bereits ab genau 20 kg
|nox, nox_Retoure . Falls Bestandkunden noch das Modul TNTInnight anstelle nox in Verwendung haben: TNTInnight, TNTInnight_Retoure
|
|
|-
|UPS
| 7.114.71
| Bei allen Sendungen aus oder nach Deutschland. UPS möchte das 10+-Logo bereits ab genau 10 kg und das 20+-Logo bereits ab genau 20 kg
|UPS_2017, UPS_Retoure_2017, UPS_WorldEase, UPS_WorldEase_Single
|
|'''Wichtig:''' Die Postgesetz Anpassung ist nur für neue aktuelle Label Layouts möglich. Sollten Sie noch alte Layouts verwenden müssen diese zuerst auf die neuste Label Version umgestellt werden, um dem Gesetz zu folgen. Über das Feld "Labelname" in der Auskunft kann dies bei einer entsprechenden Sendung überprüft werden. Ansonsten können keine Anpassungen bezüglich des Postgesetztes vorgenommen werden.
|-
|GEL
|7.114.78
|
|GEL.lbc
|
|
|-
|TNT + Fedex
|7.114.78
|
|Fedex_Voll.lbc
TNT.lbc

TNT_Retoure.lbc

TNT_Routing.lbc

TNT_WebRouting.lbc
|
|
|}

== Prüfung ob individuell angepasste Labellayouts eingesetzt werden ==
''(*) wenn für ein Projekt die relevanten Labelvorlagen individuell angepasst wurden, müssen diese Label-Vorlagen von Heidler angepasst/aktualisiert werden.''

Wie erkennt man dies? Wenn entsprechende (..._individuell.lbc - Vorlagedateien (z.B. post_common_v2013_individuell.lbc, … ) im HVS32\Labels-Unterverzeichnis bzw. in einer aktuell erzeugten individuell-zip vorhanden sind.

=== Vorgehensweise bei individuell angepassten Labels ===
Setzen Sie individuelle Labels wie im vorherigen Absatz beschrieben ein, müssen die neuen Carrier Anforderungen manuell (kostenpflichtig) auf Ihre individuellen Labellayouts nachgezogen werden, da eine automatische Aktualisierung der Labellayouts über ein reines HVS32 Update nicht möglich ist.

Wenn Sie in diesem Zuge auf (automatisch aktualisierbare) Standard-Labellayouts zurückgehen wollen, müssen Sie lediglich im Ordner \Heidler\HVS32\Labels die Dateien mit Carriername_individuell.lbc umbenennen in zB Carriername_individuell.old, dann ist das individuelle Label deaktiviert und Sie verwenden wieder das Standard Labellayout.

'''Möchten Sie Ihre individuellen Labellayouts wie beschrieben angepasst haben, melden Sie bitte bei unserem Support.''' Hierbei bitte erst dann melden, wenn Sie für jeden Ihrer eingesetzten (und indiv. angepassten) Carrier in obiger Tabelle einen Eintrag sehen, um Mehraufwand durch Einzelanpassungen zu vermeiden. (Siehe Tabelle)

Dazu senden Sie Ihre individuellen Einstellungen über ein neues Ticket an unseren Support. Diese Einstellungen (Zip Datei) enthält auch Ihre individuellen Labels. Auf dieser Basis erstellen wir Ihnen dann ein Angebot. Hier finden Sie Hilfestellung zur Erzeugung ihrer individuellen Einstellungen: [https://heidler-strichcode.de/help?question=116209&title=wie-kann-ich-meine-individuellen-einstellungen-und-die-systeminformation-erzeugen Anleitung Erzeugung Indiv. Systemeinstellungen]

== Hinweise bei Verwendung von DPL Druckern ==
''(**) wenn bei einem Projekt die Labels per direkter Datamax-Druckersprache (DPL) gedruckt werden, müssen die neuen Logos zuvor auf den Druckerspeicher hinterlegt werden, dieser Aufwand muss pro Drucker angeboten werden, hierzu kontaktieren Sie unseren Support. Alternativ bietet sich ggf. die Umstellung auf Windowsdrucker (via Treiber) an.''

Wie erkennt man das: aktuelle Systeminfo-Textdatei erzeugen (siehe Erklärungs-Link unten), diese Textdatei öffnen und im Abschnitt "Label-Ausgabe:" prüfen, ob bei einem noch benutzten Druck-Packplatz die Ausprägung LabelDrucker;DruckerArt;"DPLWinPrinter"; oder LabelDrucker;DruckerArt;"ThermoDPL"; gelistet ist.

Link: [https://heidler-strichcode.de/help/?question=116209&title=wie-kann-ich-meine-individuellen-einstellungen-und-die-systeminformation-erzeugen Anleitung zur Erzeugung der individuell-zip. bzw. Systeminfo-Textdatei]

== Geldbußen bei Nichteinhaltung ==
Dienstleister, die dies nicht einhalten, werden mit Geldbußen bis 50.000 € belegt. Der Verlader kann bei Nichteinhaltung im Rahmen der Beförderungsbedingungen in Regress genommen werden.

== Allgemeine Update-Hinweise ==
Mit der Änderung geht ein HVS32 Update einher, Sie erhalten als Kunde mit aktiven Software-Support Vertrag das Update über ihr Ticket. Dieses erstellen Sie, indem Sie eine Mail an support@heidler-strichcode.de schicken. Hier finden Sie allgemein Hilfestellung zu einem HVS32 Update:

[https://heidler-strichcode.de/help/?question=97533&title=wie-wird-ein-hvs32-update-durchgefuehrt https://heidler-strichcode.de/help/?questionhvs32=97533&title=wie-wird-ein--update-durchgefuehrt]

Postgesetz Änderungen 2025

2024-11-12T07:37:42Z

Mnh: /* Übersicht der umgesetzten Carrier */

Postgesetz Änderungen 2025

2024-11-08T07:09:19Z

Mnh: /* Übersicht der umgesetzten Carrier */

DPD Flexzustellung (Predict) aktivieren

2024-10-24T13:47:58Z

Mnh: /* Aktivierung */

= DPD Predict (früher "Flexzustellung") =

Benachrichtigung des Privat-Empfängers per SMS oder Email

Details zur Leistung: https://www.dpd.com/de/de/faq/was-bedeutet-predict/

 

==== Vorrausetzungen ====

Nur für Privatempfänger in Verbindung mit der Anwendung des DPD B2C – Services für Privatzustellung verfügbar (B2C kein Gefahrgut) 

Nicht in Verbindung mit Zusatzleistungen wie Garantie/Express und Nachnahme verfügbar

Nur national verfügbar 

Unterstützt ab HVS Version 7.78.2

 

== Aktivierung  ==

Menü: Setup > Konfigurator > DPD > Extraoptionen

* Privatadress-Option (B2C) muss zur möglichen Verwendung aktiviert werden
* FlexZustellungs-Option muss auf den Wert „mit Eingabe“ oder  „Automatisch“ gestellt werden 
* Anlage und Verwendung einer neuen Versandart mit Bezeichnung "'''DPD Standard B2C"''' (Vorgabeoption: "B2C")

==== mit Eingabe ====

Predict (früher "FlexZustellung") -Option muss mit einer Optionsbox rechts im Druckfenster aktiviert werden. Dann erscheinen im Verlauf der Verarbeitung Eingabemasken für die Mobil-Telefonnr oder für die Emailadresse

==== Automatisch ====

Hierbei wird gewähltem DPD B2C Service (via separater Versandart) die Zusatzleistung Predict (früher "FlexZustellung") automatisch aktiviert.

Die automatische Aktivierung erfolgt nur, wenn die MobiltelefonNr oder Mailadresse in den HVS32 Schnittstellenfeldern "EmpfMobilFunkNr" bzw "EmpfEmailAdresse" übergeben SOWIE der DPD B2C Service (via Versandart oder Sonderdienst) ausgewählt wurde.

[[File:DPD Predict 1 .JPG|left|upright|DPD Predict 1 .JPG]]

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

== Predict bei interaktiver Verarbeitung  ==

* Aktivierung über die Optionsbox "Privatadresse" in den Versandoptionen der Erfassungsmaske
* Einrichten und Verwenden einer '''DPD-Versandart "DPD Standard B2C"''' (diese muss die Kennung "B2C" im Versandart-Definitionsfeld ''Vorgabeoptionen'' haben)
* Alternativ zur Versandart: Übergabe der Kennung "B2C" im Daten-Eingangsfeld ‚Sonderdienste‘

 

=== Beispiel für die Optionsboxen ‚Privatadresse‘ und ‚FlexZustellung‘ in der Druckverarbeitung ===

[[File:DPD Predictt2 .JPG|RTENOTITLE]]

 

=== Eingabe der Mobil-Telefonnr für die SMS-Benachrichtigung ===

[[File:DPD Predictt3 .JPG|RTENOTITLE]]

 

=== Eingabe der Emailadresse für die Benachrichtigung per Mail ===

[[File:DPD Predictt4 .JPG|RTENOTITLE]]

 

== Übermittlung der Optionsdetails an den DPD ==

Die Übermittlung der Predict-Details erfolgt durch Übergabe der entsprechenden Parameter in der DPD-Übergabedatei MPSEXPDATA.

Auf den Ladelistendruck und das Etiketten-Layout hat die Predict-Option keine Auswirkung.

Postgesetz Änderungen 2025

2024-10-23T07:59:24Z

Mnh: /* Übersicht der umgesetzten Carrier */

Postgesetz Änderungen 2025

2024-10-11T09:33:43Z

Mnh: /* Übersicht der umgesetzten Carrier */

Leitfaden zur Integration neuer Frachtführer

2024-10-10T06:54:29Z

2024-08-20T13:11:05Z

Mnh: /* Gefahrgutstamm */

Systemvoraussetzungen

2024-08-15T11:49:50Z

Mnh: /* Freizugebende Standard Ports */

[[en:System requirements]]
= '''Betriebssysteme''' =

Alle Betriebssysteme, Computersysteme und Hardwarekomponenten, die in diesem Dokument nicht ausdrücklich als freigegeben deklariert sind, gelten grundsätzlich als nicht freigegeben. Dazu gehören z.B. alle Linux- und MacOS-basierten Computer und Betriebssysteme. Support-Anfragen zu nicht unterstützten Betriebssystemen können nur im stark eingeschränkten Maße bearbeitet werden.

Grundsätzlich werden bei den unten angegebenen Client- und Server-Betriebssystemen immer die aktuellsten Service-Packs bzw. Service-Releases und Updates vorausgesetzt.

Die Empfehlung von Multicore-Prozessoren bedeutet hier nicht, dass HVS32 in den aktuellen Versionen die Prozessorauslastung direkt steuert (Multithreading), sondern erfahrungsgemäß ein deutlich flüssigeres Arbeiten mit entsprechenden Systemen möglich ist.

Wir empfehlen die Verwendung eines 64-Bit-Betriebssystems. Bei Verwendung von Zusatzmodulen wie z.B. ComManager oder Heidler Carrier API ist ein 64-Bit Betriebssystem Voraussetzung.

=== '''Unterstützte Server Betriebssysteme''' ===
*Microsoft Windows Server 2022
*Microsoft Windows Server 2019
*Microsoft Windows Server 2016

=== '''Unterstützte Client Betriebssysteme''' ===
*Microsoft Windows 11
*Microsoft Windows 10
= '''Empfohlene Systemvoraussetzungen''' =
==='''Server'''===
*2,8 GHz Quad-Core Prozessor
*8 GB Arbeitsspeicher
*200 GB verfügbarer Festplattenspeicher (SSD)
*100 Mbit/s Netzwerk Anbindung oder besser
=== '''Client''' ===

*2 GHz Intel Pentium oder vergleichbarer AMD Prozessor
*4 GB Arbeitsspeicher
*10 GB verfügbarer Festplattenspeicher
*Farbmonitor mit einer Auflösung von 1920 x 1080 oder höher
= '''Empfohlene Systemvoraussetzungen für zentrales Polling (Server)''' =
Bei den nachfolgenden Systemvoraussetzungen handelt es sich um eine Empfehlung, welche grob abgeschätzt worden ist. Beim Aufsetzen sollte unbedingt darauf geachtet werden, dass der Server später einfach zu skalieren ist (VM), da durch Zuschaltung von Frachtführern oder weiteren Funktionalitäten zusätzliche Applikationen notwendig sein könnten, wodurch der Server mehr Ressourcen benötigt.

Es wird davon abgeraten, die VM auf einem Server aufzusetzen, welcher durch andere VMs in der Festplattengeschwindigkeit beeinträchtigt wird (z.B. Datenserver), da dies zu massiven Geschwindigkeitseinbußen in Bezug auf den HVS32 Datenbankdienst führen kann.

Bei den Systemvoraussetzungen gehen wir von einer Installation aus, in welcher unsere gängigsten Applikationen zum Einsatz kommen.

Basisversion mit folgenden Komponenten:

* HVS32 (Versandsystem)
* 1x HVS32 Packstation (Verarbeitung der Anfragen)
* 1x HVS32Monitoring (Monitoringdienst für die Packstation)
* DataGatewayServer (Schnittstelle zum Hostsystem via REST, SOAP, SAP, JDBC, HTTP)
* Com-Manager (Schnittstelle zum Frachtführer via SFTP, FTP, etc.)
* Carrier-API (Webservice Kommunikation zu den Frachtführern)

Bei einer Verarbeitung bis zu ~1000 Packstücke / Stunde empfehlen wir folgende Systemvoraussetzungen:

* Netzwerk: min. 100Mbit/s, empfohlen 1.000 Mbit/s
* Festplattenspeicher: min. 50 GB (SSD)
* CPU: 8 Kerne
* Arbeitsspeicher: 12 GB

Geht das Versandvolumen über die ~1000 Packstücke / Stunde hinaus, empfehlen wir folgende Skalierung:

Pro weitere ~1000 Packstücke / Stunde:

* + 2 Kerne
* + 3 GB Arbeitsspeicher
* + 5 GB Festplattenspeicher (SSD)
(Bei der Skalierung rechnen wir mit einer höheren Ressourcenauslastung der Basiskomponenten, sowie den zusätzlichen Einsatz einer weiteren HVS32 Packstation mit dazugehörenden HVS32Monitoring)

Bei Einsatz von weiteren Applikationen, sollte der Server wie folgt skaliert werden. Welche Applikationen zum Einsatz kommen, sollte in den Projektabsprachen geklärt werden.
{| class="wikitable"
|'''Externe Beschreibung'''
|'''Applikation'''
|'''CPU Kerne'''
|'''Arbeitsspeicher (in GB)'''
|'''Festplattenspeicher (in GB)'''
|'''Skalierung'''
|-
|weitere Schnittstellen zum Hostsystem via REST, SOAP, SAP, JDBC oder HTTP
|DataGatewayServer
|2
|2
|2
|pro Schnittstelle
|-
|DHL Paket
|Leitcode
|2
|2
|10
|einmalig
|-
|Statusdaten
|StatusdatenManager
|1
|1
|5
|pro ~1000 Packstücke / Stunde
|-
|Statusdaten Webansicht
|SEMWeb
|1
|1
|15
|pro ~1000 Packstücke / Stunde
|-
|Datenbank-Archivierung
|DBArchivierung
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|min. 50

(abhängig, wie viele Daten archiviert werden sollen)
|einmalig

(keine zusätzlichen Kerne / Arbeitsspeicher notwendig, da die restlichen Dienste beendet werden)
|-
|automatisierter Tagesabschluss
|MonitoringService
|1
|2
|5
|einmalig
|-
|Mail-Avisierung
|AMAService
|1
|1
|5
|einmalig
|-
|Tarifierung + Rechnungsprüfung
|HFMS
|2

1
|4

0,5
|5

5
|einmalig

pro ~1000 Packstücke / Stunde
|-
|Tarifierung + Rechnungsprüfung + Versandartermittlung
|HFMS / SPM
|4

2
|4

1
|5

5
|einmalig

pro ~1000 Packstücke / Stunde
|}
 

= '''Netzwerkbetrieb HVS32''' =

Für den Netzwerkbetrieb des HVS32 wird die Freigabe des HVS32 Programmverzeichnisses auf dem Server vorausgesetzt. Diese Freigabe muss als Netzlaufwerk auf den Clients mit einem festen Laufwerksbuchstaben permanent verbunden sein. Eine Verwendung von UNC Pfaden ist im HVS32 erst ab der Version 7.102.13 möglich. Die Benutzer benötigen Vollzugriff Dateiberechtigungen auf das o.g. HVS32 Verzeichnis und die Freigabe. Diese Voraussetzungen sollten bereits zum Installationstermin vom Administrator vorbereitet werden. Eine Bandbreite bzw. Verbindungsgeschwindigkeit von 100 Mbit/s oder mehr ist erforderlich. Bei nicht erreichen der Bandbreite oder bei WAN Verbindungen empfehlen wir die Verwendung des HVS32 im Terminalserver-Betrieb. Da das komplette System von der tatsächlich verfügbaren Bandbreite abhängig ist, gilt diesem Thema besondere Beachtung. Die Erfahrungen haben gezeigt dass hierbei die Verfügbarkeit der Leitung sowie der tatsächliche Datendurchsatz dennoch zu Problemen führen können. Von einem Standortübergreifenden Betrieb ohne Terminalserver Umgebung raten wir explizit ab.

 

= '''Windows Terminal Server / Citrix''' =

Der Support für HVS32 in einer Windows-Terminalserver-Umgebung (RDP) wird im gleichen Umfang wie auch bei einer Standard Installation geleistet. In einem Citrix-Umfeld können wir jedoch keinen Support für diese Umgebung bieten. Bei Problemen am Terminalserver oder der Verwaltung der Terminalserverumgebung kann der Support nur für die grundlegenden Standard-Windows–Komponenten und Funktionen geleistet werden. Alles andere wie z.B.: Netzwerk-Freigaben, Druckertreiber, Datei-Berechtigungen sowie RDP / Citrix spezifische Einstellungen etc. fallen in den Aufgabenbereich des zuständigen Administrators. Wir empfehlen, dass der Installation und Konfiguration unbedingt ein Systemadministrator beiwohnen sollte. Alle HVS32 Versionen werden ausführlich und intensiv auf den angegebenen Betriebssystemen getestet. Da es unmöglich ist, alle Eventualitäten im Vorfeld nachzustellen, können wir Ihnen auch keine Garantie für den fehlerfreien Programmablauf auf jedem Kundensystem geben.

 

= '''Freizugebende Standard Ports''' =

{| border="1" cellpadding="1" cellspacing="1" style="width: 600px;"
|-
| style="width: 91px;" | '''FTP / SFTP'''
|21/22
|extern
| style="width: 496px;" | alle für die FTP/SFTP Übertragung nötigen Ports. Bei passiven FTP muss auch den Rückkanal über UDP beachtet werden. FTP/SFTP Verwendung sowie Ziel-Server Adressen abhängig der eingesetzten Carrier
|-
| style="width: 91px;" | '''DNS'''
|
|
| style="width: 496px;" | HVS32 muss die Möglichkeit gegeben werden, FTP, HTTP, HTTPS oder SMTP Adressen über DNS aufzulösen.
|-
| style="width: 91px;" | '''HTTP/HTTPS'''
|80 / 443
|extern
| style="width: 496px;" | HVS32 muss die Möglichkeit gegeben werden, HTTP und HTTPS Adressen auflösen und erreichen zu können
|-
| style="width: 91px;" | '''SMTP'''
|25
|
| style="width: 496px;" | Um Frachtführerdateien zu übertragen oder Mail-Avisierungen zu senden werden die dort eingestellten Ports benötigt
|-
| style="width: 91px;" | '''Data Gateway Server'''
|5030 / 5034
|intern (LAN)
| style="width: 496px;" | Die HVS32 Clients müssen bei Einsatz der Kommunikation zum Vorsystem über den DataGatewayServer innerhalb des Netzwerks Zugriff auf die konfigurierten Ports haben (Port 5030 bei interaktiver Verarbeitung und Port 5034 bei Polling)
|-
| style="width: 91px;" | '''Leitcode'''
|9000
|intern (LAN)
| style="width: 496px;" | für Leitcodeermittlung (lediglich bei Modul DHL Road notwendig)
|-
| style="width: 91px;" | '''Monitoring Dienst'''
|9034
|intern (LAN)
| style="width: 496px;" | auf dem HVS32 Server bei eingesetztem HVS32 Monitoring Dienst
|-
| style="width: 91px;" | '''Firebird Datenbank'''
|3050
|intern (LAN)
| style="width: 496px;" | für Firebird Datenbankverbindung
|-
| style="width: 91px;" | '''Heidler Carrier API'''
|9900
|intern (LAN)
| style="width: 496px;" | bei Verwendung der Frachtführer Webservice Anbindung
|-
| style="width: 91px;" | '''HVS32CommunicationManager'''
|9009
|intern (LAN)
| style="width: 496px;" | für Kommunikation mit dem ComManager (via REST)
|-
| style="width: 91px;" | '''HFMS'''
|9500
|intern (LAN)
| style="width: 496px;" | für Kommunikation mit dem HFMS
|-
| style="width: 91px;" | '''ScaleService (REST)'''
|8100
|intern (LAN)
| style="width: 496px;" | für Kommunikation mit dem ScaleService (via REST)
|}

 

= '''HVS32 Testsystem''' =

Das HVS32 Testsystem sollte sich auf einem getrennten Server befinden um zu vermeiden, dass sich die Systeme gegenseitig einschränken.

Der Betrieb auf demselben Server ist möglich, bedingt aber zusätzliche Konfigurationen, ggf. auch auf Ihrer Seite. (andere Ports z.B.)
Grundlegend ist das Testsystem identisch zum Produktiven System zu dimensionieren.

HVS32 File Schnittstelle (Automatik-Polling)

2024-05-08T08:34:49Z

Mnh: /* Beispiele */

[[en:HVS32 default interface]]

= Voraussetzungen =

Eine beliebige HVS-Version.

= Funktionsbeschreibung =

Diese Schnittstelle listet die am häufigsten verwendeten Felder auf und beschreibt die Positionen der Daten im Standard-Datei-Import. Das Format kann in Rücksprache mit Ihrem Ansprechpartner sehr flexibel erweitert und angepasst werden. Es wird eine Zeile pro Packstück erwartet, mehrere Packstücke dürfen in einer Datei enthalten sein.

In einem spaltenbasierten Format geben die Felder "Von" und "Bis" die Positionen der Daten an, in einem Format wie CSV wird die Spalte "Nr." ausgewertet.

= Sendungsdaten =

Die Sendungsdaten geben die Eigenschaften eines Packstücks an.

Erläuterung Spalte Pflicht: M= Must / O= Optional / C= Conditional (in Abhängigkeit der Carrier Belange)

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || 3 || "IMP" / "EXP"
|-
| || '''--- SENDUNGS-TEIL ---''' || || || || || || || ||
|-
| 2 || Kunden-Nummer || 4 || 13 || 10 || || A || O || 20 || Kdnr des Empfängers beim Versender
|-
| 3 || Empfänger-Name1 || 14 || 43 || 30 || || A || M || 50 || LIEFER-ADRESSE
|-
| 4 || Empfänger-Name2 || 44 || 73 || 30 || || A || O || 50 || EMPFÄNGER
|-
| 5 || Empfänger-Name3 || 74 || 103 || 30 || || A || O || 50 ||
|-
| 6 || Empfänger-Strasse || 104 || 133 || 30 || || A || M || 50 ||
|-
| 7 || Empfänger-LKZ || 134 || 136 || 3 || || A || M || 3 ||
|-
| 8 || Empfänger-PLZ || 137 || 146 || 10 || || A || M || 10 ||
|-
| 9 || Empfänger-Ort || 147 || 176 || 30 || || A || M || 50 ||
|-
| 10 || Empfänger-Region / Staat || 177 || 196 || 20 || || A || C || 20 || Staat/Provinz (z.B. für USA wichtig)
|-
| 11 || Empfänger-Bahnhof || 197 || 226 || 30 || || A || O || 30 || PLZ und Ort
|-
| 12 || Ansprechpartner Empfänger || 227 || 246 || 20 || || A || O || 50 ||
|-
| 13 || Telefon-Nummer Empfänger || 247 || 266 || 20 || || A || C || 30 ||
|-
| 14 || Fax-Nummer Empfänger || 267 || 286 || 20 || || A || O || 30 ||
|-
| 15 || Ust-ID-Nummer Empfänger || 287 || 306 || 20 || || A || O || 20 ||
|-
| 16 || ILN-Nummer Empfänger || 307 || 319 || 13 || || A || C || 13 || Pflicht bei Metro-Versand
|-
| 17 || Mandant (HVS32: "Auftraggeber_ID") || 320 || 327 || 8 || || A || M || 10 ||
|-
| 18 || Versandart (HVS32: "Versandart_ID") || 328 || 333 || 6 || || A || M || 10 || Pflicht bei Automatikpolling
|-
| 19 || AVIS-Hinweis 1 || 334 || 363 || 30 || || A || O || 30 ||
|-
| 20 || AVIS-Hinweis 2 || 264 || 393 || 30 || || A || O || 30 ||
|-
| 21 || AVIS-Zusatz 1 || 394 || 413 || 60 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 1
|-
| 22 || AVIS-Zusatz 2 || 414 || 433 || 60 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 2
|-
| 23 || Lieferschein-Nummer || 434 || 443 || 10 || 0 || A || M || 40 || Wird im VS als Such-Nummer verwendet
|-
| 24 || Auftrags-Nummer || 444 || 453 || 10 || || A || O || 50 ||
|-
| 25 || Bestell-Nummer || 454 || 473 || 20 || || A || O || 50 || Metro-Bestellnr (Metro-Versand)
|-
| 26 || Warenwert || 474 || 482 || 9 || 2 || N || C || 9 ||
|-
| 27 || Warenwert-Währung || 483 || 485 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 28 || Nachnahme || 486 || 494 || 9 || 2 || N || C || 9 ||
|-
| 29 || Nachnahme-Währung || 495 || 497 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 30 || Nachnahme-Vermerk || 498 || 498 || 1 || || A || C || 1 || 'B': Bar / 'V': Verrechnungsscheck
|-
| 31 || Nachnahme-Verwendungszweck || 499 || 518 || 20 || || A || C || 30 ||
|-
| 32 || Höher-Versicherungswert || 519 || 527 || 9 || 2 || N || C || 9 ||
|-
| 33 || Höher-Versicherungswert-Währung || 528 || 530 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 34 || Frankatur-Kennung || 531 || 540 || 10 || || A || C || 10 ||
|-
| 35 || Zahlungsbedingung || 541 || 550 || 10 || || A || C || 10 || 'S':Sender,'R':Empfänger
|-
| 36 || Zahlungsbedingung Zoll/Steuern || 551 || 551 || 1 || || A || C || 1 || 'S':Sender,'R':Empfänger
|-
| 37 || Frachtführer-Kunden-Nr || 552 || 561 || 10 || || A || C || 20 || Kdnr des Frachtzahlers beim Frachtführer
|-
| 38 || Sonderdienst || 562 || 591 || 30 || || A || C || 30 || versandart-spezifisch belegt
|-
| 39 || Sendungs-Inhalt || 592 || 621 || 30 || || A || C || 30 ||
|-
| 40 || Termin-Art || 622 || 622 || 1 || || A || C || 1 || 'A'b / 'B'is / 'F'ix
|-
| 41 || Termin-Datum || 623 || 632 || 10 || || A || C || 10 || TT.MM.JJJJ
|-
| 42 || Termin-Zeit || 633 || 637 || 5 || || A || C || 5 || HH:MM
|-
| 43 || Neutral-Absender-Name1 || 638 || 667 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 44 || Neutral-Absender-Name2 || 668 || 697 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 45 || Neutral-Absender-Name3 || 698 || 727 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 46 || Neutral-Absender-Strasse || 728 || 757 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 47 || Neutral-Absender-LKZ || 758 || 760 || 3 || || A || O || 3 || Nur bei Neutral-Absendern belegt
|-
| 48 || Neutral-Absender-PLZ || 761 || 770 || 10 || || A || O || 10 || Nur bei Neutral-Absendern belegt
|-
| 49 || Neutral-Absender-Ort || 771 || 800 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 50 || Rechnungsempfänger-Name1 || 801 || 830 || 30 || || A || C || 50 || RECHNUNGSADRESSE
|-
| 51 || Rechnungsempfänger-Name2 || 831 || 860 || 30 || || A || O || 50 || EMPFÄNGER
|-
| 52 || Rechnungsempfänger-Name3 || 861 || 890 || 30 || || A || O || 50 ||
|-
| 53 || Rechnungsempfänger-Strasse || 891 || 920 || 30 || || A || C || 50 ||
|-
| 54 || Rechungsempfänger-LKZ || 921 || 923 || 3 || || A || C || 3 ||
|-
| 55 || Rechungsempfänger-PLZ || 924 || 933 || 10 || || A || C || 10 ||
|-
| 56 || Rechungsempfänger-Ort || 934 || 963 || 30 || || A || C || 50 ||
|-
| 57 || Post-Leitcode || 964 || 978 || 15 || || A || C || 15 ||
|-
| 58 || Post-Zielfrachtzentrum || 979 || 983 || 5 || || A || C || 5 ||
|-
| 59 || Frachtbrief-Nr || 984 || 1003 || 20 || || A || O || 20 || falls Fr.brief d. Vorsystem gedruckt
|-
| || '''--- PACKSTÜCK-TEIL ---''' || || || || || || || ||
|-
| 60 || Gewicht Brutto (kg) || 1004 || 1011 || 8 || 3 || N || M || 8 ||
|-
| 61 || Gewicht Netto (kg) || 1012 || 1019 || 8 || 3 || N || O || 8 ||
|-
| 62 || Packstück-Anzahl || 1020 || 1022 || 3 || 0 || N || C || 3 || Gesamt-Anzahl Colli der Sendung+J15
|-
| 63 || Packstück-Nummer || 1023 || 1025 || 3 || 0 || N || C || 3 || Laufende Nr pro Sendung
|-
| 64 || Verpackungsart || 1026 || 1031 || 6 || || A || C || 20 ||
|-
| 65 || Länge Packstück (cm) || 1032 || 1035 || 4 || 0 || N || C || 4 ||
|-
| 66 || Breite Packstück (cm) || 1036 || 1039 || 4 || 0 || N || C || 4 ||
|-
| 67 || Höhe Packstück (cm) || 1040 || 1043 || 4 || 0 || N || C || 4 ||
|-
| 68 || PackPlatz-Nr || 1044 || 1053 || 10 || || A || C || 10 || System, das den Auftrag verarbeiten soll
|-
| 69 || Hostseitige Packstück-ID || 1054 || 1068 || 15 || || A || C || 20 ||
|-
| || '''--- RÜCKMELDE-TEIL ---''' || || || || || || || ||
|-
| 70 || Paket-Nummer || 1069 || 1083 || 15 || || A || || 15 || Nummernkreis-Nr des Frachtführers
|-
| 71 || Tracking-Nummer || 1084 || 1113 || 30 || || A || || 30 ||
|-
| 72 || Druck-Datum || 1114 || 1123 || 10 || || A || || 10 || Datum der Abarbeitung (TT.MM.CCJJ)
|-
| 73 || Versand-Datum || 1124 || 1133 || 10 || || A || || 10 || Datum der Versendung(TT.MM.CCJJ)
|-
| 74 || Fracht-Gebühr || 1134 || 1141 || 8 || 2 || N || || 8 || Frachtkosten
|-
| 75 || Währung Fracht-Gebühr || 1142 || 1144 || 3 || || A || || 3 || ISO-Währungscode
|-
| 76 || Status || 1145 || 1149 || 5 || || A || || 5 ||
|-
| 77 || Ladelisten-Nummer || 1150 || 1153 || 4 || || A || || 4 ||
|-
| || '''--- STEUERUNGS-TEIL ---''' || || || || || || || ||
|-
| 78 || IMPStatus || 1154 || 1154 || 1 || || A || || 1 || 'L':Löschsatz,'F':Fehlersatz, sonst Leer
|-
| 79 || Fehlertext || 1155 || 1214 || 60 || || A || || 60 || Fehler bei Eingangs-Plausi-Prüfung
|-
| 80 || Gefahrgut-Status || 1215 || 1217 || 3 || || A || || 3 || Für int. Kommunikation, nach Absprache
|-
| 81 || ReferenzNr || 1218 || 1237 || 20 || || A || || 20 || Für int. Kommunikation, nach Absprache
|-
| || '''--- Zusatz - Teil ---''' || || || || || || || ||
|-
| 82 || Broker-Name || 1238 || 1262 || 25 || || A || C || 25 ||
|-
| 83 || Broker-Telefonnummer || 1263 || 1282 || 20 || || A || C || 20 ||
|-
| 84 || Hold-At-Location J/N || 1283 || 1283 || 1 || || A || C || 1 || 'J': ja, 'N' oder Blank: Nein
|-
| 85 || Hold-At-Location Telefon || 1284 || 1303 || 20 || || A || C || 20 || Mit Telefonnummer belegt
|-
| 86 || Hold-At-Location Ansprechpartner || 1304 || 1333 || 30 || || A || C || 30 || Mit einem Ansprechpartner belegt
|-
| || '''--- Zusatz - HVS32 ---''' || || || || || || || ||
|-
| 87 || AnzahlArtikel || 1334 || 1339 || 6 || || || O || 6 || Anzahl Artikel (Druck auf Etikett)
|-
| 88 || ZusatzZeile1 || 1340 || 1369 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)
|-
| 89 || ZusatzZeile2 || 1370 || 1399 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)
|-
| 90 || Frei-AVIS1 || 1400 || 1461 || 62 || || A || O || 62 ||
|-
| 91 || Frei-AVIS2 || 1462 || 1523 || 62 || || A || O || 62 ||
|-
| 92 || Status "Elektronik-Artikel" J/N || 1524 || 1524 || 1 || || A || O || 1 || 'J'/'T'(True): Elektronik-Artikel, ansonsten nicht
|-
| 93 || Empfänger-Emailadresse || 1525 || 1604 || 80 || || A || O || 80 || f. automatische Mailavisierung
|-
| 94 || Kostenstelle || 1605 || 1634 || 30 || || A || O || 30 ||
|-
| 95 || Druckername || 1635 || 1664 || 30 || || A || O || 30 || Name eines Ausgabekanals im HVS32
|-
| 96 || CR/LF || 1665 || 1666 || 2 || || || M || 2 || Carriage Return/Line Feed
|}

= Artikeldaten =

Die Artikeldaten geben die Eigenschaften eines Artikels an. Ein Packstück kann mehrere Artikel beinhalten.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || || Festeintrag "ART"
|-
| 2 || Lieferschein-Nr || 4 || 13 || 10 || || A || M || || nicht Pflicht im Dateipolling mit Vormerkdaten
|-
| 3 || Packstück-Nr || 14 || 16 || 3 || || N || C || || nicht Pflicht im Dateipolling mit Vormerkdaten
|-
| 4 || Positions-Nr || 17 || 26 || 10 || 0 || N || M || ||
|-
| 5 || Artikel-Nr || 27 || 76 || 50 || || A || O || ||
|-
| 6 || Artikel-Bezeichnung 1 || 77 || 176 || 100 || || A || M || ||
|-
| 7 || Artikel-Bezeichnung 2 || 177 || 276 || 100 || || A || O || ||
|-
| 8 || Artikel-Netto-Gewicht (je Masseinheit) || 277 || 285 || 9 || 3 || N || O || ||
|-
| 9 || BTN-Nummer || 286 || 310 || 25 || || A || M || ||
|-
| 10 || Artikel-Anzahl (je Masseinheit) || 311 || 319 || 9 || 0 || N || M || ||
|-
| 11 || Ursprungsland || 320 || 321 || 2 || || A || M || ||
|-
| 12 || Artikel-Wert (je Masseinheit) || 322 || 330 || 9 || 2 || N || M || ||
|-
| 13 || Artikelwert-Währung || 331 || 333 || 3 || || A || M || || ISO-Währung (z.B. "EUR")
|-
| 14 || Artikelwert-Masseinheit || 334 || 343 || 10 || || A || M || || keine Vorgabe kann frei Belegt werden (z.B. Stück, Rollen, etc.)
|-
| 15 || CR/LF || 344 || 345 || 2 || || || || || Carriage Return / Line Feed
|}

= Gefahrgut =

Die Gefahrgutdaten geben die Gefahreneigenschaften eines zu transportierenden Stoffes an. Ein Stoff kann mehrere Gefahrgutdaten besitzen.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || || || Fest 'GEF'
|-
| 2 || GefahrgutUNNr || 4 || 7 || 4 || || A || || ||
|-
| 3 || GefahrgutKlasse || 8 || 11 || 4 || || A || || ||
|-
| 4 || GefahrgutVPG || 12 || 14 || 3 || || A || || || I,II,III bzw. leer
|-
| 5 || GefahrgutKCode || 15 || 18 || 4 || || A || || || Pflicht bei Klasse 2
|-
| 6 || GefahrgutBezeichnung || 19 || 128 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle
|-
| 7 || GefahrgutMenge || 129 || 139 || 11 || 3 || N || || ||
|-
| 8 || GefahrgutBegrenzteMenge || 140 || 140 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'
|-
| 9 || GefahrgutVerpAnzahl || 141 || 143 || 3 || || N || || ||
|-
| 10 || GefahrgutVerpackungsart || 144 || 151 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.
|-
| 11 || GefahrgutID || 152 || 159 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten
|-
| 12 || GefahrgutNebengefahr || 160 || 171 || 12 || || A || || || GG-Nebengefahrklasse(n)
|-
| 13 || GefahrgutBuchst640 || 172 || 172 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)
|-
| 14 || GefahrgutMengeneinheit || 173 || 173 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter
|-
| 15 || GefahrgutBefoerdKat || 174 || 174 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6
|-
| 16 || GefahrgutFaktor || 175 || 178 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6
|-
| 17 || GefahrgutNettoExplMasse || 179 || 189 || 11 || 3 || N || || || Nur bei Klasse 1, dann aber Pflicht
|-
| 18 || GefahrgutTunnelBCode || 190 || 199 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)
|-
| 19 || GefahrgutFreigestMenge || 200 || 200 || 1 || || A || || || '*' oder 'T': Status 'Freigestellte Menge' (überstimmt Feld 8)
|-
| 20 || GefahrgutUmweltgef || 201 || 201 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'
|-
| 21 || GefahrgutTechBenennung || 202 || 301 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut
|-
| 22 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed
|}

= Gefahrgutstamm =

Im Gefahrgutstamm legt man die Eigenschaften eines Gefahrguts fest, welche dann in der HVS32 Datenbank gespeichert werden. Anschließend kann man über die GefahrgutID und Menge die Eigenschaften des Gefahrgutstoffs abrufen und dem jeweiligen Packstück zuordnen. Somit müssen nicht immer alle Gefahrgutdaten aus dem Vorsystem übergeben werden.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || GefahrgutID || 1 || 8 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten
|-
| 2 || GefahrgutBezeichnung || 9 || 118 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle
|-
| 3 || GefahrgutTechBenennung || 119 || 218 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut
|-
| 4 || GefahrgutUNNR || 219 || 222 || 4 || || A || || ||
|-
| 5 || GefahrgutKlasse || 223 || 226 || 4 || || A || || ||
|-
| 6 || GefahrgutNebenGefahr || 227 || 238 || 12 || || A || || || GG-Nebengefahrklasse(n)
|-
| 7 || GefahrgutVPG || 239 || 241 || 3 || || A || || || I,II,III bzw. leer
|-
| 8 || GefahrgutKCode || 242 || 245 || 4 || || A || || || Pflicht bei Klasse 2
|-
| 9 || GefahrgutFaktor || 246 || 249 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6
|-
| 10 || GefahrgutBefoerdKat || 250 || 250 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6
|-
| 11 || GefahrgutBuchst640 || 251 || 251 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)
|-
| 12 || GefahrgutMengenEinheit || 252 || 252 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter
|-
| 13 || GefahrgutVerpackungsart || 253 || 260 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.
|-
| 14 || GefahrgutTunnelBCode || 261 || 270 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)
|-
| 15 || GefahrgutBegrenzteMenge || 271 || 271 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'
|-
| 16 || Umweltgefaehrdend || 272 || 272 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'
|-
| 17 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed
|}

= Datentypen =

A - Alphanumerisch - Besteht aus Zahlen und Buchstaben 
N - Numerisch - Besteht ausschließlich aus Zahlen

= Beispiele =

<div style="overflow-x: scroll">

CSV-Datei - Sendungsdaten einer Sendung mit zwei Packstücken und Definitionszeile. [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten.csv Download File]

SatzKennung;KundenNummer;EmpfängerName1;EmpfängerName2;EmpfängerName3;EmpfängerStrasse;EmpfängerLKZ;EmpfängerPLZ;EmpfängerOrt;EmpfängerRegion/Staat;EmpfängerBahnhof;AnsprechpartnerEmpfänger;TelefonNummerEmpfänger;FaxNummerEmpfänger;UstIDNummerEmpfänger;ILNNummerEmpfänger;"Mandant";"Versandart";AVISHinweis1;AVISHinweis2;AVISZusatz1;AVISZusatz2;LieferscheinNummer;AuftragsNummer;BestellNummer;Warenwert;WarenwertWährung;Nachnahme;NachnahmeWährung;NachnahmeVermerk;NachnahmeVerwendungszweck;HöherVersicherungswert;HöherVersicherungswertWährung;FrankaturKennung;Zahlungsbedingung;ZahlungsbedingungZollSteuern;FrachtführerKundenNr;Sonderdienst;SendungsInhalt;TerminArt;TerminDatum;TerminZeit;NeutralAbsenderName1;NeutralAbsenderName2;NeutralAbsenderName3;NeutralAbsenderStrasse;NeutralAbsenderLKZ;NeutralAbsenderPLZ;NeutralAbsenderOrt;RechnungsempfängerName1;RechnungsempfängerName2;RechnungsempfängerName3;RechnungsempfängerStrasse;RechungsempfängerLKZ;RechungsempfängerPLZ;RechungsempfängerOrt;PostLeitcode;PostZielfrachtzentrum;FrachtbriefNr;GewichtBruttoGewichtNettoPackstückAnzahl;PackstückNummer;Verpackungsart;LängePackstückBreitePackstückHöhePackstückPackPlatzNr;HostseitigePackstückID
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;ZusatzInfo;200,00;EUR;;20,00;20;2;1;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KARTON;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;weitereInfo;200,00;EUR;;20,00;14;2;2;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
{|
|}

CSV-Datei - Sendungsdaten und Artikeldaten einer Sendung mit zwei Packstücken mit jeweils zwei Artikeln [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten_Artikeldaten.csv Download File]IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
ART;487010005;1;1;321321;Test Artikel1;;30;321321231;2;DE;20;EUR;STUECK; 
ART;487010005;1;2;321323;Test Artikel2;;30;321321233;2;DE;20;EUR;STUECK;
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
ART;487010005;2;2;321322;Test Artikel3;;30;321321232;2;DE;20;EUR;STUECK; 
ART;487010005;2;2;321322;Test Artikel4;;30;321321232;2;DE;20;EUR;STUECK;
{|
|}

CSV-Datei - Sendungsdaten und Gefahrgut Positionen einer Sendung mit zwei Packstücken mit jeweils drei Gefahrgut Positionen [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten_GefahrgutPositionen.csv Download File]
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123; 
GEF;1072;2.2;III;1O;3;SAUERSTOFF VERDICHTET / Sauerstoff-Flasche fllen 2 Liter CONOXIA©;;2;;;;56944;(5.1);;1;1;;(E);;;;25 
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Alleskleber Flinke Flasche 90g Uhu;;90;;;;12667;;;1;3;;(D/E);;;;33 
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Elefantenkleber 850gr;;0,85;;;;33566;;;1;3;;(D/E);;;;33 
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123; 
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml ATM2;(Ethylalkohol);0,5;;;;48380;;;1;1;;(D/E);;;;30 
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml Palette;(Ethylalkohol);0,5;;;;51252;;;1;1;;(D/E);;;;30 
GEF;1173;3;II;F1;2;UN 1173 ETHYLACETAT / Nagellackentferner;;0,25;;;;51203;;;1;3;;(D);;;;33 
{|
|}

CSV-Datei - Gefahrgutstamm mit drei drei neuen Gefahrguteinträgen [https://sftp.heidler-strichcode.de/download/wikiextern/Gefahrgutstamm.csv Download File]1013;1013;2;(2.2);Kohlendioxid;;;2A;3;;4G;1; 
1950;1950;2;(2.2);Druckgaspackungen;;;5A;3;;4G;1; 
1956;1956;2;(2.2);Verdichtetes Gas, N.A.G. (Kohlendioxid, Nitrogen);;;1A;3;;4G;1; 
{|
|}

HVS32 File Schnittstelle (Automatik-Polling)

2024-05-08T08:33:41Z

Mnh: /* Beispiele */

[[en:HVS32 default interface]]

= Voraussetzungen =

Eine beliebige HVS-Version.

= Funktionsbeschreibung =

Diese Schnittstelle listet die am häufigsten verwendeten Felder auf und beschreibt die Positionen der Daten im Standard-Datei-Import. Das Format kann in Rücksprache mit Ihrem Ansprechpartner sehr flexibel erweitert und angepasst werden. Es wird eine Zeile pro Packstück erwartet, mehrere Packstücke dürfen in einer Datei enthalten sein.

In einem spaltenbasierten Format geben die Felder "Von" und "Bis" die Positionen der Daten an, in einem Format wie CSV wird die Spalte "Nr." ausgewertet.

= Sendungsdaten =

Die Sendungsdaten geben die Eigenschaften eines Packstücks an.

Erläuterung Spalte Pflicht: M= Must / O= Optional / C= Conditional (in Abhängigkeit der Carrier Belange)

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || 3 || "IMP" / "EXP"
|-
| || '''--- SENDUNGS-TEIL ---''' || || || || || || || ||
|-
| 2 || Kunden-Nummer || 4 || 13 || 10 || || A || O || 20 || Kdnr des Empfängers beim Versender
|-
| 3 || Empfänger-Name1 || 14 || 43 || 30 || || A || M || 50 || LIEFER-ADRESSE
|-
| 4 || Empfänger-Name2 || 44 || 73 || 30 || || A || O || 50 || EMPFÄNGER
|-
| 5 || Empfänger-Name3 || 74 || 103 || 30 || || A || O || 50 ||
|-
| 6 || Empfänger-Strasse || 104 || 133 || 30 || || A || M || 50 ||
|-
| 7 || Empfänger-LKZ || 134 || 136 || 3 || || A || M || 3 ||
|-
| 8 || Empfänger-PLZ || 137 || 146 || 10 || || A || M || 10 ||
|-
| 9 || Empfänger-Ort || 147 || 176 || 30 || || A || M || 50 ||
|-
| 10 || Empfänger-Region / Staat || 177 || 196 || 20 || || A || C || 20 || Staat/Provinz (z.B. für USA wichtig)
|-
| 11 || Empfänger-Bahnhof || 197 || 226 || 30 || || A || O || 30 || PLZ und Ort
|-
| 12 || Ansprechpartner Empfänger || 227 || 246 || 20 || || A || O || 50 ||
|-
| 13 || Telefon-Nummer Empfänger || 247 || 266 || 20 || || A || C || 30 ||
|-
| 14 || Fax-Nummer Empfänger || 267 || 286 || 20 || || A || O || 30 ||
|-
| 15 || Ust-ID-Nummer Empfänger || 287 || 306 || 20 || || A || O || 20 ||
|-
| 16 || ILN-Nummer Empfänger || 307 || 319 || 13 || || A || C || 13 || Pflicht bei Metro-Versand
|-
| 17 || Mandant (HVS32: "Auftraggeber_ID") || 320 || 327 || 8 || || A || M || 10 ||
|-
| 18 || Versandart (HVS32: "Versandart_ID") || 328 || 333 || 6 || || A || M || 10 || Pflicht bei Automatikpolling
|-
| 19 || AVIS-Hinweis 1 || 334 || 363 || 30 || || A || O || 30 ||
|-
| 20 || AVIS-Hinweis 2 || 264 || 393 || 30 || || A || O || 30 ||
|-
| 21 || AVIS-Zusatz 1 || 394 || 413 || 60 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 1
|-
| 22 || AVIS-Zusatz 2 || 414 || 433 || 60 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 2
|-
| 23 || Lieferschein-Nummer || 434 || 443 || 10 || 0 || A || M || 40 || Wird im VS als Such-Nummer verwendet
|-
| 24 || Auftrags-Nummer || 444 || 453 || 10 || || A || O || 50 ||
|-
| 25 || Bestell-Nummer || 454 || 473 || 20 || || A || O || 50 || Metro-Bestellnr (Metro-Versand)
|-
| 26 || Warenwert || 474 || 482 || 9 || 2 || N || C || 9 ||
|-
| 27 || Warenwert-Währung || 483 || 485 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 28 || Nachnahme || 486 || 494 || 9 || 2 || N || C || 9 ||
|-
| 29 || Nachnahme-Währung || 495 || 497 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 30 || Nachnahme-Vermerk || 498 || 498 || 1 || || A || C || 1 || 'B': Bar / 'V': Verrechnungsscheck
|-
| 31 || Nachnahme-Verwendungszweck || 499 || 518 || 20 || || A || C || 30 ||
|-
| 32 || Höher-Versicherungswert || 519 || 527 || 9 || 2 || N || C || 9 ||
|-
| 33 || Höher-Versicherungswert-Währung || 528 || 530 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 34 || Frankatur-Kennung || 531 || 540 || 10 || || A || C || 10 ||
|-
| 35 || Zahlungsbedingung || 541 || 550 || 10 || || A || C || 10 || 'S':Sender,'R':Empfänger
|-
| 36 || Zahlungsbedingung Zoll/Steuern || 551 || 551 || 1 || || A || C || 1 || 'S':Sender,'R':Empfänger
|-
| 37 || Frachtführer-Kunden-Nr || 552 || 561 || 10 || || A || C || 20 || Kdnr des Frachtzahlers beim Frachtführer
|-
| 38 || Sonderdienst || 562 || 591 || 30 || || A || C || 30 || versandart-spezifisch belegt
|-
| 39 || Sendungs-Inhalt || 592 || 621 || 30 || || A || C || 30 ||
|-
| 40 || Termin-Art || 622 || 622 || 1 || || A || C || 1 || 'A'b / 'B'is / 'F'ix
|-
| 41 || Termin-Datum || 623 || 632 || 10 || || A || C || 10 || TT.MM.JJJJ
|-
| 42 || Termin-Zeit || 633 || 637 || 5 || || A || C || 5 || HH:MM
|-
| 43 || Neutral-Absender-Name1 || 638 || 667 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 44 || Neutral-Absender-Name2 || 668 || 697 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 45 || Neutral-Absender-Name3 || 698 || 727 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 46 || Neutral-Absender-Strasse || 728 || 757 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 47 || Neutral-Absender-LKZ || 758 || 760 || 3 || || A || O || 3 || Nur bei Neutral-Absendern belegt
|-
| 48 || Neutral-Absender-PLZ || 761 || 770 || 10 || || A || O || 10 || Nur bei Neutral-Absendern belegt
|-
| 49 || Neutral-Absender-Ort || 771 || 800 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 50 || Rechnungsempfänger-Name1 || 801 || 830 || 30 || || A || C || 50 || RECHNUNGSADRESSE
|-
| 51 || Rechnungsempfänger-Name2 || 831 || 860 || 30 || || A || O || 50 || EMPFÄNGER
|-
| 52 || Rechnungsempfänger-Name3 || 861 || 890 || 30 || || A || O || 50 ||
|-
| 53 || Rechnungsempfänger-Strasse || 891 || 920 || 30 || || A || C || 50 ||
|-
| 54 || Rechungsempfänger-LKZ || 921 || 923 || 3 || || A || C || 3 ||
|-
| 55 || Rechungsempfänger-PLZ || 924 || 933 || 10 || || A || C || 10 ||
|-
| 56 || Rechungsempfänger-Ort || 934 || 963 || 30 || || A || C || 50 ||
|-
| 57 || Post-Leitcode || 964 || 978 || 15 || || A || C || 15 ||
|-
| 58 || Post-Zielfrachtzentrum || 979 || 983 || 5 || || A || C || 5 ||
|-
| 59 || Frachtbrief-Nr || 984 || 1003 || 20 || || A || O || 20 || falls Fr.brief d. Vorsystem gedruckt
|-
| || '''--- PACKSTÜCK-TEIL ---''' || || || || || || || ||
|-
| 60 || Gewicht Brutto (kg) || 1004 || 1011 || 8 || 3 || N || M || 8 ||
|-
| 61 || Gewicht Netto (kg) || 1012 || 1019 || 8 || 3 || N || O || 8 ||
|-
| 62 || Packstück-Anzahl || 1020 || 1022 || 3 || 0 || N || C || 3 || Gesamt-Anzahl Colli der Sendung+J15
|-
| 63 || Packstück-Nummer || 1023 || 1025 || 3 || 0 || N || C || 3 || Laufende Nr pro Sendung
|-
| 64 || Verpackungsart || 1026 || 1031 || 6 || || A || C || 20 ||
|-
| 65 || Länge Packstück (cm) || 1032 || 1035 || 4 || 0 || N || C || 4 ||
|-
| 66 || Breite Packstück (cm) || 1036 || 1039 || 4 || 0 || N || C || 4 ||
|-
| 67 || Höhe Packstück (cm) || 1040 || 1043 || 4 || 0 || N || C || 4 ||
|-
| 68 || PackPlatz-Nr || 1044 || 1053 || 10 || || A || C || 10 || System, das den Auftrag verarbeiten soll
|-
| 69 || Hostseitige Packstück-ID || 1054 || 1068 || 15 || || A || C || 20 ||
|-
| || '''--- RÜCKMELDE-TEIL ---''' || || || || || || || ||
|-
| 70 || Paket-Nummer || 1069 || 1083 || 15 || || A || || 15 || Nummernkreis-Nr des Frachtführers
|-
| 71 || Tracking-Nummer || 1084 || 1113 || 30 || || A || || 30 ||
|-
| 72 || Druck-Datum || 1114 || 1123 || 10 || || A || || 10 || Datum der Abarbeitung (TT.MM.CCJJ)
|-
| 73 || Versand-Datum || 1124 || 1133 || 10 || || A || || 10 || Datum der Versendung(TT.MM.CCJJ)
|-
| 74 || Fracht-Gebühr || 1134 || 1141 || 8 || 2 || N || || 8 || Frachtkosten
|-
| 75 || Währung Fracht-Gebühr || 1142 || 1144 || 3 || || A || || 3 || ISO-Währungscode
|-
| 76 || Status || 1145 || 1149 || 5 || || A || || 5 ||
|-
| 77 || Ladelisten-Nummer || 1150 || 1153 || 4 || || A || || 4 ||
|-
| || '''--- STEUERUNGS-TEIL ---''' || || || || || || || ||
|-
| 78 || IMPStatus || 1154 || 1154 || 1 || || A || || 1 || 'L':Löschsatz,'F':Fehlersatz, sonst Leer
|-
| 79 || Fehlertext || 1155 || 1214 || 60 || || A || || 60 || Fehler bei Eingangs-Plausi-Prüfung
|-
| 80 || Gefahrgut-Status || 1215 || 1217 || 3 || || A || || 3 || Für int. Kommunikation, nach Absprache
|-
| 81 || ReferenzNr || 1218 || 1237 || 20 || || A || || 20 || Für int. Kommunikation, nach Absprache
|-
| || '''--- Zusatz - Teil ---''' || || || || || || || ||
|-
| 82 || Broker-Name || 1238 || 1262 || 25 || || A || C || 25 ||
|-
| 83 || Broker-Telefonnummer || 1263 || 1282 || 20 || || A || C || 20 ||
|-
| 84 || Hold-At-Location J/N || 1283 || 1283 || 1 || || A || C || 1 || 'J': ja, 'N' oder Blank: Nein
|-
| 85 || Hold-At-Location Telefon || 1284 || 1303 || 20 || || A || C || 20 || Mit Telefonnummer belegt
|-
| 86 || Hold-At-Location Ansprechpartner || 1304 || 1333 || 30 || || A || C || 30 || Mit einem Ansprechpartner belegt
|-
| || '''--- Zusatz - HVS32 ---''' || || || || || || || ||
|-
| 87 || AnzahlArtikel || 1334 || 1339 || 6 || || || O || 6 || Anzahl Artikel (Druck auf Etikett)
|-
| 88 || ZusatzZeile1 || 1340 || 1369 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)
|-
| 89 || ZusatzZeile2 || 1370 || 1399 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)
|-
| 90 || Frei-AVIS1 || 1400 || 1461 || 62 || || A || O || 62 ||
|-
| 91 || Frei-AVIS2 || 1462 || 1523 || 62 || || A || O || 62 ||
|-
| 92 || Status "Elektronik-Artikel" J/N || 1524 || 1524 || 1 || || A || O || 1 || 'J'/'T'(True): Elektronik-Artikel, ansonsten nicht
|-
| 93 || Empfänger-Emailadresse || 1525 || 1604 || 80 || || A || O || 80 || f. automatische Mailavisierung
|-
| 94 || Kostenstelle || 1605 || 1634 || 30 || || A || O || 30 ||
|-
| 95 || Druckername || 1635 || 1664 || 30 || || A || O || 30 || Name eines Ausgabekanals im HVS32
|-
| 96 || CR/LF || 1665 || 1666 || 2 || || || M || 2 || Carriage Return/Line Feed
|}

= Artikeldaten =

Die Artikeldaten geben die Eigenschaften eines Artikels an. Ein Packstück kann mehrere Artikel beinhalten.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || || Festeintrag "ART"
|-
| 2 || Lieferschein-Nr || 4 || 13 || 10 || || A || M || || nicht Pflicht im Dateipolling mit Vormerkdaten
|-
| 3 || Packstück-Nr || 14 || 16 || 3 || || N || C || || nicht Pflicht im Dateipolling mit Vormerkdaten
|-
| 4 || Positions-Nr || 17 || 26 || 10 || 0 || N || M || ||
|-
| 5 || Artikel-Nr || 27 || 76 || 50 || || A || O || ||
|-
| 6 || Artikel-Bezeichnung 1 || 77 || 176 || 100 || || A || M || ||
|-
| 7 || Artikel-Bezeichnung 2 || 177 || 276 || 100 || || A || O || ||
|-
| 8 || Artikel-Netto-Gewicht (je Masseinheit) || 277 || 285 || 9 || 3 || N || O || ||
|-
| 9 || BTN-Nummer || 286 || 310 || 25 || || A || M || ||
|-
| 10 || Artikel-Anzahl (je Masseinheit) || 311 || 319 || 9 || 0 || N || M || ||
|-
| 11 || Ursprungsland || 320 || 321 || 2 || || A || M || ||
|-
| 12 || Artikel-Wert (je Masseinheit) || 322 || 330 || 9 || 2 || N || M || ||
|-
| 13 || Artikelwert-Währung || 331 || 333 || 3 || || A || M || || ISO-Währung (z.B. "EUR")
|-
| 14 || Artikelwert-Masseinheit || 334 || 343 || 10 || || A || M || || keine Vorgabe kann frei Belegt werden (z.B. Stück, Rollen, etc.)
|-
| 15 || CR/LF || 344 || 345 || 2 || || || || || Carriage Return / Line Feed
|}

= Gefahrgut =

Die Gefahrgutdaten geben die Gefahreneigenschaften eines zu transportierenden Stoffes an. Ein Stoff kann mehrere Gefahrgutdaten besitzen.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || || || Fest 'GEF'
|-
| 2 || GefahrgutUNNr || 4 || 7 || 4 || || A || || ||
|-
| 3 || GefahrgutKlasse || 8 || 11 || 4 || || A || || ||
|-
| 4 || GefahrgutVPG || 12 || 14 || 3 || || A || || || I,II,III bzw. leer
|-
| 5 || GefahrgutKCode || 15 || 18 || 4 || || A || || || Pflicht bei Klasse 2
|-
| 6 || GefahrgutBezeichnung || 19 || 128 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle
|-
| 7 || GefahrgutMenge || 129 || 139 || 11 || 3 || N || || ||
|-
| 8 || GefahrgutBegrenzteMenge || 140 || 140 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'
|-
| 9 || GefahrgutVerpAnzahl || 141 || 143 || 3 || || N || || ||
|-
| 10 || GefahrgutVerpackungsart || 144 || 151 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.
|-
| 11 || GefahrgutID || 152 || 159 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten
|-
| 12 || GefahrgutNebengefahr || 160 || 171 || 12 || || A || || || GG-Nebengefahrklasse(n)
|-
| 13 || GefahrgutBuchst640 || 172 || 172 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)
|-
| 14 || GefahrgutMengeneinheit || 173 || 173 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter
|-
| 15 || GefahrgutBefoerdKat || 174 || 174 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6
|-
| 16 || GefahrgutFaktor || 175 || 178 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6
|-
| 17 || GefahrgutNettoExplMasse || 179 || 189 || 11 || 3 || N || || || Nur bei Klasse 1, dann aber Pflicht
|-
| 18 || GefahrgutTunnelBCode || 190 || 199 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)
|-
| 19 || GefahrgutFreigestMenge || 200 || 200 || 1 || || A || || || '*' oder 'T': Status 'Freigestellte Menge' (überstimmt Feld 8)
|-
| 20 || GefahrgutUmweltgef || 201 || 201 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'
|-
| 21 || GefahrgutTechBenennung || 202 || 301 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut
|-
| 22 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed
|}

= Gefahrgutstamm =

Im Gefahrgutstamm legt man die Eigenschaften eines Gefahrguts fest, welche dann in der HVS32 Datenbank gespeichert werden. Anschließend kann man über die GefahrgutID und Menge die Eigenschaften des Gefahrgutstoffs abrufen und dem jeweiligen Packstück zuordnen. Somit müssen nicht immer alle Gefahrgutdaten aus dem Vorsystem übergeben werden.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || GefahrgutID || 1 || 8 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten
|-
| 2 || GefahrgutBezeichnung || 9 || 118 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle
|-
| 3 || GefahrgutTechBenennung || 119 || 218 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut
|-
| 4 || GefahrgutUNNR || 219 || 222 || 4 || || A || || ||
|-
| 5 || GefahrgutKlasse || 223 || 226 || 4 || || A || || ||
|-
| 6 || GefahrgutNebenGefahr || 227 || 238 || 12 || || A || || || GG-Nebengefahrklasse(n)
|-
| 7 || GefahrgutVPG || 239 || 241 || 3 || || A || || || I,II,III bzw. leer
|-
| 8 || GefahrgutKCode || 242 || 245 || 4 || || A || || || Pflicht bei Klasse 2
|-
| 9 || GefahrgutFaktor || 246 || 249 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6
|-
| 10 || GefahrgutBefoerdKat || 250 || 250 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6
|-
| 11 || GefahrgutBuchst640 || 251 || 251 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)
|-
| 12 || GefahrgutMengenEinheit || 252 || 252 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter
|-
| 13 || GefahrgutVerpackungsart || 253 || 260 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.
|-
| 14 || GefahrgutTunnelBCode || 261 || 270 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)
|-
| 15 || GefahrgutBegrenzteMenge || 271 || 271 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'
|-
| 16 || Umweltgefaehrdend || 272 || 272 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'
|-
| 17 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed
|}

= Datentypen =

A - Alphanumerisch - Besteht aus Zahlen und Buchstaben 
N - Numerisch - Besteht ausschließlich aus Zahlen

= Beispiele =

<div style="overflow-x: scroll">

CSV-Datei - Sendungsdaten einer Sendung mit zwei Packstücken und Definitionszeile. [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten.csv Download File]

SatzKennung;KundenNummer;EmpfängerName1;EmpfängerName2;EmpfängerName3;EmpfängerStrasse;EmpfängerLKZ;EmpfängerPLZ;EmpfängerOrt;EmpfängerRegion/Staat;EmpfängerBahnhof;AnsprechpartnerEmpfänger;TelefonNummerEmpfänger;FaxNummerEmpfänger;UstIDNummerEmpfänger;ILNNummerEmpfänger;"Mandant";"Versandart";AVISHinweis1;AVISHinweis2;AVISZusatz1;AVISZusatz2;LieferscheinNummer;AuftragsNummer;BestellNummer;Warenwert;WarenwertWährung;Nachnahme;NachnahmeWährung;NachnahmeVermerk;NachnahmeVerwendungszweck;HöherVersicherungswert;HöherVersicherungswertWährung;FrankaturKennung;Zahlungsbedingung;ZahlungsbedingungZollSteuern;FrachtführerKundenNr;Sonderdienst;SendungsInhalt;TerminArt;TerminDatum;TerminZeit;NeutralAbsenderName1;NeutralAbsenderName2;NeutralAbsenderName3;NeutralAbsenderStrasse;NeutralAbsenderLKZ;NeutralAbsenderPLZ;NeutralAbsenderOrt;RechnungsempfängerName1;RechnungsempfängerName2;RechnungsempfängerName3;RechnungsempfängerStrasse;RechungsempfängerLKZ;RechungsempfängerPLZ;RechungsempfängerOrt;PostLeitcode;PostZielfrachtzentrum;FrachtbriefNr;GewichtBruttoGewichtNettoPackstückAnzahl;PackstückNummer;Verpackungsart;LängePackstückBreitePackstückHöhePackstückPackPlatzNr;HostseitigePackstückID
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;ZusatzInfo;200,00;EUR;;20,00;20;2;1;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KARTON;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;weitereInfo;200,00;EUR;;20,00;14;2;2;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
{|
|}

CSV-Datei - Sendungsdaten und Artikeldaten einer Sendung mit zwei Packstücken mit jeweils zwei Artikeln [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten_Artikeldaten.csv Download File]IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
ART;487010005;1;1;321321;Test Artikel1;;30;321321231;2;DE;20;EUR;STUECK; 
ART;487010005;1;1;321323;Test Artikel2;;30;321321233;2;DE;20;EUR;STUECK;
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
ART;487010005;2;2;321322;Test Artikel3;;30;321321232;2;DE;20;EUR;STUECK; 
ART;487010005;2;2;321322;Test Artikel4;;30;321321232;2;DE;20;EUR;STUECK;
{|
|}

CSV-Datei - Sendungsdaten und Gefahrgut Positionen einer Sendung mit zwei Packstücken mit jeweils drei Gefahrgut Positionen [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten_GefahrgutPositionen.csv Download File]
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123; 
GEF;1072;2.2;III;1O;3;SAUERSTOFF VERDICHTET / Sauerstoff-Flasche fllen 2 Liter CONOXIA©;;2;;;;56944;(5.1);;1;1;;(E);;;;25 
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Alleskleber Flinke Flasche 90g Uhu;;90;;;;12667;;;1;3;;(D/E);;;;33 
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Elefantenkleber 850gr;;0,85;;;;33566;;;1;3;;(D/E);;;;33 
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123; 
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml ATM2;(Ethylalkohol);0,5;;;;48380;;;1;1;;(D/E);;;;30 
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml Palette;(Ethylalkohol);0,5;;;;51252;;;1;1;;(D/E);;;;30 
GEF;1173;3;II;F1;2;UN 1173 ETHYLACETAT / Nagellackentferner;;0,25;;;;51203;;;1;3;;(D);;;;33 
{|
|}

CSV-Datei - Gefahrgutstamm mit drei drei neuen Gefahrguteinträgen [https://sftp.heidler-strichcode.de/download/wikiextern/Gefahrgutstamm.csv Download File]1013;1013;2;(2.2);Kohlendioxid;;;2A;3;;4G;1; 
1950;1950;2;(2.2);Druckgaspackungen;;;5A;3;;4G;1; 
1956;1956;2;(2.2);Verdichtetes Gas, N.A.G. (Kohlendioxid, Nitrogen);;;1A;3;;4G;1; 
{|
|}

Setup: Benutzerverwaltung

2024-04-17T07:42:52Z

Mnh:

[[null]]

Funktionen des Erweiterungsmodules "Benutzerverwaltung":
-Anlage eigener HVS32 Benutzer
-Änderung der Standardpasswörter
-Anpassung der Benutzerlevel
-individuelle Rechtevergabe pro HVS32 Benutzer

Die Benutzerverwaltung ist ein kostenpflichtiges Erweiterungsmodul und ist erst nach bestellter Lizenzierung unter folgendem Menüpunkt erreichbar:

Setup > Benutzerverwaltung

In der HVS32 Benutzerverwaltung gibt es bereits vier angelegte Standard Benutzer. Jeder dieser User hat unterschiedliche Rechte innerhalb des HVS32.

{| class="wikitable"
|-
! Benutzer !! Standard Passwort !! Benutzerlevel !! verwendete Lizenzart !! Etikettendruck möglich
|-
| auskunft || auskunft || 0 || Auskunft || Nein
|-
| versand || ... || 1 || Workstation || Ja
|-
| vleiter || ... || 2 || Workstation || Ja
|-
| vadmin || ... || 3 || Workstation || Ja

|}

Die Benutzerlevels gehen von 0 ( am wenigsten Rechte ) bis Level 3 ( am meisten Rechte ). Die Lizenzart ist die benötigte Lizenz im HVS32. Für Level Null ist eine Auskunfts-Lizenz ausreichend, mit welcher aber keine Versandetiketten gedruckt werden können, sondern das HVS32 lediglich mit den Auskunftsmenüpunkten genutzt werden kann.
Mit Level 1 – 3, können Versandetiketten gedruckt werden und Sie benötigen dafür eine HVS32 Workstation – Lizenz. Je nach Benutzerlevel, kann der User im HVS32 mehr oder weniger im HVS32 durchführen.
Die vordefinierten Benutzerlevel (und damit verfügbaren Funktionen) können als Vorlage verwendet werden um dann einzelne Menüpunkte einem Benutzer zuzuweisen oder zu entfernen.

[[Datei:Benutzerverwaltung2.png|rahmenlos|links]]

Hier im Beispiel, wurde ein User „test“ angelegt und mit dem Benutzerlevel 1 versehen. Also dem Standardprofil von „versand“ der am wenigsten Rechte hat, aber trotzdem Drucken kann. Auf der Linken Seite „Module und Optionen“, können Sie dem angelegten User entweder Menüpunkte zuordnen ( von links nach rechts ) oder dem Benutzer Menüpunkte und Funktionen entfernen ( von rechts nach links ).

Schnittstellen: Security Levels und Authentifizierung

2024-02-05T16:35:23Z

Mnh:

'''''Hinweis:''' Dieser Artikel ist "work in progress", die beschriebenen Sicherheitsfeatures für das DataGatewayServer sind auf unserer Entwicklungs-roadmap für Ende Q1/2024 und demnach noch nicht umgesetzt.'' 
Grundsätzlich kann das HVS32 ohne Bedenken in Cloud-Umgebungen betrieben werden, sofern die Verbindung vom Vorsystem (ERP bzw. WMS, nachfolgend der Einfachheit halber nur ERP genannt) zum HVS32 in einem gemeinsamen, gesicherten, internen Netzwerk ist. 
Wenn das Versandsystem HVS32 allerdings öffentlich erreichbar sein muss - also sich das Vorsystem (ERP/WMS) und das Versandsystem HVS32 nicht im gleichen Netzwerk (LAN, vLAN, vNET, private cloud) befinden - muss die Kommunikations-Verbindung der beiden Systeme abgesichert werden. 
Dies impliziert, dass sowohl die Verbindung verschlüsselt als auch jede eingehende Verbindung authentifiziert und autorisiert werden muss. 

=Security Levels (Infrastruktur)=
Zur Absicherung der Netzwerk-Brücke gibt es keine zu 100% perfekte oder sichere Lösung. Meist muss man sich für einen Kompromiss je nach Fall entscheiden. In der Infrastruktur können jedoch bereits diverse Security Levels implementiert werden, um die Sicherheit maßgeblich zu erhöhen.
==LAN / vLAN / vNET / private cloud / VPN==
Befinden sich die beiden Server in einem gemeinsamen Netzwerk, bzw. liegt eine gesicherte Netzwerk-Brücke via VPN zu Grunde, bietet dies grundlegend die beste Basis für eine sichere Datenkommunikation zwischen dem Vorsystem und dem Versandsystem HVS32. 
[[Datei:Securitylevel infrastructure vpn.png|1000px|rahmenlos|Security Level (Infrastruktur) - LAN / vLAN / vNET / private cloud / VPN]] 

==S2S (Server-to-Server)==
Bei einer ungesicherten Netzwerk-Brücke ist unbedingt darauf zu achten, dass die Kommunikation ausschließlich verschlüsselt und authentifiziert stattfindet.
[[Datei:Securitylevel infrastructure s2s.png|1000px|rahmenlos|Security Level (Infrastruktur) - S2S (Server-to-Server)]]
==Dead-End-Server==
Da alle Verbindungen zum DGS (DataGatewayServer - Kommunikations-/Schnittstellen-Software) eingehend sind, kann als zusätzliche Sicherheitsmaßnahme der DGS auf einem separaten Server installiert werden, bei welchem alle ausgehenden Verbindungen via Firewall blockiert werden.
[[Datei:Securitylevel infrastructure des.png|1000px|rahmenlos|Security Level (Infrastruktur) - Dead-End-Server]]

=Authentifizierung=
Authentifizierungs-Mechanismen können nur als "sicher" bezeichnet werden, wenn diese in Kombination mit anderen Sicherheits-Mechanismen wie HTTPS/SSL genutzt werden. Die Verschlüsselung ist mittels HTTPS unter Verwendung von TLSv1.2 oder TLSv1.3 (sofern vom Client unterstützt) möglich. 
Die folgenden Authentifizierungs-Optionen beziehen sich ausschließlich auf die [https://interface.heidler-strichcode.de?version=v2 RESTv2 Schnittstelle]
==Basic Authentication==
Die Basisauthentifizierung ist ein einfaches Authentifizierungsschema, welches in das HTTP-Protokoll integriert ist. Der Client sendet HTTP-Anfragen mit dem Autorisierungsheader, welcher Benutzername und Passwort enthält. 

==Digest Access Authentication==
HTTP Digest Access Authentication ist ein Authentifizierungsmechanismus, der in das HTTP-Protokoll integriert ist und dazu dient, die Sicherheit von Webanwendungen zu erhöhen. Im Gegensatz zur einfachen Basisauthentifizierung überträgt Digest Access Authentication keine Benutzernamen und Passwörter im Klartext, sondern verwendet kryptografisch sichere Methoden. 
Bei der Digest-Authentifizierung sendet der Client eine Anfrage an den Server, der daraufhin eine "Nonce" (eine einmalige Zufallszahl) zurückgibt. Der Client kombiniert diese Nonce mit Benutzername, Passwort, Anfrage-Methode und URI und erstellt einen "Digest" (Prüfzusammenstellung). Dieser Digest wird dann an den Server gesendet. 
Der Server kann den Digest überprüfen, indem er denselben Algorithmus auf der Serverseite anwendet und die berechneten Werte vergleicht. Da der Digest mit Hilfe der Nonce und kryptografisch sicheren Techniken erstellt wird, schützt die Digest-Authentifizierung effektiv vor Angriffen wie Passwortdiebstahl und MitM-Angriffen. 

==API Keys==
Die API-Key-Authentifizierung ist eine einfache Methode zur Sicherung von API-Zugriffen. Bei dieser Authentifizierungsmethode erhält der Benutzer einmalig einen eindeutigen API-Schlüssel (API-Key). Dieser Schlüssel wird dann bei jeder API-Anfrage im Header mit gesendet. 
Der Server überprüft den empfangenen API-Schlüssel, um sicherzustellen, dass die Anfrage von einem autorisierten Benutzer oder einer autorisierten Anwendung stammt. 
Der API-Schlüssel muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, den API-Schlüssel regelmäßig zu zu aktualisieren, um die Sicherheit zu gewährleisten.
==OAuth 2.0==
===Client Credentials===
OAuth 2.0 Client Credentials ist eine Authentifizierungs-Methode im OAuth 2.0-Protokoll, die es einer Anwendung ermöglicht, sich beim Authorization Server (Authentifizierungsserver) zu authentifizieren. Dies ist besonders nützlich für den Zugriff von Anwendungen auf APIs ohne Benutzerbeteiligung und eignet sich gut für server-seitige Kommunikation zwischen Diensten. 
Das ERP wird am Server registriert und erhält eine eindeutige Client-ID und ein Client Secret. 
Inital wird dann von dem ERP eine HTTP-POST-Anfrage an den Authorization Server gesendet, welche die Client-Anmeldeinformationen (Client ID und Client Secret) beinhaltet. Im Response wird ein Access-Token und ein Refresh-Token zurück gemeldet. 
Das ERP sendet nun für die Authentifizierung bei jeder Anfrage das Access-Token im Authorization Header der HTTP-Anfragen mit. Wenn das Access-Token abgelaufen ist, kann mit dem Refresh-Token ein neuer Access-Token angefragt werden. Im Falle einer mehrfachen Nutzung eines Refresh-Tokens werden automatisch alle Refresh-Tokens und Access-Tokens gesperrt. 
Das Client Secret muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, das Client Secret regelmäßig zu zu aktualisieren, um die Sicherheit weiter zu erhöhen.

===Authorization Code===
Diese Authentifizierungs-Methode ist ausschließlich über das Authentifzierungssystem [[IRIS_Cloudsystem|IRIS Cloudsystem]] möglich.

Schnittstellen: Security Levels und Authentifizierung

2024-02-05T16:35:02Z

Mnh:

[[null]]
'''''Hinweis:''' Dieser Artikel ist "work in progress", die beschriebenen Sicherheitsfeatures für das DataGatewayServer sind auf unserer Entwicklungs-roadmap für Ende Q1/2024 und demnach noch nicht umgesetzt.'' 
Grundsätzlich kann das HVS32 ohne Bedenken in Cloud-Umgebungen betrieben werden, sofern die Verbindung vom Vorsystem (ERP bzw. WMS, nachfolgend der Einfachheit halber nur ERP genannt) zum HVS32 in einem gemeinsamen, gesicherten, internen Netzwerk ist. 
Wenn das Versandsystem HVS32 allerdings öffentlich erreichbar sein muss - also sich das Vorsystem (ERP/WMS) und das Versandsystem HVS32 nicht im gleichen Netzwerk (LAN, vLAN, vNET, private cloud) befinden - muss die Kommunikations-Verbindung der beiden Systeme abgesichert werden. 
Dies impliziert, dass sowohl die Verbindung verschlüsselt als auch jede eingehende Verbindung authentifiziert und autorisiert werden muss. 

=Security Levels (Infrastruktur)=
Zur Absicherung der Netzwerk-Brücke gibt es keine zu 100% perfekte oder sichere Lösung. Meist muss man sich für einen Kompromiss je nach Fall entscheiden. In der Infrastruktur können jedoch bereits diverse Security Levels implementiert werden, um die Sicherheit maßgeblich zu erhöhen.
==LAN / vLAN / vNET / private cloud / VPN==
Befinden sich die beiden Server in einem gemeinsamen Netzwerk, bzw. liegt eine gesicherte Netzwerk-Brücke via VPN zu Grunde, bietet dies grundlegend die beste Basis für eine sichere Datenkommunikation zwischen dem Vorsystem und dem Versandsystem HVS32. 
[[Datei:Securitylevel infrastructure vpn.png|1000px|rahmenlos|Security Level (Infrastruktur) - LAN / vLAN / vNET / private cloud / VPN]] 

==S2S (Server-to-Server)==
Bei einer ungesicherten Netzwerk-Brücke ist unbedingt darauf zu achten, dass die Kommunikation ausschließlich verschlüsselt und authentifiziert stattfindet.
[[Datei:Securitylevel infrastructure s2s.png|1000px|rahmenlos|Security Level (Infrastruktur) - S2S (Server-to-Server)]]
==Dead-End-Server==
Da alle Verbindungen zum DGS (DataGatewayServer - Kommunikations-/Schnittstellen-Software) eingehend sind, kann als zusätzliche Sicherheitsmaßnahme der DGS auf einem separaten Server installiert werden, bei welchem alle ausgehenden Verbindungen via Firewall blockiert werden.
[[Datei:Securitylevel infrastructure des.png|1000px|rahmenlos|Security Level (Infrastruktur) - Dead-End-Server]]

=Authentifizierung=
Authentifizierungs-Mechanismen können nur als "sicher" bezeichnet werden, wenn diese in Kombination mit anderen Sicherheits-Mechanismen wie HTTPS/SSL genutzt werden. Die Verschlüsselung ist mittels HTTPS unter Verwendung von TLSv1.2 oder TLSv1.3 (sofern vom Client unterstützt) möglich. 
Die folgenden Authentifizierungs-Optionen beziehen sich ausschließlich auf die [https://interface.heidler-strichcode.de?version=v2 RESTv2 Schnittstelle]
==Basic Authentication==
Die Basisauthentifizierung ist ein einfaches Authentifizierungsschema, welches in das HTTP-Protokoll integriert ist. Der Client sendet HTTP-Anfragen mit dem Autorisierungsheader, welcher Benutzername und Passwort enthält. 

==Digest Access Authentication==
HTTP Digest Access Authentication ist ein Authentifizierungsmechanismus, der in das HTTP-Protokoll integriert ist und dazu dient, die Sicherheit von Webanwendungen zu erhöhen. Im Gegensatz zur einfachen Basisauthentifizierung überträgt Digest Access Authentication keine Benutzernamen und Passwörter im Klartext, sondern verwendet kryptografisch sichere Methoden. 
Bei der Digest-Authentifizierung sendet der Client eine Anfrage an den Server, der daraufhin eine "Nonce" (eine einmalige Zufallszahl) zurückgibt. Der Client kombiniert diese Nonce mit Benutzername, Passwort, Anfrage-Methode und URI und erstellt einen "Digest" (Prüfzusammenstellung). Dieser Digest wird dann an den Server gesendet. 
Der Server kann den Digest überprüfen, indem er denselben Algorithmus auf der Serverseite anwendet und die berechneten Werte vergleicht. Da der Digest mit Hilfe der Nonce und kryptografisch sicheren Techniken erstellt wird, schützt die Digest-Authentifizierung effektiv vor Angriffen wie Passwortdiebstahl und MitM-Angriffen. 

==API Keys==
Die API-Key-Authentifizierung ist eine einfache Methode zur Sicherung von API-Zugriffen. Bei dieser Authentifizierungsmethode erhält der Benutzer einmalig einen eindeutigen API-Schlüssel (API-Key). Dieser Schlüssel wird dann bei jeder API-Anfrage im Header mit gesendet. 
Der Server überprüft den empfangenen API-Schlüssel, um sicherzustellen, dass die Anfrage von einem autorisierten Benutzer oder einer autorisierten Anwendung stammt. 
Der API-Schlüssel muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, den API-Schlüssel regelmäßig zu zu aktualisieren, um die Sicherheit zu gewährleisten.
==OAuth 2.0==
===Client Credentials===
OAuth 2.0 Client Credentials ist eine Authentifizierungs-Methode im OAuth 2.0-Protokoll, die es einer Anwendung ermöglicht, sich beim Authorization Server (Authentifizierungsserver) zu authentifizieren. Dies ist besonders nützlich für den Zugriff von Anwendungen auf APIs ohne Benutzerbeteiligung und eignet sich gut für server-seitige Kommunikation zwischen Diensten. 
Das ERP wird am Server registriert und erhält eine eindeutige Client-ID und ein Client Secret. 
Inital wird dann von dem ERP eine HTTP-POST-Anfrage an den Authorization Server gesendet, welche die Client-Anmeldeinformationen (Client ID und Client Secret) beinhaltet. Im Response wird ein Access-Token und ein Refresh-Token zurück gemeldet. 
Das ERP sendet nun für die Authentifizierung bei jeder Anfrage das Access-Token im Authorization Header der HTTP-Anfragen mit. Wenn das Access-Token abgelaufen ist, kann mit dem Refresh-Token ein neuer Access-Token angefragt werden. Im Falle einer mehrfachen Nutzung eines Refresh-Tokens werden automatisch alle Refresh-Tokens und Access-Tokens gesperrt. 
Das Client Secret muss sicher aufbewahrt werden, um unbefugten Zugriff zu verhindern. Außerdem ist es wichtig, das Client Secret regelmäßig zu zu aktualisieren, um die Sicherheit weiter zu erhöhen.

===Authorization Code===
Diese Authentifizierungs-Methode ist ausschließlich über das Authentifzierungssystem [[IRIS_Cloudsystem|IRIS Cloudsystem]] möglich.

System requirements

2023-11-14T08:00:50Z

Mnh: /* Operating systems */

[[de:Systemvoraussetzungen]]
= '''Operating systems''' =

All operating systems, computer systems and hardware components, which have not been explicitly approved in this document, are to be considered as generally not approved. This contains for example all Linux or MacOS based computers and operating systems. Support requests for not supported/unapproved operating systems could only be processed in a severely limited fashion.
When using unapproved software or hardware there is no guarantee to solve any arising problem.

The following lists always assumes the latest service packs, service releases and updates, which are always required on both the client and server.

The recommendation on multicore processors does not mean, that HVS32 will control the processor load in its current version (multithreading). Based on experience a much more smoother operation is possible with appropriate systems.

=== '''Supported Server Operatingsystems''' ===
*Microsoft Windows Server 2022
*Microsoft Windows Server 2019
*Microsoft Windows Server 2016 
=== '''Supported Client Operatingsystems''' ===
*Microsoft Windows 11
*Microsoft Windows 10

= '''Recommended system requirements ''' =

=== '''Server''' ===

*2,8 GHz Quad-Core CPU
*8 GB RAM
*50 GB free hard disk space
*100 Mbit/s network connection or better

 

=== '''Client''' ===

*2 GHz Intel Pentium or similar AMD CPU
*4 GB RAM
*10 GB free hard disk space
*color screen with resolution 1280 x 1024 or higher

 

= '''Recommended system requirements for central polling''' =

The following system requirements are estimated recommendations. Please make sure your server is scalable easily (VM), so you won't run into issues if you like to add new features or functionalities in the future.

We strongly discourage to set up a VM on a server where the drive performance can be affected by other VMs (e.g. data server), because this can lead to a massive performance hit concerning the HVS32 database service.

For the recommended system requirements we assume an installation with our default components.

Basic version with the following components:

* HVS32 (shipping software)
* 1x HVS32 workstation (processing of requests)
* 1x HVS32Monitoring (monitoring service of the workstation)
* DataGatewayServer (interface to the host system via REST, SOAP, SAP, JDBC, HTTP)
* Com-Manager (interface to the carrier via SFTP, FTP, etc.)
* Carrier-API (web service communication to the carriers)

For processing up to approx. 1000 labels per hour, we recommend the following system requirements:

* Network: min. 100Mbit/s, recommended 1.000 Mbit/s
* HDD: min. 50 GB (SSD)
* CPU: 8 cores
* RAM: 12 GB

If the shipping volume exceeds ~1000 labels per hour, we recommend the following scaling:

for each 1000 labels per hour:

* + 2 cores
* + 3 GB RAM
* + 5 GB HDD(SSD)

When using additional features or functionalities, the server should be scaled as follows. Which applications are used should be clarified in the project meetings.
{| class="wikitable"
|'''description'''
|'''application'''
|'''CPU cores'''
|'''RAM (in GB)'''
|'''HDD (in GB)'''
|'''scaling'''
|-
|additional interfaces to the host system via REST, SOAP, SAP, JDBC oder HTTP
|DataGatewayServer
|2
|2
|2
|per interface
|-
|DHL Parcel
|Leitcode
|2
|2
|10
|once
|-
|Status Event Messages (SEM)
|StatusdatenManager
|1
|1
|5
|for each 1000 labels per hour
|-
|SEM web view
|SEMWeb
|1
|1
|15
|for each 1000 labels per hour
|-
|database archiving
|DBArchivierung
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|min. 50

(depends on how much data has to be archived)
|once

(no further cores / RAM necessary, because for this process all services will be stopped)
|-
|automated daily closing
|MonitoringService
|1
|2
|5
|once
|-
|automated shipping notifications via mail
|AMAService
|1
|1
|5
|once
|-
|calculation of shipping costs + invoice audit
|HFMS
|2

1
|4

0,5
|5

5
|once

for each 1000 labels per hour
|-
|calculation of shipping costs + invoice audit + best price determination
|HFMS / SPM
|4

2
|4

1
|5

5
|once

for each 1000 labels per hour
|}
 

= '''HVS32 networking''' =

For the network operation of the HVS32, a shared program directory on the server is required. This share must be connected as a permanent network drive with a fixed drive letter on the client.
The users need all file permissions in the HVS32 directory mentioned above.
These requirements should be prepared by the administrator until the installation date. A bandwidth of 100 Mbit/sec or faster is required.
If the bandwidth is not achieved or when using Wi-fi connections, we recommend using the HVS32 in terminal server mode.
Since the entire system depends on the bandwidth actually available, special attention should be paid to this issue.
Experience has shown that the availability of the network conntection and the actual data throughput can still lead to problems though.

We explicitly advise against a cross-site operation without a terminal server environment.
 

= '''Windows Terminal Server / Citrix''' =

The support for HVS32 in a Windows Terminal Server environment (RDP) is provided to the same extend as a default installation.
However in a Citrix environment we can not provide support for the environment itself. For Problems at the terminal server or the administration, support can only be provided for the basic default Windows components.
Everything else such as network shares, printer drivers, file permissions and RDP/ Citrix specifix settings etc. remain the responsibility of your system administrator.
We strongly recommend that the installation and configuration process be attended by a system administrator. All HVS32 versions are tested intensely and in detail on the aforementioned operating systems.
However since it is impossible to adjust all eventualities in advance, we can not give you any guarantee for the accurate program execution on every customer system.

 

= '''Default ports to share''' =

{| border="1" cellpadding="1" cellspacing="1" style="width: 600px;"
|-
| style="width: 91px;" | '''FTP / SFTP'''
| style="width: 496px;" | Ports 22 / 21 , respectively all ports that are required for a tansmission via FTP/SFTP. For passive FTP the ports for the UDP backchannel needed to be shared, too.
|-
| style="width: 91px;" | '''DNS'''
| style="width: 496px;" | HVS32 must be able to resolve, FTP, HTTP, HTTPS oder SMTP adresses via DNS.
|-
| style="width: 91px;" | '''HTTP/HTTPS'''
| style="width: 496px;" | HVS32 must be able to resolve and reach HTTP and HTTPD adresses, here the ports 80 and 443 are required (e.g. for carrier UPS)
|-
| style="width: 91px;" | '''SMTP'''
| style="width: 496px;" | To transmit carrier files or send e-mail notifications the configured ports are needed. (default port 25)
|-
| style="width: 91px;" | '''Data Gateway Server'''
| style="width: 496px;" | The HVS32 Clients must have access to the configured ports via DataGatewayServer within the network when using communication to the ERP system (Port 5030 for interactive processing and port 5034 for polling)
|-
| style="width: 91px;" | '''Leitcode'''
| style="width: 496px;" | Port 9000 for Leitcode determination (only neccessary for DHL DE Road)
|-
| style="width: 91px;" | '''Monitoring service'''
| style="width: 496px;" | Port 9034 on the HVS32 with deployed HVS32 monitoring service
|-
| style="width: 91px;" | '''Firebird database'''
| style="width: 496px;" | Port 3050 for Firebird database connection
|-
| style="width: 91px;" | '''Heidler Carrier API'''
| style="width: 496px;" |Port 9090 using the carrier web service connection
|-
| style="width: 91px;" | '''HVS32CommunicationManager'''
| style="width: 496px;" | Port 9009 for communication with the ComManager (via REST)
|-
| style="width: 91px;" | '''ScaleService (REST)'''
| style="width: 496px;" | Port 8100 for communication with the ScaleService (via REST)
|}

Systemvoraussetzungen

2023-11-14T08:00:22Z

Mnh: /* Unterstützte Server Betriebssysteme */

[[en:System requirements]]
= '''Betriebssysteme''' =

Alle Betriebssysteme, Computersysteme und Hardwarekomponenten, die in diesem Dokument nicht ausdrücklich als freigegeben deklariert sind, gelten grundsätzlich als nicht freigegeben. Dazu gehören z.B. alle Linux- und MacOS-basierten Computer und Betriebssysteme. Support-Anfragen zu nicht unterstützten Betriebssystemen können nur im stark eingeschränkten Maße bearbeitet werden.

Grundsätzlich werden bei den unten angegebenen Client- und Server-Betriebssystemen immer die aktuellsten Service-Packs bzw. Service-Releases und Updates vorausgesetzt.

Die Empfehlung von Multicore-Prozessoren bedeutet hier nicht, dass HVS32 in den aktuellen Versionen die Prozessorauslastung direkt steuert (Multithreading), sondern erfahrungsgemäß ein deutlich flüssigeres Arbeiten mit entsprechenden Systemen möglich ist.

Wir empfehlen die Verwendung eines 64-Bit-Betriebssystems. Bei Verwendung von Zusatzmodulen wie z.B. ComManager oder Heidler Carrier API ist ein 64-Bit Betriebssystem Voraussetzung.

=== '''Unterstützte Server Betriebssysteme''' ===
*Microsoft Windows Server 2022
*Microsoft Windows Server 2019
*Microsoft Windows Server 2016

=== '''Unterstützte Client Betriebssysteme''' ===
*Microsoft Windows 11
*Microsoft Windows 10
= '''Empfohlene Systemvoraussetzungen''' =
==='''Server'''===
*2,8 GHz Quad-Core Prozessor
*8 GB Arbeitsspeicher
*200 GB verfügbarer Festplattenspeicher (SSD)
*100 Mbit/s Netzwerk Anbindung oder besser
=== '''Client''' ===

*2 GHz Intel Pentium oder vergleichbarer AMD Prozessor
*4 GB Arbeitsspeicher
*10 GB verfügbarer Festplattenspeicher
*Farbmonitor mit einer Auflösung von 1920 x 1080 oder höher
= '''Empfohlene Systemvoraussetzungen für zentrales Polling (Server)''' =
Bei den nachfolgenden Systemvoraussetzungen handelt es sich um eine Empfehlung, welche grob abgeschätzt worden ist. Beim Aufsetzen sollte unbedingt darauf geachtet werden, dass der Server später einfach zu skalieren ist (VM), da durch Zuschaltung von Frachtführern oder weiteren Funktionalitäten zusätzliche Applikationen notwendig sein könnten, wodurch der Server mehr Ressourcen benötigt.

Es wird davon abgeraten, die VM auf einem Server aufzusetzen, welcher durch andere VMs in der Festplattengeschwindigkeit beeinträchtigt wird (z.B. Datenserver), da dies zu massiven Geschwindigkeitseinbußen in Bezug auf den HVS32 Datenbankdienst führen kann.

Bei den Systemvoraussetzungen gehen wir von einer Installation aus, in welcher unsere gängigsten Applikationen zum Einsatz kommen.

Basisversion mit folgenden Komponenten:

* HVS32 (Versandsystem)
* 1x HVS32 Packstation (Verarbeitung der Anfragen)
* 1x HVS32Monitoring (Monitoringdienst für die Packstation)
* DataGatewayServer (Schnittstelle zum Hostsystem via REST, SOAP, SAP, JDBC, HTTP)
* Com-Manager (Schnittstelle zum Frachtführer via SFTP, FTP, etc.)
* Carrier-API (Webservice Kommunikation zu den Frachtführern)

Bei einer Verarbeitung bis zu ~1000 Packstücke / Stunde empfehlen wir folgende Systemvoraussetzungen:

* Netzwerk: min. 100Mbit/s, empfohlen 1.000 Mbit/s
* Festplattenspeicher: min. 50 GB (SSD)
* CPU: 8 Kerne
* Arbeitsspeicher: 12 GB

Geht das Versandvolumen über die ~1000 Packstücke / Stunde hinaus, empfehlen wir folgende Skalierung:

Pro weitere ~1000 Packstücke / Stunde:

* + 2 Kerne
* + 3 GB Arbeitsspeicher
* + 5 GB Festplattenspeicher (SSD)
(Bei der Skalierung rechnen wir mit einer höheren Ressourcenauslastung der Basiskomponenten, sowie den zusätzlichen Einsatz einer weiteren HVS32 Packstation mit dazugehörenden HVS32Monitoring)

Bei Einsatz von weiteren Applikationen, sollte der Server wie folgt skaliert werden. Welche Applikationen zum Einsatz kommen, sollte in den Projektabsprachen geklärt werden.
{| class="wikitable"
|'''Externe Beschreibung'''
|'''Applikation'''
|'''CPU Kerne'''
|'''Arbeitsspeicher (in GB)'''
|'''Festplattenspeicher (in GB)'''
|'''Skalierung'''
|-
|weitere Schnittstellen zum Hostsystem via REST, SOAP, SAP, JDBC oder HTTP
|DataGatewayServer
|2
|2
|2
|pro Schnittstelle
|-
|DHL Paket
|Leitcode
|2
|2
|10
|einmalig
|-
|Statusdaten
|StatusdatenManager
|1
|1
|5
|pro ~1000 Packstücke / Stunde
|-
|Statusdaten Webansicht
|SEMWeb
|1
|1
|15
|pro ~1000 Packstücke / Stunde
|-
|Datenbank-Archivierung
|DBArchivierung
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|min. 50

(abhängig, wie viele Daten archiviert werden sollen)
|einmalig

(keine zusätzlichen Kerne / Arbeitsspeicher notwendig, da die restlichen Dienste beendet werden)
|-
|automatisierter Tagesabschluss
|MonitoringService
|1
|2
|5
|einmalig
|-
|Mail-Avisierung
|AMAService
|1
|1
|5
|einmalig
|-
|Tarifierung + Rechnungsprüfung
|HFMS
|2

1
|4

0,5
|5

5
|einmalig

pro ~1000 Packstücke / Stunde
|-
|Tarifierung + Rechnungsprüfung + Versandartermittlung
|HFMS / SPM
|4

2
|4

1
|5

5
|einmalig

pro ~1000 Packstücke / Stunde
|}
 

= '''Netzwerkbetrieb HVS32''' =

Für den Netzwerkbetrieb des HVS32 wird die Freigabe des HVS32 Programmverzeichnisses auf dem Server vorausgesetzt. Diese Freigabe muss als Netzlaufwerk auf den Clients mit einem festen Laufwerksbuchstaben permanent verbunden sein. Eine Verwendung von UNC Pfaden ist im HVS32 erst ab der Version 7.102.13 möglich. Die Benutzer benötigen Vollzugriff Dateiberechtigungen auf das o.g. HVS32 Verzeichnis und die Freigabe. Diese Voraussetzungen sollten bereits zum Installationstermin vom Administrator vorbereitet werden. Eine Bandbreite bzw. Verbindungsgeschwindigkeit von 100 Mbit/s oder mehr ist erforderlich. Bei nicht erreichen der Bandbreite oder bei WAN Verbindungen empfehlen wir die Verwendung des HVS32 im Terminalserver-Betrieb. Da das komplette System von der tatsächlich verfügbaren Bandbreite abhängig ist, gilt diesem Thema besondere Beachtung. Die Erfahrungen haben gezeigt dass hierbei die Verfügbarkeit der Leitung sowie der tatsächliche Datendurchsatz dennoch zu Problemen führen können. Von einem Standortübergreifenden Betrieb ohne Terminalserver Umgebung raten wir explizit ab.

 

= '''Windows Terminal Server / Citrix''' =

Der Support für HVS32 in einer Windows-Terminalserver-Umgebung (RDP) wird im gleichen Umfang wie auch bei einer Standard Installation geleistet. In einem Citrix-Umfeld können wir jedoch keinen Support für diese Umgebung bieten. Bei Problemen am Terminalserver oder der Verwaltung der Terminalserverumgebung kann der Support nur für die grundlegenden Standard-Windows–Komponenten und Funktionen geleistet werden. Alles andere wie z.B.: Netzwerk-Freigaben, Druckertreiber, Datei-Berechtigungen sowie RDP / Citrix spezifische Einstellungen etc. fallen in den Aufgabenbereich des zuständigen Administrators. Wir empfehlen, dass der Installation und Konfiguration unbedingt ein Systemadministrator beiwohnen sollte. Alle HVS32 Versionen werden ausführlich und intensiv auf den angegebenen Betriebssystemen getestet. Da es unmöglich ist, alle Eventualitäten im Vorfeld nachzustellen, können wir Ihnen auch keine Garantie für den fehlerfreien Programmablauf auf jedem Kundensystem geben.

 

= '''Freizugebende Standard Ports''' =

{| border="1" cellpadding="1" cellspacing="1" style="width: 600px;"
|-
| style="width: 91px;" | '''FTP / SFTP'''
| style="width: 496px;" | Ports 22 / 21 , bzw alle für die FTP/SFTP Übertragung nötigen Ports. Bei passiven FTP muss auch den Rückkanal über UDP beachtet werden.
|-
| style="width: 91px;" | '''DNS'''
| style="width: 496px;" | HVS32 muss die Möglichkeit gegeben werden, FTP, HTTP, HTTPS oder SMTP Adressen über DNS aufzulösen.
|-
| style="width: 91px;" | '''HTTP/HTTPS'''
| style="width: 496px;" | HVS32 muss die Möglichkeit gegeben werden, HTTP und HTTPS Adressen auflösen und erreichen zu können, hier werden die Ports 80 und 443 benötigt (z.B. für Frachtführer UPS)
|-
| style="width: 91px;" | '''SMTP'''
| style="width: 496px;" | Um Frachtführerdateien zu übertragen oder Mail-Avisierungen zu senden werden die dort eingestellten Ports benötigt (Standard Port 25)
|-
| style="width: 91px;" | '''Data Gateway Server'''
| style="width: 496px;" | Die HVS32 Clients müssen bei Einsatz der Kommunikation zum Vorsystem über den DataGatewayServer innerhalb des Netzwerks Zugriff auf die konfigurierten Ports haben (Port 5030 bei interaktiver Verarbeitung und Port 5034 bei Polling)
|-
| style="width: 91px;" | '''Leitcode'''
| style="width: 496px;" | Port 9000 für Leitcodeermittlung (lediglich bei Modul DHL Road notwendig)
|-
| style="width: 91px;" | '''Monitoring Dienst'''
| style="width: 496px;" | Port 9034 auf dem HVS32 bei eingesetztem HVS32 Monitoring Dienst
|-
| style="width: 91px;" | '''Firebird Datenbank'''
| style="width: 496px;" | Port 3050 für Firebird Datenbankverbindung
|-
| style="width: 91px;" | '''Heidler Carrier API'''
| style="width: 496px;" | Port 9900 bei Verwendung der Frachtführer Webservice Anbindung
|-
| style="width: 91px;" | '''HVS32CommunicationManager'''
| style="width: 496px;" | Port 9009 für Kommunikation mit dem ComManager (via REST)
|-
| style="width: 91px;" | '''HFMS'''
| style="width: 496px;" | Port 9500 für Kommunikation mit dem HFMS
|-
| style="width: 91px;" | '''ScaleService (REST)'''
| style="width: 496px;" | Port 8100 für Kommunikation mit dem ScaleService (via REST)
|}

IRIS Systemvoraussetzungen

2023-01-26T16:09:31Z

Mnh: /* Mindestens */

Bitte beachten Sie, dass die Voraussetzungen noch nicht final sind.

===Hardwarevoraussetzungen===

==== Mindestens ====
*1 Kern
*1 GB RAM
*2 GB freier Speicherplatz auf einer SSD
*Internetverbindung
**Öffentliche / statische IP-Adresse
**Zugewiesener öffentlicher DNS-Eintrag
**mind.5 Mbit/s Upload

==== Mäßige Auslastung (bis ca. 1.000 Pakete pro Stunde) ====
*2 Kerne
*2 GB RAM
*10 GB freier Speicherplatz auf einer SSD

=== Software- und sonstige Voraussetzungen ===

==== Allgemein ====
Allgemeine Anforderungen, unabhängig von der Installationsmethode.

* SMTP-Account (Authentifizierung mit OAuth2 ist möglich)
* Öffentliche Adresse / (Sub-)Domain
** Es muss eine separate Domain oder Subdomain für iris existieren
** Beispiel: iris.firmenname.de oder hvscloud.firmenname.de
** Nicht möglich: firmenname.de/iris
* Standard HTTP / HTTPS Ports: 80, 443
* Zertifikat für den HTTPS Server
** Von öffentlicher Zertifizierungsstelle
** Selbst signierte Zertifikate sind für den öffentlichen HTTPS-Server nicht möglich

==== Option 1: Docker ====
Zusätzliche Anforderungen, wenn IRIS über einen Docker-Container betrieben wird.

* Docker Umgebung
* nginx oder anderer Reverse-Proxy auf der Docker-Maschine
* Bereitschaft, den Container regelmäßig zu aktualisieren

==== Option 2: Installation auf eigenem Betriebssystem ====
Zusätzliche Anforderungen, wenn die IRIS-Dienste auf selbst auf einem Betriebssystem installiert werden.

* Reverse Proxy (z.B. IIS mit ARR oder nginx), konfiguriert mit o.g. Port und Zertifikat
* Bereitschaft, mehrere Dienste (momentan 2) regelmäßig zu aktualisieren
* Eigene Zertifizierungsstelle zum Erstellen von HTTPS-Zertifikaten für interne Dienste (nicht zu verwechseln mit öffentlichem HTTPS-Server)
* MariaDB
** Datenbanken:
*** iris_common
*** iris_account
*** iris_shipping
*** [weitere Datenbanken möglich bei Erweiterung von IRIS]
** DB-Accounts
*** Der User muss die DB-Struktur und auch die Datensätze anpassen können
*** Zur besseren Sicherheit sollte jede Datenbank mit einem eigenen User versehen werden

HVS32 File Schnittstelle (Automatik-Polling)

2023-01-04T09:23:02Z

Mnh: /* Sendungsdaten */

[[en:HVS32 default interface]]

= Voraussetzungen =

Eine beliebige HVS-Version.

= Funktionsbeschreibung =

Diese Schnittstelle listet die am häufigsten verwendeten Felder auf und beschreibt die Positionen der Daten im Standard-Datei-Import. Das Format kann in Rücksprache mit Ihrem Ansprechpartner sehr flexibel erweitert und angepasst werden. Es wird eine Zeile pro Packstück erwartet, mehrere Packstücke dürfen in einer Datei enthalten sein.

In einem spaltenbasierten Format geben die Felder "Von" und "Bis" die Positionen der Daten an, in einem Format wie CSV wird die Spalte "Nr." ausgewertet.

= Sendungsdaten =

Die Sendungsdaten geben die Eigenschaften eines Packstücks an.

Erläuterung Spalte Pflicht: M= Must / O= Optional / C= Conditional (in Abhängigkeit der Carrier Belange)

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || 3 || "IMP" / "EXP"
|-
| || '''--- SENDUNGS-TEIL ---''' || || || || || || || ||
|-
| 2 || Kunden-Nummer || 4 || 13 || 10 || || A || O || 20 || Kdnr des Empfängers beim Versender
|-
| 3 || Empfänger-Name1 || 14 || 43 || 30 || || A || M || 50 || LIEFER-ADRESSE
|-
| 4 || Empfänger-Name2 || 44 || 73 || 30 || || A || O || 50 || EMPFÄNGER
|-
| 5 || Empfänger-Name3 || 74 || 103 || 30 || || A || O || 50 ||
|-
| 6 || Empfänger-Strasse || 104 || 133 || 30 || || A || M || 50 ||
|-
| 7 || Empfänger-LKZ || 134 || 136 || 3 || || A || M || 3 ||
|-
| 8 || Empfänger-PLZ || 137 || 146 || 10 || || A || M || 10 ||
|-
| 9 || Empfänger-Ort || 147 || 176 || 30 || || A || M || 50 ||
|-
| 10 || Empfänger-Region / Staat || 177 || 196 || 20 || || A || C || 20 || Staat/Provinz (z.B. für USA wichtig)
|-
| 11 || Empfänger-Bahnhof || 197 || 226 || 30 || || A || O || 30 || PLZ und Ort
|-
| 12 || Ansprechpartner Empfänger || 227 || 246 || 20 || || A || O || 50 ||
|-
| 13 || Telefon-Nummer Empfänger || 247 || 266 || 20 || || A || C || 30 ||
|-
| 14 || Fax-Nummer Empfänger || 267 || 286 || 20 || || A || O || 30 ||
|-
| 15 || Ust-ID-Nummer Empfänger || 287 || 306 || 20 || || A || O || 20 ||
|-
| 16 || ILN-Nummer Empfänger || 307 || 319 || 13 || || A || C || 13 || Pflicht bei Metro-Versand
|-
| 17 || Mandant (HVS32: "Auftraggeber_ID") || 320 || 327 || 8 || || A || M || 10 ||
|-
| 18 || Versandart (HVS32: "Versandart_ID") || 328 || 333 || 6 || || A || M || 10 || Pflicht bei Automatikpolling
|-
| 19 || AVIS-Hinweis 1 || 334 || 363 || 30 || || A || O || 30 ||
|-
| 20 || AVIS-Hinweis 2 || 264 || 393 || 30 || || A || O || 30 ||
|-
| 21 || AVIS-Zusatz 1 || 394 || 413 || 20 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 1
|-
| 22 || AVIS-Zusatz 2 || 414 || 433 || 20 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 2
|-
| 23 || Lieferschein-Nummer || 434 || 443 || 10 || 0 || A || M || 40 || Wird im VS als Such-Nummer verwendet
|-
| 24 || Auftrags-Nummer || 444 || 453 || 10 || || A || O || 50 ||
|-
| 25 || Bestell-Nummer || 454 || 473 || 20 || || A || O || 50 || Metro-Bestellnr (Metro-Versand)
|-
| 26 || Warenwert || 474 || 482 || 9 || 2 || N || C || 9 ||
|-
| 27 || Warenwert-Währung || 483 || 485 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 28 || Nachnahme || 486 || 494 || 9 || 2 || N || C || 9 ||
|-
| 29 || Nachnahme-Währung || 495 || 497 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 30 || Nachnahme-Vermerk || 498 || 498 || 1 || || A || C || 1 || 'B': Bar / 'V': Verrechnungsscheck
|-
| 31 || Nachnahme-Verwendungszweck || 499 || 518 || 20 || || A || C || 30 ||
|-
| 32 || Höher-Versicherungswert || 519 || 527 || 9 || 2 || N || C || 9 ||
|-
| 33 || Höher-Versicherungswert-Währung || 528 || 530 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 34 || Frankatur-Kennung || 531 || 540 || 10 || || A || C || 10 ||
|-
| 35 || Zahlungsbedingung || 541 || 550 || 10 || || A || C || 10 || 'S':Sender,'R':Empfänger
|-
| 36 || Zahlungsbedingung Zoll/Steuern || 551 || 551 || 1 || || A || C || 1 || 'S':Sender,'R':Empfänger
|-
| 37 || Frachtführer-Kunden-Nr || 552 || 561 || 10 || || A || C || 20 || Kdnr des Frachtzahlers beim Frachtführer
|-
| 38 || Sonderdienst || 562 || 591 || 30 || || A || C || 30 || versandart-spezifisch belegt
|-
| 39 || Sendungs-Inhalt || 592 || 621 || 30 || || A || C || 30 ||
|-
| 40 || Termin-Art || 622 || 622 || 1 || || A || C || 1 || 'A'b / 'B'is / 'F'ix
|-
| 41 || Termin-Datum || 623 || 632 || 10 || || A || C || 10 || TT.MM.JJJJ
|-
| 42 || Termin-Zeit || 633 || 637 || 5 || || A || C || 5 || HH:MM
|-
| 43 || Neutral-Absender-Name1 || 638 || 667 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 44 || Neutral-Absender-Name2 || 668 || 697 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 45 || Neutral-Absender-Name3 || 698 || 727 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 46 || Neutral-Absender-Strasse || 728 || 757 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 47 || Neutral-Absender-LKZ || 758 || 760 || 3 || || A || O || 3 || Nur bei Neutral-Absendern belegt
|-
| 48 || Neutral-Absender-PLZ || 761 || 770 || 10 || || A || O || 10 || Nur bei Neutral-Absendern belegt
|-
| 49 || Neutral-Absender-Ort || 771 || 800 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 50 || Rechnungsempfänger-Name1 || 801 || 830 || 30 || || A || C || 50 || RECHNUNGSADRESSE
|-
| 51 || Rechnungsempfänger-Name2 || 831 || 860 || 30 || || A || O || 50 || EMPFÄNGER
|-
| 52 || Rechnungsempfänger-Name3 || 861 || 890 || 30 || || A || O || 50 ||
|-
| 53 || Rechnungsempfänger-Strasse || 891 || 920 || 30 || || A || C || 50 ||
|-
| 54 || Rechungsempfänger-LKZ || 921 || 923 || 3 || || A || C || 3 ||
|-
| 55 || Rechungsempfänger-PLZ || 924 || 933 || 10 || || A || C || 10 ||
|-
| 56 || Rechungsempfänger-Ort || 934 || 963 || 30 || || A || C || 50 ||
|-
| 57 || Post-Leitcode || 964 || 978 || 15 || || A || C || 15 ||
|-
| 58 || Post-Zielfrachtzentrum || 979 || 983 || 5 || || A || C || 5 ||
|-
| 59 || Frachtbrief-Nr || 984 || 1003 || 20 || || A || O || 20 || falls Fr.brief d. Vorsystem gedruckt
|-
| || '''--- PACKSTÜCK-TEIL ---''' || || || || || || || ||
|-
| 60 || Gewicht Brutto (kg) || 1004 || 1011 || 8 || 3 || N || M || 8 ||
|-
| 61 || Gewicht Netto (kg) || 1012 || 1019 || 8 || 3 || N || O || 8 ||
|-
| 62 || Packstück-Anzahl || 1020 || 1022 || 3 || 0 || N || C || 3 || Gesamt-Anzahl Colli der Sendung+J15
|-
| 63 || Packstück-Nummer || 1023 || 1025 || 3 || 0 || N || C || 3 || Laufende Nr pro Sendung
|-
| 64 || Verpackungsart || 1026 || 1031 || 6 || || A || C || 20 ||
|-
| 65 || Länge Packstück (cm) || 1032 || 1035 || 4 || 0 || N || C || 4 ||
|-
| 66 || Breite Packstück (cm) || 1036 || 1039 || 4 || 0 || N || C || 4 ||
|-
| 67 || Höhe Packstück (cm) || 1040 || 1043 || 4 || 0 || N || C || 4 ||
|-
| 68 || PackPlatz-Nr || 1044 || 1053 || 10 || || A || C || 10 || System, das den Auftrag verarbeiten soll
|-
| 69 || Hostseitige Packstück-ID || 1054 || 1068 || 15 || || A || C || 20 ||
|-
| || '''--- RÜCKMELDE-TEIL ---''' || || || || || || || ||
|-
| 70 || Paket-Nummer || 1069 || 1083 || 15 || || A || || 15 || Nummernkreis-Nr des Frachtführers
|-
| 71 || Tracking-Nummer || 1084 || 1113 || 30 || || A || || 30 ||
|-
| 72 || Druck-Datum || 1114 || 1123 || 10 || || A || || 10 || Datum der Abarbeitung (TT.MM.CCJJ)
|-
| 73 || Versand-Datum || 1124 || 1133 || 10 || || A || || 10 || Datum der Versendung(TT.MM.CCJJ)
|-
| 74 || Fracht-Gebühr || 1134 || 1141 || 8 || 2 || N || || 8 || Frachtkosten
|-
| 75 || Währung Fracht-Gebühr || 1142 || 1144 || 3 || || A || || 3 || ISO-Währungscode
|-
| 76 || Status || 1145 || 1149 || 5 || || A || || 5 ||
|-
| 77 || Ladelisten-Nummer || 1150 || 1153 || 4 || || A || || 4 ||
|-
| || '''--- STEUERUNGS-TEIL ---''' || || || || || || || ||
|-
| 78 || IMPStatus || 1154 || 1154 || 1 || || A || || 1 || 'L':Löschsatz,'F':Fehlersatz, sonst Leer
|-
| 79 || Fehlertext || 1155 || 1214 || 60 || || A || || 60 || Fehler bei Eingangs-Plausi-Prüfung
|-
| 80 || Gefahrgut-Status || 1215 || 1217 || 3 || || A || || 3 || Für int. Kommunikation, nach Absprache
|-
| 81 || ReferenzNr || 1218 || 1237 || 20 || || A || || 20 || Für int. Kommunikation, nach Absprache
|-
| || '''--- Zusatz - Teil ---''' || || || || || || || ||
|-
| 82 || Broker-Name || 1238 || 1262 || 25 || || A || C || 25 ||
|-
| 83 || Broker-Telefonnummer || 1263 || 1282 || 20 || || A || C || 20 ||
|-
| 84 || Hold-At-Location J/N || 1283 || 1283 || 1 || || A || C || 1 || 'J': ja, 'N' oder Blank: Nein
|-
| 85 || Hold-At-Location Telefon || 1284 || 1303 || 20 || || A || C || 20 || Mit Telefonnummer belegt
|-
| 86 || Hold-At-Location Ansprechpartner || 1304 || 1333 || 30 || || A || C || 30 || Mit einem Ansprechpartner belegt
|-
| || '''--- Zusatz - HVS32 ---''' || || || || || || || ||
|-
| 87 || AnzahlArtikel || 1334 || 1339 || 6 || || || O || 6 || Anzahl Artikel (Druck auf Etikett)
|-
| 88 || ZusatzZeile1 || 1340 || 1369 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)
|-
| 89 || ZusatzZeile2 || 1370 || 1399 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)
|-
| 90 || Frei-AVIS1 || 1400 || 1461 || 62 || || A || O || 62 ||
|-
| 91 || Frei-AVIS2 || 1462 || 1523 || 62 || || A || O || 62 ||
|-
| 92 || Status "Elektronik-Artikel" J/N || 1524 || 1524 || 1 || || A || O || 1 || 'J'/'T'(True): Elektronik-Artikel, ansonsten nicht
|-
| 93 || Empfänger-Emailadresse || 1525 || 1604 || 80 || || A || O || 80 || f. automatische Mailavisierung
|-
| 94 || Kostenstelle || 1605 || 1634 || 30 || || A || O || 30 ||
|-
| 95 || Druckername || 1635 || 1664 || 30 || || A || O || 30 || Name eines Ausgabekanals im HVS32
|-
| 96 || CR/LF || 1665 || 1666 || 2 || || || M || 2 || Carriage Return/Line Feed
|}

= Artikeldaten =

Die Artikeldaten geben die Eigenschaften eines Artikels an. Ein Packstück kann mehrere Artikel beinhalten.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || || Festeintrag "ART"
|-
| 2 || Lieferschein-Nr || 4 || 13 || 10 || || A || M || || nicht Pflicht im Dateipolling mit Vormerkdaten
|-
| 3 || Packstück-Nr || 14 || 16 || 3 || || N || C || || nicht Pflicht im Dateipolling mit Vormerkdaten
|-
| 4 || Positions-Nr || 17 || 26 || 10 || 0 || N || M || ||
|-
| 5 || Artikel-Nr || 27 || 76 || 50 || || A || O || ||
|-
| 6 || Artikel-Bezeichnung 1 || 77 || 176 || 100 || || A || M || ||
|-
| 7 || Artikel-Bezeichnung 2 || 177 || 276 || 100 || || A || O || ||
|-
| 8 || Artikel-Netto-Gewicht (je Masseinheit) || 277 || 285 || 9 || 3 || N || O || ||
|-
| 9 || BTN-Nummer || 286 || 310 || 25 || || A || M || ||
|-
| 10 || Artikel-Anzahl (je Masseinheit) || 311 || 319 || 9 || 0 || N || M || ||
|-
| 11 || Ursprungsland || 320 || 321 || 2 || || A || M || ||
|-
| 12 || Artikel-Wert (je Masseinheit) || 322 || 330 || 9 || 2 || N || M || ||
|-
| 13 || Artikelwert-Währung || 331 || 333 || 3 || || A || M || || ISO-Währung (z.B. "EUR")
|-
| 14 || Artikelwert-Masseinheit || 334 || 343 || 10 || || A || M || || keine Vorgabe kann frei Belegt werden (z.B. Stück, Rollen, etc.)
|-
| 15 || CR/LF || 344 || 345 || 2 || || || || || Carriage Return / Line Feed
|}

= Gefahrgut =

Die Gefahrgutdaten geben die Gefahreneigenschaften eines zu transportierenden Stoffes an. Ein Stoff kann mehrere Gefahrgutdaten besitzen.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || || || Fest 'GEF'
|-
| 2 || GefahrgutUNNr || 4 || 7 || 4 || || A || || ||
|-
| 3 || GefahrgutKlasse || 8 || 11 || 4 || || A || || ||
|-
| 4 || GefahrgutVPG || 12 || 14 || 3 || || A || || || I,II,III bzw. leer
|-
| 5 || GefahrgutKCode || 15 || 18 || 4 || || A || || || Pflicht bei Klasse 2
|-
| 6 || GefahrgutBezeichnung || 19 || 128 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle
|-
| 7 || GefahrgutMenge || 129 || 139 || 11 || 3 || N || || ||
|-
| 8 || GefahrgutBegrenzteMenge || 140 || 140 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'
|-
| 9 || GefahrgutVerpAnzahl || 141 || 143 || 3 || || N || || ||
|-
| 10 || GefahrgutVerpackungsart || 144 || 151 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.
|-
| 11 || GefahrgutID || 152 || 159 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten
|-
| 12 || GefahrgutNebengefahr || 160 || 171 || 12 || || A || || || GG-Nebengefahrklasse(n)
|-
| 13 || GefahrgutBuchst640 || 172 || 172 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)
|-
| 14 || GefahrgutMengeneinheit || 173 || 173 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter
|-
| 15 || GefahrgutBefoerdKat || 174 || 174 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6
|-
| 16 || GefahrgutFaktor || 175 || 178 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6
|-
| 17 || GefahrgutNettoExplMasse || 179 || 189 || 11 || 3 || N || || || Nur bei Klasse 1, dann aber Pflicht
|-
| 18 || GefahrgutTunnelBCode || 190 || 199 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)
|-
| 19 || GefahrgutFreigestMenge || 200 || 200 || 1 || || A || || || '*' oder 'T': Status 'Freigestellte Menge' (überstimmt Feld 8)
|-
| 20 || GefahrgutUmweltgef || 201 || 201 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'
|-
| 21 || GefahrgutTechBenennung || 202 || 301 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut
|-
| 22 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed
|}

= Gefahrgutstamm =

Im Gefahrgutstamm legt man die Eigenschaften eines Gefahrguts fest, welche dann in der HVS32 Datenbank gespeichert werden. Anschließend kann man über die GefahrgutID und Menge die Eigenschaften des Gefahrgutstoffs abrufen und dem jeweiligen Packstück zuordnen. Somit müssen nicht immer alle Gefahrgutdaten aus dem Vorsystem übergeben werden.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || GefahrgutID || 1 || 8 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten
|-
| 2 || GefahrgutBezeichnung || 9 || 118 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle
|-
| 3 || GefahrgutTechBenennung || 119 || 218 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut
|-
| 4 || GefahrgutUNNR || 219 || 222 || 4 || || A || || ||
|-
| 5 || GefahrgutKlasse || 223 || 226 || 4 || || A || || ||
|-
| 6 || GefahrgutNebenGefahr || 227 || 238 || 12 || || A || || || GG-Nebengefahrklasse(n)
|-
| 7 || GefahrgutVPG || 239 || 241 || 3 || || A || || || I,II,III bzw. leer
|-
| 8 || GefahrgutKCode || 242 || 245 || 4 || || A || || || Pflicht bei Klasse 2
|-
| 9 || GefahrgutFaktor || 246 || 249 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6
|-
| 10 || GefahrgutBefoerdKat || 250 || 250 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6
|-
| 11 || GefahrgutBuchst640 || 251 || 251 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)
|-
| 12 || GefahrgutMengenEinheit || 252 || 252 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter
|-
| 13 || GefahrgutVerpackungsart || 253 || 260 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.
|-
| 14 || GefahrgutTunnelBCode || 261 || 270 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)
|-
| 15 || GefahrgutBegrenzteMenge || 271 || 271 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'
|-
| 16 || Umweltgefaehrdend || 272 || 272 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'
|-
| 17 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed
|}

= Datentypen =

A - Alphanumerisch - Besteht aus Zahlen und Buchstaben 
N - Numerisch - Besteht ausschließlich aus Zahlen

= Beispiele =

<div style="overflow-x: scroll">

CSV-Datei - Sendungsdaten einer Sendung mit zwei Packstücken und Definitionszeile. [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten.csv Download File]

SatzKennung;KundenNummer;EmpfängerName1;EmpfängerName2;EmpfängerName3;EmpfängerStrasse;EmpfängerLKZ;EmpfängerPLZ;EmpfängerOrt;EmpfängerRegion/Staat;EmpfängerBahnhof;AnsprechpartnerEmpfänger;TelefonNummerEmpfänger;FaxNummerEmpfänger;UstIDNummerEmpfänger;ILNNummerEmpfänger;"Mandant";"Versandart";AVISHinweis1;AVISHinweis2;AVISZusatz1;AVISZusatz2;LieferscheinNummer;AuftragsNummer;BestellNummer;Warenwert;WarenwertWährung;Nachnahme;NachnahmeWährung;NachnahmeVermerk;NachnahmeVerwendungszweck;HöherVersicherungswert;HöherVersicherungswertWährung;FrankaturKennung;Zahlungsbedingung;ZahlungsbedingungZollSteuern;FrachtführerKundenNr;Sonderdienst;SendungsInhalt;TerminArt;TerminDatum;TerminZeit;NeutralAbsenderName1;NeutralAbsenderName2;NeutralAbsenderName3;NeutralAbsenderStrasse;NeutralAbsenderLKZ;NeutralAbsenderPLZ;NeutralAbsenderOrt;RechnungsempfängerName1;RechnungsempfängerName2;RechnungsempfängerName3;RechnungsempfängerStrasse;RechungsempfängerLKZ;RechungsempfängerPLZ;RechungsempfängerOrt;PostLeitcode;PostZielfrachtzentrum;FrachtbriefNr;GewichtBruttoGewichtNettoPackstückAnzahl;PackstückNummer;Verpackungsart;LängePackstückBreitePackstückHöhePackstückPackPlatzNr;HostseitigePackstückID
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;ZusatzInfo;200,00;EUR;;20,00;20;2;1;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KARTON;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;weitereInfo;200,00;EUR;;20,00;14;2;2;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
{|
|}

CSV-Datei - Sendungsdaten und Artikeldaten einer Sendung mit zwei Packstücken mit jeweils zwei Artikeln [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten_Artikeldaten.csv Download File]IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
ART;487010005;1;1;321321;Test Artikel1;;30;321321231;2;DE;20;EUR;STUECK; 
ART;487010005;1;1;321321;Test Artikel2;;30;321321231;2;DE;20;EUR;STUECK;
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
ART;487010005;2;2;321322;Test Artikel3;;30;321321232;2;DE;20;EUR;STUECK; 
ART;487010005;2;2;321322;Test Artikel4;;30;321321232;2;DE;20;EUR;STUECK;
{|
|}

CSV-Datei - Sendungsdaten und Gefahrgut Positionen einer Sendung mit zwei Packstücken mit jeweils drei Gefahrgut Positionen [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten_GefahrgutPositionen.csv Download File]
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123; 
GEF;1072;2.2;III;1O;3;SAUERSTOFF VERDICHTET / Sauerstoff-Flasche fllen 2 Liter CONOXIA©;;2;;;;56944;(5.1);;1;1;;(E);;;;25 
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Alleskleber Flinke Flasche 90g Uhu;;90;;;;12667;;;1;3;;(D/E);;;;33 
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Elefantenkleber 850gr;;0,85;;;;33566;;;1;3;;(D/E);;;;33 
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123; 
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml ATM2;(Ethylalkohol);0,5;;;;48380;;;1;1;;(D/E);;;;30 
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml Palette;(Ethylalkohol);0,5;;;;51252;;;1;1;;(D/E);;;;30 
GEF;1173;3;II;F1;2;UN 1173 ETHYLACETAT / Nagellackentferner;;0,25;;;;51203;;;1;3;;(D);;;;33 
{|
|}

CSV-Datei - Gefahrgutstamm mit drei drei neuen Gefahrguteinträgen [https://sftp.heidler-strichcode.de/download/wikiextern/Gefahrgutstamm.csv Download File]1013;1013;2;(2.2);Kohlendioxid;;;2A;3;;4G;1; 
1950;1950;2;(2.2);Druckgaspackungen;;;5A;3;;4G;1; 
1956;1956;2;(2.2);Verdichtetes Gas, N.A.G. (Kohlendioxid, Nitrogen);;;1A;3;;4G;1; 
{|
|}

HVS32 File Schnittstelle (Automatik-Polling)

2023-01-04T08:55:53Z

Mnh: /* Sendungsdaten */

[[en:HVS32 default interface]]

= Voraussetzungen =

Eine beliebige HVS-Version.

= Funktionsbeschreibung =

Diese Schnittstelle listet die am häufigsten verwendeten Felder auf und beschreibt die Positionen der Daten im Standard-Datei-Import. Das Format kann in Rücksprache mit Ihrem Ansprechpartner sehr flexibel erweitert und angepasst werden. Es wird eine Zeile pro Packstück erwartet, mehrere Packstücke dürfen in einer Datei enthalten sein.

In einem spaltenbasierten Format geben die Felder "Von" und "Bis" die Positionen der Daten an, in einem Format wie CSV wird die Spalte "Nr." ausgewertet.

= Sendungsdaten =

Die Sendungsdaten geben die Eigenschaften eines Packstücks an.

Erläuterung Spalte Pflicht: M= Muss / O= Optional / C= Pflicht in bestimmten Fällen

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || 3 || "IMP" / "EXP"
|-
| || '''--- SENDUNGS-TEIL ---''' || || || || || || || ||
|-
| 2 || Kunden-Nummer || 4 || 13 || 10 || || A || O || 20 || Kdnr des Empfängers beim Versender
|-
| 3 || Empfänger-Name1 || 14 || 43 || 30 || || A || M || 50 || LIEFER-ADRESSE
|-
| 4 || Empfänger-Name2 || 44 || 73 || 30 || || A || O || 50 || EMPFÄNGER
|-
| 5 || Empfänger-Name3 || 74 || 103 || 30 || || A || O || 50 ||
|-
| 6 || Empfänger-Strasse || 104 || 133 || 30 || || A || M || 50 ||
|-
| 7 || Empfänger-LKZ || 134 || 136 || 3 || || A || M || 3 ||
|-
| 8 || Empfänger-PLZ || 137 || 146 || 10 || || A || M || 10 ||
|-
| 9 || Empfänger-Ort || 147 || 176 || 30 || || A || M || 50 ||
|-
| 10 || Empfänger-Region / Staat || 177 || 196 || 20 || || A || C || 20 || Staat/Provinz (z.B. für USA wichtig)
|-
| 11 || Empfänger-Bahnhof || 197 || 226 || 30 || || A || O || 30 || PLZ und Ort
|-
| 12 || Ansprechpartner Empfänger || 227 || 246 || 20 || || A || O || 50 ||
|-
| 13 || Telefon-Nummer Empfänger || 247 || 266 || 20 || || A || C || 30 ||
|-
| 14 || Fax-Nummer Empfänger || 267 || 286 || 20 || || A || O || 30 ||
|-
| 15 || Ust-ID-Nummer Empfänger || 287 || 306 || 20 || || A || O || 20 ||
|-
| 16 || ILN-Nummer Empfänger || 307 || 319 || 13 || || A || C || 13 || Pflicht bei Metro-Versand
|-
| 17 || Mandant (HVS32: "Auftraggeber_ID") || 320 || 327 || 8 || || A || M || 10 ||
|-
| 18 || Versandart (HVS32: "Versandart_ID") || 328 || 333 || 6 || || A || M || 10 || Pflicht bei Automatikpolling
|-
| 19 || AVIS-Hinweis 1 || 334 || 363 || 30 || || A || O || 30 ||
|-
| 20 || AVIS-Hinweis 2 || 264 || 393 || 30 || || A || O || 30 ||
|-
| 21 || AVIS-Zusatz 1 || 394 || 413 || 20 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 1
|-
| 22 || AVIS-Zusatz 2 || 414 || 433 || 20 || || A || O || 20 || Zusatz zu Fest-AVIS-Schlüssel 2
|-
| 23 || Lieferschein-Nummer || 434 || 443 || 10 || 0 || A || M || 40 || Wird im VS als Such-Nummer verwendet
|-
| 24 || Auftrags-Nummer || 444 || 453 || 10 || || A || O || 50 ||
|-
| 25 || Bestell-Nummer || 454 || 473 || 20 || || A || O || 50 || Metro-Bestellnr (Metro-Versand)
|-
| 26 || Warenwert || 474 || 482 || 9 || 2 || N || C || 9 ||
|-
| 27 || Warenwert-Währung || 483 || 485 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 28 || Nachnahme || 486 || 494 || 9 || 2 || N || C || 9 ||
|-
| 29 || Nachnahme-Währung || 495 || 497 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 30 || Nachnahme-Vermerk || 498 || 498 || 1 || || A || C || 1 || 'B': Bar / 'V': Verrechnungsscheck
|-
| 31 || Nachnahme-Verwendungszweck || 499 || 518 || 20 || || A || C || 30 ||
|-
| 32 || Höher-Versicherungswert || 519 || 527 || 9 || 2 || N || C || 9 ||
|-
| 33 || Höher-Versicherungswert-Währung || 528 || 530 || 3 || || A || C || 3 || ISO-Währungscode
|-
| 34 || Frankatur-Kennung || 531 || 540 || 10 || || A || C || 10 ||
|-
| 35 || Zahlungsbedingung || 541 || 550 || 10 || || A || C || 10 || 'S':Sender,'R':Empfänger
|-
| 36 || Zahlungsbedingung Zoll/Steuern || 551 || 551 || 1 || || A || C || 1 || 'S':Sender,'R':Empfänger
|-
| 37 || Frachtführer-Kunden-Nr || 552 || 561 || 10 || || A || C || 20 || Kdnr des Frachtzahlers beim Frachtführer
|-
| 38 || Sonderdienst || 562 || 591 || 30 || || A || C || 30 || versandart-spezifisch belegt
|-
| 39 || Sendungs-Inhalt || 592 || 621 || 30 || || A || C || 30 ||
|-
| 40 || Termin-Art || 622 || 622 || 1 || || A || C || 1 || 'A'b / 'B'is / 'F'ix
|-
| 41 || Termin-Datum || 623 || 632 || 10 || || A || C || 10 || TT.MM.JJJJ
|-
| 42 || Termin-Zeit || 633 || 637 || 5 || || A || C || 5 || HH:MM
|-
| 43 || Neutral-Absender-Name1 || 638 || 667 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 44 || Neutral-Absender-Name2 || 668 || 697 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 45 || Neutral-Absender-Name3 || 698 || 727 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 46 || Neutral-Absender-Strasse || 728 || 757 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 47 || Neutral-Absender-LKZ || 758 || 760 || 3 || || A || O || 3 || Nur bei Neutral-Absendern belegt
|-
| 48 || Neutral-Absender-PLZ || 761 || 770 || 10 || || A || O || 10 || Nur bei Neutral-Absendern belegt
|-
| 49 || Neutral-Absender-Ort || 771 || 800 || 30 || || A || O || 50 || Nur bei Neutral-Absendern belegt
|-
| 50 || Rechnungsempfänger-Name1 || 801 || 830 || 30 || || A || C || 50 || RECHNUNGSADRESSE
|-
| 51 || Rechnungsempfänger-Name2 || 831 || 860 || 30 || || A || O || 50 || EMPFÄNGER
|-
| 52 || Rechnungsempfänger-Name3 || 861 || 890 || 30 || || A || O || 50 ||
|-
| 53 || Rechnungsempfänger-Strasse || 891 || 920 || 30 || || A || C || 50 ||
|-
| 54 || Rechungsempfänger-LKZ || 921 || 923 || 3 || || A || C || 3 ||
|-
| 55 || Rechungsempfänger-PLZ || 924 || 933 || 10 || || A || C || 10 ||
|-
| 56 || Rechungsempfänger-Ort || 934 || 963 || 30 || || A || C || 50 ||
|-
| 57 || Post-Leitcode || 964 || 978 || 15 || || A || C || 15 ||
|-
| 58 || Post-Zielfrachtzentrum || 979 || 983 || 5 || || A || C || 5 ||
|-
| 59 || Frachtbrief-Nr || 984 || 1003 || 20 || || A || O || 20 || falls Fr.brief d. Vorsystem gedruckt
|-
| || '''--- PACKSTÜCK-TEIL ---''' || || || || || || || ||
|-
| 60 || Gewicht Brutto (kg) || 1004 || 1011 || 8 || 3 || N || M || 8 ||
|-
| 61 || Gewicht Netto (kg) || 1012 || 1019 || 8 || 3 || N || O || 8 ||
|-
| 62 || Packstück-Anzahl || 1020 || 1022 || 3 || 0 || N || C || 3 || Gesamt-Anzahl Colli der Sendung+J15
|-
| 63 || Packstück-Nummer || 1023 || 1025 || 3 || 0 || N || C || 3 || Laufende Nr pro Sendung
|-
| 64 || Verpackungsart || 1026 || 1031 || 6 || || A || C || 20 ||
|-
| 65 || Länge Packstück (cm) || 1032 || 1035 || 4 || 0 || N || C || 4 ||
|-
| 66 || Breite Packstück (cm) || 1036 || 1039 || 4 || 0 || N || C || 4 ||
|-
| 67 || Höhe Packstück (cm) || 1040 || 1043 || 4 || 0 || N || C || 4 ||
|-
| 68 || PackPlatz-Nr || 1044 || 1053 || 10 || || A || C || 10 || System, das den Auftrag verarbeiten soll
|-
| 69 || Hostseitige Packstück-ID || 1054 || 1068 || 15 || || A || C || 20 ||
|-
| || '''--- RÜCKMELDE-TEIL ---''' || || || || || || || ||
|-
| 70 || Paket-Nummer || 1069 || 1083 || 15 || || A || || 15 || Nummernkreis-Nr des Frachtführers
|-
| 71 || Tracking-Nummer || 1084 || 1113 || 30 || || A || || 30 ||
|-
| 72 || Druck-Datum || 1114 || 1123 || 10 || || A || || 10 || Datum der Abarbeitung (TT.MM.CCJJ)
|-
| 73 || Versand-Datum || 1124 || 1133 || 10 || || A || || 10 || Datum der Versendung(TT.MM.CCJJ)
|-
| 74 || Fracht-Gebühr || 1134 || 1141 || 8 || 2 || N || || 8 || Frachtkosten
|-
| 75 || Währung Fracht-Gebühr || 1142 || 1144 || 3 || || A || || 3 || ISO-Währungscode
|-
| 76 || Status || 1145 || 1149 || 5 || || A || || 5 ||
|-
| 77 || Ladelisten-Nummer || 1150 || 1153 || 4 || || A || || 4 ||
|-
| || '''--- STEUERUNGS-TEIL ---''' || || || || || || || ||
|-
| 78 || IMPStatus || 1154 || 1154 || 1 || || A || || 1 || 'L':Löschsatz,'F':Fehlersatz, sonst Leer
|-
| 79 || Fehlertext || 1155 || 1214 || 60 || || A || || 60 || Fehler bei Eingangs-Plausi-Prüfung
|-
| 80 || Gefahrgut-Status || 1215 || 1217 || 3 || || A || || 3 || Für int. Kommunikation, nach Absprache
|-
| 81 || ReferenzNr || 1218 || 1237 || 20 || || A || || 20 || Für int. Kommunikation, nach Absprache
|-
| || '''--- Zusatz - Teil ---''' || || || || || || || ||
|-
| 82 || Broker-Name || 1238 || 1262 || 25 || || A || C || 25 ||
|-
| 83 || Broker-Telefonnummer || 1263 || 1282 || 20 || || A || C || 20 ||
|-
| 84 || Hold-At-Location J/N || 1283 || 1283 || 1 || || A || C || 1 || 'J': ja, 'N' oder Blank: Nein
|-
| 85 || Hold-At-Location Telefon || 1284 || 1303 || 20 || || A || C || 20 || Mit Telefonnummer belegt
|-
| 86 || Hold-At-Location Ansprechpartner || 1304 || 1333 || 30 || || A || C || 30 || Mit einem Ansprechpartner belegt
|-
| || '''--- Zusatz - HVS32 ---''' || || || || || || || ||
|-
| 87 || AnzahlArtikel || 1334 || 1339 || 6 || || || O || 6 || Anzahl Artikel (Druck auf Etikett)
|-
| 88 || ZusatzZeile1 || 1340 || 1369 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)
|-
| 89 || ZusatzZeile2 || 1370 || 1399 || 30 || || || O || 30 || Zusatztext (Druck auf Etikett)
|-
| 90 || Frei-AVIS1 || 1400 || 1461 || 62 || || A || O || 62 ||
|-
| 91 || Frei-AVIS2 || 1462 || 1523 || 62 || || A || O || 62 ||
|-
| 92 || Status "Elektronik-Artikel" J/N || 1524 || 1524 || 1 || || A || O || 1 || 'J'/'T'(True): Elektronik-Artikel, ansonsten nicht
|-
| 93 || Empfänger-Emailadresse || 1525 || 1604 || 80 || || A || O || 80 || f. automatische Mailavisierung
|-
| 94 || Kostenstelle || 1605 || 1634 || 30 || || A || O || 30 ||
|-
| 95 || Druckername || 1635 || 1664 || 30 || || A || O || 30 || Name eines Ausgabekanals im HVS32
|-
| 96 || CR/LF || 1665 || 1666 || 2 || || || M || 2 || Carriage Return/Line Feed
|}

= Artikeldaten =

Die Artikeldaten geben die Eigenschaften eines Artikels an. Ein Packstück kann mehrere Artikel beinhalten.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || M || || Festeintrag "ART"
|-
| 2 || Lieferschein-Nr || 4 || 13 || 10 || || A || M || || nicht Pflicht im Dateipolling mit Vormerkdaten
|-
| 3 || Packstück-Nr || 14 || 16 || 3 || || N || C || || nicht Pflicht im Dateipolling mit Vormerkdaten
|-
| 4 || Positions-Nr || 17 || 26 || 10 || 0 || N || M || ||
|-
| 5 || Artikel-Nr || 27 || 76 || 50 || || A || O || ||
|-
| 6 || Artikel-Bezeichnung 1 || 77 || 176 || 100 || || A || M || ||
|-
| 7 || Artikel-Bezeichnung 2 || 177 || 276 || 100 || || A || O || ||
|-
| 8 || Artikel-Netto-Gewicht (je Masseinheit) || 277 || 285 || 9 || 3 || N || O || ||
|-
| 9 || BTN-Nummer || 286 || 310 || 25 || || A || M || ||
|-
| 10 || Artikel-Anzahl (je Masseinheit) || 311 || 319 || 9 || 0 || N || M || ||
|-
| 11 || Ursprungsland || 320 || 321 || 2 || || A || M || ||
|-
| 12 || Artikel-Wert (je Masseinheit) || 322 || 330 || 9 || 2 || N || M || ||
|-
| 13 || Artikelwert-Währung || 331 || 333 || 3 || || A || M || || ISO-Währung (z.B. "EUR")
|-
| 14 || Artikelwert-Masseinheit || 334 || 343 || 10 || || A || M || || keine Vorgabe kann frei Belegt werden (z.B. Stück, Rollen, etc.)
|-
| 15 || CR/LF || 344 || 345 || 2 || || || || || Carriage Return / Line Feed
|}

= Gefahrgut =

Die Gefahrgutdaten geben die Gefahreneigenschaften eines zu transportierenden Stoffes an. Ein Stoff kann mehrere Gefahrgutdaten besitzen.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || Satz-Kennung || 1 || 3 || 3 || || A || || || Fest 'GEF'
|-
| 2 || GefahrgutUNNr || 4 || 7 || 4 || || A || || ||
|-
| 3 || GefahrgutKlasse || 8 || 11 || 4 || || A || || ||
|-
| 4 || GefahrgutVPG || 12 || 14 || 3 || || A || || || I,II,III bzw. leer
|-
| 5 || GefahrgutKCode || 15 || 18 || 4 || || A || || || Pflicht bei Klasse 2
|-
| 6 || GefahrgutBezeichnung || 19 || 128 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle
|-
| 7 || GefahrgutMenge || 129 || 139 || 11 || 3 || N || || ||
|-
| 8 || GefahrgutBegrenzteMenge || 140 || 140 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'
|-
| 9 || GefahrgutVerpAnzahl || 141 || 143 || 3 || || N || || ||
|-
| 10 || GefahrgutVerpackungsart || 144 || 151 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.
|-
| 11 || GefahrgutID || 152 || 159 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten
|-
| 12 || GefahrgutNebengefahr || 160 || 171 || 12 || || A || || || GG-Nebengefahrklasse(n)
|-
| 13 || GefahrgutBuchst640 || 172 || 172 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)
|-
| 14 || GefahrgutMengeneinheit || 173 || 173 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter
|-
| 15 || GefahrgutBefoerdKat || 174 || 174 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6
|-
| 16 || GefahrgutFaktor || 175 || 178 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6
|-
| 17 || GefahrgutNettoExplMasse || 179 || 189 || 11 || 3 || N || || || Nur bei Klasse 1, dann aber Pflicht
|-
| 18 || GefahrgutTunnelBCode || 190 || 199 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)
|-
| 19 || GefahrgutFreigestMenge || 200 || 200 || 1 || || A || || || '*' oder 'T': Status 'Freigestellte Menge' (überstimmt Feld 8)
|-
| 20 || GefahrgutUmweltgef || 201 || 201 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'
|-
| 21 || GefahrgutTechBenennung || 202 || 301 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut
|-
| 22 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed
|}

= Gefahrgutstamm =

Im Gefahrgutstamm legt man die Eigenschaften eines Gefahrguts fest, welche dann in der HVS32 Datenbank gespeichert werden. Anschließend kann man über die GefahrgutID und Menge die Eigenschaften des Gefahrgutstoffs abrufen und dem jeweiligen Packstück zuordnen. Somit müssen nicht immer alle Gefahrgutdaten aus dem Vorsystem übergeben werden.

{| class="wikitable"
|-
! Nr !! Feldname !! Von !! Bis !! Länge !! Dez !! Typ !! Pflicht !! CSV-Max !! Belegung
|-
| 1 || GefahrgutID || 1 || 8 || 8 || || A || || || Eindeutige Suchnummer für Gefahrgut-Stammdaten
|-
| 2 || GefahrgutBezeichnung || 9 || 118 || 110 || || A || || || Stoffbezeichnung lt. ADR-Tabelle
|-
| 3 || GefahrgutTechBenennung || 119 || 218 || 100 || || A || || || Gefahrauslöser/tech. Benennung bei N.A.G.-Gefahrgut
|-
| 4 || GefahrgutUNNR || 219 || 222 || 4 || || A || || ||
|-
| 5 || GefahrgutKlasse || 223 || 226 || 4 || || A || || ||
|-
| 6 || GefahrgutNebenGefahr || 227 || 238 || 12 || || A || || || GG-Nebengefahrklasse(n)
|-
| 7 || GefahrgutVPG || 239 || 241 || 3 || || A || || || I,II,III bzw. leer
|-
| 8 || GefahrgutKCode || 242 || 245 || 4 || || A || || || Pflicht bei Klasse 2
|-
| 9 || GefahrgutFaktor || 246 || 249 || 4 || || N || || || Gewichtungsfaktor lt. ADR 1.1.3.6
|-
| 10 || GefahrgutBefoerdKat || 250 || 250 || 1 || || N || || || 0-4 lt. ADR 1.1.3.6
|-
| 11 || GefahrgutBuchst640 || 251 || 251 || 1 || || A || || || Buchst. Bei Sondervorschr. 640 (A-L)
|-
| 12 || GefahrgutMengenEinheit || 252 || 252 || 1 || || A || || || 0' bzw Blank: Kilogramm; '1': Liter
|-
| 13 || GefahrgutVerpackungsart || 253 || 260 || 8 || || A || || || GG-konform, z.B. '4G' , '6HG2' usw.
|-
| 14 || GefahrgutTunnelBCode || 261 || 270 || 10 || || A || || || ab ADR 2009 Pflicht, incl. Klammerung, z.B. (C/E)
|-
| 15 || GefahrgutBegrenzteMenge || 271 || 271 || 1 || || A || || || '*' oder 'T': Status 'Begrenzte Menge'
|-
| 16 || Umweltgefaehrdend || 272 || 272 || 1 || || A || || || '*' oder 'T': Status 'Umweltgefährdend'
|-
| 17 || CR/LF || 302 || 302 || 1 || || || || || Carriage Return/Line Feed
|}

= Datentypen =

A - Alphanumerisch - Besteht aus Zahlen und Buchstaben 
N - Numerisch - Besteht ausschließlich aus Zahlen

= Beispiele =

<div style="overflow-x: scroll">

CSV-Datei - Sendungsdaten einer Sendung mit zwei Packstücken und Definitionszeile. [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten.csv Download File]

SatzKennung;KundenNummer;EmpfängerName1;EmpfängerName2;EmpfängerName3;EmpfängerStrasse;EmpfängerLKZ;EmpfängerPLZ;EmpfängerOrt;EmpfängerRegion/Staat;EmpfängerBahnhof;AnsprechpartnerEmpfänger;TelefonNummerEmpfänger;FaxNummerEmpfänger;UstIDNummerEmpfänger;ILNNummerEmpfänger;"Mandant";"Versandart";AVISHinweis1;AVISHinweis2;AVISZusatz1;AVISZusatz2;LieferscheinNummer;AuftragsNummer;BestellNummer;Warenwert;WarenwertWährung;Nachnahme;NachnahmeWährung;NachnahmeVermerk;NachnahmeVerwendungszweck;HöherVersicherungswert;HöherVersicherungswertWährung;FrankaturKennung;Zahlungsbedingung;ZahlungsbedingungZollSteuern;FrachtführerKundenNr;Sonderdienst;SendungsInhalt;TerminArt;TerminDatum;TerminZeit;NeutralAbsenderName1;NeutralAbsenderName2;NeutralAbsenderName3;NeutralAbsenderStrasse;NeutralAbsenderLKZ;NeutralAbsenderPLZ;NeutralAbsenderOrt;RechnungsempfängerName1;RechnungsempfängerName2;RechnungsempfängerName3;RechnungsempfängerStrasse;RechungsempfängerLKZ;RechungsempfängerPLZ;RechungsempfängerOrt;PostLeitcode;PostZielfrachtzentrum;FrachtbriefNr;GewichtBruttoGewichtNettoPackstückAnzahl;PackstückNummer;Verpackungsart;LängePackstückBreitePackstückHöhePackstückPackPlatzNr;HostseitigePackstückID
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;ZusatzInfo;200,00;EUR;;20,00;20;2;1;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KARTON;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
IMP;0011800229;EmpfängerGes.m.b.H;PrintingSystems;;Bergergasse38;D;72649;Wolfschlugen;01;NVESped;;;;;;,;;;;;DDP;weitereInfo;200,00;EUR;;20,00;14;2;2;;;;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
{|
|}

CSV-Datei - Sendungsdaten und Artikeldaten einer Sendung mit zwei Packstücken mit jeweils zwei Artikeln [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten_Artikeldaten.csv Download File]IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
ART;487010005;1;1;321321;Test Artikel1;;30;321321231;2;DE;20;EUR;STUECK; 
ART;487010005;1;1;321321;Test Artikel2;;30;321321231;2;DE;20;EUR;STUECK;
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123;
ART;487010005;2;2;321322;Test Artikel3;;30;321321232;2;DE;20;EUR;STUECK; 
ART;487010005;2;2;321322;Test Artikel4;;30;321321232;2;DE;20;EUR;STUECK;
{|
|}

CSV-Datei - Sendungsdaten und Gefahrgut Positionen einer Sendung mit zwei Packstücken mit jeweils drei Gefahrgut Positionen [https://sftp.heidler-strichcode.de/download/wikiextern/Sendungsdaten_GefahrgutPositionen.csv Download File]
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,800;;2;1;KT;71;42;43;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123; 
GEF;1072;2.2;III;1O;3;SAUERSTOFF VERDICHTET / Sauerstoff-Flasche fllen 2 Liter CONOXIA©;;2;;;;56944;(5.1);;1;1;;(E);;;;25 
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Alleskleber Flinke Flasche 90g Uhu;;90;;;;12667;;;1;3;;(D/E);;;;33 
GEF;1133;3;II;F1;3;KLEBSTOFFE (FLAMMPUNKT < 23°C), / Elefantenkleber 850gr;;0,85;;;;33566;;;1;3;;(D/E);;;;33 
IMP;0011800221;OceOsterreichGes.m.b.H;BusinessUnitPrintingSystems;;Carlbergergasse38;D;72649;Wien;;;;;;;;01;01;;;;;487010005;123123;321321;;;;;;;;;DDP;;;;;Kabelbinder;;;;;;;;;;;;;;;;;;;;;0,900;;2;2;KT;79;60;55;;;;;;;;;;;;;;;;;;;;;;;;;;test@test.de;;;017612312123; 
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml ATM2;(Ethylalkohol);0,5;;;;48380;;;1;1;;(D/E);;;;30 
GEF;1170;3;III;F1;3;ETHANOL LÖSUNG / Skinsept Mucosa Lösung 500ml Palette;(Ethylalkohol);0,5;;;;51252;;;1;1;;(D/E);;;;30 
GEF;1173;3;II;F1;2;UN 1173 ETHYLACETAT / Nagellackentferner;;0,25;;;;51203;;;1;3;;(D);;;;33 
{|
|}

CSV-Datei - Gefahrgutstamm mit drei drei neuen Gefahrguteinträgen [https://sftp.heidler-strichcode.de/download/wikiextern/Gefahrgutstamm.csv Download File]1013;1013;2;(2.2);Kohlendioxid;;;2A;3;;4G;1; 
1950;1950;2;(2.2);Druckgaspackungen;;;5A;3;;4G;1; 
1956;1956;2;(2.2);Verdichtetes Gas, N.A.G. (Kohlendioxid, Nitrogen);;;1A;3;;4G;1; 
{|
|}

HVS32 Zoll / Dokumenten Upload

2022-12-07T07:52:44Z

Mnh: /* Anforderung an Ihr HVS32 System */

<big>'''Wichtiger Hinweis: alle folgend erwähnten Services / Dienste sind nur beim Versand in das nicht EU Ausland relevant.'''
</big>

= Sammelverzollung =

=== UPS WorldEase ===
UPS Sammelverzollung, dieser Dienst muss separat mit UPS vereinbart werden.
UPS übernimmt gesammelt die Verzollung der Paletten, Details über den Ablauf und Preise
erfahren Sie bei ihrem UPS Ansprechpartner

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*separate Drucker mit speziellem UPS World Ease Label Material
*Labels sind 30 cm lang
*spezielle DOCboxen von UPS kommen zum Einsatz

=== DHL Break Bulk ===
Mit dem „Break Bulk“ – Service bietet DHL die Möglichkeit, die einzelnen Sendungen eines
bestimmten Ziellandes für die gesammelte Einschleusung temporär in einer „Mutter“-
Sendung zu bündeln. Die „Mutter“-Sendung unterliegt dann der Verzollung. Erst am
vereinbarten Einschleus-Ort fächert dann DHL die Sendungen dann wieder für die Zustellung
an die End-Empfänger auf. Die Verwendung des Break Bulk Services muss mit dem relevanten DHL
Ansprechpartner abgestimmt sein, eine entsprechende Vereinbarung
zwischen Versender und DHL muss getroffen sein.

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*eigene Versandart für die Break Bulk Abwicklung

= Dokument—Datei-Upload =

=== DHL PaperlessTrade PLT (nicht für alle Länder nutzbar)===
Für DHL PLT werden die relevanten Zolldokumente (Handels*oder ProForma-Rechnung, gegebenenfalls zusätzliches Ausfuhrbegleitdokument) für jede zu verzollende Sendung als PDF-Dateien auf einen DHL SFTP Server hochgeladen.
Dazu ist zusätzlich noch ein DHL AWB-PDF-Dokument erforderlich, welches jedoch durch das HVS32 die jeweilige Sendung erzeugt und beifügt wird.
Das Hochladen der Dokumente erfolgt beim DHL Tagesabschluss.
Auf den DHL-Labels wird der PLT-Status speziell gekennzeichnet.

====Anforderung an Ihr HVS32 System: ====

*für PLT-Sendung müssen die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der DHL AWB-Nr, die vom HVS32 vergeben und an den Host als TrackingNr zurückgemeldet wird. Die PDF-Dateien müssen spätestens zum Zeitpunkt des DHL Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen
*weitere Anforderungen können Projektweise seitens DHL erhoben werden (MRN bekannt bei der Druckabwicklung...)

=== UPS Paperless Document API ===
'''Umfang''':
Für UPS Paperless Document /PaperlessTrade werden die relevanten Zolldokumente für eine zu verzollende Sendung als PDF-Dateien an UPS per UPS Webservice hochgeladen.
Die relevanten Zolldokumente sind:

*Handels- oder ProForma-Rechnung
*ggfs noch Ausfuhrbegleitdokument ABD
*ggfs. Zusatz-Dokument, z.B. Ursprungszeugnis („certification of origin“)

Das Hochladen der Dokumente erfolgt beim UPS Tagesabschluss per Webservice-Datendialog.
Auf den UPS-Labels wird der Paperless Document-Status speziell gekennzeichnet (Vermerk EDI-IDIS unten rechts auf den Versandlabels).
Anmerkung: dies darf nicht verwechselt werden mit der UPS Option Paperless Invoice! Bei letzterer werden die zollrelevanten Daten incl. Artikelinformationen elektronisch in der „normalen“ UPS-EDI-Datei
in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System: ====
*es müssen uns für jede UPS*Paperless Document -Sendung die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument / Zusatzdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der UPS Sendungs-Nr, die vom HVS32 vergeben und an den Host z.B. als VersandSendungsNr zurückgemeldet wurde.
*Die PDF-Dateien müssen spätestens zum Zeitpunkt des UPS Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen. Wenn die Voraussetzungen erfüllt sind, kann man weitere Details klären (z.B. Ordner in dem die pdf-Dateien auf dem HVS32 Server für den weiteren Prozess abgelegt werden, Zugangs-Parameter von UPS für den Upload der pdf Dokumente) und dann muss es im Systemablauf nach Aufwand konfiguriert werden.

=== FedEx Electronic Trade Documents ===
bei uns in Arbeit, noch nicht verfügbar

= Elektronische Zoll/Rechnungsdaten-Übermittlung =
die Zoll/Rechnungs-Detail-Daten werden in den EDI-Dateien der Frachtführer als zusätzliche Daten übermittelt

=== UPS PaperlessInvoice ===
*der Versender muss es mit UPS vereinbart haben, dass er das abwickeln darf. Paperless Invoice ist eine sogenannte UPS "Kontrakt-"Option, d.h. es muss ein entsprechendes Vertragswerk mit UPS dazu abgeschlossen werden
*die zollrelevanten Daten incl. Artikelinformationen werden elektronisch in der „normalen“ UPS-EDI-Datei in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System====
*Artikelschnittstelle

=== DHL Customer Invoice Integration CIN ===
CIN Daten sind die Deklaration der Kopf-Daten einer Handelsrechnung und deren aufgeführte Artikel-Positionsdaten.
Anforderung von DHL Express Deutschland seit Herbst 2021, bei Nicht-EU-Warensendungen die zoll-relevanten Daten der Handelsrechnung auch in elektronischer Form innerhalb der Iftmin-EDI-Datei zu übermitteln.

Bei Neuprojekten wird es von DHL strikt vorausgesetzt, Bestandskunden kontaktiert DHL inzwischen auch direkt, ob diese Option zukünftig genutzt werden kann.
Sofern ein Neukunde es nicht umsetzen kann (aufgrund fehlender Artikeldaten o.ä.) muss dieser es projektweise mit DHL abstimmen, ob es auch ohne CIN Daten geht.

Zusätzlich müssen in der Schnittstelle folgende Daten auf Sendungsebene übergeben werden.

* Rechnungs-Nr

* RechnungsDatum (Belegung TT.MM.JJJJ)

* Frankatur
*
* benannter Frankatur-Ort (Bezugsort zur Frankatur)

Bedingt / falls verfügbar:

* MRN ("Movement Reference No." aus der Ausfuhranmeldung. Belegen, falls verfügbar.)

Bedingt / nur für Sonderfälle relevant:

* Exportgrund (Beispiel: "Commercial", "Sale" usw. Nur zu belegen, wenn es nicht um "normale" Verkaufs-Warenausfuhr geht.)

* ExportTyp (Beispiel: "P" (=Permanent) oder "T" (=Temporär) P ist Default. Nur falls es um eine temporäre Ausfuhr geht, mit T belegen.)

====Anforderung an Ihr HVS32 System====
*Zoll-Dokumente müssen trotzdem beigelegt werden, ausser DHL PLT wird separat auch noch genutzt
*Artikelschnittstelle (Übergabe der Artikeldaten pro Druckdatensatz, siehe nachfolgende relevante Felder)
{| class="wikitable"
|+
|-
! Bezeichnung !! HVS32 Feldname
|-
| Positions-Nr || PositionNr
|-
| Artikel-Text || ArtikelText1
|-
| Artikel-Menge || ArtikelMenge
|-
| Artikel-Mengeneinheit || ArtikelEinheit
|-
| Artikel-Wert || ArtikelWert
|-
| Artikel-Währung || ArtikelWaehrung
|-
| Artikel-Gewicht || ArtikelGewicht
|-
| Waren-Ursprungsland || Ursprungland
|-
| Zolltarifnummer || ArtikelBTNNr
|}

=== Post ITMATT (fürs Verfahren 53 DHL Paket International) ===
Für das Verfahren 53 Paket International verlangt die Post ab 2021 zwingend für die zoll-pflichtigen Nicht-EU-Sendungen die Übermittung einer zusätzlichen EDI-Datei ( "ITMATT"-Datei ).
Das Datei-Format nennt sich "ITMATT"-Format oder auch Format "Deutsche Post UPU – M33 Subset"
Die Datei enthält zu den zoll-pflichtigen Packstücken die Details, die auf der Zollinhaltserklärung angegeben werden müssen ( incl. den Artikeldaten )

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*aktive DHL Paket Konfiguration für das Verfahren
*Zoll-Inhaltserklärung und ggfs. Ausfuhrbegleitdokument muss trotzdem beigelegt werden

=== DPD innerhalb der MPSEXPDATA EDI-Daten ===
DPD innerhalb der MPSEXPDATA EDI-Daten
Zusätzlich Infos werden an DPD Übergen zum Thema Artikeldaten und Verzollung
*https://www.dpd.com/de/de/support/international/brexit/

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*Zoll-Dokumente müssen trotzdem beigelegt werden
*eigene Frankaturen

HVS32 Zoll / Dokumenten Upload

2022-12-07T07:51:24Z

Mnh: /* Elektronische Zoll/Rechnungsdaten-Übermittlung */

<big>'''Wichtiger Hinweis: alle folgend erwähnten Services / Dienste sind nur beim Versand in das nicht EU Ausland relevant.'''
</big>

= Sammelverzollung =

=== UPS WorldEase ===
UPS Sammelverzollung, dieser Dienst muss separat mit UPS vereinbart werden.
UPS übernimmt gesammelt die Verzollung der Paletten, Details über den Ablauf und Preise
erfahren Sie bei ihrem UPS Ansprechpartner

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*separate Drucker mit speziellem UPS World Ease Label Material
*Labels sind 30 cm lang
*spezielle DOCboxen von UPS kommen zum Einsatz

=== DHL Break Bulk ===
Mit dem „Break Bulk“ – Service bietet DHL die Möglichkeit, die einzelnen Sendungen eines
bestimmten Ziellandes für die gesammelte Einschleusung temporär in einer „Mutter“-
Sendung zu bündeln. Die „Mutter“-Sendung unterliegt dann der Verzollung. Erst am
vereinbarten Einschleus-Ort fächert dann DHL die Sendungen dann wieder für die Zustellung
an die End-Empfänger auf. Die Verwendung des Break Bulk Services muss mit dem relevanten DHL
Ansprechpartner abgestimmt sein, eine entsprechende Vereinbarung
zwischen Versender und DHL muss getroffen sein.

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*eigene Versandart für die Break Bulk Abwicklung

= Dokument—Datei-Upload =

=== DHL PaperlessTrade PLT (nicht für alle Länder nutzbar)===
Für DHL PLT werden die relevanten Zolldokumente (Handels*oder ProForma-Rechnung, gegebenenfalls zusätzliches Ausfuhrbegleitdokument) für jede zu verzollende Sendung als PDF-Dateien auf einen DHL SFTP Server hochgeladen.
Dazu ist zusätzlich noch ein DHL AWB-PDF-Dokument erforderlich, welches jedoch durch das HVS32 die jeweilige Sendung erzeugt und beifügt wird.
Das Hochladen der Dokumente erfolgt beim DHL Tagesabschluss.
Auf den DHL-Labels wird der PLT-Status speziell gekennzeichnet.

====Anforderung an Ihr HVS32 System: ====

*für PLT-Sendung müssen die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der DHL AWB-Nr, die vom HVS32 vergeben und an den Host als TrackingNr zurückgemeldet wird. Die PDF-Dateien müssen spätestens zum Zeitpunkt des DHL Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen
*weitere Anforderungen können Projektweise seitens DHL erhoben werden (MRN bekannt bei der Druckabwicklung...)

=== UPS Paperless Document API ===
'''Umfang''':
Für UPS Paperless Document /PaperlessTrade werden die relevanten Zolldokumente für eine zu verzollende Sendung als PDF-Dateien an UPS per UPS Webservice hochgeladen.
Die relevanten Zolldokumente sind:

*Handels- oder ProForma-Rechnung
*ggfs noch Ausfuhrbegleitdokument ABD
*ggfs. Zusatz-Dokument, z.B. Ursprungszeugnis („certification of origin“)

Das Hochladen der Dokumente erfolgt beim UPS Tagesabschluss per Webservice-Datendialog.
Auf den UPS-Labels wird der Paperless Document-Status speziell gekennzeichnet (Vermerk EDI-IDIS unten rechts auf den Versandlabels).
Anmerkung: dies darf nicht verwechselt werden mit der UPS Option Paperless Invoice! Bei letzterer werden die zollrelevanten Daten incl. Artikelinformationen elektronisch in der „normalen“ UPS-EDI-Datei
in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System: ====
*es müssen uns für jede UPS*Paperless Document -Sendung die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument / Zusatzdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der UPS Sendungs-Nr, die vom HVS32 vergeben und an den Host z.B. als VersandSendungsNr zurückgemeldet wurde.
*Die PDF-Dateien müssen spätestens zum Zeitpunkt des UPS Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen. Wenn die Voraussetzungen erfüllt sind, kann man weitere Details klären (z.B. Ordner in dem die pdf-Dateien auf dem HVS32 Server für den weiteren Prozess abgelegt werden, Zugangs-Parameter von UPS für den Upload der pdf Dokumente) und dann muss es im Systemablauf nach Aufwand konfiguriert werden.

=== FedEx Electronic Trade Documents ===
bei uns in Arbeit, noch nicht verfügbar

= Elektronische Zoll/Rechnungsdaten-Übermittlung =
die Zoll/Rechnungs-Detail-Daten werden in den EDI-Dateien der Frachtführer als zusätzliche Daten übermittelt

=== UPS PaperlessInvoice ===
*der Versender muss es mit UPS vereinbart haben, dass er das abwickeln darf. Paperless Invoice ist eine sogenannte UPS "Kontrakt-"Option, d.h. es muss ein entsprechendes Vertragswerk mit UPS dazu abgeschlossen werden
*die zollrelevanten Daten incl. Artikelinformationen werden elektronisch in der „normalen“ UPS-EDI-Datei in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System====
*Artikelschnittstelle

=== DHL Customer Invoice Integration CIN ===
CIN Daten sind die Deklaration der Kopf-Daten einer Handelsrechnung und deren aufgeführte Artikel-Positionsdaten.
Anforderung von DHL Express Deutschland seit Herbst 2021, bei Nicht-EU-Warensendungen die zoll-relevanten Daten der Handelsrechnung auch in elektronischer Form innerhalb der Iftmin-EDI-Datei zu übermitteln.

Bei Neuprojekten wird es von DHL strikt vorausgesetzt, Bestandskunden kontaktiert DHL inzwischen auch direkt, ob diese Option zukünftig genutzt werden kann.
Sofern ein Neukunde es nicht umsetzen kann (aufgrund fehlender Artikeldaten o.ä.) muss dieser es projektweise mit DHL abstimmen, ob es auch ohne CIN Daten geht.

Zusätzlich müssen in der Schnittstelle folgende Daten auf Sendungsebene übergeben werden.

* Rechnungs-Nr

* RechnungsDatum (Belegung TT.MM.JJJJ)

* Frankatur
*
* benannter Frankatur-Ort (Bezugsort zur Frankatur)

Bedingt / falls verfügbar:

* MRN ("Movement Reference No." aus der Ausfuhranmeldung. Belegen, falls verfügbar.)

Bedingt / nur für Sonderfälle relevant:

* Exportgrund (Beispiel: "Commercial", "Sale" usw. Nur zu belegen, wenn es nicht um "normale" Verkaufs-Warenausfuhr geht.)

* ExportTyp (Beispiel: "P" (=Permanent) oder "T" (=Temporär) P ist Default. Nur falls es um eine temporäre Ausfuhr geht, mit T belegen.)

====Anforderung an Ihr HVS32 System====
*Artikelschnittstelle
mit relevanten Feldern:
{| class="wikitable"
|+
|-
! Bezeichnung !! HVS32 Feldname
|-
| Positions-Nr || PositionNr
|-
| Artikel-Text || ArtikelText1
|-
| Artikel-Menge || ArtikelMenge
|-
| Artikel-Mengeneinheit || ArtikelEinheit
|-
| Artikel-Wert || ArtikelWert
|-
| Artikel-Währung || ArtikelWaehrung
|-
| Artikel-Gewicht || ArtikelGewicht
|-
| Waren-Ursprungsland || Ursprungland
|-
| Zolltarifnummer || ArtikelBTNNr
|}

*Zoll-Dokumente müssen trotzdem beigelegt werden, ausser DHL PLT wird separat auch noch genutzt

=== Post ITMATT (fürs Verfahren 53 DHL Paket International) ===
Für das Verfahren 53 Paket International verlangt die Post ab 2021 zwingend für die zoll-pflichtigen Nicht-EU-Sendungen die Übermittung einer zusätzlichen EDI-Datei ( "ITMATT"-Datei ).
Das Datei-Format nennt sich "ITMATT"-Format oder auch Format "Deutsche Post UPU – M33 Subset"
Die Datei enthält zu den zoll-pflichtigen Packstücken die Details, die auf der Zollinhaltserklärung angegeben werden müssen ( incl. den Artikeldaten )

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*aktive DHL Paket Konfiguration für das Verfahren
*Zoll-Inhaltserklärung und ggfs. Ausfuhrbegleitdokument muss trotzdem beigelegt werden

=== DPD innerhalb der MPSEXPDATA EDI-Daten ===
DPD innerhalb der MPSEXPDATA EDI-Daten
Zusätzlich Infos werden an DPD Übergen zum Thema Artikeldaten und Verzollung
*https://www.dpd.com/de/de/support/international/brexit/

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*Zoll-Dokumente müssen trotzdem beigelegt werden
*eigene Frankaturen

HVS32 Zoll / Dokumenten Upload

2022-12-07T07:51:04Z

Mnh: /* Anforderung an Ihr HVS32 System */

<big>'''Wichtiger Hinweis: alle folgend erwähnten Services / Dienste sind nur beim Versand in das nicht EU Ausland relevant.'''
</big>

= Sammelverzollung =

=== UPS WorldEase ===
UPS Sammelverzollung, dieser Dienst muss separat mit UPS vereinbart werden.
UPS übernimmt gesammelt die Verzollung der Paletten, Details über den Ablauf und Preise
erfahren Sie bei ihrem UPS Ansprechpartner

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*separate Drucker mit speziellem UPS World Ease Label Material
*Labels sind 30 cm lang
*spezielle DOCboxen von UPS kommen zum Einsatz

=== DHL Break Bulk ===
Mit dem „Break Bulk“ – Service bietet DHL die Möglichkeit, die einzelnen Sendungen eines
bestimmten Ziellandes für die gesammelte Einschleusung temporär in einer „Mutter“-
Sendung zu bündeln. Die „Mutter“-Sendung unterliegt dann der Verzollung. Erst am
vereinbarten Einschleus-Ort fächert dann DHL die Sendungen dann wieder für die Zustellung
an die End-Empfänger auf. Die Verwendung des Break Bulk Services muss mit dem relevanten DHL
Ansprechpartner abgestimmt sein, eine entsprechende Vereinbarung
zwischen Versender und DHL muss getroffen sein.

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*eigene Versandart für die Break Bulk Abwicklung

= Dokument—Datei-Upload =

=== DHL PaperlessTrade PLT (nicht für alle Länder nutzbar)===
Für DHL PLT werden die relevanten Zolldokumente (Handels*oder ProForma-Rechnung, gegebenenfalls zusätzliches Ausfuhrbegleitdokument) für jede zu verzollende Sendung als PDF-Dateien auf einen DHL SFTP Server hochgeladen.
Dazu ist zusätzlich noch ein DHL AWB-PDF-Dokument erforderlich, welches jedoch durch das HVS32 die jeweilige Sendung erzeugt und beifügt wird.
Das Hochladen der Dokumente erfolgt beim DHL Tagesabschluss.
Auf den DHL-Labels wird der PLT-Status speziell gekennzeichnet.

====Anforderung an Ihr HVS32 System: ====

*für PLT-Sendung müssen die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der DHL AWB-Nr, die vom HVS32 vergeben und an den Host als TrackingNr zurückgemeldet wird. Die PDF-Dateien müssen spätestens zum Zeitpunkt des DHL Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen
*weitere Anforderungen können Projektweise seitens DHL erhoben werden (MRN bekannt bei der Druckabwicklung...)

=== UPS Paperless Document API ===
'''Umfang''':
Für UPS Paperless Document /PaperlessTrade werden die relevanten Zolldokumente für eine zu verzollende Sendung als PDF-Dateien an UPS per UPS Webservice hochgeladen.
Die relevanten Zolldokumente sind:

*Handels- oder ProForma-Rechnung
*ggfs noch Ausfuhrbegleitdokument ABD
*ggfs. Zusatz-Dokument, z.B. Ursprungszeugnis („certification of origin“)

Das Hochladen der Dokumente erfolgt beim UPS Tagesabschluss per Webservice-Datendialog.
Auf den UPS-Labels wird der Paperless Document-Status speziell gekennzeichnet (Vermerk EDI-IDIS unten rechts auf den Versandlabels).
Anmerkung: dies darf nicht verwechselt werden mit der UPS Option Paperless Invoice! Bei letzterer werden die zollrelevanten Daten incl. Artikelinformationen elektronisch in der „normalen“ UPS-EDI-Datei
in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System: ====
*es müssen uns für jede UPS*Paperless Document -Sendung die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument / Zusatzdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der UPS Sendungs-Nr, die vom HVS32 vergeben und an den Host z.B. als VersandSendungsNr zurückgemeldet wurde.
*Die PDF-Dateien müssen spätestens zum Zeitpunkt des UPS Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen. Wenn die Voraussetzungen erfüllt sind, kann man weitere Details klären (z.B. Ordner in dem die pdf-Dateien auf dem HVS32 Server für den weiteren Prozess abgelegt werden, Zugangs-Parameter von UPS für den Upload der pdf Dokumente) und dann muss es im Systemablauf nach Aufwand konfiguriert werden.

=== FedEx Electronic Trade Documents ===
bei uns in Arbeit, noch nicht verfügbar

= Elektronische Zoll/Rechnungsdaten-Übermittlung =
die Zoll/Rechnungs-Detail-Daten werden in den EDI-Dateien der Frachtführer als zusätzliche Daten übermittelt

=== UPS PaperlessInvoice ===
*der Versender muss es mit UPS vereinbart haben, dass er das abwickeln darf. Paperless Invoice ist eine sogenannte UPS "Kontrakt-"Option, d.h. es muss ein entsprechendes Vertragswerk mit UPS dazu abgeschlossen werden
*die zollrelevanten Daten incl. Artikelinformationen werden elektronisch in der „normalen“ UPS-EDI-Datei in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System====
*Artikelschnittstelle

=== DHL Customer Invoice Integration CIN ===
CIN Daten sind die Deklaration der Kopf-Daten einer Handelsrechnung und deren aufgeführte Artikel-Positionsdaten.
Anforderung von DHL Express Deutschland seit Herbst 2021, bei Nicht-EU-Warensendungen die zoll-relevanten Daten der Handelsrechnung auch in elektronischer Form innerhalb der Iftmin-EDI-Datei zu übermitteln.

Bei Neuprojekten wird es von DHL strikt vorausgesetzt, Bestandskunden kontaktiert DHL inzwischen auch direkt, ob diese Option zukünftig genutzt werden kann.
Sofern ein Neukunde es nicht umsetzen kann (aufgrund fehlender Artikeldaten o.ä.) muss dieser es projektweise mit DHL abstimmen, ob es auch ohne CIN Daten geht.

Zusätzlich müssen in der Schnittstelle folgende Daten auf Sendungsebene übergeben werden.

* Rechnungs-Nr

* RechnungsDatum (Belegung TT.MM.JJJJ)

* Frankatur
*
* benannter Frankatur-Ort (Bezugsort zur Frankatur)

Bedingt / falls verfügbar:

* MRN ("Movement Reference No." aus der Ausfuhranmeldung. Belegen, falls verfügbar.)

Bedingt / nur für Sonderfälle relevant:

* Exportgrund (Beispiel: "Commercial", "Sale" usw. Nur zu belegen, wenn es nicht um "normale" Verkaufs-Warenausfuhr geht.)

* ExportTyp (Beispiel: "P" (=Permanent) oder "T" (=Temporär) P ist Default. Nur falls es um eine temporäre Ausfuhr geht, mit T belegen.)

====Anforderung an Ihr HVS32 System====
*Artikelschnittstelle
mit relevanten Feldern:
{| class="wikitable"
|+ Text der Überschrift
|-
! Bezeichnung !! HVS32 Feldname
|-
| Positions-Nr || PositionNr
|-
| Artikel-Text || ArtikelText1
|-
| Artikel-Menge || ArtikelMenge
|-
| Artikel-Mengeneinheit || ArtikelEinheit
|-
| Artikel-Wert || ArtikelWert
|-
| Artikel-Währung || ArtikelWaehrung
|-
| Artikel-Gewicht || ArtikelGewicht
|-
| Waren-Ursprungsland || Ursprungland
|-
| Zolltarifnummer || ArtikelBTNNr
|}

*Zoll-Dokumente müssen trotzdem beigelegt werden, ausser DHL PLT wird separat auch noch genutzt

=== Post ITMATT (fürs Verfahren 53 DHL Paket International) ===
Für das Verfahren 53 Paket International verlangt die Post ab 2021 zwingend für die zoll-pflichtigen Nicht-EU-Sendungen die Übermittung einer zusätzlichen EDI-Datei ( "ITMATT"-Datei ).
Das Datei-Format nennt sich "ITMATT"-Format oder auch Format "Deutsche Post UPU – M33 Subset"
Die Datei enthält zu den zoll-pflichtigen Packstücken die Details, die auf der Zollinhaltserklärung angegeben werden müssen ( incl. den Artikeldaten )

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*aktive DHL Paket Konfiguration für das Verfahren
*Zoll-Inhaltserklärung und ggfs. Ausfuhrbegleitdokument muss trotzdem beigelegt werden

=== DPD innerhalb der MPSEXPDATA EDI-Daten ===
DPD innerhalb der MPSEXPDATA EDI-Daten
Zusätzlich Infos werden an DPD Übergen zum Thema Artikeldaten und Verzollung
*https://www.dpd.com/de/de/support/international/brexit/

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*Zoll-Dokumente müssen trotzdem beigelegt werden
*eigene Frankaturen

HVS32 Zoll / Dokumenten Upload

2022-12-07T07:48:51Z

Mnh: /* Elektronische Zoll/Rechnungsdaten-Übermittlung */

<big>'''Wichtiger Hinweis: alle folgend erwähnten Services / Dienste sind nur beim Versand in das nicht EU Ausland relevant.'''
</big>

= Sammelverzollung =

=== UPS WorldEase ===
UPS Sammelverzollung, dieser Dienst muss separat mit UPS vereinbart werden.
UPS übernimmt gesammelt die Verzollung der Paletten, Details über den Ablauf und Preise
erfahren Sie bei ihrem UPS Ansprechpartner

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*separate Drucker mit speziellem UPS World Ease Label Material
*Labels sind 30 cm lang
*spezielle DOCboxen von UPS kommen zum Einsatz

=== DHL Break Bulk ===
Mit dem „Break Bulk“ – Service bietet DHL die Möglichkeit, die einzelnen Sendungen eines
bestimmten Ziellandes für die gesammelte Einschleusung temporär in einer „Mutter“-
Sendung zu bündeln. Die „Mutter“-Sendung unterliegt dann der Verzollung. Erst am
vereinbarten Einschleus-Ort fächert dann DHL die Sendungen dann wieder für die Zustellung
an die End-Empfänger auf. Die Verwendung des Break Bulk Services muss mit dem relevanten DHL
Ansprechpartner abgestimmt sein, eine entsprechende Vereinbarung
zwischen Versender und DHL muss getroffen sein.

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*eigene Versandart für die Break Bulk Abwicklung

= Dokument—Datei-Upload =

=== DHL PaperlessTrade PLT (nicht für alle Länder nutzbar)===
Für DHL PLT werden die relevanten Zolldokumente (Handels*oder ProForma-Rechnung, gegebenenfalls zusätzliches Ausfuhrbegleitdokument) für jede zu verzollende Sendung als PDF-Dateien auf einen DHL SFTP Server hochgeladen.
Dazu ist zusätzlich noch ein DHL AWB-PDF-Dokument erforderlich, welches jedoch durch das HVS32 die jeweilige Sendung erzeugt und beifügt wird.
Das Hochladen der Dokumente erfolgt beim DHL Tagesabschluss.
Auf den DHL-Labels wird der PLT-Status speziell gekennzeichnet.

====Anforderung an Ihr HVS32 System: ====

*für PLT-Sendung müssen die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der DHL AWB-Nr, die vom HVS32 vergeben und an den Host als TrackingNr zurückgemeldet wird. Die PDF-Dateien müssen spätestens zum Zeitpunkt des DHL Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen
*weitere Anforderungen können Projektweise seitens DHL erhoben werden (MRN bekannt bei der Druckabwicklung...)

=== UPS Paperless Document API ===
'''Umfang''':
Für UPS Paperless Document /PaperlessTrade werden die relevanten Zolldokumente für eine zu verzollende Sendung als PDF-Dateien an UPS per UPS Webservice hochgeladen.
Die relevanten Zolldokumente sind:

*Handels- oder ProForma-Rechnung
*ggfs noch Ausfuhrbegleitdokument ABD
*ggfs. Zusatz-Dokument, z.B. Ursprungszeugnis („certification of origin“)

Das Hochladen der Dokumente erfolgt beim UPS Tagesabschluss per Webservice-Datendialog.
Auf den UPS-Labels wird der Paperless Document-Status speziell gekennzeichnet (Vermerk EDI-IDIS unten rechts auf den Versandlabels).
Anmerkung: dies darf nicht verwechselt werden mit der UPS Option Paperless Invoice! Bei letzterer werden die zollrelevanten Daten incl. Artikelinformationen elektronisch in der „normalen“ UPS-EDI-Datei
in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System: ====
*es müssen uns für jede UPS*Paperless Document -Sendung die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument / Zusatzdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der UPS Sendungs-Nr, die vom HVS32 vergeben und an den Host z.B. als VersandSendungsNr zurückgemeldet wurde.
*Die PDF-Dateien müssen spätestens zum Zeitpunkt des UPS Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen. Wenn die Voraussetzungen erfüllt sind, kann man weitere Details klären (z.B. Ordner in dem die pdf-Dateien auf dem HVS32 Server für den weiteren Prozess abgelegt werden, Zugangs-Parameter von UPS für den Upload der pdf Dokumente) und dann muss es im Systemablauf nach Aufwand konfiguriert werden.

=== FedEx Electronic Trade Documents ===
bei uns in Arbeit, noch nicht verfügbar

= Elektronische Zoll/Rechnungsdaten-Übermittlung =
die Zoll/Rechnungs-Detail-Daten werden in den EDI-Dateien der Frachtführer als zusätzliche Daten übermittelt

=== UPS PaperlessInvoice ===
*der Versender muss es mit UPS vereinbart haben, dass er das abwickeln darf. Paperless Invoice ist eine sogenannte UPS "Kontrakt-"Option, d.h. es muss ein entsprechendes Vertragswerk mit UPS dazu abgeschlossen werden
*die zollrelevanten Daten incl. Artikelinformationen werden elektronisch in der „normalen“ UPS-EDI-Datei in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System====
*Artikelschnittstelle

=== DHL Customer Invoice Integration CIN ===
CIN Daten sind die Deklaration der Kopf-Daten einer Handelsrechnung und deren aufgeführte Artikel-Positionsdaten.
Anforderung von DHL Express Deutschland seit Herbst 2021, bei Nicht-EU-Warensendungen die zoll-relevanten Daten der Handelsrechnung auch in elektronischer Form innerhalb der Iftmin-EDI-Datei zu übermitteln.

Bei Neuprojekten wird es von DHL strikt vorausgesetzt, Bestandskunden kontaktiert DHL inzwischen auch direkt, ob diese Option zukünftig genutzt werden kann.
Sofern ein Neukunde es nicht umsetzen kann (aufgrund fehlender Artikeldaten o.ä.) muss dieser es projektweise mit DHL abstimmen, ob es auch ohne CIN Daten geht.

Zusätzlich müssen in der Schnittstelle folgende Daten auf Sendungsebene übergeben werden.

* Rechnungs-Nr

* RechnungsDatum (Belegung TT.MM.JJJJ)

* Frankatur
*
* benannter Frankatur-Ort (Bezugsort zur Frankatur)

Bedingt / falls verfügbar:

* MRN ("Movement Reference No." aus der Ausfuhranmeldung. Belegen, falls verfügbar.)

Bedingt / nur für Sonderfälle relevant:

* Exportgrund (Beispiel: "Commercial", "Sale" usw. Nur zu belegen, wenn es nicht um "normale" Verkaufs-Warenausfuhr geht.)

* ExportTyp (Beispiel: "P" (=Permanent) oder "T" (=Temporär) P ist Default. Nur falls es um eine temporäre Ausfuhr geht, mit T belegen.)

====Anforderung an Ihr HVS32 System====
*Artikelschnittstelle
mit relevanten Feldern:
{| class="wikitable"
|+ Text der Überschrift
|-
! Überschrift !! HVS32 Feldname
|-
| Positions-Nr || PositionNr
|-
| Beispiel || Beispiel
|-
| Beispiel || Beispiel
|-
| Beispiel || Beispiel
|-
| Beispiel || Beispiel
|-
| Beispiel || Beispiel
|-
| Beispiel || Beispiel
|-
| Beispiel || Beispiel
|-
| Beispiel || Beispiel
|-
| Beispiel || Beispiel
|}

- = HVS32 Feld PositionNr
-Artikel-Text = HVS32 Feld ArtikelText1
-Artikel-Menge = HVS32 Feld ArtikelMenge
-Artikel-Mengeneinheit = HVS32 Feld ArtikelEinheit
-Artikel-Wert = HVS32 Feld ArtikelWert
-Artikel-Währung = HVS32 Feld ArtikelWaehrung
-Artikel-Gewicht = HVS32 Feld ArtikelGewicht
-Waren-Ursprungsland = HVS32 Feld Ursprungland
-Zolltarifnummer = HVS32 Feld ArtikelBTNNr

*Zoll-Dokumente müssen trotzdem beigelegt werden, ausser DHL PLT wird separat auch noch genutzt

=== Post ITMATT (fürs Verfahren 53 DHL Paket International) ===
Für das Verfahren 53 Paket International verlangt die Post ab 2021 zwingend für die zoll-pflichtigen Nicht-EU-Sendungen die Übermittung einer zusätzlichen EDI-Datei ( "ITMATT"-Datei ).
Das Datei-Format nennt sich "ITMATT"-Format oder auch Format "Deutsche Post UPU – M33 Subset"
Die Datei enthält zu den zoll-pflichtigen Packstücken die Details, die auf der Zollinhaltserklärung angegeben werden müssen ( incl. den Artikeldaten )

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*aktive DHL Paket Konfiguration für das Verfahren
*Zoll-Inhaltserklärung und ggfs. Ausfuhrbegleitdokument muss trotzdem beigelegt werden

=== DPD innerhalb der MPSEXPDATA EDI-Daten ===
DPD innerhalb der MPSEXPDATA EDI-Daten
Zusätzlich Infos werden an DPD Übergen zum Thema Artikeldaten und Verzollung
*https://www.dpd.com/de/de/support/international/brexit/

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*Zoll-Dokumente müssen trotzdem beigelegt werden
*eigene Frankaturen

HVS32 Zoll / Dokumenten Upload

2022-12-07T07:46:22Z

Mnh: /* Anforderung an Ihr HVS32 System: */

<big>'''Wichtiger Hinweis: alle folgend erwähnten Services / Dienste sind nur beim Versand in das nicht EU Ausland relevant.'''
</big>

= Sammelverzollung =

=== UPS WorldEase ===
UPS Sammelverzollung, dieser Dienst muss separat mit UPS vereinbart werden.
UPS übernimmt gesammelt die Verzollung der Paletten, Details über den Ablauf und Preise
erfahren Sie bei ihrem UPS Ansprechpartner

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*separate Drucker mit speziellem UPS World Ease Label Material
*Labels sind 30 cm lang
*spezielle DOCboxen von UPS kommen zum Einsatz

=== DHL Break Bulk ===
Mit dem „Break Bulk“ – Service bietet DHL die Möglichkeit, die einzelnen Sendungen eines
bestimmten Ziellandes für die gesammelte Einschleusung temporär in einer „Mutter“-
Sendung zu bündeln. Die „Mutter“-Sendung unterliegt dann der Verzollung. Erst am
vereinbarten Einschleus-Ort fächert dann DHL die Sendungen dann wieder für die Zustellung
an die End-Empfänger auf. Die Verwendung des Break Bulk Services muss mit dem relevanten DHL
Ansprechpartner abgestimmt sein, eine entsprechende Vereinbarung
zwischen Versender und DHL muss getroffen sein.

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*eigene Versandart für die Break Bulk Abwicklung

= Dokument—Datei-Upload =

=== DHL PaperlessTrade PLT (nicht für alle Länder nutzbar)===
Für DHL PLT werden die relevanten Zolldokumente (Handels*oder ProForma-Rechnung, gegebenenfalls zusätzliches Ausfuhrbegleitdokument) für jede zu verzollende Sendung als PDF-Dateien auf einen DHL SFTP Server hochgeladen.
Dazu ist zusätzlich noch ein DHL AWB-PDF-Dokument erforderlich, welches jedoch durch das HVS32 die jeweilige Sendung erzeugt und beifügt wird.
Das Hochladen der Dokumente erfolgt beim DHL Tagesabschluss.
Auf den DHL-Labels wird der PLT-Status speziell gekennzeichnet.

====Anforderung an Ihr HVS32 System: ====

*für PLT-Sendung müssen die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der DHL AWB-Nr, die vom HVS32 vergeben und an den Host als TrackingNr zurückgemeldet wird. Die PDF-Dateien müssen spätestens zum Zeitpunkt des DHL Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen
*weitere Anforderungen können Projektweise seitens DHL erhoben werden (MRN bekannt bei der Druckabwicklung...)

=== UPS Paperless Document API ===
'''Umfang''':
Für UPS Paperless Document /PaperlessTrade werden die relevanten Zolldokumente für eine zu verzollende Sendung als PDF-Dateien an UPS per UPS Webservice hochgeladen.
Die relevanten Zolldokumente sind:

*Handels- oder ProForma-Rechnung
*ggfs noch Ausfuhrbegleitdokument ABD
*ggfs. Zusatz-Dokument, z.B. Ursprungszeugnis („certification of origin“)

Das Hochladen der Dokumente erfolgt beim UPS Tagesabschluss per Webservice-Datendialog.
Auf den UPS-Labels wird der Paperless Document-Status speziell gekennzeichnet (Vermerk EDI-IDIS unten rechts auf den Versandlabels).
Anmerkung: dies darf nicht verwechselt werden mit der UPS Option Paperless Invoice! Bei letzterer werden die zollrelevanten Daten incl. Artikelinformationen elektronisch in der „normalen“ UPS-EDI-Datei
in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System: ====
*es müssen uns für jede UPS*Paperless Document -Sendung die oben erwähnten Dokumente als PDF-Datei bereitgestellt werden. Die PDF-Dateien müssen so benamt sein, dass wir zum einen erkennen, um was für ein Dokument (Rechnung / Ausfuhrbegleitdokument / Zusatzdokument) es sich handelt, und zu welcher Sendung es gehört. Also z.B. eindeutige Benamung mit der Referenznr/LieferscheinNr der Sendung. Oder Benamung mit der UPS Sendungs-Nr, die vom HVS32 vergeben und an den Host z.B. als VersandSendungsNr zurückgemeldet wurde.
*Die PDF-Dateien müssen spätestens zum Zeitpunkt des UPS Tagesabschlusses für alle relevanten Sendungen vollständig bereitstehen. Wenn die Voraussetzungen erfüllt sind, kann man weitere Details klären (z.B. Ordner in dem die pdf-Dateien auf dem HVS32 Server für den weiteren Prozess abgelegt werden, Zugangs-Parameter von UPS für den Upload der pdf Dokumente) und dann muss es im Systemablauf nach Aufwand konfiguriert werden.

=== FedEx Electronic Trade Documents ===
bei uns in Arbeit, noch nicht verfügbar

= Elektronische Zoll/Rechnungsdaten-Übermittlung =
die Zoll/Rechnungs-Detail-Daten werden in den EDI-Dateien der Frachtführer als zusätzliche Daten übermittelt

=== UPS PaperlessInvoice ===
*der Versender muss es mit UPS vereinbart haben, dass er das abwickeln darf. Paperless Invoice ist eine sogenannte UPS "Kontrakt-"Option, d.h. es muss ein entsprechendes Vertragswerk mit UPS dazu abgeschlossen werden
*die zollrelevanten Daten incl. Artikelinformationen werden elektronisch in der „normalen“ UPS-EDI-Datei in den Sendungsdaten mit übermittelt, so dass UPS die relevante Handelsrechnung auf UPS-Seite erzeugen kann.

====Anforderung an Ihr HVS32 System====
*Artikelschnittstelle

=== DHL Customer Invoice Integration CIN ===
CIN Daten sind die Deklaration der Kopf-Daten einer Handelsrechnung und deren aufgeführte Artikel-Positionsdaten.
Anforderung von DHL Express Deutschland seit Herbst 2021, bei Nicht-EU-Warensendungen die zoll-relevanten Daten der Handelsrechnung auch in elektronischer Form innerhalb der Iftmin-EDI-Datei zu übermitteln.

Bei Neuprojekten wird es von DHL strikt vorausgesetzt, Bestandskunden kontaktiert DHL inzwischen auch direkt, ob diese Option zukünftig genutzt werden kann.
Sofern ein Neukunde es nicht umsetzen kann (aufgrund fehlender Artikeldaten o.ä.) muss dieser es projektweise mit DHL abstimmen, ob es auch ohne CIN Daten geht.

Zusätzlich müssen in der Schnittstelle folgende Daten auf Sendungsebene übergeben werden.

* Rechnungs-Nr

* RechnungsDatum (Belegung TT.MM.JJJJ)

* Frankatur
*
* benannter Frankatur-Ort (Bezugsort zur Frankatur)

Bedingt / falls verfügbar:

* MRN ("Movement Reference No." aus der Ausfuhranmeldung. Belegen, falls verfügbar.)

Bedingt / nur für Sonderfälle relevant:

* Exportgrund (Beispiel: "Commercial", "Sale" usw. Nur zu belegen, wenn es nicht um "normale" Verkaufs-Warenausfuhr geht.)

* ExportTyp (Beispiel: "P" (=Permanent) oder "T" (=Temporär) P ist Default. Nur falls es um eine temporäre Ausfuhr geht, mit T belegen.)

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*Zoll-Dokumente müssen trotzdem beigelegt werden, ausser DHL PLT wird separat auch noch genutzt

=== Post ITMATT (fürs Verfahren 53 DHL Paket International) ===
Für das Verfahren 53 Paket International verlangt die Post ab 2021 zwingend für die zoll-pflichtigen Nicht-EU-Sendungen die Übermittung einer zusätzlichen EDI-Datei ( "ITMATT"-Datei ).
Das Datei-Format nennt sich "ITMATT"-Format oder auch Format "Deutsche Post UPU – M33 Subset"
Die Datei enthält zu den zoll-pflichtigen Packstücken die Details, die auf der Zollinhaltserklärung angegeben werden müssen ( incl. den Artikeldaten )

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*aktive DHL Paket Konfiguration für das Verfahren
*Zoll-Inhaltserklärung und ggfs. Ausfuhrbegleitdokument muss trotzdem beigelegt werden

=== DPD innerhalb der MPSEXPDATA EDI-Daten ===
DPD innerhalb der MPSEXPDATA EDI-Daten
Zusätzlich Infos werden an DPD Übergen zum Thema Artikeldaten und Verzollung
*https://www.dpd.com/de/de/support/international/brexit/

====Anforderung an Ihr HVS32 System: ====
*Artikelschnittstelle
*Zoll-Dokumente müssen trotzdem beigelegt werden
*eigene Frankaturen

Verpackungen anlegen

2022-11-15T11:12:25Z

Mnh: /* Verpackungsarten anlegen / ändern im HVS32 */

== Verpackungsarten anlegen / ändern im HVS32 ==

 

'''Menü Setup -> Versand-Stammdaten -> Bearbeiten -> Verpackung'''

In der oberen Tabelle ist der Verpackungs-Stamm dargestellt. In der unteren Tabelle ist die Zuordnung der Verpackungsart zu den einzelnen ‚Frachtführern’ dargestellt.

Die Zuordnung legt fest, dass die Verpackungsart in Zusammenhang mit diesem Frachtführer zur Anwendung kommen kann. Sie definiert die frachtführer-seitigen Ausprägungen (z.B. das Listen-Kürzel oder die Kennung für die Frachtführer-spezielle EDI-Datei-Übermittlung.)

Anmerkung: Für die Versandarten des NeutralSpedition-Moduls gilt die Besonderheit, dass für jede Versandart ein separater ‚Frachtführer’ im HVS32 existiert. Für alle anderen Versand-Module ( TNT, DHL, UPS, FedEx usw.) gibt es genau 1 ‚Frachtführer’ je Versand-Modul (selbst wenn mehrere Versandarten definiert sind, die diesem Versand-Modul zugeordnet sind).

 

 

'''[[File:Verpackungsarten.png|frame|left|550x400px|Verpackungsarten]]'''

{| border="1" cellpadding="1" cellspacing="1" class="wikitable" style="width: 500px;"
|+ '''Verpackungsstamm (obere Tabelle)'''
|-
|
Beschreibung

| eindeutige Klartext-Beschreibung der Verpackungsart
|-
| VerpackungsartID:
| in den Eingangs-Verarbeitungsdaten übermittelte eindeutige Verpackungsart-Kennung
Max. 20 Stellen lang, Sonderzeichen nicht erlaubt.
|-
| Ladehilfsmittel:
| T/F : T (True) wenn es sich um eine Verpackungsart handelt, die als Ladehilfsmittel verwendet werden kann (z.B. Palette) F ( False) wenn nicht
|-
|
VorgabeLaenge/ VorgabeBreite/ VorgabeHoehe:

| fixe Abmessungsangaben in cm, falls die Verpackungsart generell diese Abmessungen umfasst und letztere dann grundsätzlich zur Anwendung kommen sollen
|-
| VerpackungsartPreis:  
| (nur im Sonderfall zu belegen, derzeit nicht relevant)
|-
| VerpackungsartGewicht: 
| (nur im Sonderfall zu belegen, derzeit nicht relevant)
|}

{| border="1" cellpadding="1" cellspacing="1" class="wikitable" style="width: 500px;"
|+ '''Verpackungszuordnung (untere Tabelle)'''
|-
| Frachtfuehrer
| Frachtführer, für den diese Verpackungsart zur Anwendung kommen soll
|-
| Verpackung_FFDatei_ID
| Kürzel für die frachtführerspezielle EDI-Datei (hier dürfen nur die Keys laut Frachtführer-Vorgaben verwendet werden)
|-
| Verpackung_Listen_ID
| Kennung für den Andruck auf den Ladelisten
|-
| AnzahlLabelsProPaket
| Anzahl zu druckender Labelexemplare je Packstück (in der Regel 1)
|-
| IsKomponentenFaehig
| T/F: T (True) wenn die Verpackungsart Verpackungs-Komponenten beinhalten kann ( z.B. Gitterbox mit enthaltenen Unterkartons) F ( False) wenn nicht
|-
| Auswahlsortierung
| num. Wert für Sortierreihenfolge, nur relevant für interaktive Auswahldarstellung (je niedriger der Wert, umso höher rutscht der Eintrag in der Anzeige)
|-
| Gesperrt
| T/F: T (True) wenn die Verpackungsart für die Anwendung gesperrt ist. F (False) wenn die Verpackungsart für die Anwendung freigegeben ist.
|}

== Hinzufügen eines neuen Lademittels: ==

#Verpackungsstamm-Eintrag hinzufügen in der oberen Tabelle (Mit Knopf „Neu“ neuen Eintrag anlegen, Feldinhalte ergänzen, mit „Speichern“ abspeichern)  
#Verpackungs-Zuordnungen hinzufügen in der unteren Tabelle Hier muss für jeden Frachtführer, bei dem die Verpackungsart zur Anwendung kommen kann, eine neue Zuordnung angelegt werden. (Mit Knopf „Neu“ neuen Eintrag anlegen, Feldinhalte ergänzen, mit „Speichern“ abspeichern)

 

Hinweis für die Feldbelegung Verpackung_FFDatei_ID: hierzu sollte man bei einer vergleichbaren, bereits enthaltenen Verpackung das relevante Kürzel aus der passenden, vorhandenen  Frachtführer-Zuordnung ermitteln und dann bei der neuen Verpackung auch anwenden.

 

Hinweis für die NeutralSpedition-Frachtführer: um sich den Aufwand zu ersparen, für jeden NeutralSpedition-Frachtführer einen gleichlautenden Zuordnungs-Eintrag anzulegen, kann man folgendermassen verfahren:

*Die Zuordnung zunächst für einen (beliebigen) der NeutralSpedition-Frachtführer anlegen.
*Dann über den Knopf „Hinzufügen, falls fehlend“ die Verpackungsart automatisch für alle anderen NeutralSpedition-Frachtführer zuordnen

DPD Georouting

2022-09-07T10:34:55Z

Mnh:

[[en:EN_DPD Georouting]]
For english version please click [[EN DPD Georouting|'''here''']]

'''Letzte Aktualisierung:''' 07.09.2022

Seit Anfang 2022 informiert der DPD seine Kunden über eine geplante umfangreiche Umstellung des DPD Routingverfahrens (sog. "Georouting") zum Jahreswechsel 2022/2023. Die Umstellung muss bis Ende 2022 erfolgen, da ab 2023 kein DPD Versand mit dem alten/bisherigen Routingverfahren erlaubt/möglich ist.

Die Umstellung kann jederzeit vorgenommen werden (nicht erst zum 01.01.2023)!

DPD hat dazu eine [https://www.dpd.com/de/de/support/it-anbindung-und-dpd-schnittstellen/georouting-transformation-gr-gl/ Seite mit Informationen] zu den Hintergründen dieser Umstellung veröffentlicht. 

'''Was bedeutet diese Umstellung für HVS32 Versandsystem Benutzer?''' Wenn Sie momentan mit dem DPD Versandmodul Pakete über das HVS32 versenden, ändert sich der bisherig bekannte Prozess des Routenupdates. Bisher müssen Sie alle 3 Monate eine Routendatei von DPD herunterladen und in das HVS32 importieren. Beim Labeldruck wird dadurch die sog. "Route" anhand der Empfänger-PLZ aus dem lokalen Routenbestand (offline) ermittelt und angedruckt.

Das HVS32 wurde final am 07.09.2022 DPD mit dem GOLD Status zertifiziert und erfüllt ab Programmversion 7.112.1 somit die neuen Anforderungen. Nach einem entsprechenden Programmupdate und dem notwendigen Routen-Umstellungsprozess kann das HVS32 somit weiterhin für den DPD Labeldruck verwenden. Zudem besteht zukünftig aber auch die Option das Routing nicht mehr lokal sondern mit entsprechendem HVS32 Plugin über den DPD Webservice (API) abzuwickeln, wodurch dann die bekannten Routenupdates entfallen würden.

Auf dieser Seite möchten wir Ihnen detailliert beschreiben, was sich bei dieser DPD Georouting Umstellung alles ändert, bzw. ändern könnte. 
==Änderungen im Ablauf und Optionen==

Bisher findet das DPD Routenupdate alle 4 Monate zum entsprechenden Stichtag statt. Mit der Umstellung auf das neue Georouting ist es erforderlich täglich zu prüfen ob neue Routen bereitstehen und diese bei Bedarf zu importieren, zudem wird es zukünftig keine separaten, Depotbezogenen Routen-Files mehr geben, sondern ein globales Routen-File. Dieses neue File hat ca. doppelt so viele Routen-Einträge wie bisher und wird den Importprozess entsprechend verlängern oder verkürzen.

Derzeit ist vom DPD ein regelmäßiges Routen-Updateintervall alle 2 Monate vorgesehen, DPD behält sich jedoch vor, jederzeit auch zwischen einem Update-Intervall außerplanmäßige Updates bereitzustellen, wann immer es erforderlich sein sollte.

HVS32 druckt die Labels generell laut geladenem Routenstand, es könnte bei Verwendung veralteter Routen zu Verzögerungen in der Auslieferung kommen bzw. auch zu Nachbelastungen durch den DPD, genaueres dazu ist vom DPD aber derzeit nicht zu solchen Fällen angegeben.

Der Prozess des [https://heidler-strichcode.de/help?question=97511&title=warum-wird-relabel-auf-das-dpd-label-gedruckt '''RELABELS'''] wird entfallen, zusätzlich wird die Verwendung von individuell angepassten Labellayouts nicht mehr erlaubt sein.

Unter folgendem Link können Sie sich für unseren Newsletter anmelden, dort werden wir auch regelmäßig neue Informationen zur Verfügung stellen:

[https://heidler-strichcode.de/kontakt/#newsletter '''Newsletter Anmeldung''']

Um die neuen Anforderungen in Ihrem HVS32 Versandsystem einzuhalten stehen Ihnen je nach Konfiguration Ihres HVS32 Systems folgende Optionen zur Verfügung:

===Option A: manueller Trigger/Anstoss im HVS32 für das Routenupdate===

Hierbei wird es die Möglichkeit geben über eine beliebige HVS32 Station manuell zu prüfen, ob es aktuelle Routen gibt. Fällt die Prüfung positiv aus beginnt der Routenimport. Während dieser Zeit ist diese Versandstation dann vom Routenimport-Prozess belegt, aber es kann währenddessen von anderen HVS32 Stationen weiterhin mit DPD verarbeitet werden. Für einen schnellstmöglichen Routenimport empfehlen wir bei dieser Option den Prozess von einer Station direkt auf dem HVS32 Server zu starten.

===Option B: eine HVS32 Station prüft bei jedem Neustart ob es aktuelle Routen gibt===

Bei jedem Neustart der Versandstation wird geprüft ob es neue DPD Routen gibt und importiert diese wenn nötig. Während dieser Zeit ist diese Versandstation vom DPD Routenimport-Prozess belegt, aber es kann währenddessen von anderen HVS32 Stationen weiterhin mit DPD verarbeitet werden. Für einen schnellstmöglichen Routenimport empfehlen wir bei dieser Option den Prozess von einer Station direkt auf dem HVS32 Server zu starten.

===Option C: Automatische Prüfung & Import durch "HVS32 Monitoring Event" Dienst (zusätzlicher Hintergrunddienst) ===

Eine zusätzliche [[HVS32-Monitoring]] Instanz/Dienst übernimmt hierbei automatisch die Prüfung auf neue Routenupdates und den Routen-Import zu definierten Zeiten.

Je nach aktuellem Lizenzumfang, entstehen hierbei ggf. Kosten für Lizenzen und Konfigurationsaufwände.

===Option D: Anbindung des HVS32 an DPD Webservice ===

Umstellung der aktuell genutzten HVS32 "offline" DPD Routenermittlung (beschrieben im Intro dieses Wiki Artikels) & Labeldrucks auf die Anbindung via DPD Webservice (API). Dies ersetzt die Notwendigkeit der lokalen Routenupdates komplett.

Dadurch würde der Prozess des Routenupdates wie in Option A-C komplett entfallen, da bei Verwendung des DPD Webservices das Label und alle nötigen Informationen vom DPD Webservice abgerufen werden (wie es heutzutage bereits z.B. GLS, TNT, DHL Express etc voraussetzen). Zusätzlich entfällt dabei dann auch die Tagesabschluss EDI Übertragung via SFTP, da dies auch über den Webservice abgewickelt wird.

Folgende '''Einschränkungen''' gibt es bei der Verwendung des DPD Webservice gemäß Aussage/Spezifikation von DPD:

* maximal 60 Sendungen / Anfragen pro Minute
* maximal 10.000 Sendungen pro Tag
* keine individuellen Labellayouts mehr möglich (identisch zur neuen offline Routing Variante)

Bei der Umstellung auf den DPD Webservice entstehen zusätzliche Lizenz und Konfigurationsaufwände.

Sofern Sie die Umstellung vornehmen wollen, müssen Sie im ersten Schritt unter der Nennung Ihrer DPD Kundennummer eine Mail an [mailto:cit@dpd.de cit@dpd.de] senden zur Beantragung eines DPD Webservice-Accounts.

Das HVS32 DPD Webservice Modul ist ab Anfang Oktober verfügbar.

Weitere Informationen können Sie über uns unter support [at] heidler-strichcode.de erfragen.

===Änderungen auf den DPD Labels / individuelle Labels===

Die neuen DPD Vorgaben umfassen auch ein neues Labellayout, welches Sie auf dem Bild rechts sehen.
[[Datei:MicrosoftTeams-image.png|alternativtext=|mini]]
Sollten Sie derzeit individuell angepasste Labels einsetzen, werden diese mit dem Update auf den neuen DPD Standard deaktiviert. Eine automatische Übernahme der individuellen Anpassungen auf das neue Labellayout ist nicht möglich.

Bedingt durch das neue DPD Georouting sind seitens DPD keine individuellen Labels / Anpassungen auf den Labellayouts, sowie der Andruck von Kunden-Absenderlogos erlaubt. Individuelle Anpassungen welche über oder unter dem Standardlayout (ca 100x150 mm) angebracht sind (zb bei Verwendung von größerem Labelmaterial) können weiterhin verwendet werden, hierzu ist dann die manuelle Übertragung dieser Parts auf das neue Labellayout durch unseren Support notwendig, in solchen Fällen bitte entsprechend den Support kontaktieren. Zusätzlich muss diese Individualität mit DPD abgestimmt werden.

==Grundlegende Voraussetzungen zur Umstellung==

Seit 07.09.2022 ist das HVS32 von DPD mit dem GOLD Status zertifiziert, wodurch das HVS32 von DPD eine "Generalabnahme" für die neuen DPD Georouting Anforderungen erhalten hat.

So wird eine Grundvoraussetzung zur Umstellung auf das DPD Georouting ein [https://heidler-strichcode.de/help?question=97533&title=wie-wird-ein-hvs32-update-durchgefuehrt HVS32 Update] auf die HVS32 Version 7.112.1 (oder neuer). Diese aktuelle Version erhalten Sie wie gewohnt bei unserem Support unter support [at] heidler-strichcode.de.

Wollen Sie weiterhin die DPD "offline" Routenermittlung einsetzen, ist zusätzlich der [[HVS32 Communication Manager|Heidler Commanager]] nötig (mind. Version 1.2.5), welcher als zentraler Dienst die Datenübertragungen an die Carrier handelt. Der Commanager wird bei diesem DPD Routenänderungen dann auch dazu verwendet, um die Routen herunterzuladen und zu prüfen.

Sollten Sie bei DPD die Tagesabschluss (EDI / MPSEXPDATA) Dateien noch über das unsichere FTP Protokoll versenden, müssen Sie diesen Übertragungsweg laut DPD Vorgabe auf SFTP umstellen. Hierfür kontaktieren Sie dazu den DPD unter [mailto:cit@dpd.de cit@dpd.de]. Die Übertragung via SFTP wird dann auch durch den Commanager durchgeführt.

Möchten Sie auf den '''DPD Webservice (Option D)''' umsteigen, entfallen die Punkte bzgl. Commanager und der SFTP Übertragung.

==Benötigte Daten==

Zugangsdaten o.ä. werden für den DPD Routendownload nicht benötigt. Sie müssen sicherstellen, dass der ComManager entsprechend Ihrer Firewall Konstellation über eine Freigabe verfügt, um die DPD Routen-Files über die vom DPD veröffentlichten Download-Links (https) herunterzuladen.

Allgemeiner Link: https://esolutions.dpd.com/partnerloesungen/rdbdistributionservice.aspx

Versionsabhängiger Link: https://esolutions.dpd.com/partnerloesungen/rdbdistributionservice.aspx?version=22070402

Sollten Sie noch FTP zum Upload der EDI Dateien verwenden, müssen Sie einen SFTP Upload Account bei DPD beantragen.

Sollten Sie auf den Webservice umstellen wollen, müssen Sie einen Webservice/API Account bei DPD beantragen.

== Möglicher Ablauf einer Umstellung ==

# HVS32 Update auf Version 7.112.1 (oder neuer)
# ComManager Update auf Version 1.2.5 oder neuer
# Umstellung des EDI Uploads von FTP auf SFTP (sofern notwendig)
# Konfiguration des gesamten neuen Routingverfahrens durch Heidler Support
# Lizenzierung und Konfiguration der ggf. zusätzlichen Komponenten (bei Entscheidung für Option C, D)
# Information an DPD durch Kunde/Versender, dass die Umstellung erfolgt ist.
# GoLive mit neuem DPD Georouting Setup

Unser Support unterstützt Sie in allen Punkten der Umstellung.

==Finale Umstellung / Zertifizierung / Abnahme==

Aufgrund der erwähnten allgemeine Zertifizierung des HVS32 durch DPD ist keine gesonderte bzw. erneute Label Abnahme nach der Umstellung notwendig.

Um nach der Umstellung mit dem neuen DPD Georouting Setup produktiv zu versenden, ist es ausreichend vor Produktivsetzung eine Email an [mailto:cit@dpd.de cit@dpd.de] zu senden.

Hierbei geben Sie Ihrer DPD KundenNr an und die Info, dass Sie ab sofort das neue Georouting einsetzen.

== Deadline Ende 2022 ==
Die Umstellung muss bis Ende 2022 erfolgen, da ab 2023 kein DPD Versand mit dem alten/bisherigen Routingverfahren erlaubt/möglich ist.

Die Umstellung kann jederzeit vorgenommen werden (nicht erst zum 01.01.2023), planen Sie frühzeitig die Updates & Umstellung ein.