HVS32 Automatik-Polling Funktionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen

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 wir Storno, Verladefreigabe, etc. anhand der hostseitigen Packstück-ID identifiziert. Diese wird im Feld PackstueckID übergeben und muss dementsprechend innerhalb des Versandsystems eindeutig sein.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKSTUECKID String 20 - Eindeutige Nummer für das Paket im Vorsystem.
PACKPLATZ String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -

Etikett nachdrucken (VersandDatenWdhDruck)

Die Gatewayfunktion VersandDatenWdhDruck wird vom Data-Gateway-Server im Automatik-Polling Modus an das HVS32 gesendet, um dort ein Etikett für ein Packstück nachzudrucken. Ein Etikett wird anhand der hostseitigen Packstück-ID nachgedruckt. Diese wird im Feld PackstueckID übergeben. Bei manchen Frachtführern (z.B. DPD) werden beim Nachdruck neue Trackingnummern vergeben. Somit ist die alte Trackingnummer nicht mehr gültig und das alte Versandetikett muss vernichtet werden. Die neue Trackingnummer kann in der Rückmeldung zurückgemeldet werden.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKSTUECKID String 20 - Eindeutige Nummer für das Paket im Vorsystem.
PACKPLATZ String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
DRUCKERNAME String 30 - Ausgabekanal, an welchem das Etikett nachgedruckt werden soll (benötigt HVS32 Erweiterungsmodul "Druckerspooler")

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -
TRACKINGNR String 35 - (neue) TrackingNr des Packstücks

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. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Storno wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKSTUECKID String 20 - Eindeutige Nummer für das Paket im Vorsystem.
PACKPLATZ String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -

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. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreicher Freigabe wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKSTUECKID String 20 - Eindeutige Nummer für das Paket im Vorsystem.
PACKPLATZ String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.
SPERRKENNZEICHEN String 1 - "J" wenn das Packstück gesperrt werden soll
WECHSELBRUECKE String 20 - Wechselbrücke auf welche das Packstück gebucht werden soll
SAMMELFREIGABE String 1 - "T" bei einer Sammel-Freigabe (Alle Packstücke mit identischer VE-ReferenzNr freigeben)
VEREFERENZNR String 20 - muss bei einer Sammel-Freigabe gefüllt sein

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -

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. Nach erfolgreichem Tagesabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKPLATZ String 10 - HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.
FRACHTFUEHRERTYPLIST String 250 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. (Option MultiFFTagesabschluss muss aktiv sein)
AUFTRAGGEBERIDLIST String 250 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. (Option MultiAGTagesabschluss muss aktiv sein)
VERSANDARTIDLIST String 250 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. (Option MultiVATagesabschluss muss aktiv sein)
WECHSELBRUECKE String 20 - Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
DRUCKERNAME String 30 - Name des Ausgabekanals auf welchem die Liste gedruckt werden soll

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -

Ausgangsliste erzeugen (Listenabschluss)

Das Gateway sendet die Listenabschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Ausgangsliste anhand der zusätzlich übergebenen Parameter erzeugt. Nur Packstücke, welche für den Ausgang freigegeben wurden, werden für den Listenabschluss 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 Erzeugen der Ausgangsliste statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Listenabschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKPLATZ String 10 - HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.
FRACHTFUEHRERTYPLIST String 250 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. (Option MultiFFTagesabschluss muss aktiv sein)
AUFTRAGGEBERIDLIST String 250 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. (Option MultiAGTagesabschluss muss aktiv sein)
VERSANDARTIDLIST String 250 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. (Option MultiVATagesabschluss muss aktiv sein)
WECHSELBRUECKE String 20 - Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.
DRUCKERNAME String 30 - Name des Ausgabekanals auf welchem die Liste gedruckt werden soll

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -

Frachtführer DFÜ erzeugen (EDIAbschluss)

Das Gateway sendet die EDIAbschluss-Anfrage an das Automatik-Polling des HVS32. Im HVS32 wird somit eine Frachtführer DFÜ anhand der zusätzlich übergebenen Parameter erzeugt und (falls konfiguriert) an den Frachtführer übertragen. Nur Packstücke, für welche zuvor eine Ausgangsliste erzeugt wurde, werden für eine Frachtführer DFÜ berücksichtigt. Die Rückmeldung im HVS32 findet nach dem Erzeugen der Frachtführer DFÜ statt. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem EDIAbschluss wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKPLATZ String 10 - HVS32-Packplatz-Client, der den Tagesabschluss ausführen soll.
FRACHTFUEHRERTYPLIST String 250 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Frachführern mitgegeben werden. (Option MultiFFTagesabschluss muss aktiv sein)
AUFTRAGGEBERIDLIST String 250 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Auftraggebern mitgegeben werden. (Option MultiAGTagesabschluss muss aktiv sein)
VERSANDARTIDLIST String 250 - Hier kann eine Semikolon separierte Liste mit den abzuschließenden Versandarten mitgegeben werden. (Option MultiVATagesabschluss muss aktiv sein)
WECHSELBRUECKE String 20 - Kennzeichen der abzuschließenden Wechselbrücke. Hiermit können nur bestimmte Sendungen abgeschlossen werden.

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -

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.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKSTUECKID String 20 - Eindeutige Nummer für das Paket im Vorsystem.
PACKPLATZ String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -

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. Aktualisiert werden können Daten innerhalb der Tabellen Versandeinheit, Abrechnungseinheit und Lieferung. 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 Richtlininen 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. Es stehen keine Packstück-/Sendungs-Daten für die Rückmeldung zur Verfügung. Nach erfolgreichem Update wird lediglich das Feld Fehler mit Wert 0 zurückgemeldet - bzw. im Fehlerfall wird Fehler mit dem Wert 1 sowie der Fehlertext1 zurückgemeldet.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKSTUECKID String 20 - Eindeutige Nummer für das Paket im Vorsystem.
PACKPLATZ String 10 - HVS32-Packplatz-Client, der den Auftrag verarbeiten soll.

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -

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.

Übergabe Parameter

Fett dargestellte Felder müssen IMMER belegt sein

Feldname Typ Max Länge Nachkommastellen Belegung
PACKSTUECKID String 20 - PackstückID des Packstücks, welches anonymisiert werden soll.
TRACKINGNR String 35 - TrackingNr des Packstücks, welches anonymisiert werden soll.
LIEFERSCHEINNR String 40 - LieferscheinNr der Sendung, welche anonymisiert werden soll.
AUFTRAGSNR String 50 - AuftragsNr der Sendung, welche anonymisiert werden soll.
PACKPLATZ String 10 - HVS32-Packplatz-Client, der die Anonymisierung verarbeiten soll.

Rückgabe Parameter

Feldname Typ Max Länge Dezimalstellen Belegung
FEHLER Integer - - 0 = Erfolgreich, 1 = Fehler
FEHLERTEXT1 String 200 - -
FEHLERTEXT2 String 200 - -
Abgerufen von „https://wiki.heidler-strichcode.de/w/index.php?title=HVS32_Automatik-Polling_Funktionen&oldid=2655“