Slovenská pošta API

Globe Pickup Points integruje się ze Slovenská pošta, słowackim operatorem pocztowym, poprzez jego API WebEPH, 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 swojego konta Slovenská pošta (Moje zásielky)
Drukować etykiety wysyłkowe w Shopify w formacie A6 lub A4
Wysyłać do placówek pocztowych, automatów paczkowych BalíkoBOX lub na adres klienta
Obsługiwać płatność za pobraniem wypłacaną na Twój IBAN

Integracja jest oferowana dla Słowacji, a adres nadawcy jest zawsze adresem słowackim.

Włączanie integracji z API Slovenská pošta

W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Dodaj nowego przewoźnika i wybierz Slovenská pošta.
Wprowadź swoje ID użytkownika i Klucz API — są to dane uwierzytelniające API WebEPH z Twojego konta Slovenská pošta. API WebEPH musi być aktywowane dla konta, zanim uwierzytelnianie zadziała.
Wypełnij blok nadawcy: Nazwa nadawcy, Ulica nadawcy, Miasto nadawcy i Kod pocztowy nadawcy są wymagane. Organizacja nadawcy, Telefon nadawcy i Email nadawcy są opcjonalne.
Wybierz Sposób nadania — Nadać na poczcie lub Nadać kurierowi — w zależności od tego, jak przekazujesz paczki.
Wybierz Sposób płatności za przesyłkę: Kredyt pocztowy, Automat płatniczy, Znaczki pocztowe, Płatne przelewem, Płatne gotówką, Przedmiot usługi pocztowej, Faktura lub Online.
Zaznacz Umowa, jeśli masz umowę ze Slovenská pošta.
Jeśli wysyłasz za pobraniem, wypełnij IBAN dla płatności za pobraniem.
Opcjonalnie skonfiguruj Ubezpieczenie przesyłek, Domyślna wartość ubezpieczenia, Domyślna waga (kg), Automatycznie realizuj zamówienia, Automatycznie oznaczaj zamówienia numerem śledzenia i Własny tag po eksporcie.
Przypisz metody wysyłki Shopify do produktów Slovenská pošta uzgodnionych z przewoźnikiem.

Eksportowanie i drukowanie etykiet

Możesz eksportować zamówienia do Slovenská pošta i drukować etykiety wysyłkowe bezpośrednio z Shopify, zarówno masowo, jak i indywidualnie — zobacz Tworzenie etykiet wysyłkowych.

Każdy eksport tworzy jeden hárok (arkusz nadawczy) dla każdego typu produktu: zamówienia są grupowane według wybranego produktu, dla każdej grupy otwierany jest hárok, dodawane są do niego paczki, a następnie hárok jest automatycznie rejestrowany. Jeśli rejestracja się nie powiedzie, paczki i tak zostaną utworzone, a hárok można zarejestrować później w Moje zásielky.

Waga zamówienia jest przeliczana z gramów na kilogramy, przy minimum 0,1 kg. Jeśli Twoje zamówienia nie mają wagi, ustaw Domyślna waga (kg) w ustawieniach przewoźnika.

Każda paczka otrzymuje numer paczki Slovenská pošta (na przykład EB534780848SK). Jeśli włączona jest opcja Automatycznie realizuj zamówienia, zamówienie jest realizowane z tym numerem oraz linkiem do strony śledzenia Slovenská pošta.

Slovenská pošta ma system testowy WebEPH, ale jest on włączany na poziomie serwera, a nie dla poszczególnych kont przewoźnika — sklepy produkcyjne zawsze komunikują się z produkcyjnym API Moje zásielky, a w ustawieniach przewoźnika nie ma przełącznika sandbox.

Produkty

Wybierz produkt odpowiadający Twojej umowie ze Slovenská pošta. Wszystkie zamówienia wyeksportowane z tym samym produktem trafiają na ten sam hárok.

Produkt	Opis
Doporučený list	List polecony
Poistený list	List ubezpieczony
Úradná zásielka	Przesyłka urzędowa
Balík	Paczka standardowa
Expres kuriér	Kurier ekspresowy
EMS zásielka	Przesyłka ekspresowa EMS
EPG – obchodný balík	Paczka handlowa EPG
Balík – zmluvní zákazníci	Paczka dla klientów z umową
Balík – zmluvní zákazníci – Consignment	Paczka dla klientów z umową, konsygnacja
Balíček	Mała paczka
Easy Expres 1	Easy Expres, dostawa w 1 dzień
Easy Expres 10	Easy Expres, dostawa w 10 dni
Prime zásielka	Przesyłka Prime
List	List zwykły

Punkty odbioru a dostawa do domu

Typ dostawy wynika z metody wysyłki wybranej przez klienta:

Punkt odbioru — gdy klient wybierze punkt odbioru Slovenská pošta (placówkę pocztową lub automat BalíkoBOX) podczas realizacji zamówienia, adres odbiorcy na paczce zostaje zastąpiony adresem punktu odbioru, a paczka jest nadawana z usługą odbioru w punkcie. Nazwa punktu jest dopisywana do miasta, aby była widoczna na etykiecie.
Dostawa do domu — paczka jest adresowana na adres wysyłki klienta. Druga linia adresu jest dopisywana do ulicy.

