HVS32 ODBC Schnittstelle (Automatik-Polling)

From Wiki - Heidler Strichcode GmbH
Jump to navigation Jump to search

Bitte beachten Sie, dass der DataGatewayServer V2 nicht weiter entwickelt wird und somit auch die ODBC-Schnittstelle.
Unsere aktuelle JDBC-Schnittstelle finden Sie hier: JDBC Schnittstelle (Automatik-Polling)

DataGatewayServer Versionsstand: DGS-2.14.1.568.
Der Steuerungs-, Sendungs-, Packstück-, Rückmelde- und Zusatzteil kann in einer Tabelle realisiert werden.
Für die Artikeldaten und Gefahrgutdaten sollte jeweils eine eigene Tabelle in der Datenbank angelegt werden.

Datentypen

Integer - Zahl mit ausschließlich numerischen Zeichen (0-9).
Decimal - Zahl mit Nachkommastellen
Text - Beliebige Zeichen aus dem Zeichensatz ISO-8859-1. Maximale Länge darf nicht überschritten werden.

Datensatz

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). Wird für die DELETE- bzw. UPDATE-Anweisung benötigt.
StatusHost Integer - - Die Funktionsnummer, die im HVS32 für den Datensatz ausgeführt werden soll.

1 = Etikettendruck
2 = Verlademeldung
3 = Update vom Datensatz
4 = Storno

StatusHVS32 Integer - - Muss von "StatusHost" abweichen, damit der Datensatz verarbeitet wird. Sollte vom Vorsystem zu Beginn auf 0 gesetzt werden.

Nach erfolgreicher Verarbeitung wird hier der Wert aus "StatusHost" hinterlegt. Im Fehlerfall wird der Wert auf 9 (1000 bei älteren Installationen) gesetzt.

Sendungs-Teil

Sendungsbezogene Daten wie z.B. Auftraggeber oder Empfänger

Feldname Typ Max Länge Dezimalstellen Belegung
Ansprechpartner Text 20 - Empfänger Ansprechpartner
AuftragNr Text 20 - -
AuftraggeberID Text 10 - Mandantenkennung aus dem HVS32
AVISHinweis1 Text 100 - -
AVISHinweis2 Text 100 - -
AVISZusatz1 Text 20 - Zusatz zu Fest-AVIS-Schlüssel 1
AVISZusatz2 Text 20 - Zusatz zu Fest-AVIS-Schlüssel 2
BestellNr Text 20 - Metro-Bestellnr (Metro-Versand)
FaxNr Text 20 - Faxnummer des Empfängers
FrachtBrief Text 20 - Frachtbrief Nummer falls Frachtbrief durch Vorsystem gedruckt werden soll
FrachtfuehrerKDNr Text 10 - Kundennummer des Frachtzahlers beim Frachtführer
FrankaturKennung Text 10 - -
ILNNr Text 20 - ILN des Empfängers (Pflicht bei Metro-Versand)
KundenNr Text 20 - Kundennummer des Empfängers beim Versender
LieferscheinNr Text 40 - Wird im HVS32 als Such-Nummer verwendet
Nachnahme Decimal 18 2 -
NeutabsenderLKZ Text 3 - Nur bei Neutral-Absendern belegt
NeutabsenderName1 Text 50 - Nur bei Neutral-Absendern belegt
NeutabsenderName2 Text 50 - Nur bei Neutral-Absendern belegt
NeutabsenderName3 Text 50 - Nur bei Neutral-Absendern belegt
NeutabsenderOrt Text 50 - Nur bei Neutral-Absendern belegt
NeutabsenderPLZ Text 10 - Nur bei Neutral-Absendern belegt
NeutabsenderStrasse Text 50 - Nur bei Neutral-Absendern belegt
NNVermerk Text 1 - B': Bar / 'V': Verrechnungsscheck
NNVerwendung Text 30 - Nachnahme Verwendungszweck
NNWaehrung Text 3 - Nachnahme - ISO-Währungscode
PostLeitcode Text 15 - -
PostZielFrachtzent Text 5 - -
RechnungsEmpfLKZ Text 5 - Rechnungsadresse
RechnungsEmpfName1 Text 50 - Rechnungsempfänger
RechnungsEmpfName2 Text 50 - Rechnungsempfänger
RechnungsEmpfName3 Text 50 - Rechnungsempfänger
RechnungsEmpfOrt Text 50 - Rechnungsadresse
RechnungsEmpfPLZ Text 10 - Rechnungsadresse
RechnungsEmpfStr Text 50 - Rechnungsadresse
RechnungsNr Text 20 - Rechnungsnummer
SendungsInhalt Text 30 - -
Sonderdienste Text 30 - Versandart-spezifisch belegt
TelefonNr Text 20 - Telefonnummer des Empfängers
TerminArt Text 1 - 'A'b / 'B'is / 'F'ix
TerminDatum Text 10 - TT.MM.JJJJ
TerminZeit Text 5 - HH:MM
UstIDNr Text 20 - UmsatzsteuerNr des Empfängers
VersandartID Text 10 - Versandartkennung aus dem HVS32
Versicherungswert Decimal 18 2 Höhe Versicherungswert
VWWaehrung Text 3 - Versicherungswert - ISO-Währungscode
Warenwert Decimal 18 2 -
WWWaehrung Text 3 - Warenwert - ISO-Währungscode
Zahlungsbedinung Text 10 - 'S' = Sender, 'R' = Empfänger
ZBZoll Text 1 - Zahlungsbedingung für Zoll Steuern 'S' = Sender, 'R' = Empfänger
ZielAdrBahnhof Text 30 - PLZ und Ort
ZielAdrLKZ Text 5 - Lieferadresse
ZielAdrName1 Text 50 - Lieferadresse
ZielAdrName2 Text 50 - Lieferadresse
ZielAdrName3 Text 50 - Lieferadresse
ZielAdrOrt Text 50 - Lieferadresse
ZielAdrPLZ Text 10 - Lieferadresse
ZielAdrRegion Text 20 - Staat/Provinz (z.B.: für Sendungen in die USA wichtig)
ZielAdrStrasse Text 50 - Lieferadresse

