Zuletzt bearbeitet vor einem Jahr
von Sandra Lindemann

Fahrtenexport an Frachtführer (FE 175713)



Der Datenexport aus cs JOB bietet die Möglichkeit, Fahrten in Auftragsdefinitionen bzw. zu Auftragsdaten umzuwandeln und zu ergänzen und diese an externe Frachtführer in Dateiformat zu übermitteln.

Funktionsbeschreibung

Hier werden verschiedene Exporttypen (Übertragungswege und Datenformate) unterstützt, deren Umfang regelmäßig gewartet, aktualisiert und erweitert wird. Als Exporttypen stehen das CS_Container_Xml - Format (für Containerfahrten) sowie das CS_Package_Xml - Format (für Ladungsfahrten) zur Verfügung. Geschäftspartner, die an einem Nachrichtenaustausch interessiert sind, können dieses Format anhand der Schema Definition cs Container Xml Definition.zip bei sich anbinden.

Zusätzlich können Rückmeldungen vom Frachtführer entgegengenommen und automatisch in die Datensätze des Auftrags-/Fahrtmanagement von cs JOB übernommen werden.

Einrichten der Schnittstelle

Die Beschreibung der Funktion erfolgt hier am Beispiel Container. Für Exporte von Ladungsfahrten finden Sie die Beschreibung der Abweichungen in Punkt 3.

Anlegen von Exportkonfigurationen

Für jeden zu verwendenden Exporttyp muss eine Exportkonfiguration angelegt werden.  Die Ansicht dafür befindet sich im Menü Vorgaben > Auftrag > Schnittstellen > Export Konfigurationen.

Zur Anzeige des Menüs ist das entsprechende Benutzerrecht Export-Einstellungen erforderlich.


Folgende Funktionen können je Exportkonfiguration angepasst werden:


Feld Beispiel-Wert Beschreibung                                        Pflicht

(FTP)

Pflicht

(HTTP)

Aktiv Gibt an, ob Exporte und Rückmeldungen für diesen Exporttyp durchgeführt werden können.
Auftragsziel CS_Container_Xml Der von dieser Konfiguration betroffene Exporttyp.
URL http://example.com/API Die HTTP-Adresse für einen Export an eine API-Schnittstelle.
Serverport 80 Der numerische Port für die HTTP-Adresse.
Benutzer MaxMustermann Der Benutzername für die HTTP-Verbindung.
Kennwort ******* Das  Kennwort für die HTTP-Verbindung.
UserGroup MusterGruppe Die Benutzergruppe für die HTTP-Verbdingung.
Importpfad C:\Beispiel\Import Das lokale FTP-Verzeichnis, aus dem Rückmeldungen importiert werden.
Exportpfad C:\Beispiel\Export Das lokale FTP-Verzeichnis, in das Exportdateien gespeichert werden.
Archivpfad C:\Beispiel\Archiv Das lokale Verzeichnis in das importierte und exportierte Dateien archiviert werden.
Export bis Fahrtstatus Durchführung Der Fahrtstatus, bis zu dem (inklusiv), Exporte einer Fahrt möglich sind.
Export bis Werktage 3 Maximale Anzahl Werktage vor dem Fahrtdatum, bis wann Exporte möglich sind. Aktuell noch nicht implementiert!
Update bis Werktage 1 Maximale Anzahl Werktage vor dem Fahrtdatum, bis wann Updates möglich sind. Aktuell noch nicht implementiert!
Storno bis Werktage 3 Maximale Anzahl Werktage vor dem Fahrtdatum, bis wann Stornos möglich sind. Aktuell noch nicht implementiert!
cs COM Kanal C-Export cs COM Kanal, in welchen automatisch funktionale Nachrichten gesendet werden.
cs COM Kanal technisch C-Export tech. cs COM Kanal, in welchen automatisch technische und Fehler-Nachrichten gesendet werden.
Standard-Dokumententyp Aktuell nicht definiert/implementiert!
Keine Updates
Aktuell nicht definiert/implementiert!
Niederlassung Die Niederlassung, für die die Schnittstelle wirksam ist.

4. Einstellen / Anbinden von Frachtführer Adressen

Für jede Frachtführeradresse, an die Aufträge übermittelt werden sollen, muss ein passender Eintrag zum Datenaustausch eingestellt werden.

