ShippyPro API

Globe Pickup Points integriert sich mit ShippyPro, einer Multi-Spediteur-Versandplattform, über die Sie mit den Spediteurverträgen versenden, die Sie bereits in Ihrem eigenen ShippyPro-Konto verbunden haben. Mit dieser Integration können Sie:

Bestellungen direkt aus Shopify an ShippyPro exportieren
Versandlabels direkt in Shopify drucken
An Abholpunkte oder an die Adresse des Kunden liefern, je nach gewähltem Spediteurservice
Nachnahme (COD) und Zollanmeldungen (CN22) für grenzüberschreitende Sendungen nutzen

Bestellungen können in 33 Zielländer exportiert werden — die EU, das Vereinigte Königreich, die Schweiz, Norwegen, die USA, Kanada und Australien.

ShippyPro 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 ShippyPro.
Geben Sie Ihren API-Schlüssel ein — Sie finden ihn in Ihrem ShippyPro-Konto. Das ist die einzige zwingend erforderliche Zugangsangabe.
Klicken Sie auf Fetch carriers. Globe prüft den Schlüssel und lädt alle Spediteure und Services herunter, die mit Ihrem ShippyPro-Konto verbunden sind, damit Sie sie Shopify-Versandmethoden zuordnen können.
Füllen Sie die Absenderdaten aus, die auf das Label gedruckt werden: Name des Absenders, Firmenname des Absenders, Straße des Absenders, Stadt des Absenders, PLZ des Absenders, Land des Absenders (ein zweistelliger Code wie CZ, SK, HU), Telefon des Absenders und E-Mail des Absenders.
Konfigurieren Sie nach Bedarf die Fulfillment- und Tagging-Optionen — Bestellungen automatisch erfüllen, Bestellungen automatisch mit Sendungsverfolgungsnummer markieren und Benutzerdefiniertes Tag nach dem Export.
Ordnen Sie Ihre Shopify-Versandmethoden den heruntergeladenen Spediteurservices zu.

Es gibt in Globe keine separate ShippyPro-Sandbox — der API-Schlüssel, den Sie eintragen, erzeugt echte Sendungen in Ihrem Konto.

Bestellungen exportieren und Labels drucken

Sie können Bestellungen direkt aus Shopify an ShippyPro exportieren und Versandlabels drucken — einzeln oder im Stapel. Den vollständigen Workflow finden Sie unter Versandlabels erstellen.

Jeder Export erstellt die Sendung und liefert Sendungsnummer und Label in einem einzigen Aufruf, sodass die Labels sofort druckbereit sind. Der Name Ihrer Shopify-Bestellung wird als Sendungsreferenz und Notiz übermittelt. Nach dem Export wird die Sendungsnummer für die Sendungsverfolgung im Fulfillment verwendet — der von ShippyPro gemeldete Spediteur wird in Shopify als Versandunternehmen eingetragen.

Spediteure und Services

ShippyPro hat kein eigenes Netzwerk. Spediteure, Services und Preislisten stammen aus Ihrem ShippyPro-Konto, die Liste beim Export entspricht also genau dem, was Sie dort verbunden haben. Wenn Sie in ShippyPro einen neuen Spediteur hinzufügen, klicken Sie in den Globe-Einstellungen des Spediteurkontos erneut auf Fetch carriers, um ihn zu übernehmen.

Liefert Ihr Konto keine Spediteurliste (zum Beispiel wenn die ShippyPro API vorübergehend nicht verfügbar ist), wechselt Globe auf manuelle Eingabe und lässt Sie die Spediteurdefinition als JSON einfügen. Über Copy sample erhalten Sie das erwartete Format.

Abholpunkte vs. Heimlieferung

Enthält die Bestellung einen im Checkout ausgewählten Abholpunkt und exportieren Sie sie auf einem Abholpunkt-Service, übermittelt Globe die Punkt-ID als Spediteuroption an ShippyPro, sodass das Paket an diesen Punkt geleitet wird.
Services, deren Name sie als Heimlieferung kennzeichnet, stellen immer an die Versandadresse des Kunden zu, auch wenn der Bestellung ein Punkt beigefügt ist.

Die Abholpunkte selbst können von jedem Anbieter stammen, den Sie im Checkout einsetzen, oder vom Anbieter ShippyPro PUDO, der die Abholpunkte der Spediteure in Ihrem ShippyPro-Konto live abfragt. Siehe Abholpunkt-Spediteure hinzufügen.

Beim Export warnt Globe Sie mit einem Banner Type selection mismatch, wenn der gewählte ShippyPro-Spediteur nicht zu dem Spediteur zu passen scheint, zu dem der Abholpunkt auf der Bestellung gehört — zum Beispiel ein Packeta-Punkt, der auf einem GLS-Service exportiert wird. Der Export wird nicht blockiert, prüfen Sie das Banner also, bevor Sie fortfahren.

Paketgewicht und -abmessungen

ShippyPro verlangt ein echtes Gewicht. Globe erfindet niemals eines: Hat die Bestellung in Shopify kein Gewicht, wird der Export abgelehnt. Hinterlegen Sie Produktgewichte in Shopify und exportieren Sie erneut.

