HVS32 ODBC Schnittstelle (Automatik-Polling)
Zur Navigation springen
Zur Suche springen
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 |
| 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 | 60 | - | Zusatz zu Fest-AVIS-Schlüssel 1 |
| AVISZusatz2 | Text | 60 | - | 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 |