Przejdź do głównej zawartości

Nova Post API

Globe Pickup Points integruje się z Nova Post i umożliwia eksport zamówień oraz drukowanie etykiet wysyłkowych bezpośrednio z Shopify dla paczek nadawanych w krajach UE. Dzięki tej integracji możesz:

  • Eksportować zamówienia do Nova Post bezpośrednio z Shopify
  • Drukować etykiety wysyłkowe w Shopify
  • Wysyłać do oddziału Nova Post, automatu paczkowego lub punktu PUDO wybranego w kasie albo na adres klienta
  • Wysyłać paczki na Ukrainę, do Mołdawii i Wielkiej Brytanii z fakturą celną utworzoną z zamówienia
  • Przyjmować płatności za pobraniem na trasach, na których Nova Post je oferuje

  1. W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Kliknij Dodaj integrację przewoźnika i wybierz Nova Post.
  2. Wpisz Klucz API. Utworzysz go w my.novapost.com w sekcji Integrations, API keys, po zalogowaniu się jako upoważniony przedstawiciel wskazany w umowie z Nova Post.
  3. Wybierz Środowisko: Produkcyjne dla prawdziwych przesyłek, Programistyczne dla środowiska testowego Nova Post. Klucz produkcyjny działa tylko ze środowiskiem Produkcyjne, a klucz testowy tylko ze środowiskiem Programistyczne.
  4. Wpisz Numer umowy. Za przesyłki płacisz Ty jako nadawca, a Nova Post rozlicza je w ramach tej umowy. Jeśli masz osobną umowę na wysyłki międzynarodowe, wpisz jej numer w polu Numer umowy międzynarodowej. Globe używa jej wtedy dla paczek do innego kraju.
  5. Wpisz NIP firmy: numer podatkowy organizacji z Twojej umowy z Nova Post, na przykład IČO, NIP lub Steuernummer. Musi to być organizacja, dla której utworzono Twój klucz API.
  6. Wypełnij pola Nazwa firmy nadawcy, Nazwa nadawcy (osoba kontaktowa widoczna na etykiecie), Telefon nadawcy (pełny numer międzynarodowy, na przykład +420777123456), Email nadawcy i Kraj nadawcy. Kraj nadawcy musi należeć do UE.
  7. Wskaż, jak Twoje paczki trafiają do Nova Post:
    • W oddziale: wypełnij pole Oddział Nova Post do nadawania przesyłek, podając numer oddziału w postaci, w jakiej pokazuje go Nova Post (na przykład 14/1), albo ID oddziału.
    • Kurierem spod Twojego adresu: zostaw pole oddziału puste i wypełnij pola Ulica nadawcy, Numer domu nadawcy, Kod pocztowy nadawcy i Miasto nadawcy. Numer domu można też wpisać w polu Ulica nadawcy.
  8. Wypełnij pola Domyślna długość paczki w milimetrach, Domyślna szerokość paczki w milimetrach i Domyślna wysokość paczki w milimetrach. Nova Post wymaga długości, szerokości i wysokości dla każdej paczki i używa ich do obliczenia wagi gabarytowej. Globe wysyła te wartości dla wszystkich paczek.
  9. Jeśli oferujesz płatność za pobraniem, wypełnij ustawienia pobrania opisane w sekcji Płatność za pobraniem (COD).
  10. Po kliknięciu Pokaż ustawienia zaawansowane możesz ustawić Warunki celne (Incoterms), Numer EORI nadawcy, Domyślny opis zawartości przesyłki, Domyślny kod HS i Domyślna waga (kg). Ustawienia celne opisujemy w sekcji Cło i przesyłki międzynarodowe.
  11. Skonfiguruj według potrzeb opcje Automatycznie realizuj zamówienia, Automatycznie oznaczaj zamówienia numerem śledzenia i Własny tag po eksporcie.
  12. W sekcji Metody wysyłki przypisz metody wysyłki Shopify do usług Nova Post opisanych w sekcji Typy usług. Metody wysyłki można przypisać dla 27 krajów UE, Ukrainy, Mołdawii i Wielkiej Brytanii.

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

Przed wysłaniem pierwszego zamówienia Globe sprawdza ustawienia i loguje się do Nova Post Twoim kluczem API. Jeśli brakuje któregoś ustawienia albo klucz zostanie odrzucony, żadne zamówienie nie zostanie wysłane. Globe sprawdza też w każdym zamówieniu dane, które Nova Post by odrzuciła, na przykład brak numeru telefonu lub numeru domu. Zamówienie, które nie przejdzie tych kontroli, nie zostanie wysłane, więc możesz je poprawić i wyeksportować ponownie.

