Handbuch
Mit dem UPS-Label druckt der Kunde seinen Retourenaufkleber selbst, abgegeben im UPS Access Point.
UPS lässt sich zusätzlich zum DHL-Label oder an dessen Stelle anbieten. Das Plugin meldet sich per OAuth bei UPS an und bestellt das Label mit deiner Kunden-Nummer; die Pakete gehen an die Anschrift, die du im Reiter „Empfänger“ einträgst. Der Kunde druckt das Label aus und gibt das Paket in einem UPS Access Point ab.
Im AdminBestellungen › Rücksendungen › Seitenmenü Versand › UPS
Vor dem Start
Welche Daten von UPS brauchst du für das Retourenlabel?
Für UPS-Labels braucht das Plugin drei Angaben aus deinem UPS-Konto und eine Anschrift, an die die Pakete gehen. Vor jedem Label holt es mit Client-ID und Secret einen OAuth-Token und bestellt danach das Label bei UPS.
Von UPS:
- die 6-stellige Kunden-Nummer; die Anfrage nennt sie als Versendernummer und als Konto, über das UPS abrechnet
- die OAuth-Client-ID
- das OAuth-Client-Secret
Die Anschrift trägst du selbst ein: Firma, Straße mit Hausnummer, Postleitzahl, Stadt, Land, Ansprechpartner und Telefonnummer.
Was bekommt der Kunde bei UPS?
Bei UPS gibt es das Label zum Ausdrucken; einen QR-Code liefert UPS nicht. Der Kunde druckt das Label, klebt es aufs Paket und gibt es in einem UPS Access Point ab. Alles, was für beide Dienstleister gilt, etwa mehrere Pakete oder das kostenpflichtige Label, zeigt das Kapitel Labels.
Beim Anlegen steht UPS mit „Label zum Ausdrucken“.
Auf der Seite der Rücksendung heißt es: „Das Label ausdrucken und auf das Paket kleben.“
Label ausdrucken lädt das Label als GIF, benannt etwa „ups-retoure-label-50287.gif“.
Die Sendungsnummer, hier „1Z000AA10000000001“, führt zur Sendungsverfolgung auf ups.com.
Abgabe im UPS Access Point; sobald das Paket da ist, ändert sich rechts im Kopf der Stand.
UPS-Zugangsdaten anlegen
Sieben Schritte bis zum ersten UPS-Retourenaufkleber
Das Beispiel richtet UPS für Deutschland ein, gültig in allen Verkaufskanälen. Für jedes weitere Land kopierst du den Datensatz danach.
- 1
Klicke unter Versand › UPS auf UPS-Zugangsdaten anlegen.
- 2
Wähle in den Stammdaten nach dem Namen das Land der Lieferadressen, für die der Datensatz gilt.
- 3
Trag unter Zugangsdaten Kunden-Nummer, OAuth-Client-ID und OAuth-Client-Secret ein.
- 4
Fülle den Reiter Empfänger mit der Anschrift, an die UPS die Pakete bringt.
- 5
Speichern legt den Datensatz an und gibt den Reiter Sandbox frei.
- 6
Prüfe im Reiter Sandbox zuerst mit OAuth-Token prüfen die Anmeldung, dann mit UPS-Label erstellen ein ganzes Label.
- 7
Schalte in der Konfiguration, Karte UPS, UPS-Label anbieten ein und speichere.
Auch der Einrichtungsassistent schaltet UPS ein, im Schritt „Versand und Labels“; siehe Einrichten.
Stammdaten und Optionen: für welche Bestellungen, und kostet das Label etwas?
Diese beiden Reiter sind bei UPS gebaut wie bei DHL. Das Land der Stammdaten wählt den Datensatz nach der Lieferadresse des Kunden, und ein Datensatz mit Verkaufskanal geht einem für alle Verkaufskanäle vor. Die Regeln mit Beispielen zeigt das Kapitel DHL-Label.
Land: Die Lieferadresse des Kunden liegt in diesem Land. UPS-Zugänge gibt es je Land und Verkaufskanal, nicht nur für Deutschland.
Verkaufskanal: Ohne Auswahl gilt der Datensatz überall.
Im Reiter Optionen macht Aktivieren das UPS-Label für dieses Land kostenpflichtig; unter Produkt steht das Label-Produkt, etwa „UPS-Label“ für 4,95 €.
Zugangsdaten: Kunden-Nummer, Client-ID und Secret
Die drei Felder sind Pflicht. Sie stehen als Text da, auch das Secret ist lesbar.
Kunden-Nummer: die 6-stellige UPS-Kundennummer; über dieses Konto rechnet UPS die Labels ab.
OAuth-Client-ID: die Kennung deiner Anwendung bei UPS.
OAuth-Client-Secret: zusammen mit der Client-ID holt das Plugin damit vor jedem Label einen Token.
Empfänger: wohin UPS die Retouren bringt
Der Reiter „Empfänger“ hält die Anschrift deines Lagers oder Shops. Sie geht mit jedem Label an UPS und ist das Ziel des Pakets; alle Felder außer der E-Mail-Adresse sind Pflicht.
Firma: der Name des Unternehmens, das die Rücksendung empfängt.
Straße + Hausnummer stehen in einem Feld.
Land als ISO-2-Code, etwa „DE“. Es ist das Land des Ziels und hat mit dem Land der Stammdaten nichts zu tun: Ein Datensatz für Österreich kann seine Pakete nach Deutschland schicken.
Ansprechpartner: wen UPS bei Bedarf erreicht.
Telefonnummer nur aus Ziffern, ohne Leerzeichen, Satz- und Sonderzeichen.
E-Mail-Adresse ist freiwillig; sie bleibt am Datensatz, UPS bekommt sie nicht.
Sandbox: erst die Anmeldung, dann ein Probelabel
Der Reiter „Sandbox“ hat bei UPS zwei Knöpfe. Beide speichern zuerst den Datensatz, und beide laufen auch, solange „UPS-Label anbieten“ noch aus ist. Das Land ist aus den Stammdaten übernommen und gesperrt.
OAuth-Token prüfen fragt UPS nur nach einem Token, ohne Label. So siehst du, ob Client-ID und Secret stimmen; ins Protokoll schreibt dieser Knopf nichts.
Passt die Anmeldung, meldet die Seite „UPS-Zugangsdaten korrekt“ mit „Der OAuth-Token wurde von der UPS-Schnittstelle akzeptiert.“
UPS-Label erstellen holt einen Token und bestellt ein Probelabel über 1 kg von der Adresse darüber an die Anschrift aus „Empfänger“, abgerechnet über die Kunden-Nummer.
Klappt auch das, steht dort „Mit den hinterlegten UPS-Zugangsdaten konnte erfolgreich ein Label erzeugt werden.“; sonst die Antwort von UPS im Wortlaut.
Die Karte „UPS“ in der Konfiguration
Was regelt die Karte „UPS“ in der Konfiguration?
In der Karte „UPS“ schaltest du das UPS-Label ein und legst fest, für wen es gilt. Einen Schalter für den QR-Code gibt es hier nicht, weil UPS nur das Label liefert.
So findest du sie in der Konfiguration (Bestellungen › Rücksendungen › Seitenmenü System › Einstellungen):
Karte UPS › UPS-Label anbietenKunden können UPS als Versandweg wählen und bekommen ein UPS-Label, wenn Zugang, Kundengruppe, Mindestwarenwert und Frist passen. Aus: UPS steht beim Anlegen nicht zur Wahl.
Karte UPS › Mehrere Labels je Rücksendung erlaubenDer Kunde kann für mehrere Pakete mehrere Labels erstellen, höchstens fünf je Rücksendung; nach dem ersten Label weist die Seite darauf hin. Aus: ein Label je Rücksendung.
Karte UPS › Gültige KundengruppenDas UPS-Label gibt es nur für Kunden dieser Kundengruppen, die anderen wählen einen anderen Versandweg. Leer: jede Kundengruppe.
Karte UPS › Mindestwarenwert (netto)Ist der Warenwert der Rücksendung (netto, in der Währung der Bestellung) höchstens so groß, bekommt der Kunde kein Label, sondern einen Hinweis. 0: keine Grenze.
Karte UPS › Logo im Versand zeigenZeigt beim Anlegen das Logo neben UPS, wo der Kunde den Versand wählt. Aus: nur der Name.
Karte UPS › LogoDas Logo neben UPS, gezeigt als Kachel von 96 × 32 Pixeln. Die Erweiterung bringt eins mit, ein eigenes Bild ersetzt es.
Liste und Fehlersuche
Die Liste „UPS“ mit Kunden-Nummer und Client-ID
Die Liste zeigt je Datensatz Name, Kunden-Nummer, OAuth-Client-ID, Land und Verkaufskanal, neueste oben; das Secret steht nicht in der Liste. Für Österreich kopierst du den deutschen Datensatz und änderst Land, Verkaufskanal und bei Bedarf die Anschrift.
Kunden-Nummer: das UPS-Konto des Datensatzes.
OAuth-Client-ID: die Anwendung, mit der sich das Plugin anmeldet.
Verkaufskanal: „Alle Verkaufskanäle“ steht hellgrau, wenn keiner gewählt ist.
Solange es keinen Datensatz gibt, steht dort „Noch keine UPS-Zugangsdaten“ mit dem Knopf zum Anlegen.
Im Zeilenmenü stehen Bearbeiten, Kopieren und Löschen; die Kopie heißt wie das Original mit „(Kopie)“ und hat kein kostenpflichtiges Label.
Wenn UPS kein Label liefert
Ein abgelehntes UPS-Label steht als Fehlversuch an der Rücksendung, mit der Meldung von UPS, und der Kunde sieht, dass das Label nicht erstellt werden konnte. Klappt schon die Anmeldung nicht, scheitert jedes Label; das zeigt „OAuth-Token prüfen“, ohne ein Label zu bestellen.
So findest du sie in der Konfiguration (Bestellungen › Rücksendungen › Seitenmenü System › Einstellungen):
Karte UPS › Anfragen protokollierenHält jede Anfrage an die Schnittstelle und jede Antwort in den Ereignis-Logs von Shopware fest (Einstellungen, System, Ereignis-Logs), samt der gesendeten Zugangsdaten.
Prüfe der Reihe nach:
- OAuth-Client-ID und Secret, mit „OAuth-Token prüfen“
- die Kunden-Nummer, 6-stellig
- im Reiter „Empfänger“ das Land als ISO-2-Code und die Telefonnummer nur aus Ziffern
Was sich geändert hat
Was aus den fünf Einstellungen wurde
Früher hatte UPS fünf Einstellungen. Vier gibt es weiter, mit klareren Namen in der Karte „UPS“; „Label speichern“ ist entfallen, weil jedes Label gespeichert bleibt. Neu sind der Mindestwarenwert und das Logo. Den Zugang mit OAuth und die vollständige Anschrift im Reiter „Empfänger“ hat jeder Datensatz.
| Bisher | Jetzt |
|---|---|
| UPS Label aktivieren | „UPS-Label anbieten“ |
| Label speichern | entfallen; jedes Label bleibt gespeichert |
| Mehrere Labels aktivieren | „Mehrere Labels je Rücksendung erlauben“ |
| Protokoll aktivieren | „Anfragen protokollieren“, in den Ereignis-Logs |
| Gültige Kundengruppen | gleicher Name |
| neu | „Mindestwarenwert (netto)“, „Logo im Versand zeigen“ und „Logo“ |
Alte UPS-Labels fehlen nach dem Update an den Rücksendungen, ihre Sendungsnummern bleiben; mehr im Kapitel Update.
Häufige Fragen
Wie bekommt der Kunde einen UPS-Retourenaufkleber?
Wählt er beim Anlegen UPS, entsteht das Label beim Absenden der Rücksendung. Er lädt es auf der Seite der Rücksendung als GIF, druckt es aus, klebt es aufs Paket und gibt das Paket in einem UPS Access Point ab.
Welche Zugangsdaten braucht das UPS-Label?
Die 6-stellige Kunden-Nummer, eine OAuth-Client-ID und das OAuth-Client-Secret, dazu im Reiter „Empfänger“ die Anschrift, an die UPS die Pakete bringt.
Gibt es bei UPS einen QR-Code?
Nein. UPS liefert nur das Label zum Ausdrucken. Einen QR-Code für die Filiale gibt es beim DHL-Label.
Was prüft „OAuth-Token prüfen“?
Nur die Anmeldung bei UPS mit Client-ID und Secret, ohne ein Label zu bestellen. „UPS-Label erstellen“ bestellt danach ein echtes Probelabel über 1 kg.
Gilt das UPS-Label nur für Deutschland?
Nein. Je Land und Verkaufskanal gibt es einen eigenen Datensatz; es gilt der Datensatz zum Land der Lieferadresse des Kunden.
Warum steht das Land im Reiter „Empfänger“ als Code?
UPS erwartet das Land der Anschrift als ISO-2-Code, etwa „DE“ für Deutschland. Es ist das Ziel des Pakets und unabhängig vom Land der Stammdaten.
Kann ich das UPS-Label kostenpflichtig machen?
Ja, im Reiter „Optionen“ des Datensatzes mit „Aktivieren“ und einem Label-Produkt. Der Kunde kauft das Label dann über den Warenkorb und erstellt es nach der Zahlung.
Weitere Kapitel