SPS API

Globe Pickup Points integruje się z SPS (Slovak Parcel Service) przez SOAP API WebShip, umożliwiając eksport zamówień i drukowanie etykiet wysyłkowych bezpośrednio z Shopify. Dzięki tej integracji możesz:

Eksportować zamówienia do SPS WebShip bezpośrednio z Shopify
Drukować etykiety wysyłkowe w Shopify
Wysyłać do punktów odbioru Balíkovo, automatów paczkowych SPS lub na adres klienta
Obsługiwać płatność za pobraniem (COD) z wypłatą na Twoje konto bankowe

Włączanie integracji z API SPS

W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Dodaj nowego przewoźnika i wybierz SPS.
Wprowadź swoją Nazwę użytkownika i Hasło — są to Twoje dane logowania do WebShip. Skontaktuj się ze swoim przedstawicielem handlowym SPS, aby uzyskać dostęp do usługi sieciowej.
Jeśli korzystasz z płatności za pobraniem, wprowadź IBAN dla płatności za pobraniem oraz SWIFT/BIC dla pobrania konta bankowego, na które SPS ma przekazywać pobrane kwoty.
Opcjonalnie ustaw Domyślną wartość ubezpieczenia stosowaną do wszystkich przesyłek. Jeśli pozostawisz to pole puste, używana jest suma zamówienia.
Skonfiguruj opcje realizacji i tagowania według potrzeb — Automatycznie realizuj zamówienia, Automatycznie oznaczaj zamówienia numerem śledzenia i Własny tag po eksporcie.
Przypisz metody wysyłki Shopify do usług SPS uzgodnionych z przewoźnikiem.

SPS nie udostępnia środowiska testowego — WebShip ma jeden endpoint produkcyjny, więc wprowadzone dane logowania tworzą prawdziwe przesyłki.

Eksportowanie i drukowanie etykiet

Możesz eksportować zamówienia do SPS i drukować etykiety wysyłkowe bezpośrednio z Shopify, zarówno masowo, jak i indywidualnie. Pełny przepływ pracy opisujemy w artykule Tworzenie etykiet wysyłkowych.

Każda przesyłka jest tworzona, a jej etykieta generowana w ramach jednego wywołania API, więc etykiety są gotowe do druku natychmiast po eksporcie. Referencją paczki wysyłaną do SPS jest nazwa Twojego zamówienia Shopify bez początkowego znaku #, w razie potrzeby skrócona do 35 znaków.

Po wyeksportowaniu paczka otrzymuje numer przesyłki SPS, który służy do śledzenia realizacji i który można sprawdzić na stronie śledzenia SPS. Jeśli zamówienie zawiera adres e-mail klienta, Globe prosi też SPS o powiadomienie odbiorcy e-mailem.

Typy usług

Przypisując metody wysyłki lub eksportując zamówienie, wybierz usługę SPS odpowiadającą Twojej umowie:

Usługa	Opis
SPS Standard	Standardowa dostawa na adres domowy lub firmowy
SPS Express	Dostawa ekspresowa
SPS 9:00	Gwarantowana dostawa do godziny 9:00
SPS 12:00	Gwarantowana dostawa do godziny 12:00
SPS Saturday Delivery	Dostawa w sobotę
SPS Balíkovo	Dostawa do punktu odbioru Balíkovo
SPS Parcel Terminal	Dostawa do automatu paczkowego SPS

Zamówienia można eksportować do 11 krajów docelowych: Słowacji, Czech, Austrii, Węgier, Niemiec, Polski, Rumunii, Chorwacji, Słowenii, Bułgarii i Serbii.

Punkty odbioru a dostawa do domu

SPS Balíkovo i SPS Parcel Terminal wysyłają paczkę do punktu odbioru wybranego przez klienta podczas realizacji zamówienia. Globe przekazuje identyfikator punktu do SPS i umieszcza nazwisko klienta na etykiecie jako osobę kontaktową.
Wszystkie pozostałe usługi dostarczają na adres wysyłki klienta.

