Przejdź do głównej zawartości

Hrvatska pošta API

Globe Pickup Points integruje się z Hrvatska pošta, chorwackim operatorem pocztowym, przez jego API HP Shipping Service. Dzięki tej integracji możesz:

  • Eksportować zamówienia do Hrvatska pošta bezpośrednio z Shopify
  • Drukować etykiety wysyłkowe w Shopify w formacie A6 lub A6 na A4
  • Wysyłać paczki Paket 24 do placówek pocztowych, automatów paczkowych (paketomati) lub na adres klienta
  • Przyjmować płatności za pobraniem w EUR
  • Śledzić paczki na stronie śledzenia Hrvatska pošta

Integracja obejmuje tylko przesyłki na terenie Chorwacji.


  1. W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Kliknij Dodaj integrację przewoźnika i wybierz Hrvatska pošta.
  2. Wpisz dane w polach Nazwa użytkownika i Hasło. To dane uwierzytelniające API, które Hrvatska pošta wydaje klientom z umową. Poproś o nie swojego opiekuna handlowego w Hrvatska pošta lub napisz na npa-3pdx@posta.hr.
  3. W polu Środowisko zostaw Produkcyjne. Programistyczne łączy się z systemem testowym Hrvatska pošta.
  4. W polu Usługa wybierz Paket 24 D+1, Paket 24 D+2 lub Paket 24 D+3. Ustawienie dotyczy każdej przesyłki. D+1 oznacza doręczenie w następnym dniu roboczym.
  5. W polu Jak przekazujesz paczki HP wybierz sposób nadania:
    • Kurier HP odbiera je pod moim adresem (wybrane domyślnie): kurier Hrvatska pošta odbiera paczki pod adresem nadawcy. Jeśli nikt nie przekaże paczek, Hrvatska pošta zamyka przesyłkę. Nie zostawiaj tej opcji, jeśli paczki zanosisz do Hrvatska pošta samodzielnie.
    • Zanoszę je na pocztę: wpisz kod pocztowy placówki pocztowej w polu Poczta lub paczkomat nadania.
    • Nadaję je w paczkomacie: wpisz 5-cyfrowy kod automatu paczkowego w polu Poczta lub paczkomat nadania. Paczki nadane w automacie paczkowym mogą trafić tylko do placówki pocztowej lub automatu paczkowego, nie na adres, i mogą ważyć najwyżej 30 kg.
  6. Wypełnij dane nadawcy. Nazwa firmy nadawcy (drukowana jako nadawca na każdej etykiecie), Ulica nadawcy, Miasto nadawcy, Kod pocztowy nadawcy (5 cyfr) i Telefon nadawcy są wymagane. Numer domu nadawcy i Email nadawcy są opcjonalne. Numer domu można też wpisać w polu Ulica nadawcy.
  7. Kliknij Pokaż ustawienia zaawansowane, aby ustawić:
    • Rozmiar skrytki w automacie paczkowym: rozmiar skrytki deklarowany dla paczek, które trafiają do automatu paczkowego lub które w nim nadajesz: XS (9 x 16 x 64 cm), S (9 x 38 x 64 cm), M (19 x 38 x 64 cm) lub L (39 x 38 x 64 cm). Domyślnie wybrany jest M.
    • Domyślna waga (kg): używana, gdy zamówienie nie ma wagi.
  8. Skonfiguruj realizację i tagowanie: Automatycznie realizuj zamówienia (Nigdy, Tak, wyślij email z numerem śledzenia lub Tak, nie wysyłaj emaila), Automatycznie oznaczaj zamówienia numerem śledzenia, Własny tag po eksporcie i Własny tag po druku.
  9. W sekcji Metody wysyłki przypisz metody wysyłki Shopify do typów Hrvatska pošta opisanych w sekcji Typy usług.

Możesz eksportować zamówienia do Hrvatska pošta i drukować etykiety wysyłkowe bezpośrednio z Shopify, masowo lub pojedynczo. Cały proces tworzenia etykiet opisujemy w artykule Tworzenie etykiet wysyłkowych.

  • Każda etykieta to jedna przesyłka z jedną paczką.
  • Waga przesyłki to waga zamówienia z Shopify przeliczona z gramów na kilogramy. Jeśli zamówienie nie ma wagi, Globe używa wartości z pola Domyślna waga (kg). Wagę możesz też wpisać w panelu tworzenia etykiety w sekcji Zaawansowane → Waga przesyłki (kg).
  • API Hrvatska pošta nie ma pola na drugą linię adresu, więc Globe dopisuje ją do ulicy.
  • Na etykiecie drukowany jest numer zamówienia Shopify.

