Einführung

Hiermit können Versand-Etiketten (Labels/Aufkleber) direkt aus der Bestellung heraus erstellt und gedruckt werden.

Bei einer Retoure kann das automatisch erstellte Retourenetikett per E-Mail direkt an den Kunden versendet werden.

Funktionen

Versand-Etiketten

Beim Öffnen einer Bestellung in der Administration erscheint eine separate Registerkarte  “UPS-Etiketten”. Bei Klick kommt man in den Bereich, zum Erstellen und Verwalten von UPS Versand- und Retouren-Etiketten.

Über den Button “Versand-Etikett hinzufügen” kann ein neues Label für den Versand erstellt werden.

In einem Pop-Up Fenster können folgenden Angaben gemacht werden:

Nach Bestätigung wird das Versand-Etikett erstellt und die Tracking-Nummer in der Bestellung gespeichert.

Danach kann das Versand-Etikett angezeigt und ausgedruckt werden. 

Beispiel: Einzel-Label

oder Multi-Label

Rücksende-Etiketten

Wenn die Bestellung storniert werden soll, kann bei Klick auf den Button “Rücksende-Etikett hinzufügen” ein neues Retouren-Label erstellt werden.

In einem Pop-Up Fenster können folgenden Angaben gemacht werden:

Nach der Erstellung kann das Retouren-Label direkt an den Kunden gesendet werden.

Konfiguration

Damit Sie in Ihrem Testsystem die Funktionen der UPS Integration testen können, aktivieren Sie den Testmodus. Damit können Sie kostenfrei beliebig viele Test-Etiketten erzeugen, die aber nicht für den physischen Versand verwendet werden können. 

Lediglich der Export-Upload ist im Testmodus eingeschränkt, da die UPS® API diesen Test nicht bereitstellt. Ein Upload, von z.B. Zolldokumenten für eine Bestellung ins nicht europäische Ausland, kann somit nur im Livebetrieb durchgeführt werden.

Für den Livebetrieb dann bitte den Testmodus wieder deaktivieren!

Zuordnung UPS Produkt in der Versandart

Bitte ordnen Sie in einer UPS Versandart auch immer das dazu passende UPS Produkt zu.  Erst dann ist. eine korrekte Labelerstellung z.B. per Mehrfachänderung möglich. 

Notwendige Apps in Ihrem UPS Konto

In Ihrem UPS Konto müssen mindestens folgende Apps aktiviert sein:
Authorization (OAuth), Rating, Shipping

Falls Sie auch Export-Dokumente zu UPS übermitteln möchten, bei Lieferungen ins Nicht-EU Ausland, muss zusätzlich die App “Paperless Documents” aktiv sein.

Falls Sie auch UPS On-Call Pickup® nutzen, muss zusätzlich die App “Pickup” aktiv sein. 

Wie Sie Apps im UPS Konto hinzufügen können, finden Sie auch hier in unseren FAQ!

Neue Funktionen / Änderungen

Version 5.1.4

Vorbelegung der Paketangaben bei Multi-Labels

Die Paketangaben bei Bestellung mit einem Gesamtgewicht von z.B. mehr als 25 kg werden nun automatisch berechnet und vorbelegt.

Speichern aller Trackingcodes für Multi-Labels

Ab sofort wird jeder einzelne Trackingcode von Multi-Labels in der Bestellung abgelegt. 

Version 4.6.0

Referenzfelder

In der Konfiguration kann nun festgelegt werden, ob die UPS Referenzfelder 1 + 2 vor der Labelerstellung dynamisch mit Produktnummern der Bestellung oder der Bestellnummer vorbelegt werden. Zusätzlich kann auch ein “Statischer Text” angefügt werden.

Dabei kann z.B. auch mit welcher Bedingungen festgelegt werden, in welches Referenzfeld Produktnummer einsortiert werden.

Beispiel: Alle Produktnummern, die mit “A1” anfangen, sollen in das Referenzfeld 1 vorbelegt werden.

Version 4.5.0

Zustellung nur mit Unterschrift

In der Konfiguration kann nun bestimmt werden, ob für die Übergabe der Sendung eine Unterschrift erforderlich ist oder sogar zusätzlich eine Übergabe nur an Volljährige erfolgen darf. Im Standard ist diese Option deaktiviert (=Nein).

Diese Einstellung wird auch bei einer Mehrfachänderung verwendet. Bei der Erstellung  eines Labels innerhalb einer Bestellung kann in der Registerkarte “Optionen” diese Voreinstellung noch manuell verändert werden.

Version 4.4.0

E-Mail Benachrichtigungen an Versender

Damit können auch Sie als Versender per E-Mail informiert werden. Sie können entscheiden, ob Sie automatische Versand- oder Lieferbenachrichtigungen erhalten möchten oder bei Ausnahmen oder Zustellproblemen informiert werden sollen

Version 4.3.0

UPS On-Call Pickup®

Aktivieren Sie diese Option, um UPS On-Call Pickup® zu nutzen. Falls Ihr UPS Fahrer täglich bei Ihnen abholt, benötigen Sie diese Option nicht.