Packstück-Teil

Packstück bezogene Daten, wie z.B. Gewicht, PackstückID oder Maße

Feldname Typ Max Länge Dezimalstellen Belegung
Gewicht Decimal 8 3 Bruttogewicht in KG
NettoGewicht Decimal 8 3 Nettogewicht in KG
PackStkGes Integer - - Gesamt-Anzahl Colli der Sendung
PackStkNr Integer - - Laufende Nummer pro Sendung
Packplatz Text 10 - HVS32-Packplatz-Client, der den Auftrag
PackstueckBreite Integer - - Breite in cm
PackstueckHoehe Integer - - Höhe in cm
PackstueckID Text 20 - Eindeutige Nummer für das Paket im Vorsystem. Wird als eindeutige Paketreferenz benötigt um das Etikett später zu stornieren oder zu Verladen.
PackstueckLaenge Integer - - Länge in cm
Verpackungsart Text 6 - -

Rückmelde-Teil

Nach Verarbeitung im HVS32 werden folgende Daten zurück gemeldet.

Feldname Typ Max Länge Dezimalstellen Belegung
AusgangDateTime TEXT 10 - Datum der Versendung(TT.MM.CCJJ)
AusgangslisteNr INTEGER - - Nummer der Ladeliste
DruckDateTime TEXT 10 - Datum der Abarbeitung (TT.MM.CCJJ)
Fehlertext1 TEXT 200 - Wird im Fehlerfall befüllt
Fehlertext2 Text 200 - Wird im Fehlerfall befüllt
Gebuehr DECIMAL 18 2 Frachtkosten
GebuehrWaehrung TEXT 3 - Frachtkosten ISO-Währungscode
TrackingNr Text 35 - Paketnummer
VersandSendungsNr TEXT 20 - Sendungsnummer

Zusatz-Teil

