UPS API

Globe Pickup Points integriert sich mit UPS, einem weltweit tätigen Paketdienstleister, und ermöglicht den Bestellexport sowie den Druck von Versandlabels direkt aus Shopify. Mit dieser Integration können Sie:

Bestellungen direkt aus Shopify an UPS exportieren
Versandlabels direkt in Shopify drucken
15 inländische, europäische und weltweite UPS-Services nutzen
Internationale Pakete mit Zolldaten versenden, die automatisch aus Ihren Shopify-Produkten erzeugt werden

UPS wird auf Anfrage pro Shop freigeschaltet. Wenn Sie UPS nicht in der Spediteurliste sehen, kontaktieren Sie den Globe-Support, und wir aktivieren UPS für Ihren Shop.

UPS API-Integration aktivieren

Öffnen Sie in Ihrer Shopify-Verwaltung Globe Pickup Points und navigieren Sie zu Versandetiketten. Fügen Sie ein neues Spediteurkonto hinzu und wählen Sie UPS.
Tragen Sie Ihre Kontonummer ein — Ihre UPS-Versandkontonummer, die in den Details Ihres UPS-Abrechnungskontos angezeigt wird.
Füllen Sie die Absenderdaten aus: Name des Absenders, Straße des Absenders, Stadt des Absenders, PLZ des Absenders, Land des Absenders und Telefon des Absenders. E-Mail des Absenders ist optional.
Bundesland/Provinz des Absenders ist ein Bundesland- oder Provinzcode (zum Beispiel NY, CA). Er ist erforderlich, wenn Sie aus den Vereinigten Staaten oder Kanada versenden, und kann sonst leer bleiben.
Klicken Sie auf UPS-Konto verbinden. Es öffnet sich ein UPS-Fenster, in dem Sie sich mit Ihren UPS-Zugangsdaten anmelden und Globe autorisieren. Nach der Rückkehr ist die Verbindung gespeichert, und das Zugriffstoken wird automatisch erneuert — Sie müssen nirgends einen API-Schlüssel oder ein Passwort eingeben.
Konfigurieren Sie nach Bedarf die Fulfillment- und Tagging-Optionen.
Ordnen Sie Ihre Shopify-Versandmethoden den UPS-Services zu, die Sie in Ihrem Konto haben.

Sie können das UPS-Konto jederzeit auf demselben Bildschirm wieder trennen; der Export ist dann blockiert, bis es erneut verbunden wird.

Bestellungen exportieren und Labels drucken

Sie können Bestellungen direkt aus Shopify an UPS exportieren und Versandlabels drucken — einzeln oder im Stapel. Zum Label-Workflow selbst siehe Versandlabels erstellen.

Jede Sendung erhält eine UPS-Sendungsnummer, und das Labelbild wird bei der Bestellung gespeichert, sodass es später ohne erneuten Kontakt zu UPS nachgedruckt werden kann. Ist das gespeicherte Bild in Globe nicht mehr vorhanden, wird es über den UPS Label Recovery Service anhand der Sendungsnummer erneut abgerufen. Pakete werden unter https://www.ups.com/track?tracknum=<tracking number> verfolgt.

Servicetypen

Wählen Sie beim Export einer Bestellung den Service, der Ihrem UPS-Vertrag entspricht:

Code	Service	Typische Verwendung
03	UPS Ground	Bodentransport im Inland (USA)
11	UPS Standard	Straßentransport innerhalb Europas
01	UPS Next Day Air	Inland, Luftfracht am nächsten Tag
02	UPS 2nd Day Air	Inland, Luftfracht in zwei Tagen
12	UPS 3 Day Select	Inland, Luftfracht in drei Tagen
13	UPS Next Day Air Saver	Inland, nächster Tag, Tagesende
14	UPS Next Day Air Early	Inland, nächster Tag, früher Morgen
59	UPS 2nd Day Air A.M.	Inland, zwei Tage, Zustellung am Vormittag
07	UPS Worldwide Express	Internationaler Express
08	UPS Worldwide Expedited	International, tagesgenau
54	UPS Worldwide Express Plus	International, früher Morgen
65	UPS Worldwide Saver	Internationaler Express, Tagesende
96	UPS Worldwide Express Freight	Internationale Palettenfracht
71	UPS Worldwide Economy DDU	Economy, unverzollt
72	UPS Worldwide Economy DDP	Economy, verzollt

Nicht jeder Service ist in jedem Konto oder aus jedem Ursprungsland verfügbar — UPS lehnt eine Sendung ab, wenn Sie einen Service verwenden, für den Ihr Konto keinen Vertrag hat.

Nur Zustellung an Privat- und Geschäftsadressen

In Globe erstellte UPS-Labels sind immer an die Privat- oder Geschäftsadresse des Kunden aus der Shopify-Bestellung adressiert. Die Zustellung an UPS Access Point-Standorte wird nicht unterstützt — ein im Checkout ausgewählter Abholpunkt wird nicht an UPS übermittelt, und das Paket wird stattdessen an die Versandadresse zugestellt. Ordnen Sie einem UPS-Service daher keine Abholpunkt-Versandmethode zu. Retourenlabels werden ebenfalls nicht unterstützt.

