Inhalt

Funktion im Auftrag

• Sicherheitsprüfung Luftfracht

• CSD-Reiter

Per XML

In der Unionsdatenbank werden die Adressdaten der reglementierten Beauftragten und der bekannten Versender als Download (XML) zur Verfügung gestellt. 

Hier müssen die Dateien täglich heruntergeladen und in CargoSoft im Luftfrachtmenü Sicherheitsprüfung  importiert werden.

Per API

Wir stellen Ihnen eine API zur Verfügung, mit der Sie die Adressdaten automatisch gegen die Sicherheits-daten der EU-Datenbank prüfen können.

Alternativ zum täglichen Daten herunterladen und manuellen Einlesen in CargoSoft TMS, kann dies ab sofort automatisch durchgeführt werden. Für die Prüfung der im TMS erfassten Adressdaten gibt es eine API, die den Webservice der EU nutzt, um die Sicherheitsdaten automatisch abzufragen.

Mittels dieses Webservices findet der Prozess der Aktualisierung der Adressen automatisch statt - dieses über die API-Schnittstelle.

Voraussetzung: Der Kunde meldet sich für die API bei der EU-Kommission an.

LUFTFRACHT → AIR PARAMETER

Prüfvariante einstellen

Für die automatische Prüfung des Sicherheitsstatus gegen den Datenbestand der EU-Datenbank muss in den AIR PARAMETERN die Prüfvariante W oder A eingestellt sein.

Prüfung Luftsicherheit = W

Open

Bei Variante W werden Auftragsadressen, die in den ADRESSQUALIFIZIERUNGEN als luftsicherheitsrelevant gekennzeichnet sind, automatisch gegen den Datenbestand der EU‑Datenbank geprüft.
Die Prüfung erfolgt, wenn die Adresse im entsprechenden Adressfeld eingetragen wird.

Neben jedem Adressfeld wird der Status angezeigt: UNSECURE, SPX KC oder SPX RA.
Das Feld bleibt leer, wenn keine Prüfung erfolgt ist.

Der Status im Textfeld [Security Text] bleibt leer, so dass eine manuelle Änderung des Sicherheitsstatus durch den User erfolgen muss.

Wird eine Adresse geändert oder der Auftrag kopiert, wird neu geprüft.

Prüfung Luftsicherheit = A

Open

Bei Variante A werden Adressen analog der Prüfvariante W automatisch gegen die EU‑Datenbank geprüft, sofern diese in den ADRESSQUALIFIZIERUNGEN als Luftsicherheitsrelevant gekennzeichnet sind.
Die Prüfung erfolgt, wenn die Adresse im entsprechenden Adressfeld eingetragen wird.

Neben jedem Adressfeld wird der Status angezeigt: UNSECURE, SPX KC oder SPX RA.
Das Feld bleibt leer, wenn keine Prüfung erfolgt ist.

Der Status im Textfeld [secured/not secured shipper] wird bei Prüfvariante A auf Basis der Abholadresse gesetzt.
Wird eine Adresse geändert oder der Auftrag kopiert, wird neu geprüft.

Prüfung mit Anwenderbestätigung

In den Stammdaten LUFTFRACHT → AIR PARAMETER → EU-DB mit Anwenderbestätigung kann eingestellt werden, dass der Anwender die Prüfung bestätigen muss.

Das Validierungsergebnis der Sicherheitsprüfung einer Adresse gegen die Daten der EU-Datenbank wird dem Anwender im Auftrag in TMS direkt neben der Adresse angezeigt.

Dies betrifft die Prüfvarianten W und A.

Der Anwender muss dann im Falle einer erfolgreichen Prüfung die Adressdaten der im Auftrag erfassten Adresse mit den Adressdaten aus der EU-Datenbank sichten und bestätigen.

Luftsicherheitsstatus manuell prüfen

Zusätzlich können die Adressen im Auftrag manuell über den Eintrag Validierung in der Datenbank der Union zur sicheren Lieferkette im Kontextmenü geprüft werden.

• Die Funktion Update Security Status im F6-Menü prüft alle für die Automatik aktivierten Adressen.

• Auch die Funktion Shipper Sicherheitsstatus aktualisieren im Kontextmenü der Kopfdaten prüft alle für die Automatik aktivierten Adressen.