Das erfolgt in den Stammdaten > Adressen > Inhalt > Datenaustausch.


Release:Frachtführer Adressen.png

Hier wird im unteren Bereich ein neuer Kommunikationseintrag hinzugefügt und entsprechend gefüllt.

Feld Beispiel-Wert Beschreibung
Kommunikationspartner Kann leer bleiben / kein Effekt.
Kommunikationspartner Name Kann leer bleiben / kein Effekt.
Kommunikationsweg CS_Container_Xml Muss dem Auftragsziel der jeweiligen Exportkonfiguration entsprechen.
Bezeichnung / Code ABC123456789 Der Empfängercode wird bei Übertragung zwischen cargo support Systemen für den Nachrichtenversand benötigt.

Bei Exportschnittstellen an externe Systeme dient er zur eindeutigen Identifizierung des Empfängers.

Aktuell noch nicht vollständig implementiert, muss jedoch mit beliebigem Wert gefüllt werden (z.b. Matchcode oder Adressname).

Standard Auftragsaustausch
Dieser Haken muss gesetzt sein. Er identifiziert eindeutig den Kommunikationseintrag, der für Auftragsexporte verwendet werden soll.

5. Export

5.1. Durchführung

Der Datenexport von Fahrten kann in cs PLAN in den Fenstern Alle Fahrten oder Containerdispo über das Rechtsklick-Menü Export an Subunternehmer angestoßen werden.

Falls diese Funktion nicht sichtbar ist, muss gegebenenfalls zuerst die Menü-Einstellung in cs JOB angepasst werden.


Durch das Ausführen der Funktion Export an Subunternehmer werden alle in der aktuellen Ansicht markierten Fahrten gemäß der zutreffenden Exportkonfigurationen exportiert. Dabei gelten folgende Bedingungen:

  • Der Fahrt muss ein Frachtführer zugewiesen sein.
  • Die Frachtführeradresse muss in den Stammdaten einen gültigen Kommunikationseintrag haben. Ist das der Fall, wird der disponierte Frachtführer grün hinterlegt angezeigt.
  • Für den im Kommunikationseintrag angegebenen Kommunikationsweg muss es eine aktive Exportkonfiguration geben.


Release:Fahrten exportiert.png

Falls eine der genannten Bedingungen nicht erfüllt ist, wird eine entsprechende Warnmeldung ausgegeben.


Release:Nicht exportiert.png


Nach dem erfolgreichen Export ändert sich der Fahrtstatus automatisch zu informiert.

Release:informiert.png


Container: Werden mehrere Fahrten aus einer Tour markiert und exportiert (CS_Container_Xml), greift die Standardlogik für Container: pro Container ein Auftrag.

Ladung: Werden mehrere Fahrten aus einer Tour markiert und exportiert (CS_Package_Xml), wird die gesamte Tour als 1 Auftrag exportiert.


Die erzeugten Dateien sind dann im angegebenen Ordner (siehe Punkt 2) gespeichert.

Release:erzeugte Dateien.png

Auszug aus dem Datei-Inhalt:

Release:Datei Inhalt.png

5.2. Monitoring

Getätigte Exporte können in cs JOB in der Ansicht Datei > Container Export angeschaut und kontrolliert werden. Im oberen Bereich sind die allgemeinen Informationen zum Auftrag und Container zu finden, im unteren Bereich dann die Details zu den Wegpunkten, Ladungsinhalten, Gefahrgütern und Abrechnungsartikeln.

Release:Abrechnungsartikel.png

Falls es beim Export Probleme gab, ist das an den Einträgen in den Spalten Exportstatus und Export-Error im oberen Bereich erkennbar.


Release:Export Error.png

6. Rückmeldungen

6.1. Empfang von Rückmeldungen einrichten

Um Rückmeldungen empfangen zu können, muss der CronJob ContainerExportFeedbackJob aktiviert sein. Diese Einstellung findet sich in cs JOB im Menü Einstellungen > Administration > Geplante Aufgaben.


Release:Cron.png

6.2. Arten von Rückmeldungen

Folgende Rückmeldungen können von CS_Container_Xml empfangen werden:


XML-Datei Feld Beschreibung
ContainerFeedbackStatus ReferenceNumber Die Referenznummer des exportierten Container Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