Globe wysyła każde zamówienie jako jedną przesyłkę z jedną paczką:

  • Waga: waga zamówienia zaokrąglona do 10 g (co najmniej 10 g)
  • Wymiary: domyślna długość, szerokość i wysokość z ustawień
  • Wartość ubezpieczenia: wartość z pola Zadeklarowana wartość, domyślnie suma zamówienia, w walucie zamówienia
  • Zawartość: wartość z pola Opis zawartości albo, gdy jest puste, nazwy produktów z zamówienia

Wagę, zadeklarowaną wartość, kwotę pobrania, kod HS i opis zawartości przesyłki możesz zmienić w sekcji Zaawansowane przy tworzeniu etykiety.

Nova Post zwraca numer przesyłki, na przykład SHCZ0123456789. Globe zapisuje go jako numer śledzenia i pobiera etykietę z Nova Post przy każdym drukowaniu. Link do śledzenia otwiera https://novapost.com/en-<country>/tracking/<shipment number>/ dla kraju z numeru przesyłki (na przykład en-pl dla SHPL…) albo en-cz, gdy ten kraj nie ma strony śledzenia. Jeśli włączona jest opcja Automatycznie realizuj zamówienia, Globe tworzy realizację z numerem przesyłki, przewoźnikiem Nova Post i tym linkiem.

Jeśli Nova Post nie odpowie na czas albo połączenie zostanie przerwane, przesyłka może istnieć w Nova Post, choć Globe nie ma jej numeru. Globe dodaje wtedy do zamówienia notatkę z prośbą o sprawdzenie my.novapost.com przed ponownym utworzeniem etykiety i zatrzymuje partię przed kolejnym zamówieniem. Zamówienia, które nie zostały wysłane, można bezpiecznie wyeksportować ponownie.

Globe nie anuluje przesyłek w Nova Post. Aby anulować przesyłkę, usuń ją w my.novapost.com.


Przy przypisywaniu metod wysyłki lub tworzeniu etykiety wybierz jedną z tych usług:

UsługaDostawa
Nova Post (branch or parcel locker if selected, otherwise address)Do oddziału Nova Post, automatu paczkowego lub punktu PUDO wybranego przez klienta w kasie. Zamówienie bez punktu odbioru trafia na adres klienta.
Nova Post courier (address)Zawsze na adres wysyłki klienta, także gdy zamówienie ma punkt odbioru.
Nova Post branch or parcel lockerDo oddziału Nova Post, automatu paczkowego lub punktu PUDO z zamówienia. Zamówienie bez punktu jest odrzucane.

W obu usługach z dostawą do punktu zamówienie z punktem odbioru z sieci innego przewoźnika jest odrzucane, a Globe nie wysyła paczki zamiast tego na adres klienta. Wybierz punkt Nova Post akcją Zmodyfikuj punkt odbioru albo utwórz etykietę z usługą Nova Post courier (address).


Usługi z dostawą do punktu wysyłają paczkę do oddziału Nova Post, automatu paczkowego lub punktu PUDO wybranego przez klienta w kasie. Globe przekazuje ID tego punktu w Nova Post, więc punkt musi pochodzić z sieci Nova Post w selektorze punktów odbioru Globe. Aby udostępnić punkty Nova Post w kasie, dodaj Nova Post jako przewoźnika z punktami odbioru. Zobacz Dodawanie przewoźników z punktami odbioru. Oddziały Nova Post, które inny przewoźnik pokazuje w swojej sieci, na przykład Packeta lub Boxpi, mają identyfikatory tego przewoźnika i są odrzucane.

Nova Post nie ma oddziałów, automatów paczkowych ani punktów PUDO w Bułgarii, Chorwacji, na Cyprze, w Grecji, na Malcie i w Słowenii. Paczki do tych krajów mogą trafić tylko na adres klienta.

Przy dostawie na adres Nova Post wymaga ulicy i numeru domu w osobnych polach. Globe pobiera numer domu z pierwszej linii adresu (Vinohradská 12/34, 12 rue de la Paix) albo z początku drugiej linii, a numer mieszkania zapisany po numerze domu (byt 4, m. 5, Apt 2B) wysyła jako numer mieszkania. Adres bez numeru domu, ulicy, miasta lub kodu pocztowego jest odrzucany.

Nova Post wymaga numeru telefonu odbiorcy w każdej przesyłce, także do oddziałów i automatów paczkowych. Numer bez kodu kraju jest traktowany jako numer kraju docelowego. Nova Post odrzuca odbiorcę w Polsce bez polskiego numeru (+48) i odbiorcę na Ukrainie bez ukraińskiego numeru (+380).


Paczki opuszczające UE (na Ukrainę, do Mołdawii lub Wielkiej Brytanii) wymagają faktury celnej. Globe wypełnia własną fakturę handlową Nova Post na podstawie zamówienia. Możesz ją wydrukować razem z etykietą (zobacz Drukowanie etykiet).