Przed wysłaniem zamówienia Globe sprawdza kraj docelowy, punkt odbioru, imię i nazwisko odbiorcy, ulicę, miasto, kod pocztowy i numer telefonu, wagę oraz kwotę pobrania. Zamówienie, które nie przejdzie kontroli, nie zostanie wysłane, a panel tworzenia etykiety pokaże przyczynę. Brak danych logowania, niekompletne dane nadawcy lub brak kodu miejsca nadania zatrzymują cały eksport.

Każda przesyłka otrzymuje numer przesyłki Hrvatska pošta. Jeśli włączona jest opcja Automatycznie realizuj zamówienia, Globe realizuje zamówienie z tym numerem i linkiem do strony śledzenia Hrvatska pošta: https://posiljka.posta.hr/hr/tracking/trackingdata?barcode=<parcel number>.

Globe nie ponawia eksportu automatycznie. Gdy eksport kończy się bez jednoznacznej odpowiedzi od Hrvatska pošta, przesyłka może już istnieć. Zanim ponownie utworzysz etykietę, sprawdź swoje konto Hrvatska pošta.


Wybierz Typ dla każdego zamówienia w panelu tworzenia etykiety albo przypisz typ do każdej metody wysyłki w ustawieniach przewoźnika. Każdy typ korzysta z czasu doręczenia Paket 24 ustawionego w polu Usługa.

TypDokąd doręcza
Hrvatska pošta (post office or parcel locker if selected, otherwise address)Do placówki pocztowej lub automatu paczkowego wybranego przez klienta w kasie. Zamówienia bez punktu odbioru trafiają na adres wysyłki.
Hrvatska pošta Paket 24 (address)Na adres wysyłki klienta. Punkt odbioru w zamówieniu jest ignorowany.
Hrvatska pošta Paket 24 (post office or parcel locker)Do placówki pocztowej lub automatu paczkowego z zamówienia. Zamówienie bez punktu jest odrzucane.

Pierwszy typ możesz przypisać zarówno do metod wysyłki z punktem odbioru, jak i do metod z dostawą do domu.

Pierwszy i trzeci typ odrzucają zamówienie, którego punkt odbioru należy do innego przewoźnika. Globe nie wysyła wtedy paczki zamiast tego na adres klienta. Wybierz punkt Hrvatska pošta akcją Zmodyfikuj punkt odbioru albo wybierz Hrvatska pošta Paket 24 (address), aby wysłać paczkę na adres.

Usługi Hrvatska pošta EasyReturn i usługi paletowe nie są dostępne.


Aby udostępnić punkty Hrvatska pošta w kasie, dodaj Hrvatska pošta jako przewoźnika z punktami odbioru w Globe. Zobacz Dodawanie przewoźników z punktami odbioru. Globe wczytuje punkty z publicznych danych na posta.hr:

  • Placówki pocztowe: zwykłe placówki oraz placówki czynne w niepełnym wymiarze godzin. Na liście nie ma placówek sezonowych i celnych ani placówek bez opublikowanych godzin otwarcia, na przykład tymczasowo zamkniętych.
  • Automaty paczkowe: paketomati Hrvatska pošta.

Globe wysyła z przesyłką 5-cyfrowy kod punktu Hrvatska pošta: kod pocztowy placówki pocztowej albo kod automatu paczkowego, który zaczyna się od 6. Globe przyjmuje też punkty Hrvatska pošta wybrane z listy punktów Packety.

Dostawy do automatów paczkowych mają dodatkowe wymagania:

  • Telefon odbiorcy musi być chorwackim numerem komórkowym (091, 092, 095, 097, 098 lub 099). Hrvatska pošta wysyła na niego PIN w SMS-ie.
  • Paczka może ważyć najwyżej 30 kg.
  • Rozmiar skrytki pochodzi z ustawienia Rozmiar skrytki w automacie paczkowym.

Dostawy do placówek pocztowych i na adres też wymagają numeru telefonu, ale akceptowany jest dowolny numer.


Hrvatska pošta obsługuje płatność za pobraniem tylko w EUR, do 13 300 EUR na przesyłkę. Zamówienie z pobraniem w innej walucie lub z wyższą kwotą jest odrzucane, a przesyłka nie zostanie utworzona. Płatność za pobraniem działa przy dostawie na adres, do placówki pocztowej i do automatu paczkowego.

  • Globe wstępnie wypełnia kwotę pobrania kwotą zamówienia pozostałą do zapłaty, gdy rozpozna metodę płatności jako płatność za pobraniem, na przykład Płatność za pobraniem (COD) w Shopify.
  • Jeśli Globe nie rozpozna Twojej metody płatności za pobraniem, na przykład takiej z chorwacką nazwą, kwota nie zostanie wstępnie wypełniona, a panel tworzenia etykiety ostrzeże, że zamówienie jest nieopłacone. Wpisz wtedy kwotę samodzielnie.
  • Kwotę możesz zmienić w panelu tworzenia etykiety w sekcji Zaawansowane → Kwota pobrania.