ContainerFeedbackStatus Timestamp Der Zeitstempel wann die Rückmeldungsdatei gesendet wurde.
ContainerFeedbackStatus Status Der Auftragsstatus seitens des Subunternehmers.

Setzt den Fahrtstatus der betroffenen Fahrt im eigenen System.

ContainerFeedbackStatus Remark Bemerkung zum Auftragsstatus.

Falls der Auftrag abgelehnt wurde wird dieser Text in das Feld Fahrerinformationen der Ursprungsfahrt eingetragen.

ContainerFeedbackContainerInfo ReferenceNumber Die Referenznummer des exportierten Container Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

ContainerFeedbackContainerInfo Timestamp Der Zeitstempel wann die Rückmeldungsdatei gesendet wurde.
ContainerFeedbackContainerInfo ContainerNumber Die gemeldete Containernummer.

Wird in Fahrt & Auftrag anhand der Logik "Fehlende Auftragsdaten ergänzen" übernommen.

ContainerFeedbackContainerInfo IsoCode Der gemeldete Container ISO Code.

Wird mit den ISO Codes der eigenen Lademittel Stammdaten abgeglichen und das passende Lademittel in Fahrt & Auftrag anhand der Logik "Fehlende Auftragsdaten ergänzen" übernommen.

ContainerFeedbackContainerInfo SealNumber Die gemeldete Siegelnummer.

Wird in Fahrt & Auftrag anhand der Logik "Fehlende Auftragsdaten ergänzen" übernommen.

ContainerFeedbackContainerInfo TaraWeighjt Das gemeldete Tara Gewicht.

Wird in Fahrt & Auftrag anhand der Logik "Fehlende Auftragsdaten ergänzen" übernommen.

ContainerFeedbackContainerInfo NetWeight Die gemeldete Netto Gewicht.

Wird in Fahrt & Auftrag anhand der Logik "Fehlende Auftragsdaten ergänzen" übernommen.

ContainerFeedbackContainerInfo GrossWeight Die gemeldete Brutto Gewicht.

Wird in Fahrt & Auftrag anhand der Logik "Fehlende Auftragsdaten ergänzen" übernommen.

ContainerFeedbackDispo ReferenceNumber Die Referenznummer des exportierten Container Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

ContainerFeedbackDispo Timestamp Der Zeitstempel wann die Rückmeldungsdatei gesendet wurde.
ContainerFeedbackDispo TruckLicensePlate Das gemeldete LKW-Nummernschild.

Wird zusammen mit dem gemeldeten Anhänger-Nummernschild in das Feld "Freies Kennzeichen" übernommen.

ContainerFeedbackDispo TrailerLicensePlate Das gemeldete Anhänger-Nummernschild.

Wird zusammen mit dem gemeldeten LKW-Nummernschild in das Feld "Freies Kennzeichen" übernommen.

ContainerFeedbackWaypointStatus ReferenceNumber Die Referenznummer des exportierten Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

ContainerFeedbackWaypointStatus Timestamp Der Zeitstempel wann die Rückmeldungsdatei gesendet wurde.
ContainerFeedbackWaypointStatus ExternalWaypointId Eine Referenz-ID um die Rückmeldung eindeutig einem Fahrtwegpunkt der Ursprungsfahrt zuzuweisen.
ContainerFeedbackWaypointStatus WaypointStatus Der gemeldete Wegpunktstatus.

Setzt den entsprechenden Fahrtwegpunktstatus (z.B. Anfahrt, Ankunft, Abgeschlossen, etc.)

ContainerFeedbackWaypointTimes ReferenceNumber Die Referenznummer des exportierten Container Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

ContainerFeedbackWaypointTimes Timestamp Der Zeitstempel wann die Rückmeldungsdatei gesendet wurde.
ContainerFeedbackWaypointTimes ExternalWaypointId Eine Referenz-ID um die Rückmeldung eindeutig einem Fahrtwegpunkt der Ursprungsfahrt zuzuweisen.
ContainerFeedbackWaypointTimes WaypointDate Die gemeldete Planzeit eines Wegpunkts.
ContainerFeedbackWaypointTimes Approaching Die gemeldete Anfahrtzeit eines Wegpunkts.
ContainerFeedbackWaypointTimes Arrival Die gemeldete Ankunftzeit eines Wegpunkts.
ContainerFeedbackWaypointTimes ReportedBegin Die gemeldete Anmeldezeit eines Wegpunkts.
ContainerFeedbackWaypointTimes LoadingFrom Die gemeldete Ladebeginnzeit eines Wegpunkts.
ContainerFeedbackWaypointTimes LoadingTo Die gemeldete Ladeendezeit eines Wegpunkts.
ContainerFeedbackWaypointTimes ReportedEnd Die gemeldete Abmeldezeit eines Wegpunkts.
ContainerFeedbackWaypointTimes Departure Die gemeldete Abfahrtzeit eines Wegpunkts.
ContainerFeedbackGPS ReferenceNumber Die Referenznummer des exportierten Container Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

