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.
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.
Falls eine der genannten Bedingungen nicht erfüllt ist, wird eine entsprechende Warnmeldung ausgegeben.
Nach dem erfolgreichen Export ändert sich der Fahrtstatus automatisch zu informiert.
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.
Auszug aus dem Datei-Inhalt:
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.
Falls es beim Export Probleme gab, ist das an den Einträgen in den Spalten Exportstatus und Export-Error im oberen Bereich erkennbar.
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.
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.
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.
8. Export
8.1. Durchführung
In cs PLAN wird der Export über Markieren der Fahrten und Rechtsklick > Auftragsexport (Ladung) ausgeführt.
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.
