Speedy API
Globe Pickup Points integruje się ze Speedy, bułgarskim przewoźnikiem kurierskim, który obsługuje sieć DPD w Bułgarii. Dzięki tej integracji możesz:
- Eksportować zamówienia do Speedy bezpośrednio z Shopify
- Drukować etykiety wysyłkowe w Shopify
- Wysyłać na terenie Bułgarii na adres klienta, do oddziału Speedy lub do automatu paczkowego Speedy
- Wysyłać paczki za pobraniem w EUR, także do oddziałów i automatów paczkowych
Włączanie integracji z API Speedy
Dział zatytułowany „Włączanie integracji z API Speedy”- W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Kliknij Dodaj integrację przewoźnika i wybierz Speedy.
- Wpisz dane API Speedy w polach Nazwa użytkownika i Hasło. Speedy wydaje je klientom z umową. Poproś o nie swojego opiekuna w Speedy.
- W polu Usługa Speedy wybierz usługę ze swojej umowy ze Speedy: Standard 24 godziny (505) lub Standard 24 godziny paczka (515). Obie są usługami dla paczek na terenie Bułgarii i obie doręczają na adres, do oddziałów i do automatów paczkowych.
- W polu Za wysyłkę płaci wybierz, kto płaci Speedy za doręczenie: Nadawca (moja umowa ze Speedy) lub Odbiorca (płaci przy odbiorze).
- Jeśli nadajesz paczki w oddziale lub automacie paczkowym Speedy, wpisz jego ID w polu Oddział Speedy, w którym nadajesz paczki (na przykład
77). Jeśli kurier odbiera je spod Twojego adresu, zostaw to pole puste. - Opcjonalnie kliknij Pokaż ustawienia zaawansowane:
- ID klienta nadawcy: jeśli Twoja umowa ze Speedy ma kilka adresów nadania, wpisz ID klienta adresu, z którego wysyłasz. Jeśli zostawisz pole puste, nadawcą będzie domyślny adres Twojego konta Speedy.
- Client system ID: zostaw pole puste, chyba że Speedy przydzielił Ci client system ID.
- Domyślna waga (kg): domyślna waga przesyłki w kilogramach. Puste pole jest ignorowane.
- Skonfiguruj opcje realizacji i tagowania według potrzeb:
- Automatycznie realizuj zamówienia: Nigdy, Tak, wyślij email z numerem śledzenia lub Tak, nie wysyłaj emaila.
- Automatycznie oznaczaj zamówienia numerem śledzenia: dodaje numer przesyłki Speedy do zamówienia jako tag.
- Własny tag po eksporcie: tag dodawany do zamówienia po każdym udanym eksporcie etykiety.
- Przypisz metody wysyłki Shopify do typów usług Speedy opisanych w sekcji Typy usług. Dla metody wysyłki z punktem odbioru użyj Speedy (office or locker if selected, otherwise address) lub Speedy to office or locker. Nie używaj dla niej Speedy to address: paczka trafiłaby na adres klienta.
Pola Oddział Speedy, w którym nadajesz paczki, ID klienta nadawcy i Client system ID przyjmują tylko cyfry. Globe nie wysyła do Speedy adresu nadawcy. Nadawcą jest domyślny adres Twojego konta Speedy albo adres nadania ustawiony w polu ID klienta nadawcy.
Eksportowanie i drukowanie etykiet
Dział zatytułowany „Eksportowanie i drukowanie etykiet”Możesz eksportować zamówienia do Speedy i drukować etykiety wysyłkowe bezpośrednio z Shopify, masowo lub pojedynczo. Cały proces tworzenia etykiet opisujemy w artykule Tworzenie etykiet wysyłkowych.
Globe tworzy dla każdego zamówienia jedną przesyłkę Speedy z jedną paczką. Numer przesyłki Speedy jest numerem śledzenia. Globe go zapisuje i pobiera etykietę ze Speedy przy każdym drukowaniu, więc etykietę możesz później wydrukować ponownie. Na etykiecie drukowany jest numer zamówienia Shopify.
Gdy automatyczna realizacja jest włączona, Globe dodaje do realizacji numer przesyłki, przewoźnika Speedy i link do śledzenia https://www.speedy.bg/en/track-shipment?shipmentNumber=<shipment number>.
Etykiety Speedy w Globe służą do dostaw na terenie Bułgarii. Przed wysłaniem zamówienia Globe sprawdza dane, których wymaga Speedy:
- Numer telefonu odbiorcy przy każdej dostawie: na adres, do oddziału lub do automatu paczkowego. Speedy przyjmuje go w formacie
+359…albo jako numer zaczynający się od0. Numery zagraniczne działają w formacie z+. - Imię i nazwisko odbiorcy, co najmniej 3 znaki. Jeśli nazwa firmy ma co najmniej 3 znaki, odbiorcą jest firma, a klient jest osobą kontaktową.
- Przy dostawie na adres: ulica oraz miasto lub czterocyfrowy kod pocztowy. Miasto można zapisać alfabetem łacińskim lub cyrylicą. Ulica razem z drugą linią adresu może mieć najwyżej 200 znaków.
Zamówienie, które nie przejdzie kontroli, nie zostanie wysłane do Speedy. Pozostałe zamówienia z partii są przetwarzane dalej.
Integracja ze Speedy nie synchronizuje statusów dostawy z powrotem do Shopify. Globe nie anuluje przesyłek Speedy. Anuluj je na swoim koncie Speedy.
Typy usług
Dział zatytułowany „Typy usług”Wybierz typ usługi przy eksporcie zamówienia albo przypisz go do metody wysyłki w ustawieniach przewoźnika:
| Typ usługi | Dokąd trafia paczka |
|---|---|
| Speedy (office or locker if selected, otherwise address) | Do oddziału lub automatu paczkowego Speedy wybranego przez klienta w kasie. Zamówienie bez punktu odbioru trafia na adres klienta. |
| Speedy to address | Zawsze na adres klienta, także gdy zamówienie ma punkt odbioru. |
| Speedy to office or locker | Do oddziału lub automatu paczkowego Speedy z zamówienia. Zamówienie bez punktu jest odrzucane. |
Punkt odbioru z innej sieci albo punkt DPD poza Bułgarią zatrzymuje eksport z typem Speedy (office or locker if selected, otherwise address) i z typem Speedy to office or locker. Globe nigdy nie wysyła takiego zamówienia zamiast tego na adres klienta. Aby wysłać je na adres, utwórz etykietę z typem Speedy to address.
Usługa wybrana w polu Usługa Speedy dotyczy wszystkich trzech typów usług.
Oddziały i automaty paczkowe Speedy
Dział zatytułowany „Oddziały i automaty paczkowe Speedy”Oddziały i automaty paczkowe Speedy są adresowane za pomocą ID oddziału Speedy. Integracja ze Speedy akceptuje punkty Speedy z dwóch list punktów odbioru:
- Punkty odbioru DPD w Bułgarii. Każdy punkt DPD w Bułgarii jest oddziałem lub automatem paczkowym Speedy. ID punktu to
BG, a po nim ID oddziału Speedy uzupełnione do pięciu cyfr:BG08009to oddział Speedy 8009. - Oddziały Speedy z listy Packety (przewoźnik Packeta
BG Speedy PP). To wyłącznie oddziały Speedy, bez automatów paczkowych. ID punktu to ID oddziału Speedy.
Punkty DPD w innych krajach nie są punktami Speedy i są odrzucane.
Automaty paczkowe Speedy przyjmują paczki do 20 kg. Limit oddziału wynosi od 32 do 1200 kg, zależnie od oddziału. Speedy odrzuca cięższe paczki.
Płatność za pobraniem (COD)
Dział zatytułowany „Płatność za pobraniem (COD)”Speedy obsługuje płatność za pobraniem w Bułgarii tylko w EUR. Globe bierze kwotę pobrania z zamówienia, gdy ma ono metodę płatności za pobraniem. Płatność za pobraniem działa przy dostawie na adres, do oddziałów i do automatów paczkowych.
Zamówienie z płatnością za pobraniem w innej walucie, także w BGN, jest zatrzymywane przed wysłaniem do Speedy.
Drukowanie etykiet
Dział zatytułowany „Drukowanie etykiet”Etykiety Speedy są plikami PDF. Dostępne są następujące formaty:
| Format | Etykiet na arkuszu |
|---|---|
| 10x15 cm | 1 |
| A6 on A4 | 4 (na jednym arkuszu A4) |
| A4 | 1 (etykieta w górnej połowie strony A4) |
Na arkuszu A4 nie można wybrać pozycji startowej. Przy formatach 10x15 cm i A4 etykiety są drukowane w kolejności zaznaczenia. Przy formacie A6 on A4 Speedy sortuje je według numeru przesyłki.
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”Gdy Speedy odrzuci przesyłkę, w Speedy nic nie powstaje, a Globe pokazuje komunikat Speedy ze wskazówką dla typowych przypadków.
| Problem | Rozwiązanie |
|---|---|
| Ustawienia Speedy są niekompletne | Wypełnij pola Nazwa użytkownika i Hasło. Pola Oddział Speedy, w którym nadajesz paczki, ID klienta nadawcy i Client system ID przyjmują tylko cyfry. |
| Speedy odrzucił nazwę użytkownika lub hasło | Sprawdź pola Nazwa użytkownika i Hasło w ustawieniach integracji. Po tym błędzie Globe nie wysyła pozostałych zamówień z partii. |
| Brakuje numeru telefonu albo ma formę, której Speedy nie przyjmuje | Dodaj lub popraw numer telefonu w Shopify (+359…, numer zaczynający się od 0 albo numer zagraniczny z +) i utwórz etykietę ponownie. |
| Speedy wymaga imienia i nazwiska odbiorcy o długości co najmniej 3 znaków | Popraw imię i nazwisko w adresie wysyłki w Shopify. |
| Adres wysyłki jest poza Bułgarią, jest niekompletny lub za długi | Etykiety Speedy w Globe są przeznaczone dla adresów w Bułgarii. Adres wymaga ulicy oraz miasta lub czterocyfrowego kodu pocztowego. Ulica razem z drugą linią adresu może mieć najwyżej 200 znaków, a miasto najwyżej 50. |
Invalid site | Speedy nie mógł dopasować miasta i kodu pocztowego, na przykład dlatego, że kod pocztowy należy do innego miasta. Sprawdź miasto i kod pocztowy w adresie wysyłki. |
| Punkt odbioru nie jest oddziałem ani automatem paczkowym Speedy | Punkt należy do innej sieci albo jest punktem DPD poza Bułgarią. Wybierz oddział lub automat paczkowy Speedy akcją Zmodyfikuj punkt odbioru albo utwórz etykietę z typem Speedy to address, aby wysłać paczkę na adres klienta. |
| Zamówienie nie ma oddziału ani automatu paczkowego Speedy albo nie ma ID oddziału Speedy | Wybierz oddział lub automat paczkowy akcją Zmodyfikuj punkt odbioru albo utwórz etykietę z typem Speedy to address. |
| Oddział lub automat paczkowy jest zamknięty albo Speedy go nie zna | Wybierz inny oddział lub automat paczkowy Speedy akcją Zmodyfikuj punkt odbioru. |
| Speedy obsługuje płatność za pobraniem tylko w EUR | Zamówienie jest w innej walucie. Zobacz Płatność za pobraniem (COD). Jeśli pobranie odrzuca sam Speedy, sprawdź kwotę i swoją umowę ze Speedy. |
| „The price cannot be determined for provided shipment parameters” | Twoja umowa ze Speedy nie ma ceny dla tej usługi i płatnika. Zmień wartość w polu Usługa Speedy lub Za wysyłkę płaci w ustawieniach integracji. |
| Zamówienie nie ma wagi | Ustaw wagę produktu w Shopify, wpisz wagę przy tworzeniu etykiety albo wypełnij pole Domyślna waga (kg). |
| Speedy ogranicza liczbę zapytań albo Globe nie mógł połączyć się ze Speedy | Nic nie zostało utworzone. Spróbuj ponownie za minutę. |
| Speedy nie odpowiedział na czas, połączenie zostało przerwane albo Speedy nie potwierdził przesyłki | Przesyłka może już istnieć. Zanim ponownie utworzysz etykietę, sprawdź swoje konto Speedy. |
| Globe zatrzymał się przed wysłaniem zamówienia do Speedy | Wcześniejsze zamówienie z partii nie miało jednoznacznego wyniku albo Globe nie mógł zapisać jego przesyłki. Dla tego zamówienia nic nie zostało utworzone, więc możesz ponownie utworzyć jego etykietę. |
| Speedy utworzył przesyłkę, ale Globe nie mógł jej zapisać | Nie twórz etykiety ponownie: Speedy utworzyłby drugą przesyłkę. Wydrukuj lub anuluj przesyłkę wskazaną w komunikacie na swoim koncie Speedy. |
| „Printed X of Y Speedy labels” lub „Error printing Speedy labels” | Komunikat wymienia brakujące numery przesyłek i przyczynę, na przykład numer przesyłki, którego Speedy nie zna. Jeśli przyczyną jest problem z połączeniem, wydrukuj ponownie. |