Nazwa odbiorcy, ulica, miasto i kod pocztowy są obowiązkowe. Zamówienia, w których brakuje któregokolwiek z tych pól, są odrzucane podczas eksportu.

Zakresy numerów paczek (klienci z umową)

Jeśli Slovenská pošta przydzieliła Ci własny zakres numerów paczek, wypełnij zaawansowane pola Zakres numerów paczek – od i Zakres numerów paczek – do (na przykład EB534780848SK). Globe przydziela wtedy numery z tego zakresu i po każdym eksporcie zapisuje kolejny numer w polu Następny numer paczki, które możesz również poprawić ręcznie.

Numery mają format PPNNNNNNNN[C]SS — dwuliterowy prefiks, osiem cyfr, opcjonalna cyfra kontrolna i dwuliterowy sufiks. Globe wylicza cyfrę kontrolną za Ciebie. Gdy zakres się wyczerpie, eksporty przestają działać, dopóki nie wprowadzisz nowego zakresu. Pozostaw te pola puste, aby numery przydzielała Slovenská pošta.

Płatność za pobraniem (COD)

COD jest obsługiwane. Kwota pobrania jest pobierana z pozostałej do zapłaty kwoty zamówienia w walucie zamówienia i wysyłana jako przelew bankowy na IBAN dla płatności za pobraniem skonfigurowany na koncie przewoźnika, z symbolem zmiennym wyprowadzonym z cyfr numeru zamówienia. Bez prawidłowego IBAN API odrzuci paczkę.

Ubezpieczenie

Ubezpieczenie jest dodawane, gdy wartość zamówienia jest większa od zera i albo wybranym produktem jest Poistený list, albo w ustawieniach przewoźnika włączono Ubezpieczenie przesyłek. Kwotą ubezpieczenia jest wartość zamówienia w walucie zamówienia lub Domyślna wartość ubezpieczenia, jeśli ją ustawisz.

Status dostawy

Synchronizacja statusów dostawy nie jest dostępna dla Slovenská pošta — statusy paczek nie są zapisywane z powrotem w Shopify, a płatności za pobraniem nie są automatycznie oznaczane jako opłacone. Numer paczki i link do strony śledzenia Slovenská pošta są nadal dołączane do realizacji. Etykiety zwrotne oraz anulowanie już wyeksportowanej paczki z poziomu Globe również nie są obsługiwane; paczki anuluj w Moje zásielky.

Drukowanie etykiet

Etykiety Slovenská pošta są zwracane jako PDF i można je drukować w następujących formatach:

Format	Etykiet na arkuszu	Pozycja startowa
A6	1 (jedna etykieta na stronę)	–
A4	4 (siatka 2×2)	1–4

Podczas drukowania arkuszy A4 wybierz pozycję startową, aby ponownie użyć częściowo zużytych arkuszy etykiet. Domyślnie używany format ustawisz w opcji Domyślna opcja druku w ustawieniach przewoźnika.

Rozwiązywanie problemów

Problem	Rozwiązanie
Błąd uwierzytelniania	Sprawdź ID użytkownika i Klucz API oraz upewnij się, że API WebEPH jest aktywowane na Twoim koncie Slovenská pošta.
Brak wymaganych pól nadawcy	Nazwa nadawcy, Ulica nadawcy, Miasto nadawcy i Kod pocztowy nadawcy muszą być wypełnione.
Brak nazwy, adresu, miasta lub kodu pocztowego odbiorcy	Adres wysyłki w Shopify jest niekompletny. W przypadku zamówień do punktów odbioru sprawdź, czy klient faktycznie wybrał punkt podczas realizacji zamówienia.
Nieprawidłowy format numeru paczki	W polach zakresu numerów paczek użyj formatu `PPNNNNNNNN[C]SS`, na przykład `EB534780848SK`.
Wyczerpany zakres numerów paczek	Wszystkie przydzielone numery zostały wykorzystane. Poproś Slovenská pošta o nowy zakres i zaktualizuj pola Zakres numerów paczek – od/do oraz Następny numer paczki.
Błąd walidacji podczas eksportu	API odrzuciło wartość na paczce — najczęściej brakujący IBAN dla płatności za pobraniem albo kwota ubezpieczenia lub pobrania niedozwolona dla wybranego produktu.
Nie znaleziono identyfikatorów paczek w zamówieniach	Zamówienie nie zostało poprawnie wyeksportowane, więc nie ma czego drukować. Wyeksportuj je ponownie przed drukowaniem.
Typ etykiety niedostępny	Etykieta dla tej paczki nie jest jeszcze gotowa. Odczekaj chwilę i wydrukuj ponownie.
Nie udało się połączyć z API Slovenská pošta	API WebEPH jest chwilowo niedostępne. Ponów eksport lub wydruk później.

Add Slovenská pošta pickup points to your Shopify store — pricing, demo & setup →