Prüfung Luftsicherheit = N

Es erfolgt keine Prüfung.

Berechtigungen

ADMIN → CS ADMIN → CS CODES

Sicherheitstexte hinterlegen

Berechtigungsobjekt: STACSCODES

Suche nach Codes mit Art = SPX:

Achtung: Die Codes D1 = SPX (=Default SPX Status) und U1 = Not secured sind Standardeinträge. Die Bezeichnung kann hier geändert werden. Platzhalter sind für den Code D1 möglich.

Sie können sich Codes mit Platzhaltern hinterlegen.

• Diese ziehen sich aus der Adresse (vom Reiter Security) die Validierungsnummer.

• Ein weiterer Eintrag ermöglicht das Ziehen der eigenen RAC-Nummer aus dem AWB-Agent.

Platzhalter für Luftsicherheitsprüfung

Folgende Platzhalter sind möglich:

#A1 = Adresse 1 (Shipper)
#A2 = Adresse 2 (Consignee)
#A3 = Adresse 3 (Notify)
#A4 = Adresse 4 (DES Agent)
#A5 = Adresse 5
#A6 = Adresse 6
#A7 = Adresse 7
#A8 = Adresse 8
#OwnRacNr =  LBA-Zulassungsnummer aus AWB-Agent (AWB Main-Reiter)

Sind in einer Adresse zwei Validierungsnummern hinterlegt, können auch die Platzhalter
#A1KC = Adresse 1 (KC-Nummer des Shippers)
#A1RA = Adresse 1 (RA-Nummer des Shippers) verwendet werden.

Beispiel

Auswahl eines Codes auf dem Reiter AWB Main: 

Nach Auswahl des Codes werden die Platzhalter #A1 und #OwnRacNr umgesetzt: 

Hier wird aus der Adresse A1 (Shipper) die Validierungsnummer vom Reiter Security ermittelt → aus dem AWB-Agent die LBA-Zulassungsnummer.

ADRESSEN → ADRESSEN → Reiter Security

Validierungsnummer in Adressen hinterlegen

Bei der Prüfung einer Adresse gegen des Datenbestand der EU-Datenbank wird die Validierungsnummer aus der Adresse ermittelt.
Im Programm Sicherheitsprüfung wird geschaut, ob ein gültiger Eintrag mit dieser Validierungsnummer existiert.

Die Validierungsnummern Ihrer Kunden (KC) und Lieferanten (RA) werden in den ADRESSEN auf dem Reiter Security hinterlegt.
In der Adresse können beide Nummern erfasst werden.

Eine Priorität für die Prüfung wird in den Adressqualifizierungen eingestellt.

ADMIN → ADRESSQUALIFIZIERUNGEN

Automatische Prüfung aktivieren

Für die automatische Web-Prüfung (W und A), benötigt jede zu prüfende Auftragsadresse einen Qualifier (Adressqualifizierung).

Mögliche Qualifier sind:

SHP = Shipper
CNE = Consignee
NFY = Notify
AGT = Agent
CAR = Carrier
TRA = Transport Company
PUP = Pickup
DEL = Delivery
HDL = Handlings Agent

• Einstellung der zu prüfenden Adressen

  • Für Variante W: Entscheiden Sie, welche Adressen automatisch geprüft werden sollen. Aktivieren Sie dazu die Checkbox Luftsicherheitsrelevant.

  • Für Variante A: muss die Abholadresse zwingend der Adressqualifizierung PUP zugewiesen werden und das Feld Luftsicherheitsrelevant aktiviert werden.

Hat eine Adresse zwei Validierungsnummern (KC und RA), kann über das Feld Prio eingestellt werden, welche Validierungsnummer bevorzugt geprüft werden soll.
Bei Verwendung eines Sicherheitsstatus mit dem Platzhalter z.B. #A1 wird ebenfalls die hier hinterlegte Prio berücksichtigt.

• Ist keine Prio eingetragen, wird die KC-Nummer herangezogen.

Datenbestand der EU-Datenbank im Menü Sicherheitsprüfung hinterlegen

Wählen Sie im Auftrag das Menü Luftfracht → Sicherheitsprüfung.