Paketabmessungen sind optional. Paketlänge (cm), Paketbreite (cm) und Pakethöhe (cm) sind erweiterte Optionen und keine Einstellungen des Spediteurkontos; ist kein Wert gesetzt, wird für jede Abmessung 1 cm übermittelt. Bietet der gewählte Spediteurservice eine Versicherungsoption, wird die Sendung mit der Bestellsumme versichert.

Zoll

Für grenzüberschreitende Sendungen erstellt Globe aus den Positionen der Bestellung eine CN22-Anmeldung — Beschreibung, Menge, Stückwert, Gewicht, HS-Code und Ursprungsland aus dem Inventarobjekt des Produkts. Wo die Produktdaten unvollständig sind, füllen diese Einstellungen des Spediteurkontos die Lücken:

Einstellung	Verwendet für
Land des Absenders	Ursprungsland, wenn ein Produkt keines hat
Contents type	Art der Waren, die auf dem CN22 deklariert werden (Merchandise, Geschenk, Dokumente, Warenmuster, Rücksendung)
DDP-Länder	Zielländer, die als DDP versendet werden (Zölle zahlen Sie); alle anderen Zielländer werden als DDU versendet

Inhaltsbeschreibung (die Beschreibung des Sendungsinhalts, standardmäßig Goods) und HS-Code (der Zolltarifcode, der verwendet wird, wenn ein Produkt keinen hat) sind keine Einstellungen des Spediteurkontos — sie sind erweiterte Optionen, die Sie pro Sendung im Exportdialog eintragen.

Nachnahme (COD)

ShippyPro unterstützt Nachnahme. Wenn bei der Bestellung noch ein Betrag einzuziehen ist, sendet Globe den Nachnahmebetrag zusammen mit der Bestellwährung, und ShippyPro reicht ihn an den Endspediteur weiter. Bestellungen ohne offenen Betrag werden als normale Sendungen exportiert. Ob Nachnahme tatsächlich verfügbar ist — und in welchen Währungen — hängt vom Spediteurvertrag hinter dem gewählten Service in Ihrem ShippyPro-Konto ab.

Lieferstatus

Die Lieferstatus-Synchronisation ist für ShippyPro nicht verfügbar — Paketstatus werden nicht nach Shopify zurückgeschrieben, der Fortschritt muss also in ShippyPro oder auf der Sendungsverfolgungsseite des Endspediteurs verfolgt werden. Die Sendungsnummer und der Tracking-Link werden dem Fulfillment trotzdem beigefügt. Retourenlabels werden ebenfalls nicht unterstützt; erstellen Sie sie direkt in ShippyPro.

Labeldruck

Die Labels werden beim Druck in der gewählten Größe von ShippyPro angefordert, und alle Labels eines Stapels werden zu einem einzigen mehrseitigen PDF zusammengeführt:

Format	Beschreibung
A6	Label in 10,5 × 14,8 cm gerendert
A4 (4-up)	Label in 21 × 29,7 cm gerendert

Da ShippyPro das Label selbst rendert, stammt das genaue Layout auf der Seite aus der Labelvorlage des Endspediteurs. Labels können jederzeit nachgedruckt werden — Globe ruft für jede Sendung eine frische Download-URL ab und greift ersatzweise auf die beim Export gespeicherte Label-URL zurück.

Fehlerbehebung

Problem	Lösung
„Invalid API key — please check your ShippyPro credentials“	Der Schlüssel wurde von ShippyPro abgelehnt. Kopieren Sie ihn erneut aus Ihrem ShippyPro-Konto und speichern Sie das Spediteurkonto.
„ShippyPro API key is not configured“	Das Feld für den API-Schlüssel ist im Spediteurkonto leer. Tragen Sie ihn ein und speichern Sie.
„No carriers configured. Use the ‘Fetch carriers’ button“	Die Spediteurliste wurde nie heruntergeladen. Öffnen Sie die Einstellungen des Spediteurkontos und klicken Sie auf Fetch carriers.
„Please select a carrier before exporting.“	Der für die Bestellung gewählte Service ist nicht in der heruntergeladenen Liste enthalten — meist nach einer Änderung der Liste. Laden Sie die Spediteure erneut und ordnen Sie die Versandmethode neu zu.
„Order has no weight set.“	ShippyPro verlangt ein Gewicht größer als null. Hinterlegen Sie Produktgewichte in Shopify und exportieren Sie erneut.
Export mit einer Spediteur-Fehlermeldung abgelehnt	ShippyPro reicht den Validierungsfehler des Endspediteurs samt Lösungsvorschlag durch — typischerweise eine unvollständige Adresse, ein nicht unterstütztes Zielland oder ein Service, der für Ihr Konto nicht freigeschaltet ist.
Paket an die Adresse statt an den Abholpunkt versendet	Für den Spediteurservice ist keine Abholpunkt-Option hinterlegt. Klicken Sie erneut auf Fetch carriers, um die Spediteuroptionen zu aktualisieren, und exportieren Sie erneut.
„Could not retrieve label for order …“	Weder die frische noch die gespeicherte Label-URL konnte heruntergeladen werden. Warten Sie einen Moment und drucken Sie den Stapel erneut; schlägt es weiterhin fehl, exportieren Sie die Bestellung erneut.

Browse all supported carriers in Globe for Shopify — pickup points & label printing →