/
NCT - CSV Schnittstelle

NCT - CSV Schnittstelle

1   Allgemein

1.1   Einführung

Nachfolgend wird die Schnittstelle beschrieben, die Shiptrack.com im CSV-Format anbietet. Diese Dokumentation beschreibt CSV-Dateien, die aus der ecovium-Struktur aufgebaut sind und soll Ihnen als unterstützendes Mittel bei der Schnittstellenentwicklung dienen.

 

2   Ablage der Trackingdaten

Zur Ablage der Trackingdaten, die Sie später mit Hilfe dieses Dokumentes erstellt haben, gibt es zwei Möglichkeiten.

2.1    Datenablage bei ecovium

Die Datenablage erfolgt nur über FTP - Server. Sie können mitentscheiden, ob eine SFTP Anbindung, oder eine FTP Anbindung für Sie in Frage kommt. Die Zugangsdaten zu Ihrem persönlichen FTP-Verzeichnis fragen Sie bitte bei ecovium an.

2.1.1    Ablage auf einem FTP-Server

Diese Variante der Datenablage benutzt in der Regel den Port 21 und ist eine unverschlüsselte Verbindung.

2.1.2    Ablage auf einem SFTP-Server

Diese Variante verwendet in der Regel ebenfalls den Port 21 bei ecovium, aber beinhaltet zusätzliche SSL-Einstellungen, die dafür sorgen, dass Daten in beide Richtungen verschlüsselt übertragen werden.

2.2    Datenablage bei Ihnen oder einem Drittanbieter

Es besteht auch die Möglichkeit, dass Sie die Daten auf Ihrem eigenen (S)FTP – Server ablegen. In diesen Fall benötigen wir allerdings folgende Verbindungsinformationen zum entsprechenden Server:

Name

Datentyp

Beschreibung

(S)FTP Port

Integer

Login Port für den FTP-Server (meistens 21 bei FTP oder 22 bei SFTP)

(S)FTP IP Adresse / Servername

String

Adresse des Servers

(S)FTP Ordner

String

Ablageverzeichnis/ Ablageordner des (S)FTP Servers

Username

String

Login Benutzername für den Server

Passwort

String

Login Passwort für den Server

 

2.3    Bereitstellungszeiten der Daten

Um den Datenfluss von Trackinginformationen optimal zu regeln und dem Kunden möglichst aktuelle Trackinginformationen bereitzustellen, ist es für uns notwendig, eine Auskunft darüber zu bekommen, in welchen Intervallen Sie die Trackingdaten auf unserem bzw. auf Ihrem Server bereitstellen.

Inhalt

 

 

3    Beschreibung der Datei

3.1    Dateinamen

Die Namenskonvention bleibt Ihnen frei überlassen. Allerdings muss jede Datei mit Statusrückmeldungen, die Sie uns übergeben die Dateiendung .csv besitzen. 

Um ein Überschreiben vorhandener Dateien zu verhindern wäre es von Vorteil, wenn jede Datei einen eigenen Namen besitzt. Dies kann z.B.: durch eine fortlaufende Nummer, oder durch das Nutzen des aktuellen Datums + Uhrzeit erfolgen.

Bsp.:

000000001.csv, 000000002.csv, 000000003.csv, … 100000001.csv, 100000002.csv

20151221081025.csv, 20151221091026.csv, 20151221101029.csv,

3.2    Dateicodierung

Die Kodierung der Dateien wird (wie in der Musterdatei unter Punkt 7 aufgeführt) als UTF8 erwartet.

3.3    CSV-Felder

3.3.1    Pflichtfelder

Einige Felder im CSV Format wurden von ecovium als Pflichtfelder definiert, die immer in einem CSV Dokument vorkommen müssen (siehe Punkte 5.1 und 6.1).

3.3.1    Optionale Felder

Die übrigen Felder sind sogenannte optionale Felder, die nicht immer in einem CSV Dokument vorkommen müssen. Dies kann z.B. daran liegen, dass Sie das Feld nicht kennen oder nicht befüllen können, da Sie die Daten dazu nicht bereitstellen bzw. übergeben können (siehe Punkte 5.2 und 6.2).

 

 

 

4    Modifizierungen

4.1    CSV-Veränderungen