Feldname Typ Max Länge Dezimalstellen Belegung
AnzahlArtikel INTEGER 6 - Anzahl Artikel (Druck auf Etikett)
Druckername TEXT 30 - Name eines Ausgabekanals (Drucker) im HVS32 über den das Etikett gedrucktwird. (Benötigt Druckerspooler Erweiterungsmodul)
EmpfEmailadresse TEXT 100 - f. automatische Mailavisierung (Erweiterungsmodul)
FreiAvis1 TEXT 62 - -
FreiAvis2 Text 62 - -
HV_ElektronikArtikel TEXT 1 - 'J'/'T'(True): Elektronik-Artikel,
Kostenstelle TEXT 30 - -
ZusatzZeile1 Text 150 - Zusatztext (Druck auf Etikett)
ZusatzZeile2 TEXT 150 - Zusatztext (Druck auf Etikett)

Artikeldaten

Feldname Typ Max Länge Dezimalstellen Belegung
VersandeinheitID Integer - - Fremdschlüssel zum Packstückdatensatz. Über diese Beziehung können einem Packstück 0 .. n Positionen zugewiesen werden.
AnzahlPosEtiketten Integer - - Anzahl Artikeletiketten, welche gedruckt werden sollen
ArtikelBTNNr Text 25 - BTN Nummer / Zolltarifnummer
ArtikelEAN Text 20 - EAN Nummer
ArtikelEinheit Text 10 - Einheit der Artikelmenge
ArtikelGewicht Decimal 9 3 Gewicht des Arikels
ArtikelGruppe Text 50 - Artikelgruppe
ArtikelMenge Decimal 9 3 Menge des Artikels
ArtikelServices Text 100 - Pipe getrennte Services für diesen Artikel
ArtikelSollMenge Decimal 9 3 -
ArtikelText1 Text 100 - Artikelbezeichnung
ArtikelText2 Text 100 - Artikelbezeichnung
ArtikelText3 Text 100 - Artikelbezeichnung
ArtikelText4 Text 100 - Artikelbezeichnung
ArtikelVolumen Decimal 9 3 Volumen des Artikels
ArtikelWaehrung Text 3 - Währung in welcher der Wert des Artikels angegeben wird
ArtikelWert Decimal 18 2 Wert des Artikels
ChargeFlag Text 1 -
KundenArtikelNr Text 50 - Artikelnummer
KundenBestellNr Text 50 - Bestellnummer
PosAuftragNr Text 50 - Auftragsnummer
PosLieferNr Text 40 - Lieferscheinnummer
PositionNr Text 50 - Laufende Nummer innerhalb des Packstücks
SerienNr Text 30 - Seriennummer
UrsprungLand Text 2 - Ursprungsland des Artikels

Gefahrgut

In der Gefahrgut Abwicklung bieten wir zwei Möglichkeiten der Abwicklung an. Zum einen können die kompletten Gefahrgutdaten ans HVS32 übermittelt werden (aus den Positionsdaten).
Zum anderen gibt es die Möglichkeit, die Gefahrgutdaten ins HVS32 zu importieren und dort zu pflegen (siehe Gefahrgutstamm). In diesem Fall müssen nicht alle Gefahrgutdaten ans HVS32 übermittelt werden, sondern werden aus dem im HVS32 hinterlegten Stamm ausgelesen. (über Gefahrgutstamm im HVS32)

Gefahrgut (aus den Positionsdaten)

