Statusdaten Export Standard Schnittstelle - Versionsgeschichte

Treum am 1. Juli 2026 um 13:10 Uhr

2026-07-01T13:10:31Z

Treum am 28. Juni 2023 um 11:11 Uhr

2023-06-28T11:11:41Z

Treum: Treum verschob die Seite Statusdaten Export Standard Schnitstelle nach Statusdaten Export Standard Schnittstelle

2022-01-24T13:11:28Z

Treum verschob die Seite Statusdaten Export Standard Schnitstelle nach Statusdaten Export Standard Schnittstelle

Treum am 9. November 2021 um 07:47 Uhr

2021-11-09T07:47:52Z

Treum am 22. April 2020 um 15:09 Uhr

2020-04-22T15:09:30Z

Treum am 6. Dezember 2019 um 07:05 Uhr

2019-12-06T07:05:13Z

Treum: Die Seite wurde neu angelegt: „Im Standard werden die folgenden Felder exportiert. Unterhalb der Tabelle finden Sie noch verschiedene Exporttypen (CSV, Datenbank) {| class="wikitable" ! Fel…“

2019-12-05T16:42:58Z

Die Seite wurde neu angelegt: „Im Standard werden die folgenden Felder exportiert. Unterhalb der Tabelle finden Sie noch verschiedene Exporttypen (CSV, Datenbank) {| class="wikitable" ! Fel…“

Neue Seite

Im Standard werden die folgenden Felder exportiert. Unterhalb der Tabelle finden Sie noch
verschiedene Exporttypen (CSV, Datenbank)

{| class="wikitable"
! Feldname HVS32
! Datentyp
! Länge
! Beschreibung
|-
| FFKURZNAME
| Text
| 10
| Kennung des Frachtführers zum Host-System
|-
| FFSTATUSCODE
| Text
| 10
| Frachtführerspezifischer Statuscode
|-
| FFSTATUSKLARTEXT
| Text
| 250
| Klartext der den Statuscode beschreibt
|-
| FFZUSATZCODE
| Text
| 10
| Zusätzlicher Statuscode
|-
| FFZUSATZKLARTEXT
| Text
| 120
| Klartext der den zusätzlichen Statuscode beschreibt
|-
| ZUSATZKLARTEXT
| Text
| 80
| Zusätzliche Informationen
|-
| STATUSORT
| Text
| 50
| Ort an dem der Status eingetreten ist (z.B. Nummer des Depots)
|-
| EMPFANGSQUITTIERER
| Text
| 100
| Name des Empfängers, der das Paket/die Sendung entgegen nahm
|-
| STATUSDATETIME
| Text
| 20
| Datum und optional Uhrzeit des Statuscodes (Format: dd.mm.yyyy hh:mm:ss)
|-
| DRUCKDATETIME
| Text
| 20
| Datum und Uhrzeit des Etikettendrucks (Format: dd.mm.yyyy hh:mm:ss)
|-
| AUSGANGDATETIME
| Text
| 20
| Datum der Übergabe an den Frachtführer (Format: dd.mm.yyyy)
|-
| TRACKINGNR
| Text
| 35
| Trackingnummer
|-
| VERSANDSENDUNGSNR
| Text
| 20
| Sendungsnummer
|-
| LIEFERSCHEINNR
| Text
| 40
| Lieferscheinnummer des Haupt-Lieferscheins
|-
| PackageNo
| Integer
|
| Packstücknummer innerhalb des Lieferscheins
|-
| PACKSTUECKID
| Text
| 20
| Eindeutige Packstück-ID aus dem Host-System (nur Automatik-Polling)
|-
| STATUSTYP
| Text
| 2
| E = Endestatus, Z = Zwischenstatus
|-
| FEHLERSTATUS
| Text
| 2
| I = Info, F = Fehler
|-
|}

=== CSV ===
Die Felder werden Semikolon separiert in eine CSV-Datei geschrieben. Wobei die Feldnamen die Definitionszeile bilden.
Die Länge der Felder definiert nur die maximale Länge, es wird nicht auf die angegebene Länge aufgefüllt.

=== Flatfile ===
Die Felder werden mit festen Feldlängen, wie angegeben, in eine Textdatei geschrieben. Es gibt keine Definitionszeile.
Die Felder werden auf der Rechten seite auf die Angegebene Länge aufgefüllt.

=== Datenbank / JDBC ===
Die Daten werde mithilfe eines JDBC-Treiber (jar-Datei) welcher vom Datenbank Hersteller bereitgestellt wird in Ihre Datenbank übertragen.
Der Standard Tabellenname ist „status“ kann aber auch beliebig geändert werden. So auch die Namen der Felder.

← Nächstältere Version		Version vom 1. Juli 2026, 13:10 Uhr
Zeile 118:		Zeile 118:
	* Die Connection Klasse des JDBC Treiber (bei MySQL z.B. com.mysql.jdbc.Driver)		* Die Connection Klasse des JDBC Treiber (bei MySQL z.B. com.mysql.jdbc.Driver)
	* User und Passwort für den DB Zugriff		* User und Passwort für den DB Zugriff
		+
		+	=== DGS (DataGatewayServer) ===
		+	Über den DataGatewayServer (DGS) werden die Statusdaten aktiv an Ihr Zielsystem gesendet – vergleichbar mit einem „Webhook" bzw. Push. Sie müssen die Daten also nicht abholen: Der Versand erfolgt automatisch, sobald neue Statusdaten vorliegen. Ein Zielsystem kann bei Bedarf auch an mehrere Empfänger gleichzeitig senden.
		+
		+	Die exportierten Felder entsprechen den Standardfeldern aus der Tabelle oben.
		+
		+	Voraussetzung: StatusdatenManager ab Version 1.6.9, DatagatewayService ab Version 3.8.45.
		+
		+	==== Mögliche Zielsysteme ====
		+	Der Versand ist zu unterschiedlichen Zielsystemen möglich. Der häufigste Fall ist der Push an eine REST-API.
		+
		+	{\| class="wikitable"
		+	! Zielsystem / Weg
		+	! Beschreibung
		+	\|-
		+	\| REST-API
		+	\| Push per HTTP an eine Web-API (Standardfall, Format JSON)
		+	\|-
		+	\| SOAP-Webservice
		+	\| Push an einen SOAP-Webservice (Format XML)
		+	\|-
		+	\| HTTP-Endpoint
		+	\| Einfache HTTP-Aufrufe (GET/POST/PUT)
		+	\|-
		+	\| Datei
		+	\| Ablage als Datei (XML oder Bild) in einem Verzeichnis
		+	\|-
		+	\| SAP
		+	\| Übergabe an SAP (RFC oder IDoc)
		+	\|-
		+	\| CUBE3 / PSI-WMS
		+	\| Anbindung an CUBE3 bzw. ein PSI-Warehouse-Management-System
		+	\|}
		+
		+	==== Voraussetzungen – was Sie bereitstellen müssen ====
		+	Je nach gewähltem Zielsystem benötigen wir von Ihnen die folgenden Angaben.
		+
		+	Push-Ziele (REST/SOAP/HTTP):
		+
		+	{\| class="wikitable"
		+	! Zielsystem
		+	! Von Ihnen bereitzustellen
		+	\|-
		+	\| REST-API
		+	\| Ziel-URL (Endpoint); Authentifizierung (keine / Benutzer + Passwort / API-Key / OAuth-Zugangsdaten); erwartetes Datenformat (i. d. R. JSON); bei HTTPS ggf. das TLS-Zertifikat
		+	\|-
		+	\| SOAP-Webservice
		+	\| Endpoint-URL bzw. WSDL; Authentifizierung; erwartete XML-Struktur; bei HTTPS ggf. das TLS-Zertifikat
		+	\|-
		+	\| HTTP-Endpoint
		+	\| Ziel-URL und HTTP-Methode; ggf. Authentifizierung
		+	\|}
		+
		+	Weitere Ziele:
		+
		+	{\| class="wikitable"
		+	! Ziel
		+	! Von Ihnen bereitzustellen
		+	\|-
		+	\| Datei (XML/Bild)
		+	\| Zielverzeichnis sowie gewünschtes Format und Encoding
		+	\|-
		+	\| SAP (RFC/IDoc)
		+	\| SAP-Zugangsdaten (Mandant, Benutzer, Passwort, Host) und den Namen der RFC-Funktion bzw. des IDoc
		+	\|-
		+	\| CUBE3 / PSI-WMS
		+	\| jeweils Ziel-URL und Zugangsdaten
		+	\|}
		+
		+	==== Technische Details ====
		+	Ablauf: Der StatusdatenManager sendet die Daten über das Export-Event „DGS REST SERVER EXPORT" an ein DGS-Server-Plugin (Typ „DGSRestServerGatewayFactory"). Von dort werden sie über den Mediator (GatewayID + Funktion „exportData") an ein oder mehrere Client-Plugins weitergeleitet, die den eigentlichen Versand an das Zielsystem durchführen. Als Authentifizierung zwischen SEM und DGS werden NONE und ClientCredentials unterstützt.

← Nächstältere Version		Version vom 6. Dezember 2019, 07:05 Uhr
Zeile 1:		Zeile 1:
		+	[[en:Statusdata_export_default_interface]]
	Im Standard werden die folgenden Felder exportiert. Unterhalb der Tabelle finden Sie noch		Im Standard werden die folgenden Felder exportiert. Unterhalb der Tabelle finden Sie noch
	verschiedene Exporttypen (CSV, Datenbank)		verschiedene Exporttypen (CSV, Datenbank)

@@ Zeile 109: / Zeile 109: @@
 Die Felder werden auf der Rechten seite auf die Angegebene Länge aufgefüllt.
-=== Datenbank / JDBC ===
+=== JDBC / Datenbank ===
 Die Daten werde mithilfe eines JDBC-Treiber (jar-Datei) welcher vom Datenbank Hersteller bereitgestellt wird in Ihre Datenbank übertragen.
 Der Standard Tabellenname ist „status“ kann aber auch beliebig geändert werden. So auch die Namen der Felder.

← Nächstältere Version	Version vom 24. Januar 2022, 13:11 Uhr
(kein Unterschied)

@@ Zeile 79: / Zeile 79: @@
 | Lieferscheinnummer des Haupt-Lieferscheins
 |-
-| PackageNo
+| PACKSTKNR
 | Integer
 | 3

@@ Zeile 11: / Zeile 11: @@
 | FFKURZNAME
 | Text
-| 10
+| 30
 | Kennung des Frachtführers zum Host-System
 |-
@@ Zeile 41: / Zeile 41: @@
 | STATUSORT
 | Text
-| 50
+| 30
 | Ort an dem der Status eingetreten ist (z.B. Nummer des Depots)
 |-
@@ Zeile 51: / Zeile 51: @@
 | STATUSDATETIME
 | Text
-| 20
+| 25
 | Datum und optional Uhrzeit des Statuscodes (Format: dd.mm.yyyy hh:mm:ss)
 |-
 | DRUCKDATETIME
 | Text
-| 20
+| 25
 | Datum und Uhrzeit des Etikettendrucks (Format: dd.mm.yyyy hh:mm:ss)
 |-
 | AUSGANGDATETIME
 | Text
-| 20
+| 25
 | Datum der Übergabe an den Frachtführer (Format: dd.mm.yyyy)
 |-
@@ Zeile 76: / Zeile 76: @@
 | LIEFERSCHEINNR
 | Text
-| 40
+| 50
 | Lieferscheinnummer des Haupt-Lieferscheins
 |-
 | PackageNo
 | Integer
+| 3
 | Packstücknummer innerhalb des Lieferscheins
 |-