ContainerFeedbackGPS TruckRegistrationPlate Das Nummernschild des georteten Fahrzeugs
ContainerFeedbackGPS Longitude Längengrad der GPS Ortung.
ContainerFeedbackGPS Latitude Breitengrad der GPS Ortung.
ContainerFeedbackGPS LocatingDate Datum & Uhrzeit der GPS Ortung.
ContainerFeedbackGPS City Stadt der GPS Ortung.
ContainerFeedbackGPS Street Straße der GPS Ortung.
ContainerFeedbackGPS PostCode PLZ der GPS Ortung.
ContainerFeedbackGPS Country Land der GPS Ortung.
ContainerFeedbackGPS LocationName Ergänzender Name der GPS Ortung.
ContainerFeedbackGPS Bearing Ausrichtung (Himmelsrichtung) des LKW während der GPS Ortung.
ContainerFeedbackGPS Speed Geschwindigkeit des LKW während der GPS Ortung.
ContainerFeedbackGPS ExternalWaypointID Eine Referenz-ID um die Rückmeldung eindeutig einem Fahrtwegpunkt der Ursprungsfahrt zuzuweisen.

Folgende Rückmeldungen können von CS_Package_Xml empfangen werden:


XML-Datei Feld Beschreibung
PackageFeedbackStatus ReferenceNumber Die Referenznummer des exportierten Ladungs Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

PackageFeedbackStatus Timestamp Der Zeitstempel wann die Rückmeldungsdatei gesendet wurde.
PackageFeedbackStatus Status Der Auftragsstatus seitens des Subunternehmers.

Setzt den Fahrtstatus der betroffenen Fahrt im eigenen System.

PackageFeedbackStatus Remark Bemerkung zum Auftragsstatus.

Falls der Auftrag abgelehnt wurde wird dieser Text in das Feld Fahrerinformationen der Ursprungsfahrt eingetragen.

PackageFeedbackDispo ReferenceNumber Die Referenznummer des exportierten Ladungs Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

PackageFeedbackDispo Timestamp Der Zeitstempel wann die Rückmeldungsdatei gesendet wurde.
PackageFeedbackDispo TruckLicensePlate Das gemeldete LKW-Nummernschild.

Wird zusammen mit dem gemeldeten Anhänger-Nummernschild in das Feld "Freies Kennzeichen" übernommen.

PackageFeedbackDispo TrailerLicensePlate Das gemeldete Anhänger-Nummernschild.

Wird zusammen mit dem gemeldeten LKW-Nummernschild in das Feld "Freies Kennzeichen" übernommen.

PackageFeedbackDispo SwapTrailer1 Die gemeldete 1. Wechselbrücke

Wird Anhand Name/Matchcode mit den eigenen Wechselbrücken Stammdaten abgeglichen.

Falls es einen Treffer gibt wird dieser Datensatz in das Feld Wechselbrücke 1 der eigenen Fahrt übernommen.

PackageFeedbackDispo SwapTrailer2 Die gemeldete 2. Wechselbrücke

Wird Anhand Name/Matchcode mit den eigenen Wechselbrücken Stammdaten abgeglichen.

Falls es einen Treffer gibt wird dieser Datensatz in das Feld Wechselbrücke 2 der eigenen Fahrt übernommen.

PackageFeedbackWaypointStatus ReferenceNumber Die Referenznummer des exportierten Ladungs Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

PackageFeedbackWaypointStatus Timestamp Der Zeitstempel wann die Rückmeldungsdatei gesendet wurde.
PackageFeedbackWaypointStatus ExternalWaypointId Eine Referenz-ID um die Rückmeldung eindeutig einem Fahrtwegpunkt der Ursprungsfahrt zuzuweisen.
PackageFeedbackWaypointStatus WaypointStatus Der gemeldete Wegpunktstatus.

