UPS-Integration

Was ist UPS?

UPS (United Parcel Service) ist einer der größten Paketdienste der Welt, mit Boden-, Luftexpress- und internationalen Diensten. Software wird über die UPS APIs auf developer.ups.com angebunden: Transportial nutzt die Shipping API zum Buchen und Stornieren von Sendungen und die Tracking API zu deren Verfolgung.

Welche Daten zwischen UPS und Transportial fließen

• → Nach UPS

  Sendungen → UPS-Sendungen

  Wird ein Trip bestätigt, der unter einem Kapazitätsvertrag mit der UPS-Integration vergeben ist, wird jede Sendung auf Ihre UPS-Versendernummer gebucht. Jedes Paket aus den Waren wird ein UPS-Packstück mit Gewicht und Maßen, und die Sendungsnummer ist die Referenz.

• ← Nach Transportial

  Labels und Trackingnummern

  Pro Packstück wird ein Label an der Sendung gespeichert — als PDF im Format 4×6 Zoll oder als ZPL für Thermodrucker —, zusammen mit den Trackingnummern der Sendung.

• → Nach UPS

  Handelsrechnung für internationale Sendungen

  Internationale Sendungen erhalten Zolldaten aus den Waren: Beschreibung, Menge, Wert, Gewicht, HS-Code und Ursprung. Die Handelsrechnung von UPS wird an der Sendung abgelegt, und mit dem Incoterm DDP werden Zölle und Steuern Ihrem eigenen UPS-Konto belastet.

• → Nach UPS

  Stornieren vor der Abholung

  Stornieren Sie den Trip, werden seine noch nicht abgeholten UPS-Sendungen storniert (Void); Disponenten können auch eine einzelne Sendung an der Sendung stornieren.

• ← Nach Transportial

  Tracking, ETA und Abschluss der Stopps

  Status, Aktivitäten, die geplante Zustellung und wer das Paket quittiert hat, kommen an der Sendung zurück. Der erste Abholscan schließt den Ladestopp ab und die Zustellung den Entladestopp.

• ← Nach Transportial

  Anderswo gebuchte UPS-Nummern

  Fügen Sie einer Sendung eine beliebige UPS-Trackingnummer hinzu — etwa einer im UPS-eigenen Portal erstellten Sendung —, und Transportial verfolgt sie genauso.

So verbinden Sie UPS

1. Paketdienste werden pro Plattform aktiviert: Bitten Sie uns, sie für Ihr Transportial-Konto freizuschalten.

2. Legen Sie im UPS Developer Portal (developer.ups.com) eine App mit der Shipping und der Tracking API an, verknüpft mit Ihrem UPS-Konto, und notieren Sie Client-ID und Client-Secret.

3. Legen Sie die UPS-Integration in Transportial an: Client-ID und Secret, Ihre UPS-Versendernummer, den Standarddienst und das Labelformat (PDF oder ZPL). Sie können zunächst in der Testumgebung von UPS starten.

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

Synchronisationsintervalle und Grenzen

• Sendungen werden gebucht, sobald der Trip bestätigt ist; später hinzugefügte Sendungen beim nächsten Update des Trips, nie zweimal mit derselben Integration.
• Offene Trackingnummern werden standardmäßig alle 60 Minuten abgefragt — pro Integration einstellbar —, bis die Sendung zugestellt, retourniert oder storniert ist.
• Die UPS Tracking API nimmt eine Nummer pro Abfrage.
• UPS liefert Labels als Bild; Transportial macht aus jedem Label eine PDF-Seite im Format 4×6 Zoll oder speichert ZPL unverändert.
• Eine Sendung lässt sich nur stornieren, solange UPS sie noch nicht abgeholt hat.

Typischer Anwendungsfall

Ein Großhändler in Venlo versendet Ersatzteile an Werkstätten in ganz Europa und an einige Kunden in den USA. Palettenaufträge fahren die eigenen Lkw; Pakete werden auf einem Trip unter einem UPS-Kapazitätsvertrag geplant, mit UPS Standard als Standard und Express Saver für Eilaufträge. Mit der Bestätigung wird jede Sendung gebucht, und das Lager druckt Labels und Handelsrechnungen aus der Sendung. Der Abholscan schließt den Ladestopp, der Kundenservice sieht die geplante Zustellung, und der Entladestopp schließt sich, sobald UPS die Zustellung meldet.

Häufig gestellte Fragen