Faktura zawiera łączną wartość towarów, walutę zamówienia, powód eksportu Selling oraz Warunki celne (Incoterms) z ustawień: domyślnie DAP (cło importowe płaci klient) albo DDP (cło importowe płacisz Ty). Każda wysyłana pozycja zamówienia z ceną staje się jedną pozycją faktury z:

  • nazwą produktu z Shopify jako nazwą pozycji i jej nazwą angielską (Nova Post oczekuje tej nazwy po angielsku)
  • ilością i ceną jednostkową
  • kodem HS z produktu w Shopify, a w razie jego braku z pola Kod HS ustawionego przy tworzeniu etykiety lub z pola Domyślny kod HS
  • krajem pochodzenia z produktu, jeśli jest ustawiony
  • częścią wagi paczki proporcjonalną do wagi produktu, tak aby wagi pozycji sumowały się do wagi paczki, czego wymaga Nova Post

Kody HS muszą mieć co najmniej 6 cyfr. Nova Post przyjmuje od 8 do 10 cyfr, więc Globe uzupełnia 6-cyfrowy kod zerami (610910 zmienia się w 61091000). Paczki do Mołdawii dostają dokładnie 10 cyfr. Gdy żadna pozycja zamówienia się nie kwalifikuje, Globe deklaruje całą paczkę jako jedną pozycję z opisem zawartości (lub Goods), wartością zamówienia oraz kodem z pola Kod HS ustawionego przy tworzeniu etykiety lub z pola Domyślny kod HS.

Nova Post deklaruje towary z kodami HS 210690 (preparaty spożywcze, na przykład suplementy diety) i HS 630900 (odzież używana) w kilogramach. Globe przelicza te pozycje na kilogramy na podstawie wagi produktu. Paczka może zawierać tylko jedną taką pozycję, o wadze najwyżej 10 kg.

Paczki opuszczające UE wymagają też adresu e-mail klienta w zamówieniu. Przy paczkach na Ukrainę pole Nazwa nadawcy musi być wypełnione alfabetem łacińskim: znaki diakrytyczne są dozwolone, cyrylica i alfabet grecki nie. Numer EORI nadawcy jest opcjonalny i zalecany dla paczek opuszczających UE.


Nova Post obsługuje płatność za pobraniem w obrębie Czech, Polski i Niemiec oraz z Czech, Polski, Niemiec i Słowacji na Ukrainę. Nova Post musi włączyć płatność za pobraniem w Twojej umowie (umowa o pobranie).

Gdy metodą płatności zamówienia jest płatność za pobraniem, Globe dodaje usługę pobrania Nova Post z kwotą zamówienia pozostałą do zapłaty. Kwotę możesz zmienić w polu Kwota pobrania przy tworzeniu etykiety.

Wypełnij te ustawienia:

  • IBAN do pobrań: konto, na które Nova Post wypłaca pobrane pieniądze. Wypłata trafia do firmy wskazanej w polu NIP firmy.
  • Numer umowy o pobranie: numer Twojej umowy o pobranie. Zostaw pole puste, jeśli masz tylko jedną umowę.
  • Kto płaci opłatę za pobranie: domyślnie Nadawca (Ty) albo Odbiorca. Ustawienie musi być zgodne z Twoją umową o pobranie.

Globe wysyła pobranie tylko wtedy, gdy zamówienie jest w walucie kraju nadawcy: CZK przy wysyłce z Czech, PLN z Polski, EUR z Niemiec i Słowacji. Zamówienie z pobraniem na trasie, na której Nova Post nie obsługuje pobrań, w innej walucie albo bez prawidłowego numeru IBAN jest odrzucane, zanim cokolwiek zostanie utworzone.


Globe pobiera etykiety z Nova Post jako PDF przy drukowaniu. Dostępne są dwie opcje druku:

Opcja drukowaniaCo jest drukowane
10x15 or 10x10 cm (size set by Nova Post)Etykieta przesyłki. Nova Post ustala rozmiar dla każdej przesyłki: 100 × 150 mm lub 100 × 100 mm.
Label + commercial invoice A4 (parcels leaving the EU)Etykieta, a po niej faktura handlowa Nova Post na A4 dla każdej paczki, która opuściła UE. Paczki w obrębie UE dostają tylko etykietę.

Gdy drukujesz kilka przesyłek, Globe łączy ich dokumenty w jeden plik PDF w kolejności przesyłek. Pozycja na papierze ma zawsze wartość 1.