Setzt den entsprechenden Fahrtwegpunktstatus (z.B. Anfahrt, Ankunft, Abgeschlossen, etc.)

PackageFeedbackWaypointTimes ReferenceNumber Die Referenznummer des exportierten Ladungs Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

PackageFeedbackWaypointTimes Timestamp Der Zeitstempel wann die Rückmeldungsdatei gesendet wurde.
PackageFeedbackWaypointTimes ExternalWaypointId Eine Referenz-ID um die Rückmeldung eindeutig einem Fahrtwegpunkt der Ursprungsfahrt zuzuweisen.
PackageFeedbackWaypointTimes WaypointDate Die gemeldete Planzeit eines Wegpunkts.
PackageFeedbackWaypointTimes Approaching Die gemeldete Anfahrtzeit eines Wegpunkts.
PackageFeedbackWaypointTimes Arrival Die gemeldete Ankunftzeit eines Wegpunkts.
PackageFeedbackWaypointTimes ReportedBegin Die gemeldete Anmeldezeit eines Wegpunkts.
PackageFeedbackWaypointTimes LoadingFrom Die gemeldete Ladebeginnzeit eines Wegpunkts.
PackageFeedbackWaypointTimes LoadingTo Die gemeldete Ladeendezeit eines Wegpunkts.
PackageFeedbackWaypointTimes ReportedEnd Die gemeldete Abmeldezeit eines Wegpunkts.
PackageFeedbackWaypointTimes Departure Die gemeldete Abfahrtzeit eines Wegpunkts.
PackageFeedbackGPS ReferenceNumber Die Referenznummer des exportierten Ladungs Auftrags.

Ist notwendig um die eingehende Rückmeldung der eigenen Fahrt zuzuweisen.

PackageFeedbackGPS TruckRegistrationPlate Das Nummernschild des georteten Fahrzeugs
PackageFeedbackGPS Longitude Längengrad der GPS Ortung.
PackageFeedbackGPS Latitude Breitengrad der GPS Ortung.
PackageFeedbackGPS LocatingDate Datum & Uhrzeit der GPS Ortung.
PackageFeedbackGPS City Stadt der GPS Ortung.
PackageFeedbackGPS Street Straße der GPS Ortung.
PackageFeedbackGPS PostCode PLZ der GPS Ortung.
PackageFeedbackGPS Country Land der GPS Ortung.
PackageFeedbackGPS LocationName Ergänzender Name der GPS Ortung.
PackageFeedbackGPS Bearing Ausrichtung (Himmelsrichtung) des LKW während der GPS Ortung.
PackageFeedbackGPS Speed Geschwindigkeit des LKW während der GPS Ortung.
PackageFeedbackGPS ExternalWaypointID Eine Referenz-ID um die Rückmeldung eindeutig einem Fahrtwegpunkt der Ursprungsfahrt zuzuweisen.


Einstellungen für Ladungsexport

7. Einrichten

7.1. Anlegen von Exportkonfigurationen

In den Vorgaben > Auftrag > Schnittstellen > Export Konfigurationen wird eine Einstellung für den CS_Package_Xml Export entsprechend eingestellt.

Release:xml.png

7.2. Einstellen / Anbinden von Frachtführer Adressen

In den Stammdaten > Adressen > Inhalt > Datenaustausch erfolgt beim jeweiligen Frachtführer ein passender Eintrag für den Ladungsexport.

Release:Datenaustausch.png

8. Export

8.1. Durchführung

In cs PLAN wird der Export über Markieren der Fahrten und Rechtsklick > Auftragsexport (Ladung) ausgeführt.

Release:Auftragsexport.png

Release:Auftragsexport2.png

Release:Auftragsexport3.png

8.2. Monitoring

Getätigte Exporte können in cs JOB in der Ansicht Datei > Ladung Export angeschaut und kontrolliert werden. Im oberen Bereich sind die allgemeinen Informationen zum Auftrag zu finden, im unteren Bereich dann die Details zu den Wegpunkten, Ladungsinhalten, Gefahrgütern und Abrechnungsartikeln.

Release:Ladung Export.png