Erweiterte Sendungsoptionen

Diese Optionen werden pro Sendung im Exportdialog gesetzt. Es handelt sich nicht um Einstellungen des Spediteurkontos — das UPS-Spediteurkonto bietet keine Möglichkeit, dafür Standardwerte zu speichern, setzen Sie sie also bei den Sendungen, die sie benötigen.

Option	Beschreibung
Verpackungstyp	Eigene Verpackung (Standard), UPS Brief, Tube, PAK, UPS Express Box, UPS 25KG Box, UPS 10KG Box
Inhaltsbeschreibung	Sendungsbeschreibung, die auf das Label gedruckt und in den Zollformularen verwendet wird. Standardwert ist `Goods`.
HS-Code	HS-Code, der in den Zollformularen dieser Sendung verwendet wird, wenn ein Produkt in Shopify keinen HS-Code hat.

Zoll und internationale Sendungen

Zollformulare (eine Handelsrechnung) werden automatisch hinzugefügt, wenn Absenderland und Zielland unterschiedlich sind und es sich nicht um eine innereuropäische Bewegung handelt. Globe erstellt die Rechnung aus den Positionen der Bestellung:

Produkttitel, Menge, Stückpreis und SKU
HS-Code aus dem Shopify-Inventarobjekt des Produkts, ersatzweise der HS-Code, der für diese Sendung im Exportdialog eingetragen wurde
Ursprungsland aus dem Shopify-Inventarobjekt des Produkts, ersatzweise das Absenderland
Artikelgewicht aus Shopify, umgerechnet in die Gewichtseinheit der Sendung

Die Rechnungsnummer ist die Shopify-Bestellnummer, der Exportgrund ist SALE, und die Währung ist die Bestellwährung. Gewichte werden in Kilogramm übermittelt, außer bei Absendern in den Vereinigten Staaten, Puerto Rico und den Amerikanischen Jungferninseln, wo Pfund verwendet werden.

Nachnahme (COD)

UPS unterstützt in Globe keine Nachnahme. Es wird kein Nachnahmebetrag an UPS übermittelt, eine an UPS exportierte Nachnahmebestellung wird also als gewöhnliches, vorausbezahltes Paket versendet, und bei der Zustellung wird kein Geld eingezogen. Verwenden Sie für solche Bestellungen einen Spediteur mit Nachnahme-Unterstützung, oder stellen Sie den Kunden vor dem Export auf eine Vorauszahlungsmethode um.

Lieferstatus

Die UPS-Integration synchronisiert Lieferstatus nicht zurück nach Shopify. Die Sendungsnummer und der Tracking-Link werden dem Fulfillment trotzdem beigefügt (sofern die automatische Erfüllung aktiviert ist), sodass der Zustellfortschritt auf ups.com verfolgt werden kann.

Labeldruck

UPS liefert ein Labelbild im Format 4×6 Zoll, das Globe in ein PDF umwandelt und für den Druck ins Hochformat dreht. Die folgenden Formate stehen zur Verfügung:

Format	Positionen pro Bogen
A6	1
A6 auf A4	4

Beim Druck von A6-Labels auf A4 können Sie die Startposition auf dem Bogen wählen (Positionen 1–4), um teilweise verbrauchte Bögen weiterzuverwenden.

Fehlerbehebung

Problem	Lösung
UPS-Konto ist nicht verbunden	Öffnen Sie die Einstellungen des Spediteurkontos und klicken Sie auf UPS-Konto verbinden, um die UPS-Anmeldung abzuschließen.
UPS-Authentifizierung fehlgeschlagen — Token möglicherweise abgelaufen	Die gespeicherte UPS-Autorisierung konnte nicht erneuert werden. Trennen Sie das UPS-Konto und verbinden Sie es erneut.
Ungültige oder abgelaufene Sitzung beim Verbinden	Die UPS-Anmeldung muss innerhalb von 10 Minuten abgeschlossen werden. Schließen Sie das Fenster und starten Sie die Verbindung erneut.
Sendungserstellung mit einer UPS-Meldung fehlgeschlagen	Die Meldung kommt direkt von UPS. Meist ist der Service für Ihr Konto nicht freigeschaltet, die Empfängeradresse ist unvollständig, oder die Kontonummer passt nicht zur Absenderadresse.
Bundesland/Provinz fehlt oder ist ungültig	Absender und Empfänger in den USA und Kanada benötigen einen gültigen Bundesland- oder Provinzcode. Füllen Sie Bundesland/Provinz des Absenders aus und prüfen Sie die Adresse des Kunden.
Es konnten keine Labels von UPS abgerufen werden	Das gespeicherte Labelbild fehlt, und die Label-Wiederherstellung ist fehlgeschlagen. Prüfen Sie, ob die Sendung eine Sendungsnummer hat und ob das UPS-Konto noch verbunden ist.
Nachnahmebestellung ohne Geldeinzug zugestellt	Das ist zu erwarten — UPS-Sendungen in Globe sind nie Nachnahmesendungen. Siehe Nachnahme (COD) oben.

Add UPS pickup points to your Shopify store — pricing, demo & setup →