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.
Włączanie integracji z API Hrvatska pošta
Dział zatytułowany „Włączanie integracji z API Hrvatska pošta”- 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.
- 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.
- W polu Środowisko zostaw Produkcyjne. Programistyczne łączy się z systemem testowym Hrvatska pošta.
- 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.
- 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.
- 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.
- 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.
- 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.
- W sekcji Metody wysyłki przypisz metody wysyłki Shopify do typów Hrvatska pošta opisanych w sekcji Typy usług.
Eksportowanie i drukowanie etykiet
Dział zatytułowany „Eksportowanie i drukowanie etykiet”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.
Typy usług
Dział zatytułowany „Typy usług”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.
| Typ | Doką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.
Punkty odbioru
Dział zatytułowany „Punkty odbioru”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.
Płatność za pobraniem (COD)
Dział zatytułowany „Płatność za pobraniem (COD)”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.
Drukowanie etykiet
Dział zatytułowany „Drukowanie etykiet”Globe pobiera etykiety z Hrvatska pošta jako PDF w momencie drukowania. Dostępne są następujące formaty:
| Format | Etykiet na stronie |
|---|---|
| A6 | 1 |
| A6 on A4 | 4 (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.
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”| Problem | Rozwiązanie |
|---|---|
| Nazwa użytkownika i hasło nie są ustawione albo Hrvatska pošta je odrzuciła | Sprawdź 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šta | Nie utworzono żadnej przesyłki. Spróbuj ponownie za minutę. |
| Adres nadawcy jest niekompletny | Wypeł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 nadania | Wpisz 5-cyfrowy kod w polu Poczta lub paczkomat nadania. |
| Hrvatska pošta doręcza tylko na terenie Chorwacji | Zamó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šta | Klient 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 kodu | Wybierz punkt akcją Zmodyfikuj punkt odbioru albo wybierz typ, który wysyła na adres. |
| Paczki nadane w automacie paczkowym nie mogą trafić na adres | Aby wysłać paczkę na adres, wybierz w polu Jak przekazujesz paczki HP nadanie na poczcie lub odbiór przez kuriera. |
| Zamówienie nie ma wagi | Ustaw wagę produktów w Shopify, wpisz wagę w panelu tworzenia etykiety albo ustaw pole Domyślna waga (kg). |
| Automaty paczkowe przyjmują najwyżej 30 kg | Limit 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 telefonu | Popraw 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 odbiorcy | Uzupeł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 EUR | Zobacz 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 potwierdzona | Przesył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ł etykiety | Wydrukuj 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 etykiet | Hrvatska pošta pomija etykiety anulowanych przesyłek i przesyłek, których nie ma na tym koncie. |