HVS32 JDBC Schnittstelle (Automatik-Polling)
Unsere ODBC-Schnittstelle finden Sie hier: ODBC-Schnittstelle
Voraussetzungen
DGS-Version | 3.6.0.XXX oder höher |
DGS-Plugins | HVS32Client, JDBC Server |
JDBC Treiber | neuste Version der JDBC Treiber für die eingesetzte Datenbank |
Funktionsbeschreibung
Steuerungs-Teil
Anhand vom Steuerungs-Teil wird definiert, welche Aktion mit dem Datensatz aus der Datenbank durchgeführt werden soll.
Feldname | Typ | Max Länge | Dezimalstellen | Belegung |
---|---|---|---|---|
ID | Integer | - | - | Eindeutige Nummer zur Identifizierung des Datensatzes (Autocounter). |
HVS32Funktion | Integer | - | - | Die Funktionsnummer, die im HVS32 für den Datensatz ausgeführt werden soll. 1 = VersandDatenAnfrage |
HVS32Verarbeitet | Integer | - | - | Wird nach der Verarbeitung im HVS32 auf 1 gesetzt. Datensätze werden anhand dieses Feldes selektiert. |
HVS32Fehler | Integer | - | - | Wenn der Datensatz im HVS32 verarbeitet worden ist und ein Fehler auftrat, wird dieser Wert auf 1 gesetzt. |
HVS32Fehlertext1 | Integer | - | - | Fehlertext im Fehlerfall |
HVS32Fehlertext2 | Integer | - | - | Fehlertext im Fehlerfall |
Verfügbare HVS32 Funktionen
Packstück-Verarbeitung (VersandDatenAnfrage)
Die Gatewayfunktion VersandDatenAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück zu erzeugen und verbuchen. Ein Etikett wird für alle weiteren Funktionen wie Storno, Verladefreigabe, etc. anhand der hostseitigen Packstück-ID identifiziert. Diese wird im Feld PackstueckID übergeben und muss dementsprechend innerhalb des Versandsystems eindeutig sein.
Schnittstellen-Feld-Beschreibung
Packstück verladen/freigeben (VerladeVersandDaten)
Die Gatewayfunktion VerladeVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort Packstücke für den Ausgang frei zu geben. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt.
Schnittstellen-Feld-Beschreibung
Packstückdaten aktualisieren (UpdateVersandDaten)
Die Gatewayfunktion UpdateVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort die Daten von bestehende Packstücken zu verändern. Diese Anfrage wird zum Beispiel gesendet, wenn der Warenwert für ein Packstück erst zu einem späteren Zeitpunkt bekannt ist. Dabei wird stets über das Feld PackstueckID und bei Belegung auch über das Feld TrackingNr gesucht. Bei dieser Anfrage werden allerdings die zu aktualisierenden Felder und Inhalte nicht mehr nach den Richtlinien des Frachtführers geprüft (z.B. Gewichtsgrenzen, etc.). Es muss somit vom Vorsystem sichergestellt werden, dass die aktualisierenden Werte mit den Richtlinien des Frachtführers übereinstimmen. Sollte dies nicht möglich sein, kann diese Funktion nicht genutzt werden, sondern das Etikett muss storniert und neu verarbeitet werden. Außerdem können Felder, welche bereits auf einem Etikett angedruckt oder vom Versandsystem HVS32 in einer Frachtführerabwicklung ermittelt wurden (z.B. Adresse, Route, TrackingNr, Sonderdienste, etc.) nicht manipuliert werden.
Schnittstellen-Feld-Beschreibung
Packstück stornieren (StornoVersandDaten)
Die Gatewayfunktion StornoVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort bestehende Packstücke zu stornieren, die noch nicht auf einer Ausgangsliste sind. In der Regel wird ein Packstück anhand der hostseitigen Packstück-ID storniert. Diese wird im Feld PackstueckID übergeben. Zusätzlich zur hostseitigen Packstück-ID kann auch die TrackingNr zur Identifikation des Packstücks beitragen, für den Fall, dass die hostseitige Packstück-ID keine Eindeutigkeit garantieren kann.
Schnittstellen-Feld-Beschreibung
Packstückdaten prüfen (VersandDatenPruefAnfrage)
Das Gateway sendet die VersandDatenPruefAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine VersandDatenAnfrage simuliert. Dabei werden keine Etiketten gedruckt und das Packstück bzw. das Etikett wird nicht verbucht, jedoch sind alle weiteren Prozesse identisch zur VersandDatenAnfrage (Routenermittlung, Trackingnummer-Ermittlung, Adressprüfung, etc.) Diese Funktion dient dazu im Vorfeld alle Versand-Daten zu validieren.
Schnittstellen-Feld-Beschreibung
Packstückdaten anonymisieren (AnonymisiereVersandDaten)
Das Gateway sendet die AnonymisiereVersandDaten an das Automatik-Polling des HVS32. Im HVS32 werden somit Kunden bezogene Daten für den entsprechenden Datensatz gemäß DSGVO anonymisiert. Diese Anonymisierung wird unwiderruflich und endgültig auf der Datenbankebene des Versandsystems durchgeführt. Eine Wiederherstellung der ursprünglichen Daten ist somit nicht mehr möglich. Log-Dateien, Rückmelde-Dateien, bereits übertragene Frachtführer DFÜs etc. sind hiervon nicht betroffen. Es können ausschließlich Packstücke und Sendungen anonymisiert werden, welche bereits Tages abgeschlossen sind.
Schnittstellen-Feld-Beschreibung
Tagesabschluss (Tagesabschluss)
Das Gateway sendet die Tagesabschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit ein Tagesabschluss anhand der zusätzlich übergebenen Parameter ausgelöst. Der Tagesabschluss setzt sich aus den Punkten Ausgangsliste erzeugen und Frachtführer DFÜ erzeugen zusammen. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Tagesabschluss berücksichtigt. Standardmäßig sind alle Packstücke freigegeben, außer sie wurden durch das Erweiterungsmodul Ausgangsscannung gesperrt. Die Rückmeldung im HVS32 findet nach dem Ausführen des Tagesabschluss statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung.
Schnittstellen-Feld-Beschreibung