ShippyPro API

Globe Pickup Points integruje się z ShippyPro, platformą wysyłkową obsługującą wielu przewoźników, która pozwala wysyłać na podstawie umów z przewoźnikami już podłączonych w Twoim własnym koncie ShippyPro. Dzięki tej integracji możesz:

• Eksportować zamówienia do ShippyPro bezpośrednio z Shopify
• Drukować etykiety wysyłkowe w Shopify
• Wysyłać do punktów odbioru lub na adres klienta, w zależności od wybranej usługi przewoźnika
• Obsługiwać płatność za pobraniem (COD) i deklaracje celne (CN22) dla przesyłek zagranicznych

Zamówienia można eksportować do 33 krajów docelowych — UE, Wielkiej Brytanii, Szwajcarii, Norwegii, USA, Kanady i Australii.

---

Włączanie integracji z API ShippyPro

1. W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Dodaj nowego przewoźnika i wybierz ShippyPro.
2. Wprowadź swój Klucz API — znajdziesz go na swoim koncie ShippyPro. To jedyne obowiązkowe dane uwierzytelniające.
3. Kliknij Fetch carriers. Globe zweryfikuje klucz i pobierze wszystkich przewoźników oraz wszystkie usługi podłączone do Twojego konta ShippyPro, dzięki czemu będziesz mógł przypisać je do metod wysyłki Shopify.
4. Wypełnij dane nadawcy drukowane na etykiecie: Nazwa nadawcy, Nazwa firmy nadawcy, Ulica nadawcy, Miasto nadawcy, Kod pocztowy nadawcy, Kraj nadawcy (dwuliterowy kod, taki jak CZ, SK, HU), Telefon nadawcy i Email nadawcy.
5. Skonfiguruj opcje realizacji i tagowania według potrzeb — Automatycznie realizuj zamówienia, Automatycznie oznaczaj zamówienia numerem śledzenia i Własny tag po eksporcie.
6. Przypisz metody wysyłki Shopify do pobranych usług przewoźników.

W Globe nie ma osobnego środowiska sandbox ShippyPro — wprowadzony klucz API tworzy prawdziwe przesyłki na Twoim koncie.

---

Eksportowanie i drukowanie etykiet

Możesz eksportować zamówienia do ShippyPro 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żdy eksport tworzy przesyłkę i zwraca numer śledzenia oraz etykietę w jednym wywołaniu, więc etykiety są od razu gotowe do druku. Nazwa Twojego zamówienia Shopify jest wysyłana jako referencja i notatka przesyłki. Po eksporcie numer śledzenia jest używany do śledzenia realizacji — przewoźnik zgłoszony przez ShippyPro jest zapisywany w Shopify jako firma śledząca przesyłkę.

---

Przewoźnicy i usługi

ShippyPro nie ma własnej sieci. Przewoźnicy, usługi i cenniki pochodzą z Twojego konta ShippyPro, więc lista widoczna podczas eksportu to dokładnie to, co masz tam podłączone. Jeśli dodasz w ShippyPro nowego przewoźnika, kliknij ponownie Fetch carriers w ustawieniach przewoźnika w Globe, aby go zaciągnąć.

Jeśli Twoje konto nie zwróci listy przewoźników (na przykład gdy API ShippyPro jest chwilowo niedostępne), Globe przechodzi na wprowadzanie ręczne i pozwala wkleić definicję przewoźnika w formacie JSON. Użyj przycisku Copy sample, aby uzyskać oczekiwany format.

---

Punkty odbioru a dostawa do domu

• Jeśli zamówienie zawiera punkt odbioru wybrany podczas realizacji zamówienia i wyeksportujesz je usługą do punktów odbioru, Globe wysyła identyfikator punktu do ShippyPro jako opcję przewoźnika, dzięki czemu paczka trafia do tego punktu.
• Usługi, których nazwa wskazuje na dostawę do domu, zawsze wysyłają na adres wysyłki klienta, nawet jeśli do zamówienia dołączony jest punkt.

Same punkty odbioru mogą pochodzić od dowolnego dostawcy, z którego korzystasz podczas realizacji zamówienia, lub od dostawcy ShippyPro PUDO, który odpytuje na żywo punkty odbioru przewoźników z Twojego konta ShippyPro. Zobacz Dodawanie przewoźników z punktami odbioru.

Podczas eksportu Globe ostrzega Cię banerem Type selection mismatch, jeśli wybrany przewoźnik ShippyPro nie wygląda na przewoźnika, do którego należy punkt odbioru w zamówieniu — na przykład gdy punkt Packeta jest eksportowany usługą GLS. Eksport nie jest blokowany, więc przejrzyj baner, zanim przejdziesz dalej.

---

Waga i wymiary paczki

ShippyPro wymaga rzeczywistej wagi. Globe nigdy jej nie wymyśla: jeśli zamówienie nie ma wagi ustawionej w Shopify, eksport zostanie odrzucony. Dodaj wagi produktów w Shopify i wyeksportuj ponownie.