Gehen Sie wie folgt vor

1.    Download der XML-Dateien:

Melden Sie sich mit Ihrem Login in der Unionsdatenbank an (https://ksda.ec.europa.eu/app/).

Klicken Sie rechts auf das Zahnrad und selektieren Regulated Agents data as XML.

Speichern Sie die Datei an einem Ort den Sie aus CargoSoft ansteuern können.

Wiederholen Sie den Vorgang mit den Known Consignors data as XML.
                   

2.    Import der XML-Dateien:

Melden Sie sich im TMS Modul Luftfracht an.
Öffnen Sie das Menü Luftfracht →  Sicherheitsprüfung.

Selektieren Sie im Kontextmenü Import.
Selektieren Sie eine der unter Punkt 1 heruntergeladenen Dateien.

Nach dem Import werden alle Dateien im Fenster der Sicherheitsprüfung angezeigt.

Wiederholen Sie den Import-Vorgang für die 2. Datei.

Hinweis: In die Sicherheitstabelle wird ein Eintrag mit den Dateinamen und einer Gültigkeit eingetragen.
Bei der Prüfung der Adressen im Auftrag sind alle Adressen nur bis zu diesem Gültigkeitsdatum sicher.

Dies ist entscheidend, da die Daten täglich aktualisiert werden müssen. 

Sie können im Suchfeld ‚Name‘ mit dem Wert *xml suchen, um sich die beiden Dateien anzusehen.

Mit jedem Import werden die alten Daten gelöscht.
Es erfolgt ein kompletter Austausch der Daten.

Programm Sicherheitsprüfung verwenden

Sind Daten importiert, können Sie danach suchen.
Dazu stehen Ihnen 4 Suchfelder zur Verfügung.

Zum Starten der Suche drücken Sie die F3-Taste.

Durch einen einfachen Klick auf eine Spaltenüberschrift sortieren Sie das Ergebnis.
Klicken Sie auf eine Zeile und drücken STRG+C, um die Validierungsnummer in die Windows-Zwischenablage zu kopieren.

Suchergebnis und Validierungsnummer in Zwischenablage kopieren:

Daten der EU-Datenbank AUTOMATISCH ins TMS importieren

Je Datei wird eine zusätzliche Zeile mit dem Dateinamen in die Tabelle geschrieben und das Gültigkeits-datum auf den nächsten Tag gesetzt. Dieses Gültigkeitsdatum wird bei der Prüfung der Adressen im Auftrag verwendet. So wird sichergestellt, dass immer aktuelle Daten im TMS vorliegen. Dieses Datum ist einstellbar (bei Verwendung des neuen Webservices) und kann mit dem aktuellen Tagesdatum vorbelegt werden.

• Diese Daten können auch per Webservice automatisch ins TMS eingespielt werden.
  Alle 24 Stunden erfolgt dann zu einer festen und vereinbarten Uhrzeit der Datenimport.

Mit jeder automatischen Übernahme werden alle gültigen Daten im TMS Luftfracht → Sicherheitsprüfung angezeigt und die Veralteten gelöscht. Es erfolgt ein kompletter Austausch der Daten genau wie beim manuellen Datenimport.

Im Umgebungsmenü EDI → EDI-LOG können die Übertragungen überwacht und Details zu den importierten Datensätzen eingesehen werden.

Voraussetzung

Voraussetzung für die Nutzung dieser Funktion ist eine Anmeldung bei der EU-Kommission für die API.

Nach erfolgreicher Anmeldung vergibt die EU-Kommission einen Consumer Key und einen Consumer Secret. Diese Daten müssen zur Einrichtung der Schnittstelle an CargoSoft übermittelt werden.

Im EDI-Partner ist der EDI-Partner CHECKRKD notwendig.
Dieser wird automatisch bei Auslieferung der Schnittstelle durch CargoSoft angelegt.

Im Reiter Qualifier des EDI-Partners wird eingestellt, wie lange der importierte Datensatz gültig ist:

• Qualifier = ADD_DAYS

• Inhalt = Anzahl der Tage ( 0=Heute, 1=Morgen, 2 =Übermorgen, usw.)

• Als Standard wird der Wert 1 ausgeliefert.