Falls diese Konfiguration aktiv ist, wird auf der Registerkarte “UPS-Etiketten” einer Bestellung ein zusätzlicher Button “UPS On-Call Pickup®” angezeigt.

Dort können dann explizite Angaben zum gewünschten Dienst gemacht werden.

Version 4.2.0

Dokumenten-Upload für Lieferung ins NON-EU Ausland

Bei Bestellungen, deren Lieferadresse im Nicht-EU Ausland liegt, können ab sofort vor der Labelerstellung Export-Dokumente im PDF-Dateiformat wie z.B. Zoll Informationen oder Rechnungen an UPS übermittelt werden.

Sobald alle notwendigen UPS Dokumententypen hinzugefügt sind, müssen die Dateien durch Klick auf den roten Button an UPS übertragen werden. Bei Erfolg wird dies beim Dokument durch einen grünen Haken symbolisiert.

Danach kann wie gewohnt das Versand-Etikett erstellt werden.

Bitte beachten: Sofern die Lieferadresse im Nicht-EU Ausland liegt, erscheint am oberen Rand der zusätzliche Button “Export-Dokumente vorbereiten”. 

Die Export-Dokumente müssen vor der Labelerstellung an UPS übertragen werden. 

Ein nachträglicher Upload ist nicht mehr möglich!

Export-Dokumente können nur im Livemodus hochgeladen werden. 

Die von UPS bereitgestellte API erlaubt leider keine Test-Uploads!

Wahl des Medien-Ordners für Label PDF-Dokumente

Ab sofort werden PDF-Dokumente im Medien-Ordner “UPS Documents” abgelegt. Dieser Ordner kann an jede beliebige Stelle verschoben oder auch umbenannt werden.

Version 4.1.0

Labelerstellung per Mehrfachänderung in der Bestellübersicht

Ab sofort können auch Labels für mehrere Bestellungen über die Mehrfachänderung erstellt werden. Damit die Labels korrekt erstellt werden können, stellen Sie bitte sicher, dass in allen im Shop verfügbaren UPS® Versandarten auch UPS® Produkte zugeordnet sind.

Bitte beachten: Die Labeldaten werden direkt aus einer Bestellung übernommen und können bei der Mehrfachänderung nicht manuell geändert werden! 

Möchten Sie also z.B. Änderungen an der Empfänger-Adresse, den Paketangaben, Multi-Label oder Label Optionen vornehmen, erstellen Sie das Label bitte einzeln innerhalb der Bestellung.

Bitte beachten: Falls ein Label über die Mehrfachänderung nicht erstellt werden konnte, prüfen Sie bitte, ob das Gesamtgewicht der Bestellung z.B. 25Kg überschreitet. Dann muss die Lieferung nämlich in mehrere Pakete aufgeteilt werden und es handelt sich um ein Multi-Label.

Version 3.0.0

Multi-Labelfunktion mit Gewicht und Abmessungen

Ab sofort ist es möglich, in einer Bestellung mehrere Labels mit unterschiedlichem Gewicht und Abmessungen anzulegen. Sofern im Produkt Abmessungen wie Höhe, Breite und Tiefe hinterlegt sind, werden diese Abmessungen aufsummiert und als Standardwert im Label vorbelegt. Mit jedem Klick auf das (+) Symbol kann ein weiteres Label hinzugefügt werden. Mit jedem Klick auf das (-) Symbol kann ein Label entfernt werden.

Es wird dann ein PDF erstellt, in dem alle Multi-Labels der Bestellung enthalten sind. Labels für mehrere Pakete einer Bestellung müssen somit nicht mehr einzeln erstellt werden.

Version 2.0.0

Neue Autorisierungs-Methode OAuth 2.0 / Umstellung durch UPS

Für die Nutzung unserer Erweiterung benötigen Sie lediglich Ihre OAuth 2.0 Zugangsdaten. Hier eine Schritt-für-Schritt-Anleitung, wie Sie an die Daten kommen.

Falls Sie unsere Schnittstelle schon länger im Einsatz haben, beachten Sie bitte folgenden Hinweise:

Am 5. Juni 2023 begann UPS den Sunset-Prozess für die Authentifizierung von Zugriffsschlüssel zugunsten des sicheren OAuth 2.0-Modells für alle APIs. Diese Änderung wirkt sich auf alle UPS API-Integrationen aus und erfordert Aktualisierungen auch in Ihrer Anwendungsschnittstelle.

• Ab dem 3. Juni 2024 werden Ihre bisherigen API-Zugriffsschlüssel für die Authentifizierung nicht mehr unterstützt.

• Sie müssen daher rechtzeitig die neuen OAuth2.0-Anmeldedaten wie oben beschrieben beziehen und Ihre neue Client-ID und Client-Secret in der Konfiguration eintragen.

Version 1.1.4

Auswählbare UPS Produkte für Labelerstellung einschränken

Die hier in der Konfiguration hinterlegten UPS Produkte schränken die Auswahl der UPS Produkte für die Labelerstellung ein.

