SPS API

Globe Pickup Points integriert sich über die WebShip SOAP API mit SPS (Slovak Parcel Service) und ermöglicht den Bestellexport sowie den Druck von Versandlabels direkt aus Shopify. Mit dieser Integration können Sie:

Bestellungen direkt aus Shopify an SPS WebShip exportieren
Versandlabels direkt in Shopify drucken
An Balíkovo-Abholpunkte, SPS-Paketterminals oder an die Adresse des Kunden liefern
Nachnahme mit Auszahlung auf Ihr Bankkonto nutzen

SPS 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 SPS.
Geben Sie Benutzername und Passwort ein — das sind Ihre WebShip-Zugangsdaten. Wenden Sie sich an Ihren SPS-Vertriebsbeauftragten, um den Webservice-Zugang zu erhalten.
Wenn Sie Nachnahme nutzen, geben Sie die Nachnahme-IBAN und den Nachnahme SWIFT/BIC des Bankkontos ein, auf das SPS das eingezogene Geld auszahlen soll.
Optional können Sie einen Standard-Versicherungswert festlegen, der für alle Sendungen gilt. Wenn Sie das Feld leer lassen, wird die Bestellsumme verwendet.
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 SPS-Services zu, die Sie mit dem Spediteur vereinbart haben.

Es gibt keine SPS-Testumgebung — WebShip hat einen einzigen Produktiv-Endpunkt, sodass die Zugangsdaten, die Sie eintragen, echte Sendungen erzeugen.

Bestellungen exportieren und Labels drucken

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

Jede Sendung wird in einem einzigen API-Aufruf angelegt und ihr Label erzeugt, sodass die Labels unmittelbar nach dem Export druckbereit sind. Als Paketreferenz wird der Name Ihrer Shopify-Bestellung ohne führendes # an SPS übermittelt, bei Bedarf auf 35 Zeichen gekürzt.

Nach dem Export erhält das Paket eine SPS-Sendungsnummer, die für die Sendungsverfolgung im Fulfillment verwendet wird und auf der SPS-Sendungsverfolgungsseite nachgeschlagen werden kann. Wenn die Bestellung eine Kunden-E-Mail-Adresse enthält, bittet Globe SPS zusätzlich darum, den Empfänger per E-Mail zu benachrichtigen.

Servicetypen

Wählen Sie beim Zuordnen von Versandmethoden oder beim Export einer Bestellung den SPS-Service, der Ihrer Vereinbarung entspricht:

Service	Beschreibung
SPS Standard	Standardzustellung an Privat- oder Geschäftsadressen
SPS Express	Expresszustellung
SPS 9:00	Garantierte Zustellung bis 9:00 Uhr
SPS 12:00	Garantierte Zustellung bis 12:00 Uhr
SPS Saturday Delivery	Zustellung am Samstag
SPS Balíkovo	Zustellung an einen Balíkovo-Abholpunkt
SPS Parcel Terminal	Zustellung an ein SPS-Paketterminal (Schließfach)

Bestellungen können in 11 Zielländer exportiert werden: Slowakei, Tschechien, Österreich, Ungarn, Deutschland, Polen, Rumänien, Kroatien, Slowenien, Bulgarien und Serbien.

Abholpunkte vs. Heimlieferung

SPS Balíkovo und SPS Parcel Terminal senden das Paket an den Abholpunkt, den der Kunde im Checkout ausgewählt hat. Globe übergibt die Punkt-ID an SPS und trägt den Namen des Kunden als Kontaktperson auf dem Label ein.
Alle anderen Services stellen an die Versandadresse des Kunden zu.

Wird ein Balíkovo- oder Parcel-Terminal-Service verwendet, die Bestellung enthält aber keinen Abholpunkt, wird die Sendung an die Straßenadresse des Kunden statt an einen Abholpunkt erstellt. Stellen Sie sicher, dass Ihre Abholpunkt-Versandmethoden dem Balíkovo- oder Parcel-Terminal-Service zugeordnet sind und dass die Auswahl im Checkout aktiv ist — siehe Abholpunkt-Spediteure hinzufügen.

Versicherungswert

SPS verlangt für jede Sendung einen Versicherungswert. Globe ermittelt ihn in dieser Reihenfolge:

Versicherungswert, der beim Export auf der einzelnen Sendung gesetzt wurde
Standard-Versicherungswert aus den Einstellungen des Spediteurkontos
Die Bestellsumme, wenn keiner von beiden gesetzt ist

Nachnahme (COD)

SPS unterstützt Nachnahme. Wenn bei einer Bestellung noch ein Betrag einzuziehen ist, sendet Globe den Nachnahmebetrag zusammen mit der Bestellwährung sowie die Nachnahme-IBAN und den Nachnahme SWIFT/BIC aus Ihren Spediteurkonto-Einstellungen, damit SPS weiß, wohin das Geld überwiesen werden soll. Bestellungen ohne offenen Betrag werden als normale Sendungen exportiert.

Lieferstatus

Die Lieferstatus-Synchronisation ist für SPS nicht verfügbar — Paketstatus werden nicht nach Shopify zurückgeschrieben, der Fortschritt muss also auf der SPS-Sendungsverfolgungsseite oder in Ihrem SPS-Portal geprüft werden. Die Sendungsnummer und der Tracking-Link werden dem Fulfillment trotzdem beigefügt. Retourenlabels werden ebenfalls nicht unterstützt; Rücksendungen vereinbaren Sie direkt mit SPS.

Labeldruck

SPS-Labels werden beim Export als PDF erzeugt und können in den folgenden Formaten gedruckt werden:

Format	Labels pro Bogen
A6	1
A6 auf A4	4 (2×2-Raster)

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

Fehlerbehebung

Problem	Lösung
„Username or password is not configured“	WebShip-Benutzername und -Passwort sind beide Pflichtfelder. Tragen Sie sie im Spediteurkonto ein und speichern Sie.
Authentifizierungsfehler von WebShip	Prüfen Sie Ihre WebShip-Zugangsdaten und lassen Sie sich von Ihrem SPS-Vertriebsbeauftragten bestätigen, dass der Webservice-Zugang für das Konto aktiviert ist.
Export mit einer SPS-Fehlermeldung abgelehnt	WebShip validiert die Sendung und gibt den Grund zurück — meist eine unvollständige Adresse, eine nicht unterstützte Ziel-PLZ oder ein Service, der für Ihr Konto nicht freigeschaltet ist. Korrigieren Sie die Bestellung und exportieren Sie erneut.
„SPS did not return a tracking number“	SPS hat die Anfrage angenommen, aber keine Sendungsnummer geliefert. Prüfen Sie im SPS-Portal auf eine doppelte Sendung, bevor Sie erneut exportieren.
Paket an die Heimadresse statt an einen Abholpunkt versendet	Die Bestellung wurde auf einem Balíkovo- oder Parcel-Terminal-Service ohne zugehörigen Abholpunkt exportiert. Prüfen Sie, ob der Kunde im Checkout einen Punkt ausgewählt hat und ob die Zuordnung der Versandmethode korrekt ist.
„No label URLs found for these SPS orders“	Für diesen Stapel sind die Labels nicht mehr verfügbar. Exportieren Sie die Bestellungen erneut, um neue Labels zu erzeugen.
Labels können nicht von SPS WebShip abgerufen werden	Die Label-PDFs konnten nicht von SPS heruntergeladen werden. Warten Sie einen Moment und drucken Sie den Stapel erneut.

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