Globe pobiera etykiety z Hrvatska pošta jako PDF w momencie drukowania. Dostępne są następujące formaty:

FormatEtykiet na stronie
A61
A6 on A44 (2×2)

W formacie A6 on A4 drukowanie zawsze zaczyna się od pierwszej pozycji. Nie można wybrać pozycji startowej. Domyślnie używany format ustawisz w polu Domyślna opcja druku w ustawieniach przewoźnika.

Etykiety A6 są drukowane w kolejności zaznaczenia, gdy zwrócone zostaną wszystkie etykiety. Na arkuszach A4 Hrvatska pošta sortuje etykiety według numeru przesyłki. Etykiety anulowanych przesyłek oraz przesyłek, których nie ma na tym koncie Hrvatska pošta, są pomijane bez błędu.


ProblemRozwiązanie
Nazwa użytkownika i hasło nie są ustawione albo Hrvatska pošta je odrzuciłaSprawdź pola Nazwa użytkownika i Hasło w ustawieniach przewoźnika. Nie utworzono żadnej przesyłki.
Logowanie do Hrvatska pošta nie powiodło się albo Globe nie mógł połączyć się z Hrvatska poštaNie utworzono żadnej przesyłki. Spróbuj ponownie za minutę.
Adres nadawcy jest niekompletnyWypełnij pola nadawcy wymienione w komunikacie. Kod pocztowy nadawcy musi mieć 5 cyfr.
Ustawienia są niekompletne: kod pocztowy placówki lub kod automatu paczkowego do nadaniaWpisz 5-cyfrowy kod w polu Poczta lub paczkomat nadania.
Hrvatska pošta doręcza tylko na terenie ChorwacjiZamówienie jest wysyłane do innego kraju. Użyj dla niego innego przewoźnika.
Punkt odbioru nie jest placówką pocztową ani automatem paczkowym Hrvatska poštaKlient wybrał punkt innego przewoźnika. Wybierz punkt Hrvatska pošta akcją Zmodyfikuj punkt odbioru albo wybierz Hrvatska pošta Paket 24 (address).
Zamówienie nie ma placówki pocztowej ani automatu paczkowego Hrvatska pošta albo jego punkt nie ma 5-cyfrowego koduWybierz punkt akcją Zmodyfikuj punkt odbioru albo wybierz typ, który wysyła na adres.
Paczki nadane w automacie paczkowym nie mogą trafić na adresAby wysłać paczkę na adres, wybierz w polu Jak przekazujesz paczki HP nadanie na poczcie lub odbiór przez kuriera.
Zamówienie nie ma wagiUstaw wagę produktów w Shopify, wpisz wagę w panelu tworzenia etykiety albo ustaw pole Domyślna waga (kg).
Automaty paczkowe przyjmują najwyżej 30 kgLimit dotyczy dostawy do automatu i nadania w automacie. Cięższą paczkę wyślij do placówki pocztowej lub na adres i wybierz w polu Jak przekazujesz paczki HP nadanie na poczcie lub odbiór przez kuriera.
Automaty paczkowe wymagają chorwackiego numeru komórkowego albo brakuje numeru telefonuPopraw numer telefonu w zamówieniu. Dla automatu paczkowego musi to być chorwacki numer komórkowy (091, 092, 095, 097, 098 lub 099).
To nie jest chorwacki kod pocztowy albo brakuje imienia i nazwiska, ulicy lub miasta odbiorcyUzupełnij adres wysyłki w zamówieniu. Kod pocztowy musi mieć 5 cyfr.
Płatność za pobraniem w walucie innej niż EUR lub powyżej 13 300 EURZobacz Płatność za pobraniem (COD).
Komunikat zaczynający się od „Hrvatska pošta:”Hrvatska pošta odrzuciła przesyłkę. Treść komunikatu, często po chorwacku, wskazuje odrzucone pole. Popraw wartość i wyeksportuj zamówienie ponownie.
Hrvatska pošta nie odpowiedziała na czas, połączenie zostało przerwane albo przesyłka nie została potwierdzonaPrzesyłka może już istnieć. Zanim ponownie utworzysz etykietę, sprawdź swoje konto Hrvatska pošta.
Hrvatska pošta utworzyła przesyłkę, ale Globe nie mógł jej zapisaćNie twórz etykiety ponownie: Hrvatska pošta utworzyłaby drugą przesyłkę. Napisz na help@appfleece.com i podaj numer przesyłki.
Przewoźnik nie zwrócił etykietyWydrukuj ponownie za chwilę. Hrvatska pošta nie zwraca etykiety dla anulowanej przesyłki ani dla przesyłki, której nie ma na tym koncie. Jeśli drukowanie nadal się nie udaje, sprawdź pola Nazwa użytkownika i Hasło.
W pliku PDF brakuje niektórych etykietHrvatska pošta pomija etykiety anulowanych przesyłek i przesyłek, których nie ma na tym koncie.