Ecovium behält sich das Recht vor, das CSV jederzeit zu ändern. Eine Veränderung kann z.B. dann erfolgen, wenn Felder hinzugefügt bzw. entfernt werden.

4.2    Kundenbenachrichtigungen

Sofern wir Veränderungen am CSV Format durchführen, die für Sie relevant sind, werden wir Sie darüber zeitnah informieren, sofern Sie uns Kontaktinformationen mitgeteilt haben.

 

 

 

5    Felder mit Sendungsdaten

Die folgenden Felder enthalten Informationen über die Sendung. Bitte beachten Sie die Zuordnung der Felder in die Kategorien „Pflichtfelder“ und „Optionale Felder“.

5.1    Pflichtfelder

Name

Vorkommen

Typ

Beschreibung

Min.

Max.

shipment_tracking_id

1

1

String

Eindeutige Sendungsnummer

5.2    Optionale Felder

Name

Vorkommen

Typ

Beschreibung

Min.

Max.

send_versanddatum

0

1

Date

Datum an dem die Sendung versendet wurde; Format dd/MM/yyyy

carrier_name

0

1

String

Frachtführer/ Spedition

send_referenznr_01

0

1

String

1 Referenznummer des Kunden

send_referenznr_02

0

1

String

2 Referenznummer des Kunden

send_referenznr_03

0

1

String

3 Referenznummer des Kunden

send_referenznr_04

0

1

String

4 Referenznummer des Kunden

send_referenznr_05

0

1

String

5 Referenznummer des Kunden

send_gewichtgesamt

0

1

String

Gesamtgewicht der Sendung

send_service_code

0

1

String

Servicecode zur Sendung*1

send_service_details

0

1

String

Beschreibung zum verwendeten Servicecode*1

abs_adr_nr

0

1

String

Kundennummer des Absender (vom Spediteur)

abs_land

0

1

String

Land des Absender

abs_land_kurz

0

1

String

Zweistelliges Absenderländerkürzel (ISO3166)*4

abs_staat

0

1

String

Staat des Absender

abs_adr_01

0

1

String

Erste Adresse des Absenders

abs_adr_02

0

1

String

Zweite Adresse des Absenders

abs_adr_03

0

1

String

Dritte Adresse des Absenders

abs_strasse

0

1

String

Straße des Absenders

abs_hnr

0

1

String

Hausnummer des Absenders

abs_plz

0

1

String

Postleitzahl des Absenders

abs_ort

0

1

String

Ort des Absenders

abs_geodat_longitude

0

1

String

Längengrad der Position des Absenders*5

abs_geodat_latitude

0

1

String

Breitengrad der Position des Absenders*5

abs_mail

0

1

String

E-Mail Adresse des Absenders

abs_telefon

0

1

String

Telefonnummer des Absenders

abs_telefax

0

1

String

Fax des Absenders

empf_adr_01

0

1

String

Empfänger Adresse 01*2

empf_adr_02

0

1

String

Empfänger Adresse 02*2

empf_adr_03

0

1

String

Empfänger Adresse 03*2

empf_adr_04

0

1

String

Empfänger Adresse 04*2

empf_adr_05

0

1

String

Empfänger Adresse 05*2

empf_fax

0

1

String

Fax des Empfängers

empf_kdnr

0

1

String

Kundennummer des Empfängers (vom FF)

empf_hnr

0

1

String

Hausnummer des Empfängers

empf_iso

0

1

String

Iso Code für das Empfängerland*4

empf_land

0

1

String

Land des Empfängers

empf_ort

0

1

String

Ort des Empfängers

empf_plz

0

1

String

Postleitzahl des Empfängers

empf_staat

0

1

String

Staat des Empfängers

empf_strasse

0

1

String

Straße des Empfängers

empf_geodat_longitude

0

1

String

Längengrad der Position des Empfängers*5

empf_geodat_latitude

0

1

String

Breitengrad der Position des Empfängers*5

empf_tel

0

1

String

Telefonnummer des Empfängers

empf_mobile

0

1

String

Mobilnummer des Empfängers

empf_land_kurz

0

1

String

Zweistelliges Absenderländerkürzel (ISO3166)*3

empf_mail

0

1

String

E-Mail Adresse des Empfängers

empf_postfach

0

1

String

Postfach des Empfängers