Feldname Typ Max Länge Dezimalstellen Belegung
VersandeinheitID Integer - - Fremdschlüssel zum Packstückdatensatz. Über diese Beziehung können einem Packstück 0 .. n Positionen zugewiesen werden.
GefahrgutBefoerdKat Integer 1 - Beförderungskategorie, Pflicht (siehe ADR-Tabelle Spalte (15)), kann 0-4 sein. Achtung! Muss unbedingt korrekt sein.
GefahrgutBegrenzteMenge Text 1 - T wenn der Stoff mit Status LQ / Begrenzte Menge nach ADR 3.4 verschickt wird, ansonsten F, Pflicht
GefahrgutBezeichnung Text 100 - Pflicht (siehe ADR-Tabelle Spalte (2))
GefahrgutBuchst640 Text 1 - Buchstabe für Sondervorschrift 640, bedingte Pflicht bei Stoffen, bei denen die Sondervorschrift 640 gilt (siehe ADR-Tabelle Spalte (6))
GefahrgutFFCode Text 20 - Übergabecode an Frachtführer (z.B. für GLS) (Optional)
GefahrgutFaktor Integer 3 - Bewertungsfaktor für Punktesummation auf dem Beförderungspapier, (kann 0, 1, 3, 50 oder 999 sein), eigentlich Pflicht, kann aber eindeutig aus der Beförderungskategorie geschlossen werden, daher muss es nicht unbedingt belegt sein
GefahrgutFreigestMenge Text 1 - T wenn der Stoff mit Status EQ / Excepted Quantities nach ADR 3.5 verschickt wird, ansonsten F, Pflicht
GefahrgutKCode Text 10 - Klassifizierungscode, Pflicht (siehe ADR-Tabelle Spalte (3b))
GefahrgutKlasse Text 100 - Pflicht (siehe ADR-Tabelle Spalte (3a))
GefahrgutMenge Decimal 8 3 Stoff-Menge an Gefahrgut, die ADR-technisch zu deklarieren ist ( in Litern bei Flüssigkeiten und verdichteten Gasen, sonst in kg, bei LQ-Gefahrgut immer kg )
GefahrgutMengenEinheit Text 2 - Mengeneinheit zur Stoff-Menge. ‚1‘ oder ‚l‘: Liter ; ‚0‘ oder ‚kg‘ oder leer: kg
GefahrgutNebenGefahr Text 10 - bedingte Pflicht bei Stoffen, bei denen neben der Hauptgefahr-Klasse/Zettelnummer noch Nebengefahr-Zettelnummern vorhanden sind (siehe ADR-Tabelle Spalte (5), wenn dort z.B. 3+6.1+8 eingetragen ist, sind 6.1 und 8 die Nebengefahr-Zettelnummern und als (6.1)(8) im Feld Nebengefahr zu übermitteln )
GefahrgutNettoExplMasse Decimal 8 3 Netto-Explosivmasse in kg, nur bei Gefahrgütern der Klasse 1
GefahrgutTechBenennung Text 150 3 bedingte Pflicht bei N.A.G. Gefahrgut(d.h. wenn die Bezeichnung mit N.A.G. endet) , dann muss der Gefahrgutauslöser
GefahrgutTunnelBCode Text 10 - Tunnelbeschränkungscode, Pflicht (siehe ADR-Tabelle Spalte (15))
GefahrgutUNNR Text 10 - Pflicht (siehe ADR-Tabelle Spalte (1))
GefahrgutUmweltGef Text 1 - T wenn Stoff umweltgefährdend ist , ansonsten F, Pflicht bei umweltgefährdenden Stoffen
GefahrgutVPG Text 3 - Verpackungsgruppe, bedingt Pflicht bei den Stoffen, bei denen diese in der ADR-Tabelle belegt ist, kann I,II oder III sein oder gar nicht belegt (letzteres z.B. bei Klasse 2)) (siehe ADR-Tabelle Spalte (4))
GefahrgutVerpAnzahl Integer 4 - Anzahl der Einheiten, in denen das Gefahrgut verpackt ist (in Zusammenhang mit dem nächsten Feld GefahrgutVerpackungsart)
GefahrgutVerpackungsart Text 5 - ADR-Code der Verpackungsart, z.B. 4G für Kiste (Pappe), Pflicht, siehe separate Doc f. Verpackungscodes

Gefahrgut (über Gefahrgutstamm im HVS32)

Feldname Typ Max Länge Dezimalstellen Belegung
VersandeinheitID Integer - - Fremdschlüssel zum Packstückdatensatz. Über diese Beziehung können einem Packstück 0 .. n Positionen zugewiesen werden.
GefahrgutID Text 20 - Eindeutige Suchnummer für Gefahrgut-Stammdaten
GefahrgutMenge Decimal 8 3 -
GefahrgutVerpAnzahl Integer - - -
GefahrgutMengenEinheit Text 2 - '0' bzw Blank: Kilogramm; '1': Liter
GefahrgutNettoExplMasse Decimal 8 3 Nur bei Klasse 1, dann aber Pflicht