Jeśli użyto usługi Balíkovo lub Parcel Terminal, ale zamówienie nie zawiera punktu odbioru, przesyłka zostanie utworzona na adres ulicy klienta zamiast do punktu odbioru. Upewnij się, że Twoje metody wysyłki do punktów odbioru są przypisane do usługi Balíkovo lub Parcel Terminal i że selektor jest aktywny podczas realizacji zamówienia — zobacz Dodawanie przewoźników z punktami odbioru.

Wartość ubezpieczenia

SPS wymaga wartości ubezpieczenia dla każdej przesyłki. Globe ustala ją w następującej kolejności:

Wartość ubezpieczenia ustawiona dla pojedynczej przesyłki w momencie eksportu
Domyślna wartość ubezpieczenia z ustawień przewoźnika
Suma zamówienia, jeśli żadna z powyższych nie jest ustawiona

Płatność za pobraniem (COD)

SPS obsługuje COD. Gdy zamówienie ma kwotę pozostałą do pobrania, Globe wysyła kwotę pobrania wraz z walutą zamówienia oraz wartościami IBAN dla płatności za pobraniem i SWIFT/BIC dla pobrania z ustawień przewoźnika, aby SPS wiedziało, gdzie przekazać pieniądze. Zamówienia bez kwoty do pobrania są eksportowane jako zwykłe przesyłki.

Status dostawy

Synchronizacja statusów dostawy nie jest dostępna dla SPS — statusy paczek nie są zapisywane z powrotem w Shopify, więc postęp trzeba sprawdzać na stronie śledzenia SPS lub w swoim portalu SPS. Numer przesyłki i link do śledzenia są nadal dołączane do realizacji. Etykiety zwrotne również nie są obsługiwane; zwroty ustalaj bezpośrednio z SPS.

Drukowanie etykiet

Etykiety SPS są generowane jako pliki PDF w momencie eksportu i można je drukować w następujących formatach:

Format	Etykiet na arkuszu
A6	1
A6 na A4	4 (siatka 2×2)

Podczas drukowania A6 na A4 możesz wybrać pozycję startową na arkuszu (pozycje 1–4), aby ponownie użyć częściowo zużytych arkuszy etykiet.

Rozwiązywanie problemów

Problem	Rozwiązanie
„Username or password is not configured”	Nazwa użytkownika i hasło WebShip są obowiązkowe. Uzupełnij je na koncie przewoźnika i zapisz.
Błąd uwierzytelniania z WebShip	Zweryfikuj swoje dane logowania do WebShip i potwierdź u przedstawiciela handlowego SPS, że dostęp do usługi sieciowej jest włączony dla konta.
Eksport odrzucony z komunikatem błędu SPS	WebShip waliduje przesyłkę i zwraca przyczynę — zwykle niekompletny adres, nieobsługiwany docelowy kod pocztowy lub usługa niewłączona na Twoim koncie. Popraw zamówienie i wyeksportuj ponownie.
„SPS did not return a tracking number”	SPS przyjęło żądanie, ale nie odesłało numeru przesyłki. Sprawdź w portalu SPS, czy nie powstała duplikatowa przesyłka, zanim wyeksportujesz ponownie.
Paczka wysłana na adres domowy zamiast do punktu odbioru	Zamówienie zostało wyeksportowane w usłudze Balíkovo lub Parcel Terminal bez przypisanego punktu odbioru. Sprawdź, czy klient wybrał punkt podczas realizacji zamówienia i czy przypisanie metody wysyłki jest poprawne.
„No label URLs found for these SPS orders”	Etykiety nie są już dostępne dla tej partii. Wyeksportuj zamówienia ponownie, aby wygenerować nowe etykiety.
Nie można pobrać etykiet z SPS WebShip	Nie udało się pobrać plików PDF etykiet z SPS. Odczekaj chwilę i wydrukuj partię ponownie.

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