HVS32 JDBC Schnittstelle (Automatik-Polling): Unterschied zwischen den Versionen
| Zeile 1: | Zeile 1: | ||
| − | Unsere ODBC-Schnittstelle finden Sie | + | Unsere ODBC-Schnittstelle finden Sie unter: [[HVS32_ODBC_Schnittstelle_(Automatik-Polling)|ODBC-Schnittstelle]] |
<!-- ------------------------------------------------------------------------------- Voraussetzungen ------------------------------------------------------------------------------- --> | <!-- ------------------------------------------------------------------------------- Voraussetzungen ------------------------------------------------------------------------------- --> | ||
= Voraussetzungen = | = Voraussetzungen = | ||
| Zeile 13: | Zeile 13: | ||
<!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- --> | <!-- ------------------------------------------------------------------------------- Funktionsbeschreibung ------------------------------------------------------------------------------- --> | ||
= Funktionsbeschreibung = | = Funktionsbeschreibung = | ||
| + | Der DataGatewayServer (DGS) selektiert in einem konfigurierbaren Intervall (default 1000 ms) die zu verarbeitenden Datensätze aus der Polling Tabelle und übermittelt diese an den HVS32 Client zur Verarbeitung. Die Datensätze werden dabei anhand vom Steuerungsfeld '''[[#Steuerungs-Teil|HVS32Verarbeitet]]''' (Wert = 0) selektiert.<br> | ||
| + | Anhand vom Steuerungsfeld '''[[#Steuerungs-Teil|HVS32Funktion]]''' wird dem DGS mitgeteilt, welche Funktion für den selektierten Datensatz ausgeführt werden soll.<br> | ||
| + | Nachdem der Datensatz vom HVS32 bearbeitet wurde, erfolgt die Rückmeldung. Dabei wird der Wert [[#Steuerungs-Teil|HVS32Verarbeitet]] auf den Wert 1 gesetzt. Sollte im HVS32 ein Fehler bei der Verarbeitung aufgetreten sein, z.B. "Die Route konnte nicht ermittelt werden!", so wird das Feld '''[[#Steuerungs-Teil|HVS32Fehler]]''' mit dem Wert 1 und der Fehlertext in [[#Steuerungs-Teil|HVS32Fehlertext1]] + [[#Steuerungs-Teil|HVS32Fehlertext2]] zurück gemeldet.<br> | ||
| + | |||
| + | Für die Anfrage (Request) und Rückmeldung (Response) können weitere "Subrequests / -responses" konfiguriert werden. Diese SQLs werden zusätzlich ausgeführt und die Daten mit dem Hauptrequest / -response angereichert. Für jede Request / Response und Subrequest / - response kann die SQL individuell angepasst, sowie eine unterschiedliche Datenbankquelle konfiguriert werden.<br> | ||
| + | |||
| + | Zusätzlich gibt es die Möglichkeit einen Failover zu konfigurieren, welcher ausgeführt wird, sobald der Request oder Response fehlschlagen sollte. Zum Beispiel wenn in der Request Steuerzeichen oder in der Rückmeldung ein falscher Datentyp (alphanumerische anstelle von numerischen Werten) übermittelt wird. Des Weiteren kann der Failover genutzt werden, wenn keine HVS32 Clients am DGS verbunden sind. Damit soll verhindert werden, das fehlerhafte Datensätze immer wieder selektiert werden und somit erneut auf Fehler laufen. | ||
| + | <br><br> | ||
| + | Artikel- und Gefahrgutdaten sollten jeweils in einer eigenen Tabelle realisiert werden. | ||
<!-- ------------------------------------------------------------------------------- ENDE Funktionsbeschreibung ------------------------------------------------------------------------------- --> | <!-- ------------------------------------------------------------------------------- ENDE Funktionsbeschreibung ------------------------------------------------------------------------------- --> | ||
<!-- ------------------------------------------------------------------------------- Steuerungs-Teil ------------------------------------------------------------------------------- --> | <!-- ------------------------------------------------------------------------------- Steuerungs-Teil ------------------------------------------------------------------------------- --> | ||
| Zeile 37: | Zeile 46: | ||
| HVS32Fehler || [[#Datentypen|Integer]] || - || - || Wenn der Datensatz im HVS32 verarbeitet worden ist und ein Fehler auftrat, wird dieser Wert auf 1 gesetzt. | | HVS32Fehler || [[#Datentypen|Integer]] || - || - || Wenn der Datensatz im HVS32 verarbeitet worden ist und ein Fehler auftrat, wird dieser Wert auf 1 gesetzt. | ||
|- | |- | ||
| − | | HVS32Fehlertext1 || [[#Datentypen| | + | | HVS32Fehlertext1 || [[#Datentypen|String]] || 200 || - || Fehlertext im Fehlerfall |
|- | |- | ||
| − | | HVS32Fehlertext2 || [[#Datentypen| | + | | HVS32Fehlertext2 || [[#Datentypen|String]] || 200 || - || Fehlertext im Fehlerfall |
|} | |} | ||
<!-- ------------------------------------------------------------------------------- ENDE Steuerungs-Teil ------------------------------------------------------------------------------- --> | <!-- ------------------------------------------------------------------------------- ENDE Steuerungs-Teil ------------------------------------------------------------------------------- --> | ||
| − | + | <!-- ------------------------------------------------------------------------------- Verfügbare Funktionen ------------------------------------------------------------------------------- --> | |
= Verfügbare HVS32 Funktionen = | = Verfügbare HVS32 Funktionen = | ||
| + | <!-- ------------------------------------------------------------------------------- VersandDatenAnfrage ------------------------------------------------------------------------------- --> | ||
=== Packstück-Verarbeitung (VersandDatenAnfrage) === | === Packstück-Verarbeitung (VersandDatenAnfrage) === | ||
Die Gatewayfunktion VersandDatenAnfrage wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück zu erzeugen und verbuchen. Ein Etikett wird für alle weiteren Funktionen 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. | 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. | ||
<br><br> | <br><br> | ||
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck-Verarbeitung_.28VersandDatenAnfrage.29|Schnittstellen-Feld-Beschreibung]] | [[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck-Verarbeitung_.28VersandDatenAnfrage.29|Schnittstellen-Feld-Beschreibung]] | ||
| − | + | <!-- ------------------------------------------------------------------------------- ENDE VersandDatenAnfrage ------------------------------------------------------------------------------- --> | |
| + | <!-- ------------------------------------------------------------------------------- VerladeDatenAnfrage ------------------------------------------------------------------------------- --> | ||
=== Packstück verladen/freigeben (VerladeVersandDaten) === | === 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. | 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. | ||
<br><br> | <br><br> | ||
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck_verladen.2Ffreigeben_.28VerladeVersandDaten.29|Schnittstellen-Feld-Beschreibung]] | [[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck_verladen.2Ffreigeben_.28VerladeVersandDaten.29|Schnittstellen-Feld-Beschreibung]] | ||
| − | + | <!-- ------------------------------------------------------------------------------- ENDE VerladeVersandDaten ------------------------------------------------------------------------------- --> | |
| + | <!-- ------------------------------------------------------------------------------- UpdateVersandDaten ------------------------------------------------------------------------------- --> | ||
=== Packstückdaten aktualisieren (UpdateVersandDaten) === | === 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. | 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. | ||
<br><br> | <br><br> | ||
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_aktualisieren_.28UpdateVersandDaten.29|Schnittstellen-Feld-Beschreibung]] | [[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_aktualisieren_.28UpdateVersandDaten.29|Schnittstellen-Feld-Beschreibung]] | ||
| − | + | <!-- ------------------------------------------------------------------------------- ENDE UpdateVersandDaten ------------------------------------------------------------------------------- --> | |
| + | <!-- ------------------------------------------------------------------------------- StornoVersandDaten ------------------------------------------------------------------------------- --> | ||
=== Packstück stornieren (StornoVersandDaten) === | === Packstück stornieren (StornoVersandDaten) === | ||
Die Gatewayfunktion StornoVersandDaten wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort bestehende Packstücke zu stornieren, die noch nicht auf einer Ausgangsliste sind. In der Regel wird ein Packstück anhand der hostseitigen Packstück-ID storniert. Diese wird im Feld PackstueckID übergeben. Zusätzlich zur hostseitigen Packstück-ID kann auch die TrackingNr zur Identifikation des Packstücks beitragen, für den Fall, dass die hostseitige Packstück-ID keine Eindeutigkeit garantieren kann. | 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. | ||
<br><br> | <br><br> | ||
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck_stornieren_.28StornoVersandDaten.29|Schnittstellen-Feld-Beschreibung]] | [[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCck_stornieren_.28StornoVersandDaten.29|Schnittstellen-Feld-Beschreibung]] | ||
| − | + | <!-- ------------------------------------------------------------------------------- ENDE StornoVersandDaten ------------------------------------------------------------------------------- --> | |
| + | <!-- ------------------------------------------------------------------------------- VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --> | ||
=== Packstückdaten prüfen (VersandDatenPruefAnfrage) === | === 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. | Das Gateway sendet die VersandDatenPruefAnfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine VersandDatenAnfrage simuliert. Dabei werden keine Etiketten gedruckt und das Packstück bzw. das Etikett wird nicht verbucht, jedoch sind alle weiteren Prozesse identisch zur VersandDatenAnfrage (Routenermittlung, Trackingnummer-Ermittlung, Adressprüfung, etc.) Diese Funktion dient dazu im Vorfeld alle Versand-Daten zu validieren. | ||
<br><br> | <br><br> | ||
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_pr.C3.BCfen_.28VersandDatenPruefAnfrage.29|Schnittstellen-Feld-Beschreibung]] | [[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_pr.C3.BCfen_.28VersandDatenPruefAnfrage.29|Schnittstellen-Feld-Beschreibung]] | ||
| − | + | <!-- ------------------------------------------------------------------------------- ENDE VersandDatenPruefAnfrage ------------------------------------------------------------------------------- --> | |
| + | <!-- ------------------------------------------------------------------------------- AnonymisiereVersandDaten ------------------------------------------------------------------------------- --> | ||
=== Packstückdaten anonymisieren (AnonymisiereVersandDaten) === | === Packstückdaten anonymisieren (AnonymisiereVersandDaten) === | ||
Das Gateway sendet die AnonymisiereVersandDaten an das Automatik-Polling des HVS32. Im HVS32 werden somit Kunden bezogene Daten für den entsprechenden Datensatz gemäß DSGVO anonymisiert. Diese Anonymisierung wird unwiderruflich und endgültig auf der Datenbankebene des Versandsystems durchgeführt. Eine Wiederherstellung der ursprünglichen Daten ist somit nicht mehr möglich. Log-Dateien, Rückmelde-Dateien, bereits übertragene Frachtführer DFÜs etc. sind hiervon nicht betroffen. Es können ausschließlich Packstücke und Sendungen anonymisiert werden, welche bereits Tages abgeschlossen sind. | Das Gateway sendet die AnonymisiereVersandDaten an das Automatik-Polling des HVS32. Im HVS32 werden somit Kunden bezogene Daten für den entsprechenden Datensatz gemäß DSGVO anonymisiert. Diese Anonymisierung wird unwiderruflich und endgültig auf der Datenbankebene des Versandsystems durchgeführt. Eine Wiederherstellung der ursprünglichen Daten ist somit nicht mehr möglich. Log-Dateien, Rückmelde-Dateien, bereits übertragene Frachtführer DFÜs etc. sind hiervon nicht betroffen. Es können ausschließlich Packstücke und Sendungen anonymisiert werden, welche bereits Tages abgeschlossen sind. | ||
<br><br> | <br><br> | ||
[[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_anonymisieren_.28AnonymisiereVersandDaten.29|Schnittstellen-Feld-Beschreibung]] | [[HVS32_Automatik-Polling_Funktionen#Packst.C3.BCckdaten_anonymisieren_.28AnonymisiereVersandDaten.29|Schnittstellen-Feld-Beschreibung]] | ||
| − | + | <!-- ------------------------------------------------------------------------------- ENDE AnonymisiereVersandDaten ------------------------------------------------------------------------------- --> | |
| + | <!-- ------------------------------------------------------------------------------- Tagesabschluss ------------------------------------------------------------------------------- --> | ||
=== Tagesabschluss (Tagesabschluss) === | === 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 [[HVS32_Automatik-Polling_Funktionen#Ausgangsliste_erzeugen_.28Listenabschluss.29|Ausgangsliste erzeugen]] und [[HVS32_Automatik-Polling_Funktionen#Frachtf.C3.BChrer_DF.C3.9C_erzeugen_.28EDIAbschluss.29|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. | 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 [[HVS32_Automatik-Polling_Funktionen#Ausgangsliste_erzeugen_.28Listenabschluss.29|Ausgangsliste erzeugen]] und [[HVS32_Automatik-Polling_Funktionen#Frachtf.C3.BChrer_DF.C3.9C_erzeugen_.28EDIAbschluss.29|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. | ||
<br><br> | <br><br> | ||
[[HVS32_Automatik-Polling_Funktionen#Tagesabschluss_.28Tagesabschluss.29|Schnittstellen-Feld-Beschreibung]] | [[HVS32_Automatik-Polling_Funktionen#Tagesabschluss_.28Tagesabschluss.29|Schnittstellen-Feld-Beschreibung]] | ||
| − | + | <!-- ------------------------------------------------------------------------------- ENDE Tagesabschluss ------------------------------------------------------------------------------- --> | |
| + | <!-- ------------------------------------------------------------------------------- ENDE Verfügbare Funktionen ------------------------------------------------------------------------------- --> | ||
| + | <!-- ------------------------------------------------------------------------------- Beispiele ------------------------------------------------------------------------------- --> | ||
= Beispiele = | = Beispiele = | ||
| − | + | <!-- ------------------------------------------------------------------------------- ENDE Beispiele ------------------------------------------------------------------------------- --> | |
| + | <div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;"> | ||
| + | <div style="font-weight:bold;line-height:1.6;">'''Scripte'''</div> | ||
| + | <div class="mw-collapsible-content"> | ||
| + | <!-- ------------- SCRIPTE ----------------- --> | ||
| + | </div></div> | ||
| + | <!-- ------------------------------------------------------------------------------- FAQ / Troubleshooting ------------------------------------------------------------------------------- --> | ||
= FAQ / Troubleshooting = | = FAQ / Troubleshooting = | ||
| + | <!-- ------------------------------------------------------------------------------- ENDE FAQ / Troubleshooting ------------------------------------------------------------------------------- --> | ||
Version vom 28. April 2020, 13:25 Uhr
Unsere ODBC-Schnittstelle finden Sie unter: 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
Der DataGatewayServer (DGS) selektiert in einem konfigurierbaren Intervall (default 1000 ms) die zu verarbeitenden Datensätze aus der Polling Tabelle und übermittelt diese an den HVS32 Client zur Verarbeitung. Die Datensätze werden dabei anhand vom Steuerungsfeld HVS32Verarbeitet (Wert = 0) selektiert.
Anhand vom Steuerungsfeld HVS32Funktion wird dem DGS mitgeteilt, welche Funktion für den selektierten Datensatz ausgeführt werden soll.
Nachdem der Datensatz vom HVS32 bearbeitet wurde, erfolgt die Rückmeldung. Dabei wird der Wert HVS32Verarbeitet auf den Wert 1 gesetzt. Sollte im HVS32 ein Fehler bei der Verarbeitung aufgetreten sein, z.B. "Die Route konnte nicht ermittelt werden!", so wird das Feld HVS32Fehler mit dem Wert 1 und der Fehlertext in HVS32Fehlertext1 + HVS32Fehlertext2 zurück gemeldet.
Für die Anfrage (Request) und Rückmeldung (Response) können weitere "Subrequests / -responses" konfiguriert werden. Diese SQLs werden zusätzlich ausgeführt und die Daten mit dem Hauptrequest / -response angereichert. Für jede Request / Response und Subrequest / - response kann die SQL individuell angepasst, sowie eine unterschiedliche Datenbankquelle konfiguriert werden.
Zusätzlich gibt es die Möglichkeit einen Failover zu konfigurieren, welcher ausgeführt wird, sobald der Request oder Response fehlschlagen sollte. Zum Beispiel wenn in der Request Steuerzeichen oder in der Rückmeldung ein falscher Datentyp (alphanumerische anstelle von numerischen Werten) übermittelt wird. Des Weiteren kann der Failover genutzt werden, wenn keine HVS32 Clients am DGS verbunden sind. Damit soll verhindert werden, das fehlerhafte Datensätze immer wieder selektiert werden und somit erneut auf Fehler laufen.
Artikel- und Gefahrgutdaten sollten jeweils in einer eigenen Tabelle realisiert werden.
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 | String | 200 | - | Fehlertext im Fehlerfall |
| HVS32Fehlertext2 | String | 200 | - | 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