DSV-Integration

Was ist DSV?

DSV ist ein weltweites Transport- und Logistikunternehmen für Straßen-, Luft-, See- und Bahnfracht. Software verbindet sich über die generischen APIs von DSV auf developer.dsv.com: Transportial nutzt die Booking API zum Buchen, die Label Printing API für Packstücketiketten, die Tracking API für Meilensteine und die Document Download API für Zustellnachweise.

Welche Daten zwischen DSV und Transportial fließen

• → Nach DSV

  Sendungen → DSV-Buchungen

  Wird ein Trip bestätigt, der unter einem Kapazitätsvertrag mit der DSV-Integration vergeben ist, wird jede Sendung auf Ihr MDM-Konto bei DSV gebucht: Straße (Sammelgut und Teilladungen je Packstück oder Ladungen nach Lademetern), Luftfracht, Seefracht (LCL oder FCL mit den Containertypen) oder Bahn. Das Produkt folgt dem Verkehrsträger des Trips, sofern Sie keines wählen; die Waren liefern Gewicht, Maße, Volumen, Lademeter, Verpackungsart und ADR-Angaben, der Auftrag den Incoterm, und die Lade- und Entladefenster werden als Ortszeiten übermittelt.

• ← Nach Transportial

  Zuerst die Buchungsnummer, dann Sendungsnummer und Etikett

  DSV bestätigt eine Buchung mit einer Buchungsnummer. Sobald DSV sie verarbeitet hat, kommen die DSV-Sendungsnummer, der Luftfrachtbrief oder das Konnossement und das Packstücketikett (PDF oder ZPL) an die Sendung.

• ← Nach Transportial

  Meilensteine und Abschluss der Stopps

  Buchung, Abholung, Abfahrt und Ankunft in Häfen und an Flughäfen, Export- und Importverzollung, Zustellfahrt, Zustellung und Probleme wie ein Zollstopp kommen zur Ortszeit ihres Geschehens an die Sendung zurück. Die Abholung schließt den Ladestopp ab, die Zustellung den Entladestopp; der Zustellnachweis wird gespeichert, sobald DSV ihn bereitstellt.

• ← Nach Transportial

  Anderswo gebuchte DSV-Nummern

  Fügen Sie einer Sendung eine DSV-Buchungs- oder -Sendungsnummer hinzu — auch von einer DSV-XPress-Sendung —, um eine in myDSV oder von Ihrem Lieferanten gebuchte Sendung zu verfolgen.

So verbinden Sie DSV

1. Paket- und Frachtdienstleister werden pro Plattform freigeschaltet: Bitten Sie uns, sie für Ihr Transportial-Konto zu aktivieren.

2. Registrieren Sie sich im DSV-Entwicklerportal (developer.dsv.com) und abonnieren Sie die Access-Token-, Booking-, Tracking- und Label-Printing-API (und Document Download für Zustellnachweise). Notieren Sie die Abonnementschlüssel und Ihre MDM-Kontonummer und legen Sie einen myDSV-Benutzer für die API an.

3. Legen Sie die DSV-Integration in Transportial an: myDSV-Benutzername und -Passwort, die MDM-Nummer als Kontonummer, den Abonnementschlüssel — einen für alle DSV-APIs oder einen je API —, das Standardprodukt oder „Verkehrsträger des Trips“, den Standard-Incoterm und das Etikettenformat. Sie können in der Demo-Umgebung von DSV beginnen.

4. Stellen Sie bei einem Kapazitätsvertrag diese Integration als Kommunikationsmethode ein. Trips, die unter diesem Vertrag vergeben werden, werden bei DSV gebucht, sobald Sie sie bestätigen.

Synchronisationsintervalle und Grenzen

• Gebucht wird, wenn der Trip bestätigt wird; später hinzugefügte Sendungen werden bei der nächsten Trip-Änderung gebucht, nie zweimal mit derselben Integration.
• Bevor eine Buchung rausgeht, prüft Transportial, was DSV je Verkehrsträger verlangt — Postleitzahlen, Feldlängen, Maße oder Volumen, Container bei FCL, UN-Nummer, Klasse und Verpackungsgruppe für Gefahrgut auf der Straße — und nennt, was fehlt.
• Offene Buchungen werden standardmäßig alle 60 Minuten abgefragt — je Integration einstellbar —, bis DSV sie als zugestellt oder storniert meldet; eine Buchung, die DSV noch nicht kennt, wird einfach erneut abgefragt.
• Bei Luftfracht zeigt das Integrationsprotokoll das frachtpflichtige Gewicht (tatsächlich oder volumetrisch mit 6.000 cm³ je kg, je nachdem, was höher ist).
• Die Buchungs-API von DSV kann nicht stornieren: Stornieren Sie eine Buchung in myDSV oder bei Ihrer DSV-Niederlassung.

Typischer Anwendungsfall

Ein Spediteur in Rotterdam versendet Maschinenteile per Straße an Kunden in Deutschland und Ersatzteile per Luftfracht in die USA. Straßensendungen werden auf einem Trip unter einem DSV-Vertrag geplant, Luftfrachtsendungen auf einem Trip mit Verkehrsträger Luft; mit der Bestätigung der Trips werden sie bei DSV gebucht. Die Etiketten erscheinen an den Sendungen, sobald DSV die Buchungen verarbeitet hat, der Kundenservice sieht Abflug, Ankunft und Verzollung, und der Entladestopp wird abgeschlossen, wenn DSV die Zustellung meldet.

Häufig gestellte Fragen