Wenn dort kein UPS Produkt hinterlegt ist, werden alle UPS Produkte zur Auswahl im Formular für die Labelerstellung angeboten (Standard bei Neuinstallation).

Obiges Beispiel sieht bei der Labelerstellung dann so aus:

FAQ

Wie komme ich an meine OAuth 2.0 Zugangsdaten?

Melden sich über das im UPS Entwicklerportal mit Ihren UPS Anmeldedaten oben rechts an (https://developer.ups.com/?loc=de_DE ).

Klicken Sie dann auf “Eine Anwendung erstellen” und danach auf “Apps hinzufügen”

Wählen Sie dann "Ich möchte die UPS Technologie in mein Unternehmen integrieren", geben das gewünschte UPS Konto an, mit dem Sie Labels erstellen möchten und klicken auf “Weiter”.

Das UPS Konto ist meist eine Buchstaben-/Zahlen-Kombination und muss in der Konfiguration im Feld “UPS-Kontonummer” hinterlegt werden (siehe auch unter “Konfiguration”).

Geben Sie dann die bevorzugte Kontaktperson für die API Anbindung in Ihrem Unternehmen an und klicken auf “Weiter”.

Vergeben Sie dann einen Appname, wie z.B. “SHOP_UPS” oder mit Ihrer Shop-Domain “MEINSHOP_DE_UPS” oder “MYSHOP_COM_UPS”. 

Geben Sie im Suchfeld “ship” ein und fügen durch klick auf das (+) Plus-Symbol das Produkt “Shipping” Ihrer App hinzu. 

Es müssen die beiden Produkte "Shipping" und “Rating” hinzugefügt werden!

Mit Klick auf das (+) Plus-Symbol, fügen Sie das Produkt “Rating” Ihrer App hinzu. 

Geben Sie im Suchfeld “ship” ein und fügen durch Klick auf das (+) Plus-Symbol auch das Produkt “Shipping” Ihrer App hinzu. 

Unsere Shopware 6 Erweiterung “Dynamische UPS Versandkosten” verwendet die gleichen UPS Produkte. Schreiben Sie uns gerne, falls Sie Fragen hierzu haben.

Klicken Sie dann auf “Speichern”.

Sie haben dann Zugang zu Ihrer Client-ID und Client-Secret. 

Bei Klick auf das kleine Kopieren Symbol können Sie sich den jeweiligen Wert in die Zwischenablage kopieren und in der Konfiguration unserer Erweiterung im Feld “Client-ID” bzw. “Client-Secret” eintragen (Windows <Strg>+<v>, Mac <Apfeltaste>+<v>).

Sobald Sie OAuth 2.0 Anmeldedaten verwenden, werden die Angaben der drei API Felder (API: Benutzer-ID, Passwort und Zugangsschlüssel) nicht mehr berücksichtigt und können auch gelöscht werden.

Meine UPS Anmeldedaten sind ungültig

Prüfen Sie, ob im Feld “API: Benutzer-ID” und “API: Passwort” Ihre E-Mail-Adresse und Passwort hinterlegt ist, mit der Sie sich auch an www.ups.com anmelden können. Wenn diese Zugangsdaten auch in der Konfiguration hinterlegt sind, muss der ”API Zugangstest” erfolgreich sein.

Die USP-Kontonummer ist in der Regel eine alphanumerische Zahl mit Buchstaben am Anfang, gefolgt von Zahlen.

Es wird keine richtige Sendungsnummer generiert und kein Barcode erstellt

Sobald Sie in der Konfiguration den Testmodus ausschalten, werden echte Tracking-Nummern und Labels mit Barcode erstellt.

Wie sollte der UPS Tracking-Link konfiguriert werden?

In Ihrer UPS Versandart (unter Einstellungen > Shop > Versand) können Sie folgenden Link eingeben: http://wwwapps.ups.com/WebTracking/processRequest?HTMLVersion=5.0&Requester=NES&AgreeToTermsAndConditions=yes&loc=de_DE&tracknum=%s 

Bei Verwendung in einem E-Mail Template wird der Platzhalter %s durch die gespeicherte Trackingnummer der Bestellung ersetzt.

Um die angezeigte Sprache auf der UPS Sendungsverfolgung-Seite zu ändern, stellen Sie in Ihrer Versandart oben rechts zuerst auf die gewünschte Sprache um und ersetzen dann den Parameter &loc=de_DE z.B. durch &loc=en_EN für eine englische Oberfläche.

Wie kann ich den Fehler “Quantum View Notification Memo cannot exceed the length of 150 characters” abstellen?

Wenn in Ihrer Konfiguration "Automatische Versandbenachrichtigungen?" aktiviert und ein E-Mail-Text mit mehr als 150 Zeichen hinterlegt ist, meldet UPS diesen Fehler, da UPS nur maximal 150 Zeichen verarbeiten kann. 

Kürzen Sie den E-Mail-Text auf weniger oder gleich 150 Zeichen und die Meldung verschwindet!