ProblemRozwiązanie
„Nova Post settings are incomplete”Komunikat wymienia brakujące ustawienia. Uzupełnij je w ustawieniach przewoźnika i zapisz.
„Globe creates Nova Post labels for senders in the EU”W polu Kraj nadawcy wybierz kraj UE, z którego wysyłasz.
„The sender phone must be a full international number”Wpisz Telefon nadawcy z kodem kraju, na przykład +420777123456.
„The sender address needs a house number”Wpisz Numer domu nadawcy albo wypełnij pole Oddział Nova Post do nadawania przesyłek.
„Nova Post did not accept the API key” lub „Nova Post says the API key is not active”Sprawdź Klucz API i Środowisko: klucz produkcyjny działa tylko ze środowiskiem Produkcyjne, a klucz testowy tylko ze środowiskiem Programistyczne. Nieaktywny klucz musi zostać aktywowany w my.novapost.com lub przez Twojego opiekuna w Nova Post.
„Access to the company is forbidden by API key” lub „Nova Post refused the request for this API key”NIP firmy musi należeć do organizacji, dla której utworzono Twój klucz API. Sprawdź klucz w my.novapost.com.
„Recipient phone number is missing”, „Nova Post needs a Polish phone number (+48)” lub „…a Ukrainian phone number (+380)”Dodaj numer telefonu klienta z kodem kraju do adresu wysyłki zamówienia. Odbiorcy w Polsce potrzebują polskiego numeru, odbiorcy na Ukrainie ukraińskiego.
„Nova Post needs the house number in its own field” lub „the shipping address needs a street, city and postcode”Uzupełnij adres wysyłki zamówienia, w tym numer domu.
„Nova Post does not know the recipient’s city”Sprawdź nazwę miasta w adresie wysyłki.
„Order … has no weight”Ustaw wagę produktów w Shopify, wpisz wagę przy tworzeniu etykiety albo ustaw pole Domyślna waga (kg) w ustawieniach zaawansowanych.
„has no Nova Post branch or parcel locker”, „is not a Nova Post branch or parcel locker” lub „is not a Nova Post division id”Wybierz oddział lub automat paczkowy Nova Post akcją Zmodyfikuj punkt odbioru albo utwórz etykietę z usługą Nova Post courier (address), aby wysłać paczkę na adres klienta.
„parcels to Ukraine need the sender name in Latin letters”Wpisz w polu Nazwa nadawcy nazwę alfabetem łacińskim.
„Nova Post needs the customer’s e-mail for parcels leaving the EU”Dodaj adres e-mail klienta do zamówienia.
„parcels leaving the EU need an HS code”Dodaj kod HS do produktu w Shopify albo wypełnij pole Domyślny kod HS w ustawieniach zaawansowanych.
Odrzucone towary z kodem HS 210690 lub 630900Nova Post przyjmuje jedną taką pozycję na paczkę, najwyżej 10 kg, i wymaga jej wagi. Dodaj wagę produktu w Shopify albo podziel towary na więcej paczek w my.novapost.com.
Płatność za pobraniem odrzucona dla trasy lub walutyNova Post obsługuje płatność za pobraniem tylko na trasach i w walutach wymienionych w sekcji Płatność za pobraniem (COD). Wyślij zamówienie innym przewoźnikiem albo ustaw pole Kwota pobrania na 0 przy tworzeniu etykiety.
„no valid IBAN for the collected money” lub „Nova Post refused the cash on delivery bank account”Sprawdź pola IBAN do pobrań i Numer umowy o pobranie w ustawieniach.
„Nova Post did not answer in time”, „did not confirm the shipment” lub „The connection to Nova Post broke off”Przesyłka może istnieć. Zanim ponownie utworzysz etykietę, sprawdź my.novapost.com.
„Globe could not connect to Nova Post”, „the Nova Post login did not answer” lub „Nova Post is limiting requests right now”Nic nie zostało utworzone. Spróbuj ponownie za minutę.
„Do not create the label again”Nova Post utworzyła przesyłkę, ale Globe nie mógł jej zapisać. Wydrukuj etykietę w my.novapost.com albo usuń tam przesyłkę, zanim utworzysz nową.
„Globe stopped before sending order …”Wcześniejsze zamówienie z partii nie dostało użytecznej odpowiedzi albo nie dało się go zapisać. Dla tego zamówienia nic nie zostało utworzone, więc jego etykietę można utworzyć ponownie.
Inne komunikaty zaczynające się od „Nova Post:”Tekst pochodzi z walidacji Nova Post i wskazuje odrzucone pole. Popraw zamówienie lub ustawienia i wyeksportuj ponownie.
„Error printing Nova Post labels”Szczegóły pokazują numer przesyłki i przyczynę podaną przez Nova Post, na przykład Shipment not found. Sprawdź przesyłkę w my.novapost.com.