Spring GDS API
Globe Pickup Points integruje się ze Spring GDS, konsolidatorem przesyłek międzynarodowych, który przekazuje Twoje paczki lokalnym przewoźnikom ostatniej mili, takim jak PostNL, Royal Mail, DPD, Hermes, Colis Privé i Packeta. Dzięki tej integracji możesz:
- Eksportować zamówienia do Spring GDS bezpośrednio z Shopify
- Wysyłać do 49 krajów docelowych za pomocą 34 usług
- Drukować etykiety wysyłkowe w Shopify
- Wysyłać pełne dane celne (kody HS, kraj pochodzenia, DDP/DDU) w przesyłkach międzynarodowych
Włączanie integracji z API Spring GDS
Dział zatytułowany „Włączanie integracji z API Spring GDS”- W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Dodaj nowego przewoźnika i wybierz Spring GDS.
- Wprowadź swój Klucz API — znajdziesz go na swoim koncie Spring GDS.
- Wypełnij dane nadawcy używane na każdej etykiecie: Nazwa nadawcy, Nazwa firmy nadawcy (opcjonalnie), Ulica nadawcy, Miasto nadawcy, Kod pocztowy nadawcy, Kraj nadawcy, Telefon nadawcy i Email nadawcy.
- Jeśli wysyłasz za granicę, dodaj swoje identyfikatory celne. Wszystkie są opcjonalne:
- NIP nadawcy — Twój numer VAT. Dla Norwegii użyj VOEC, dla Szwajcarii UID, dla Singapuru GST.
- Numer EORI nadawcy — używany w rozwiązaniu celnym Spring Clear.
- Numer IOSS nadawcy — używany w rozwiązaniu Spring Clear IOSS+ i Union OSS.
- Numer GB EORI nadawcy — zaczyna się od
GB, wymagany dla przesyłek DDP do Wielkiej Brytanii przez Spring Clear.
- Wybierz URL śledzenia wysyłany klientom w e-mailu o realizacji zamówienia: Śledzenie Spring GDS lub Śledzenie kuriera końcowego.
- Skonfiguruj opcje realizacji i tagowania według potrzeb.
- Przypisz metody wysyłki Shopify do usług Spring GDS uzgodnionych ze Spring.
Eksportowanie i drukowanie etykiet
Dział zatytułowany „Eksportowanie i drukowanie etykiet”Możesz eksportować zamówienia do Spring GDS 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 wyeksportowana przesyłka otrzymuje numer śledzenia Spring GDS. W zależności od ustawienia URL śledzenia realizacje są tworzone albo ze stroną śledzenia Spring GDS, albo z linkiem do śledzenia przewoźnika ostatniej mili, który Spring zwraca dla tej przesyłki.
Typy usług
Dział zatytułowany „Typy usług”Spring GDS udostępnia 34 usługi. Wybierz tę, która odpowiada Twojej umowie ze Spring i krajowi docelowemu — pełna lista jest dostępna w oknie eksportu oraz w przypisaniu metod wysyłki.
| Grupa usług | Przykłady |
|---|---|
| Sieć Spring | Spring Tracked (TRCK), Spring Signature (SIGN), Spring Untracked (UNTR) |
| Spring Collect | Spring Collect (CLLCT) — jedyna usługa do punktów odbioru |
| PostNL | Packet Tracked / Registered / Non Tracked, Parcel EU, GlobalPack EMS i UPU, EPG, warianty Benelux z podpisem i bez |
| Royal Mail | Tracked 24 i Tracked 48, z podpisem lub bez |
| Partnerzy ostatniej mili | DPD DE, Hermes, Colis Privé, Italian Post Crono i Crono Express, Sending Mainland i Islands, Spring Com Standard i Express, Packeta, Austrian Post Eurodis, Express |
Punkty odbioru a dostawa do domu
Dział zatytułowany „Punkty odbioru a dostawa do domu”Spring Collect (CLLCT) to jedyna usługa Spring GDS dostarczająca do punktu odbioru. Gdy zamówienie jest eksportowane tą usługą, Globe dołącza identyfikator lokalizacji PUDO punktu wybranego przez klienta podczas realizacji zamówienia. Wszystkie pozostałe usługi dostarczają na adres wysyłki klienta.
Jeśli zamówienie wyeksportowane jako Spring Collect nie ma wybranego punktu odbioru, wraz z przesyłką nie zostanie wysłana żadna lokalizacja PUDO. Użyj zamiast tego usługi z dostawą do domu lub zadbaj o to, by klient wybrał punkt podczas realizacji zamówienia.
Cło i opłaty
Dział zatytułowany „Cło i opłaty”Spring GDS jest przewoźnikiem międzynarodowym, więc Globe zawsze wysyła z przesyłką deklarację celną. Pozycje produktów zawierają kod HS i kraj pochodzenia z Twoich pozycji magazynowych w Shopify; tam, gdzie ich brakuje, używane są Kod HS wprowadzony dla tej przesyłki w momencie eksportu oraz Twój kraj nadawcy.
Sekcja Cło i opłaty na koncie przewoźnika steruje następującymi ustawieniami:
| Ustawienie | Działanie |
|---|---|
| Kraje DDP | Kraje docelowe obsługiwane jako DDP (Delivered Duty Paid). Wszystkie pozostałe są wysyłane jako DDU. |
| Wysyłaj wartości bez VAT dla krajów | Wartości zamówień i wysyłki dla tych krajów docelowych są wysyłane bez VAT. |
| Kraje z preferencyjnym pochodzeniem | Dodaje oznaczenie preferencyjnego pochodzenia do każdej pozycji produktu. Wymagane dla Wielkiej Brytanii zgodnie z Umową o handlu i współpracy UE–UK. |
| Typ deklaracji | Sprzedaż towarów (domyślnie), Dokumenty, Prezent, Towar zwrócony lub Próbka handlowa. |
Dwie kolejne wartości w ogóle nie są ustawieniami przewoźnika — Kod HS (6–10 cyfr, nadpisywany przez kody HS na poziomie produktu z Shopify, jeśli są dostępne) oraz Opis zawartości (na przykład Goods lub Clothing) to opcje zaawansowane, które wypełniasz dla każdej przesyłki w oknie eksportu.
Tryb testowy
Dział zatytułowany „Tryb testowy”Każde konto przewoźnika Spring GDS ma pole wyboru Tryb testowy. Gdy jest włączone, zarówno tworzenie przesyłek, jak i pobieranie etykiet trafiają do środowiska testowego Spring GDS zamiast do produkcyjnego. Wyłącz je, zanim zaczniesz wysyłać prawdziwe zamówienia — przesyłki testowe nie są nadawane.
Płatność za pobraniem (COD)
Dział zatytułowany „Płatność za pobraniem (COD)”Spring GDS nie obsługuje płatności za pobraniem. Z przesyłką nie jest wysyłana żadna kwota pobrania, niezależnie od metody płatności w zamówieniu. Jeśli potrzebujesz COD, użyj do takich zamówień innego przewoźnika.
Status dostawy
Dział zatytułowany „Status dostawy”Synchronizacja statusów dostawy nie jest dostępna dla Spring GDS — nie jest on objęty dwukierunkową synchronizacją statusów dostawy, którą mają przewoźnicy tacy jak Packeta, PPL, DPD czy GLS, więc statusy paczek nie są zapisywane z powrotem w Shopify. Numer śledzenia i link do śledzenia są nadal dołączane do realizacji, a dalsze aktualizacje statusu pochodzą z własnego śledzenia Shopify lub z portalu Spring GDS.
Etykiety zwrotne również nie są obsługiwane dla Spring GDS.
Drukowanie etykiet
Dział zatytułowany „Drukowanie etykiet”Spring GDS zwraca etykiety w formacie PDF, które Globe może wydrukować w dwóch formatach:
| Format | Pozycji na arkuszu |
|---|---|
| A6 | 1 |
| A6 na A4 | 4 |
Podczas drukowania A6 na A4 możesz wybrać pozycję startową (1–4), aby ponownie użyć częściowo zużytych arkuszy.
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”| Problem | Rozwiązanie |
|---|---|
| Klucz API Spring GDS nie jest skonfigurowany | Konto przewoźnika nie ma klucza API. Dodaj go w ustawieniach przewoźnika — jest wymagany także do drukowania. |
| Błąd krytyczny ze Spring GDS | Spring odrzucił przesyłkę. Komunikat zwrócony przez Spring jest pokazywany przy nieudanym zamówieniu — najczęściej to nieprawidłowy kod usługi dla kraju docelowego lub brakujące dane celne. |
| Nie zwrócono numeru śledzenia | Przesyłka została przyjęta, ale Spring nie zwrócił numeru śledzenia. Wyeksportuj zamówienie ponownie i sprawdź, czy usługa jest włączona na Twoim koncie Spring. |
| Nie udało się pobrać żadnych etykiet | Etykieta nie jest jeszcze dostępna dla tego numeru śledzenia. Odczekaj chwilę i wydrukuj ponownie. |
| Spring Collect wyeksportowane bez punktu odbioru | Zamówienie nie ma punktu odbioru wybranego podczas realizacji zamówienia. Wybierz usługę z dostawą do domu lub poproś klienta o wybranie punktu. |
| Przesyłki testowe nigdy nie docierają | Na koncie przewoźnika wciąż włączony jest Tryb testowy. Wyłącz go do wysyłki produkcyjnej. |