Wymiary paczki są opcjonalne. Długość paczki (cm), Szerokość paczki (cm) i Wysokość paczki (cm) to opcje zaawansowane, a nie ustawienia przewoźnika, i gdy nie ustawisz żadnej wartości, dla każdego wymiaru wysyłany jest 1 cm. Jeśli wybrana usługa przewoźnika oferuje opcję ubezpieczenia, przesyłka jest ubezpieczana na sumę zamówienia.

---

Cło

Dla przesyłek zagranicznych Globe buduje deklarację CN22 z pozycji zamówienia — opis, ilość, wartość jednostkowa, waga, kod HS i kraj pochodzenia pobrane z pozycji magazynowej produktu. Tam, gdzie dane produktu są niekompletne, luki uzupełniają następujące ustawienia przewoźnika:

Ustawienie	Używane do
Kraj nadawcy	Kraj pochodzenia, gdy produkt go nie ma
Contents type	Rodzaj towarów deklarowany na formularzu CN22 (Merchandise, Prezent, Dokumenty, Próbka handlowa, Towar zwrócony)
Kraje DDP	Kraje docelowe obsługiwane jako DDP (cło opłacasz Ty); wszystkie pozostałe kraje docelowe są wysyłane jako DDU

Opis zawartości (opis zawartości przesyłki, domyślnie Goods) i Kod HS (kod taryfowy używany, gdy produkt go nie ma) nie są ustawieniami przewoźnika — to opcje zaawansowane, które wypełniasz dla każdej przesyłki w oknie eksportu.

---

Płatność za pobraniem (COD)

ShippyPro obsługuje COD. Gdy zamówienie ma kwotę pozostałą do pobrania, Globe wysyła kwotę pobrania wraz z walutą zamówienia, a ShippyPro przekazuje ją przewoźnikowi docelowemu. Zamówienia bez kwoty do pobrania są eksportowane jako zwykłe przesyłki. To, czy COD jest faktycznie dostępne — i w jakich walutach — zależy od umowy z przewoźnikiem stojącym za wybraną usługą na Twoim koncie ShippyPro.

---

Status dostawy

Synchronizacja statusów dostawy nie jest dostępna dla ShippyPro — statusy paczek nie są zapisywane z powrotem w Shopify, więc postęp trzeba śledzić w ShippyPro lub na stronie śledzenia przewoźnika docelowego. Numer śledzenia i link do śledzenia są nadal dołączane do realizacji. Etykiety zwrotne również nie są obsługiwane; twórz je bezpośrednio w ShippyPro.

---

Drukowanie etykiet

Etykiety są pobierane z ShippyPro w momencie druku w wybranym rozmiarze, a wszystkie etykiety z partii są łączone w jeden wielostronicowy plik PDF:

Format	Opis
A6	Etykieta wygenerowana w rozmiarze 10,5 × 14,8 cm
A4 (4-up)	Etykieta wygenerowana w rozmiarze 21 × 29,7 cm

Ponieważ etykietę renderuje samo ShippyPro, dokładny układ na stronie pochodzi z szablonu etykiety przewoźnika docelowego. Etykiety można wydrukować ponownie w dowolnym momencie — Globe pobiera świeży adres URL do pobrania dla każdej przesyłki, a w razie potrzeby korzysta z adresu etykiety zapisanego w momencie eksportu.

---

Rozwiązywanie problemów

Problem	Rozwiązanie
„Invalid API key — please check your ShippyPro credentials”	Klucz został odrzucony przez ShippyPro. Skopiuj go ponownie ze swojego konta ShippyPro i zapisz przewoźnika.
„ShippyPro API key is not configured”	Pole klucza API na koncie przewoźnika jest puste. Uzupełnij je i zapisz.
„No carriers configured. Use the ‘Fetch carriers’ button”	Lista przewoźników nigdy nie została pobrana. Otwórz ustawienia przewoźnika i kliknij Fetch carriers.
„Please select a carrier before exporting.”	Usługa wybrana dla zamówienia nie znajduje się na pobranej liście — zwykle po zmianie listy. Pobierz przewoźników ponownie i przypisz metodę wysyłki od nowa.
„Order has no weight set.”	ShippyPro wymaga niezerowej wagi. Dodaj wagi produktów w Shopify, a następnie wyeksportuj ponownie.
Eksport odrzucony z komunikatem błędu przewoźnika	ShippyPro przekazuje błąd walidacji przewoźnika docelowego wraz z proponowanym rozwiązaniem — zwykle to niekompletny adres, nieobsługiwany kraj docelowy lub usługa niewłączona na Twoim koncie.
Paczka wysłana na adres zamiast do punktu odbioru	Usługa przewoźnika nie ma zapisanej opcji punktu odbioru. Kliknij ponownie Fetch carriers, aby odświeżyć opcje przewoźników, a następnie wyeksportuj ponownie.
„Could not retrieve label for order …”	Nie udało się pobrać ani świeżego, ani zapisanego adresu URL etykiety. Odczekaj chwilę i wydrukuj partię ponownie; jeśli błąd się powtarza, wyeksportuj zamówienie ponownie.