Nova Poshta API podłącza się w Elbuz jednym kluczem, a program sam wystawia listy przewozowe Nova Poshta, co 10 minut pobiera statusy paczek, tworzy rejestry, zleca przekierowania i zwroty — bez konta biznesowego.
Kiedy to się przyda:
- Codziennie dziesiątki przesyłek — list przewozowy wystawiasz z karty zamówienia, rejestr i etykiety — z jednego okna.
- Paczki wracają z oddziałów — widać, komu kończy się przechowywanie; SMS do klienta wyślesz z tego samego miejsca.
- Pobranie — widać, które paczki odebrano, a przelew jest jeszcze w drodze, i na jaką kwotę.
- Klient prosi o inny oddział — przekierowanie i zwrot zlecasz z Elbuz, koszt znasz z góry.
Od czego zacząć: utwórz klucz API na koncie Nova Poshta → wpisz go w Elbuz.
Co potrafi Nova Poshta w Elbuz
- List przewozowy z zamówienia — do oddziału, paczkomatu lub na adres, pojedynczo, zbiorczo albo automatycznie według statusu zamówienia; przed przekazaniem paczki list można zmienić lub usunąć.
- Statusy paczek — co 10 minut, z terminem przechowywania, powodem niedoręczenia i przelewem pobrania; listy z konta Nova Poshta łączą się z zamówieniami.
- Rejestr i kurier — jeden dokument na wszystkie paczki dnia, druk rejestru i etykiet, zamawianie kuriera do paczek.
- Przekierowanie, zmiana danych, zwrot — z wyliczeniem kosztu przed zleceniem i wpisem w dzienniku zamówienia.
- Kontrola pobrań — które paczki czekają na przelew i na jaką kwotę.
- Powiadomienia dla klienta — SMS z rejestru przesyłek, automatyczny SMS według statusu dostawy, odpowiedź AI na „gdzie jest moje zamówienie”.
- Ochrona przed martwym kluczem — po 10 odmowach z rzędu połączenie się wyłącza i przychodzi powiadomienie.
Jak podłączyć Nova Poshta: klucz API i ustawienia
Skąd wziąć klucz API Nova Poshta
Klucz tworzy się na koncie biznesowym Nova Poshta; daje on Elbuz dostęp do Twojej umowy: listów przewozowych, rejestrów, statusów.
- Zaloguj się na konto biznesowe Nova Poshta.
- Otwórz „Налаштування” (Ustawienia) → kartę „Безпека” (Bezpieczeństwo) → blok „Мої ключі API” (Moje klucze API).
- Kliknij „Створити ключ” (Utwórz klucz), zaakceptuj warunki korzystania z API i skopiuj klucz.
1
Karta „Bezpieczeństwo”2
Moje klucze API3
Utwórz klucz- Klucze API są w ustawieniach konta, na karcie „Bezpieczeństwo”.
- Tu widać klucze, które już masz; klucz na zrzucie jest ukryty.
- Nowy klucz — przycisk „Utwórz klucz”; ten klucz wpisujesz w Elbuz.
Opis metod API Nova Poshta publikuje na developers.novaposhta.ua; do pracy w Elbuz nie jest potrzebny.
Gdzie wpisać klucz w Elbuz
Gdzie: Panel klienta → Ustawienia systemu → Inne ustawienia → „Usługi zewnętrzne i integracje” → grupa „Dostawa” → rekord Nova Poshta.
- Wklej klucz w pole „Token”.
- Włącz „Aktywność”.
- W bloku „Nadawca” wybierz „Nadawca” i „Osoba kontaktowa” — listy przychodzą z Twojego konta Nova Poshta zaraz po wpisaniu klucza; telefon i e-mail uzupełnią się z osoby kontaktowej.
- Tam też wybierz „Obwód”, „Miasto” i „Oddział”, z którego wysyłasz paczki.
- Jeśli masz włączoną usługę „Kontrola płatności”, włącz przełącznik „Usługa «Kontrola płatności»” — stanie się on wartością domyślną dla nowych listów przewozowych.
1
Token2
Nadawca i Osoba kontaktowa3
Obwód, Miasto i Oddział nadawcy4
Przełącznik usługi „Kontrola płatności”- Token — klucz API Nova Poshta, pokazywany w formie zamaskowanej.
- Nadawca i Osoba kontaktowa — wybierane raz i używane we wszystkich listach przewozowych.
- Obwód, Miasto i Oddział — gdzie nadawca nadaje paczki.
- Usługa „Kontrola płatności” — przełącznik usługi kontroli pobrania.
Przycisku „Zapisz” w formularzu nie ma: każda zmiana pola zapisuje się od razu. Klucz w polu „Token” nie jest pokazywany: jeśli jest zapisany, w polu widać kropki. Puste pole nie kasuje klucza; aby go wymienić, wpisz nowy w jego miejsce.
Nadawcę i osobę kontaktową wybiera się raz: formularz listu przewozowego i wystawianie zbiorcze uzupełniają je same. W formularzu pojedynczego listu można je zmienić.
Słowniki miast i oddziałów
Obwody, miasta, oddziały i paczkomaty Nova Poshta Elbuz aktualizuje sam raz na dobę, w nocy; blok „Słowniki przewoźnika” w tym samym formularzu pokazuje, ile rekordów ma każdy słownik i kiedy go zaktualizowano. Przycisk „Aktualizuj słowniki” uruchamia aktualizację od razu — „Aktualizacja słowników... może to potrwać kilka minut”.
Jeśli aktualizacja się nie uda, pojawi się „Błąd aktualizacji słowników:” z przyczyną, a słownik zostanie wczorajszy — nic nie jest kasowane. Nowy oddział, otwarty dziś, pojawi się na listach po nocnej lub ręcznej aktualizacji.
Kiedy Elbuz sam wyłącza Nova Poshta
Jeśli Nova Poshta 10 razy z rzędu odrzuci klucz — przeterminowany, usunięty na koncie — Elbuz wyłącza „Aktywność” połączenia. Właściciel konta dostaje powiadomienie „Integracja wyłączona” z treścią odpowiedzi Nova Poshta i radą „Zaktualizuj klucz API w ustawieniach integracji i włącz ją ponownie.”
Liczą się tylko odmowy z powodu klucza: awarie łączności czy prace techniczne Nova Poshta nie wyłączają połączenia. Odmowę nalicza każde zapytanie do Nova Poshta z tym kluczem — sprawdzanie statusów, działania użytkowników — więc połączenie wyłącza się po 10 odmowach z rzędu, czasem szybciej niż po 10 przebiegach sprawdzania.
Jeśli nie ma czego śledzić, sprawdzanie statusów nie odpytuje Nova Poshta. Jedna udana odpowiedź zeruje licznik.
Gdy połączenie jest wyłączone, statusy paczek się nie odświeżają, listy przewozowe się nie wystawiają, a przyciski działań Nova Poshta w „Przesyłkach” znikają. Aby przywrócić pracę, utwórz nowy klucz na koncie, wpisz go w „Token” i włącz „Aktywność”.
Jak utworzyć list przewozowy Nova Poshta z zamówienia
Ogólna procedura dla wszystkich przewoźników — w artykule jak wystawić list przewozowy z zamówienia.
Gdzie: karta zamówienia → „Dostawa” → „Utwórz list przewozowy”.
Co formularz wypełni sam, a co sprawdzić
| Pole | Co jest od razu | Co sprawdzić |
|---|---|---|
| „Nadawca”, „Osoba kontaktowa”, miasto i oddział nadawcy | z ustawień połączenia | można zmienić dla pojedynczej wysyłki |
| „Nazwisko”, „Imię”, „Imię ojca”, „Telefon” odbiorcy | dane klienta z zamówienia | jeśli odbiera inna osoba — popraw tutaj |
| „Miasto”, „Oddział” odbiorcy | oddział wybrany przez klienta na stronie; miasto — po zgodności nazwy ze słownikiem | pola mogą być puste, jeśli nazwa się nie zgadza, — list i tak trafi do oddziału klienta |
| „Opis przesyłki” | kategoria produktu, a bez niej — lista produktów | do Nova Poshta trafi najwyżej 120 znaków |
| „Waga całkowita, kg” | waga każdego produktu × ilość, razem | przy pustej wadze do listu trafią 2 kg |
| „Dostawa zwrotna (odbiorca)” | „Pieniądze” na kwotę zamówienia dla nieopłaconego, „Niepotrzebna” dla opłaconego | zapłacono kartą, a płatność nie jest odnotowana — ustaw „Niepotrzebna” |
| „Płatnik dostawy” | „Odbiorca” | dostawa na Twój koszt — „Nadawca”; „Strona trzecia” — tylko z „Kod EDRPOU/RNOKPP” płatnika |
| Odbiorca: „Osoba prywatna” / „Firma” | „Osoba prywatna” | dla „Firma” obowiązkowy jest „Kod EDRPOU/RNOKPP”; imię i nazwisko — jej osoba kontaktowa |
| „Forma płatności za dostawę” | „Gotówka” | „Przelew” — jeśli płacisz na podstawie umowy |
1
Dostawa zwrotna (odbiorca) — Pieniądze2
Usługa „Kontrola płatności”3
Płatnik dostawy- Dostawa zwrotna (odbiorca) ustawiona na Pieniądze z kwotą zamówienia.
- Przełącznik usługi „Kontrola płatności” jest wyłączony.
- Tu wybiera się płatnika dostawy: odbiorcę, nadawcę lub stronę trzecią.
Oddział, paczkomat czy adres
„Sposób nadania” domyślnie to „Oddział”. Wariant „Paczkomat” w przełączniku jest nieaktywny: paczkomat wybiera się z listy oddziałów, a Elbuz przekazuje Nova Poshta paczkę 20×20×10 cm. Limitów paczkomatu co do wagi i rozmiaru program nie sprawdza.
„Adres” — dostawa kurierem pod drzwi: zamiast oddziału pojawiają się „Ulica”, „Nr domu”, „Nr mieszkania” i „Komentarz do adresu (opcjonalnie)”; ulica i numer domu są obowiązkowe.
Ulicę Elbuz szuka po nazwie w słowniku Nova Poshta w mieście odbiorcy. Jeśli jej nie znajdzie, list się nie utworzy, a w oknie „Uwaga” będzie „Error: Street not found in the city: ‹ulica›”. Wpisz nazwę bez „вул.” (ul.).
Co się dzieje po kliknięciu „Utwórz list przewozowy”
- Elbuz sprawdza uprawnienie do okna tworzenia listu przewozowego i pola obowiązkowe. Gdy brakuje danych, pojawi się „Uwaga” z nazwą pola, na przykład „pusto Nadawca - Osoba kontaktowa”; list się nie tworzy, pieniądze nie są pobierane.
- Program rejestruje odbiorcę w Nova Poshta i tworzy list przewozowy z datą wysyłki „dzisiaj”.
- Numer trafia do pola „Numer listu przewozowego” zamówienia, okno zamyka się z komunikatem „Utworzono list przewozowy nr ‹numer›”. Link „Utwórz list przewozowy” znika z karty. Jeśli w sposobie dostawy wypełniono „Link do śledzenia przesyłki”, do zamówienia zapisuje się też link do śledzenia.
- Ponowne kliknięcie zwróci „List przewozowy już utworzony: ‹numer› — pominięto.”
- Jeśli Nova Poshta odmówi, w oknie „Uwaga” pojawi się jej komunikat, a zamówienie zostanie bez numeru.
Jak zmienić lub usunąć list przewozowy
Dopóki Nova Poshta nie przyjęła paczki — list ma status „utworzona” — można go zmienić lub usunąć z Elbuz. „Podgląd listu przewozowego” w karcie zamówienia otwiera wtedy ten sam formularz z komunikatem „List przewozowy nie został jeszcze przekazany Nova Poshta: dane można zmienić i zapisać albo usunąć list.”
1
Zapisz zmiany2
Usuń list przewozowy- Zapisz zmiany — zapisuje poprawione dane listu, dopóki nie został przekazany Nova Poshta.
- Usuń list przewozowy — usuwa numer listu z zamówienia.
- „Zapisz zmiany” wysyła formularz do Nova Poshta ponownie, numer listu się nie zmienia: „Zmiany zapisano w liście przewozowym Nova Poshta”.
- „Usuń list przewozowy” po potwierdzeniu usuwa list w Nova Poshta i czyści zamówienie: numer i stan paczki znikają, pojawia się „List przewozowy usunięty. Zamówienie można wysłać ponownie.”
Obie operacje zapisują się w historii zamówienia i wymagają uprawnienia do okna „Tworzenie listu przewozowego”. Usunąć list można też w „Przesyłkach” — dla paczki w stanie „Utworzona”.
Po przekazaniu formularz tylko pokazuje list; odbiorcę i płatnika zmienia się przez „Zmień dane listu przewozowego”.
Listy przewozowe zbiorczo, automatycznie i z konta Nova Poshta
Listy przewozowe zbiorczo
„Utwórz list przewozowy (dostawa)” na liście zamówień wystawia listy do wszystkich zaznaczonych zamówień bez formularza.
Nie musisz otwierać formularza każdego zamówienia: nadawca — z połączenia, waga — produkty × ilość, opis — kategoria lub lista produktów, reszta — jak w tabeli powyżej.
Sposób dostawy jest brany z zamówienia: do oddziału — wybranego przez klienta. Przy dostawie na adres ulicę i numer domu wystawianie zbiorcze bierze tylko z zapisanego formularza listu; bez niego w wierszu będzie „pusto Odbiorca - Ulica”. Jeśli w formularzu zamówienia coś zmieniano, brane są zapisane w nim wartości.
Zamówienia z listem są pomijane z czerwonym wierszem „List przewozowy już utworzony: ‹numer› — pominięto.” Więcej: listy przewozowe zbiorczo.
List przewozowy sam, gdy zamówienie przechodzi w status
Elbuz może wystawiać listy bez klikania. W połączeniu Nova Poshta wybierz status w polu „Twórz list przewozowy automatycznie, gdy zamówienie przejdzie w status”, na przykład „Skompletowano”. Domyślnie jest tam „— nie twórz —”.
1
Nadawca2
Status automatycznego tworzenia3
Podpowiedź pod polem- Nadawca — bez niego automatyczne tworzenie nie działa.
- Twórz list przewozowy automatycznie — ustawione na „nie twórz”.
- Podpowiedź objaśnia 10-minutowy cykl.
Co 10 minut program bierze zamówienia klientów w tym statusie z dostawą Nova Poshta, utworzone w ciągu ostatnich 7 dni i jeszcze bez listu — do 20 naraz — i wystawia listy tak samo jak zbiorczo. W historii zamówienia pojawia się „List ‹numer› utworzony automatycznie”.
Bez wybranego nadawcy automatyczne tworzenie nie działa, a formularz ostrzega: „Wybierz nadawcę powyżej — bez niego listy nie są tworzone automatycznie.” Jeśli Nova Poshta odmówi, w historii zamówienia będzie „Nie utworzono listu automatycznie: ‹przyczyna›. Kolejna próba za godzinę.” Popraw dane zamówienia — kolejna próba przejdzie sama.
Listy przewozowe wystawione na koncie Nova Poshta
Jeśli część listów wystawiasz na koncie Nova Poshta, Elbuz pokaże te, których nie ma w żadnym zamówieniu. Menu okna „Przesyłki” → „Listy przewozowe z konta Nova Poshta”: wybierz okres — domyślnie ostatnie 14 dni, nie dłużej niż 31 dni — i kliknij „Pokaż”.
Na liście są numer, data, stan, koszt dostawy, kwota pobrania i numer rejestru; imienia, nazwiska i telefonu odbiorcy tam nie ma. „Powiąż z zamówieniem” → „Numer zamówienia w Elbuz” → potwierdzenie → „List ‹numer› powiązany: jego status aktualizuje się teraz automatycznie.”
Powiązać można tylko z zamówieniem klienta bez listu przewozowego; sposób dostawy zamówienia zmienia się na „Nova Poshta”, a w historii pojawia się „Powiązano list ‹numer› z konta Nova Poshta”. Listę widzi pracownik, który widzi wszystkie zamówienia: na koncie są listy wszystkich menedżerów.
1
Okres i Pokaż2
Listy, których nie ma w Elbuz3
Powiąż z zamówieniem- Ustaw daty Od i Do i kliknij Pokaż, aby pobrać listy z konta.
- Ten wiersz podaje liczbę listów z konta, które nie mają odpowiadającego zamówienia w Elbuz.
- Ikona wiąże list z zamówieniem.
Pobranie i „Kontrola płatności”
| Przełącznik | Co trafi do Nova Poshta |
|---|---|
| wyłączony, „Dostawa zwrotna (odbiorca)” — „Pieniądze” | pobranie: zwrotna dostawa pieniędzy na kwotę z pola „Kwota”, płaci odbiorca |
| włączony, „Pieniądze” | usługa „Kontrola płatności” na tę samą kwotę |
| „Niepotrzebna” — z przełącznikiem lub bez | paczka bez pobrania |
„Kontrola płatności” działa tylko razem z „Pieniądze”: dla opłaconego zamówienia wystarczy ustawić „Niepotrzebna”.
Jak sprawdzić, że przelew dotarł
Odebraną paczkę Nova Poshta oznacza jednym z trzech kodów: 9 — odebrana, 10 — odebrana, przelew wpłynie w ciągu doby, 11 — przelew wypłacony. Paczkę z kodem 10 Elbuz śledzi dalej, dopóki nie przyjdzie 11.
- Kolumna „Pobranie” w „Przesyłkach” pokazuje kwotę i oznaczenie: „przelew otrzymany”, „oczekuje na przelew” albo „nieodebrana” — przy odmowach.
- Szybki filtr „Oczekuje na przelew pobrania” zostawia paczki, które odebrano, a pieniądze jeszcze nie przyszły.
- Kafelki „Przelewy pobrań w drodze” i „Pobrania w aktywnych przesyłkach” pokazują kwoty.
1
Kafelek Przelewy pobrań w drodze2
Oznaczenie oczekuje na przelew3
Filtr Oczekuje na przelew pobrania- Przelewy pobrań w drodze — suma pobrań, których Nova Poshta jeszcze nie wypłaciła.
- Oznaczenie oczekuje na przelew — paczka odebrana, a wypłata pobrania jest jeszcze w drodze.
- Filtr Oczekuje na przelew pobrania — pokazuje tylko paczki czekające na wypłatę.
Status płatności zamówienia sam zmienia się na „Opłacono” po kodzie 11, jeśli zamówienie jest w wybranym statusie — zob. automatyczną zmianę statusów.
Jak Elbuz śledzi paczki i zmienia statusy zamówień
Elbuz sam pyta Nova Poshta o stan paczek co 10 minut — według harmonogramu zadania „Sprawdzanie statusu dostawy”. Przycisk „Odśwież statusy” uruchamia sprawdzenie poza kolejnością.
Wynik trafia do okna „Przesyłki”: gdzie jest paczka, w którym oddziale, do kiedy jest przechowywana, ile kosztowała dostawa, czy przyszedł przelew, dlaczego nie doręczono. Filtry, kolumny i kafelki okna opisuje artykuł Przesyłki: wszystkie paczki w jednym rejestrze.
1
Kafelki stanów, które są też szybkimi filtrami2
Kafelki statystyk3
Przyciski operacji Nova Poshta- Szybkie filtry zawężają listę do paczek w punkcie odbioru, w drodze, z odmową itd.
- Kafelki statystyk pokazują, ile paczek i jaka kwota pobrań jest w drodze.
- Po zaznaczeniu wiersza Nova Poshta nad listą pojawiają się przyciski: rejestr, etykiety, przekierowanie, zmiana danych i zwrot.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
- Вирішальний крок
- Elbuz śledzi listy przewozowe Nova Poshta w zamówieniach z ostatnich 60 dni, a w zamówieniach w wybranych statusach — bez limitu dat. Odpytywanie kończy się na kodzie końcowym: 9 — odebrana, 11 — przelew wypłacony, 106 — odebrana i utworzono dostawę zwrotną, 2 — usunięta, 124 — zniszczona. Odmowy nie są końcowe: Elbuz śledzi je dalej.
- W jednym przebiegu — do 100 listów, najpierw te, które najdłużej nie były sprawdzane.
- Numer wpisany do zamówienia ręcznie (list utworzono na koncie Nova Poshta) też jest śledzony — jeśli sposób dostawy zamówienia to „Nova Poshta”.
- Koszt dostawy wyliczony przez Nova Poshta pojawia się w kolumnie „Dostawa”; do samego zamówienia przy tworzeniu listu nie jest zapisywany.
- Imienia, nazwiska, telefonu i adresu odbiorcy z odpowiedzi Nova Poshta Elbuz nie zapisuje.
Jak ustawić automatyczną zmianę statusu zamówienia
Status zamówienia, status dostawy i status płatności Elbuz zmienia tylko w zamówieniach, których status zaznaczono w połączeniu. Pozostałe paczki są tylko śledzone.
- W formularzu połączenia, w bloku „Statusy zamówień, dla których sprawdzać status przesyłki w firmie kurierskiej”, zaznacz statusy, w których zamówienie czeka na dostawę, na przykład „Wysłano” i „Dostarczono”. Zaznacz też statusy, w które program sam przestawi zamówienie: zamówienie w „Dostarczono” bez zaznaczenia nie przejdzie już w „Zrealizowano” i nie dostanie „Opłacono”.
- W bloku „Ustawienia powiadomień” otwórz po kolei „Statusy zamówienia”, „Statusy dostawy” i „Statusy płatności”. Przy pierwszym otwarciu program sam wpisze kody Nova Poshta w kolumnę „Kod (nazwa) na stronie (API)”.
- Sprawdź kody albo dopisz swoje po przecinku.
| Okno | Twój status | Kody Nova Poshta |
|---|---|---|
| „Statusy zamówienia” | „Dostarczono” | 7, 8 — dotarła do oddziału lub paczkomatu |
| „Statusy zamówienia” | „Zrealizowano” | 9, 10, 11 — odebrana |
| „Statusy dostawy” | „W drodze” | 4, 41, 5, 6 |
| „Statusy dostawy” | „W miejscu docelowym” | 7, 8 |
| „Statusy dostawy” | „Dostarczono” | 9, 10, 11 |
| „Statusy dostawy” | „Odrzucenie” | 102, 103 |
| „Statusy płatności” | „Opłacono” | 11 — przelew wypłacony |
1
Kolumna Kod (nazwa) na stronie (API)2
Wiersz W miejscu docelowym z kodami 7,8- Kolumna Kod (nazwa) na stronie (API) zawiera kody statusów Nova Poshta przypisane do każdego statusu dostawy.
- Do wiersza W miejscu docelowym przypisane są kody 7 i 8.
Gdy status się zmieni, do dziennika operacji zamówienia trafia „Zmienił się status dostawy: ‹kod› ‹tekst Nova Poshta› #‹numer listu›” i uruchamiają się Twoje reguły automatyczne na zdarzenie „Dokument: aktualizacja” — na przykład SMS o dotarciu paczki.
Rejestr, etykiety i zamawianie kuriera
Rejestr to jeden dokument na wszystkie paczki, które nadajesz w oddziale lub przekazujesz kurierowi, zamiast osobnego listu na każdą. Elbuz tworzy go na koncie Nova Poshta.
Gdzie: Słowniki → Dokumenty → Przesyłki → zaznacz wiersze → „Dodaj do rejestru Nova Poshta”.
- Ustaw filtr „Nienadane” — paczki, które nie zostały jeszcze nadane.
- Zaznacz potrzebne wiersze i kliknij „Dodaj do rejestru Nova Poshta”.
- W polu „Rejestr” wybierz „Nowy rejestr na dziś” lub otwarty rejestr, który nie był jeszcze drukowany.
- Kliknij „Dodaj”. Program odpowie „Rejestr ‹numer›: dodano listów przewozowych — ‹liczba›” i wymieni listy, których Nova Poshta nie przyjęła, z przyczyną.
- Kliknij „Drukuj rejestr” — wydrukuj dwa egzemplarze — i jeden z przycisków etykiet: „Etykiety A4 (6 na arkuszu, 85×85)” lub „Etykiety na drukarkę termiczną 100×100”, aby nakleić etykietę na każdą paczkę.
1
Numery wybranych listów2
Pole Rejestr3
Przycisk Dodaj- Numery wybranych listów przewozowych, które trafią do rejestru.
- Pole Rejestr — domyślnie „Nowy rejestr na dziś”.
- Przycisk Dodaj — dodaje listy do rejestru.
Numer rejestru pojawia się w kolumnie „Rejestr NP” i w dzienniku zamówienia.
Zasady rejestru ustala Nova Poshta: wszystkie listy — od jednego nadawcy; list może być tylko w jednym rejestrze; po wydrukowaniu rejestru nic nie można do niego dodać; paczki zeskanowanej już w oddziale nie da się dodać. Elbuz szuka listu po numerze na koncie, do którego należy klucz, więc list z innego konta do rejestru nie trafi.
Druk listu przewozowego, etykiet i rejestru
| Przycisk | Co się drukuje |
|---|---|
| „Drukuj” w „Podglądzie listu przewozowego”, „Drukuj list przewozowy” w „Przesyłkach” | blankiet listu przewozowego A4; gdy zaznaczono kilka listów Nova Poshta — wszystkie blankiety w jednym PDF |
| „Drukuj etykiety” w „Przesyłkach” → „Etykiety A4 (6 na arkuszu, 85×85)” | naklejki 85×85 mm, po 6 na arkuszu A4 — na zwykłą drukarkę |
| „Drukuj etykiety” → „Etykiety na drukarkę termiczną 100×100” | etykiety 100×100 mm na drukarkę termiczną (Zebra) |
| „Drukuj rejestr” | rejestr przekazania |
PDF otwiera się z Elbuz w nowej karcie: nie trzeba logować się na konto Nova Poshta, a w adresie nie ma klucza API. Jeśli Nova Poshta odmówi druku, w tej samej karcie pojawi się przyczyna.
Czerwony komunikat zamiast karty oznacza, że zapytanie nie dotarło do Nova Poshta: brak klucza połączenia lub numeru listu, „Brak dostępu do tej przesyłki.” — brak uprawnienia albo zamówienie poza „Czyje dane”, „Nie udało się wykonać działania. Spróbuj ponownie.” — awaria łączności.
Zamawianie kuriera do paczek
Kuriera Nova Poshta, który odbierze paczki spod Twojego adresu, zamawia się z „Przesyłek”. Do jednej paczki można go zamówić też z okna listu przewozowego w karcie zamówienia — blok „Zamówienie kuriera” pod formularzem; do kilku paczek — z „Przesyłek”. Usługę „Zamówienie kuriera” włącza osobisty opiekun Nova Poshta.
- Zaznacz paczki i kliknij „Zamów kuriera”.
- „Data odbioru” — najbliższy dzień roboczy: dziś, jeśli jest przed 16:00, w przeciwnym razie następny; weekend przesuwa się na poniedziałek.
- „Przedział godzin” — wolne przedziały Nova Poshta; „Adres nadawcy” — z Twojego konta; „Planowana waga, kg” — suma wag zaznaczonych listów.
- „Zamów” → „Kurier zamówiony, zlecenie ‹numer›”. Listy, których Nova Poshta nie przyjęła do zlecenia, zostaną wymienione z przyczyną.
1
Data odbioru2
Przedział godzin3
Adres nadawcy4
Planowana waga5
Zamów- Wybierz dzień, w którym ma przyjechać kurier.
- Wybierz jeden z przedziałów godzin oferowanych przez Nova Poshta.
- Wybierz adres nadawcy, spod którego kurier odbierze paczki.
- Wpisz szacowaną łączną wagę zaznaczonych paczek.
- Zamów składa zlecenie kuriera.
Przyjęte listy dostają wpis w historii zamówienia. Brak wolnych przedziałów — wybierz inny dzień; brak adresów — dodaj adres odbioru na koncie Nova Poshta.
Menu okna → „Zamówienia kuriera” pokazuje zlecenia z ostatnich 7 dni i przycisk „Anuluj zamówienie”. Jeśli do końca przedziału zostało mniej niż godzina, a rozliczenie jest bezgotówkowe, anulowanie jest płatne — 350 UAH. Lista i anulowanie są dostępne dla pracownika, który widzi wszystkie zamówienia: zlecenia są wspólne dla całego konta.
Lista rejestrów i rozwiązywanie
Rejestr Nova Poshta jest wspólny dla całego konta, dlatego pracownik z ograniczonymi „Czyje dane” nie widzi pozycji „Rejestry Nova Poshta”, a w „Dodaj do rejestru Nova Poshta” ma dostępny tylko „Nowy rejestr na dziś”. Przy próbie druku cudzego rejestru dostanie odmowę „Rejestrami Nova Poshta zarządza pracownik, który widzi wszystkie zamówienia: rejestr zawiera listy przewozowe całego konta.”
Menu okna „Przesyłki” → „Rejestry Nova Poshta” pokazuje rejestry konta: numer, datę, oznaczenie „wydrukowany” lub „otwarty”. Tu też są druk i „Rozwiąż”: „Rozwiązać rejestr ‹numer›? Listy przewozowe pozostaną i można je dodać do innego rejestru.”
1
Otwarty rejestr2
Wydrukowany rejestr3
Przycisk Rozwiąż- Otwarty rejestr — można jeszcze dodawać listy.
- Wydrukowany rejestr — nie można już dodawać listów.
- Przycisk Rozwiąż — rozwiązuje rejestr.
Przekierowanie, zmiana danych i zwrot paczki
Trzy działania z paczką, która jest już w drodze lub w oddziale — bez konta Nova Poshta. Zaznacz wiersz w „Przesyłkach”, a nad listą pojawią się przyciski „Przekieruj”, „Zmień dane listu przewozowego”, „Zwróć do nadawcy”. Czy działanie jest możliwe właśnie teraz, decyduje Nova Poshta: Elbuz najpierw ją pyta, a jeśli nie można, pokazuje jej odpowiedź.
Przekierowanie paczki Nova Poshta do innego oddziału
U góry panelu widać, dokąd paczka jedzie teraz i do kogo. Dalej:
- W polu „Miasto” zacznij wpisywać nazwę — od dwóch liter — i wybierz miasto, potem „Oddział”.
- Wskaż „Kto płaci” („Odbiorca” lub „Nadawca (my)”), „Forma płatności” i w razie potrzeby „Uwagi dla przewoźnika”.
- „Oblicz” pokaże „Koszt” i „Przewidywana dostawa” — tak znasz koszt przekierowania przed jego zleceniem.
- „Zleć przekierowanie” → potwierdzenie „Przekierować przesyłkę do «‹oddział›»?” → „Utworzono zlecenie przekierowania: ‹numer›”.
1
Obecny cel2
Nowe miasto i punkt odbioru3
Wyliczony koszt4
Zleć przekierowanie- Wiersz „Obecnie” pokazuje, dokąd paczka jedzie w tej chwili.
- Tu wybierz nowe miasto i punkt odbioru.
- Po kliknięciu Oblicz panel pokazuje koszt przekierowania i przewidywaną datę dostawy.
- Zleć przekierowanie tworzy zlecenie w Nova Poshta.
Oddział w karcie zamówienia się nie zmienia — zlecenie zapisuje się w dzienniku zamówienia: „Zlecono przekierowanie listu przewozowego ‹numer›, zlecenie ‹numer›”.
Zmiana danych listu przewozowego
„Zmień dane listu przewozowego” otwiera to, co Nova Poshta pozwala zmienić właśnie w tej paczce: „Imię i nazwisko odbiorcy” i „Telefon odbiorcy”, „Kto płaci” i „Forma płatności”. Jeśli nie pozwala na nic — „Przewoźnik nie pozwala zmienić tego listu przewozowego.” „Zapisz zmiany” → „Wysłać do przewoźnika zmiany listu przewozowego ‹numer›?” → „Utworzono zlecenie zmiany danych: ‹numer›”.
Zwrot paczki do nadawcy
- „Dokąd zwrócić” — adres zwrotu, który Nova Poshta proponuje dla Twojego konta.
- „Powód” i „Szczegóły powodu” — z listy Nova Poshta.
- „Forma płatności”: „Gotówka”, a „Przelew” — jeśli Nova Poshta na to pozwala; „Uwagi dla przewoźnika” — w razie potrzeby.
- „Oblicz” — cena i data zwrotu.
- „Zleć zwrot” → „Zwrócić list przewozowy ‹numer› do nadawcy? Usługa jest płatna według cennika przewoźnika.” → „Utworzono zlecenie zwrotu: ‹numer›”.
1
Dokąd zwrócić2
Powód3
Wyliczony koszt4
Zleć zwrot- Dokąd zwrócić — oddział Nova Poshta, do którego wraca paczka.
- Powód i szczegóły powodu pochodzą z listy przewoźnika.
- Po kliknięciu Oblicz pojawia się koszt zwrotu.
- Zleć zwrot wysyła zlecenie do Nova Poshta.
W dzienniku zamówienia zapisuje się „Zlecono zwrot listu przewozowego ‹numer› do nadawcy, zlecenie ‹numer›”. Numer listu zwrotnego pojawi się w „Przesyłkach” w kolumnie „List zwrotny” po jednym z najbliższych sprawdzeń statusu. Kolumna jest domyślnie ukryta — włącz ją w menu okna → „Ustawienia kolumn”.
Jak powiadomić klienta o paczce
SMS do odbiorcy ręcznie
W „Przesyłkach” przycisk „SMS do odbiorcy” nad wierszem lub ikona SMS w wierszu otwiera to samo okno wysyłki co „Wyślij” → SMS w karcie zamówienia. Numer telefonu jest brany z telefonu dostawy zamówienia, a gdy jest pusty — z karty klienta; sprawdź go przed wysłaniem. Numer listu przewozowego wpisz w treść. Potrzebny jest podłączony serwis SMS — jak go podłączyć.
Paczki, o których czas przypomnieć, zostawia filtr „Kończy się przechowywanie” — w oddziale, a do zwrotu zostały 2 dni lub mniej.
Automatyczny SMS, gdy paczka dotarła
Elbuz może sam wysłać SMS, gdy Nova Poshta poinformuje, że paczka jest w oddziale. Potrzebna jest do tego reguła automatyczna (lista zamówień → menu w nagłówku → „Reguły automatyczne”):
- zdarzenie — „Dokument: aktualizacja”;
- warunek — „Status dostawy” równa się „W miejscu docelowym”;
- polecenie — „Wyślij SMS” z tekstem o oddziale i numerze listu przewozowego.
Zadziała, jeśli zamówienie jest w wybranym statusie, a kod 7, 8 jest w „Statusach dostawy” (ustawienia). Jedno zamówienie dostanie ten SMS jeden raz.
Gdzie jest moje zamówienie: odpowiedź AI i „Zgłoszenia”
- Wsparcie AI odpowiada klientowi na „gdzie jest moje zamówienie” na czacie, w komunikatorze lub e-mailu: stan paczki, oddział, przewidywana data, do kiedy jest przechowywana. Więcej: status paczki w AI.
- Proaktywne wiadomości: „dotarła do oddziału” i przypomnienie przed zwrotem — powiadomienia dla klienta.
- „Zgłoszenia” dla menedżera przy problematycznych paczkach — „paczka czeka w oddziale, klient jej nie odbiera”, „odmowa przyjęcia paczki / zwrot do nadawcy”, „pobranie nie wpłynęło po dostawie”, „paczka utknęła w drodze — brak ruchu”. Domyślnie są wyłączone i niczego nie wysyłają klientowi: problematyczne zamówienia.
- AI zmienia oddział Nova Poshta na prośbę klienta: zmiana oddziału. Tryb jest domyślnie wyłączony. Ponownie utworzyć list w statusie „utworzona” AI może tylko przy włączonym „Można utworzyć list przewozowy ponownie” — stary list usuwa wtedy przez API; bez zgody przekazuje zgłoszenie pracownikowi.
Co zostaje na koncie Nova Poshta
Codzienna praca z paczkami odbywa się w Elbuz. Na konto Nova Poshta trzeba zajrzeć przy takich działaniach:
| Działanie | Co zrobić |
|---|---|
| Przedłużyć przechowywanie | na koncie; Elbuz pokazuje, do kiedy paczka jest przechowywana |
| Przekierować na adres, zwrócić do innego oddziału lub na inny adres | na koncie; z Elbuz — przekierowanie do oddziału i zwrot na adres z Twojego konta |
| Zamienić pobranie na przelew na kartę, zmienić przedział godzin dostawy kurierem do odbiorcy, anulować zlecenie zwrotu lub przekierowania | na koncie |
| Usunąć list przewozowy, który Nova Poshta już przyjęła | nigdzie — paczkę zwraca się do nadawcy (zwrot) |
| Dokumenty, palety, opony; paczki o różnych wymiarach w jednej przesyłce | na koncie; z Elbuz — paczka lub ładunek z łączną wagą i liczbą miejsc |
Scenariusze
Pierwsze podłączenie
Co zrobić. Utwórz klucz na koncie, wpisz go w „Token”, włącz „Aktywność”, wybierz miasto i oddział nadawcy, zaznacz statusy „Wysłano” i „Dostarczono” i otwórz trzy okna statusów.
Efekt. Po 10 minutach (albo od razu po „Odśwież statusy”) w „Przesyłkach” zaczną pojawiać się statusy paczek z ostatnich 60 dni — po 100 listów na przebieg. Zamówienia w „Wysłano” same przejdą w „Dostarczono”, a dalej w „Zrealizowano”.
Codzienna wysyłka
Co zrobić. Zaznacz zamówienia na liście i wybierz „Utwórz list przewozowy (dostawa)”, potem w „Przesyłkach” ustaw filtr „Nienadane”, zaznacz wszystkie, „Dodaj do rejestru Nova Poshta” → „Nowy rejestr na dziś” → „Dodaj”, potem „Drukuj rejestr” i „Drukuj etykiety”. Paczki odbiera kurier — „Zamów kuriera” dla tych samych wierszy.
Efekt. Jeden rejestr w dwóch egzemplarzach i etykieta na każdej paczce; numer rejestru — w każdym zamówieniu, kurier przyjedzie w wybranym przedziale.
Listy przewozowe bez klikania
Co zrobić. W połączeniu Nova Poshta wybierz nadawcę, a w automatycznym tworzeniu — status „Skompletowano”.
Efekt. Gdy magazyn przestawi zamówienie na „Skompletowano”, w ciągu 10 minut pojawi się w nim numer listu; odmowy Nova Poshta widać w historii zamówienia.
Klient prosi o inny oddział, paczka już jedzie
Co zrobić. „Przesyłki” → wiersz → „Przekieruj”, wybierz miasto i oddział, „Oblicz”, podaj klientowi cenę, „Zleć przekierowanie”.
Efekt. Zlecenie w Nova Poshta, wpis w dzienniku zamówienia; nowy oddział pojawi się w kolumnie „Punkt odbioru” po sprawdzeniu statusu.
Paczka leży, wkrótce wróci
Co zrobić. Filtr „Kończy się przechowywanie” → „SMS do odbiorcy”.
Efekt. Klient dostaje przypomnienie, póki paczkę można jeszcze odebrać; przedłużenie przechowywania — na koncie Nova Poshta.
Kontrola pobrań w skali tygodnia
Co zrobić. Filtr „Oczekuje na przelew pobrania” i kafelek „Przelewy pobrań w drodze”; w „Zgłoszeniach” włącz problem „pobranie nie wpłynęło po dostawie”.
Efekt. Widzisz kwotę w drodze, a zamówienia, w których pieniądze nie przyszły w ciągu 5 dni, trafiają do menedżera jako osobne zgłoszenie.
Co zrobić, gdy coś pójdzie nie tak
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Firma kurierska nie jest podłączona: uzupełnij ustawienia API tej firmy (Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje).” przy otwieraniu formularza listu; zbiorczo — „pusto - Token API” | Nie wpisano klucza albo „Aktywność” jest wyłączona, także po automatycznym wyłączeniu | Wpisz klucz i włącz „Aktywność” (gdzie wpisać klucz) |
| Powiadomienie „Integracja wyłączona” | Nova Poshta 10 razy z rzędu odrzuciła klucz | Utwórz nowy klucz na koncie, wpisz go w „Token”, włącz „Aktywność” (automatyczne wyłączenie) |
| „pusto Nadawca - Nadawca” (lub „- Osoba kontaktowa”, „- Miasto”, „- Oddział”) | W połączeniu Nova Poshta nie wybrano nadawcy, osoby kontaktowej lub oddziału nadania | Wybierz je w bloku „Nadawca” połączenia — potem wszystkie listy uzupełnią je same (gdzie wpisać klucz) |
| Listy „Nadawca” i „Osoba kontaktowa” w połączeniu są puste | Nova Poshta nie przyjęła klucza | Skopiuj klucz z konta jeszcze raz i wpisz go w „Token” (klucz API) |
| „Error: Street not found in the city: ‹ulica›” | Ulicy o takiej nazwie nie ma w słowniku Nova Poshta dla miasta odbiorcy | Wpisz nazwę ulicy bez „вул.” i skrótów, tak jak zapisuje ją Nova Poshta (dostawa na adres) |
| W formularzu listu puste są miasto i oddział odbiorcy | Nazwa miasta lub oddziału w zamówieniu nie zgadza się ze słownikiem Nova Poshta | Wybierz miasto i oddział w formularzu ręcznie (słowniki) |
| List usunięto na koncie, a w karcie nie ma „Utwórz list przewozowy” | Numer usuniętego listu został w zamówieniu | Wyczyść „Numer listu przewozowego” w „Więcej pól” (po utworzeniu) |
| „‹numer›: listu przewozowego nie ma na koncie Nova Poshta tego klucza API (utworzony na innym koncie lub usunięty).” przy dodawaniu do rejestru | List utworzono na innym koncie Nova Poshta, nie na tym, którego klucz wpisano w Elbuz | Dodaj go do rejestru na koncie, na którym go utworzono (rejestr) |
| „Rejestrami Nova Poshta zarządza pracownik, który widzi wszystkie zamówienia: rejestr zawiera listy przewozowe całego konta.” | Masz ograniczone „Czyje dane” | Dodawaj listy do nowego rejestru; cudze rejestry drukuje pracownik z dostępem do wszystkich zamówień (lista rejestrów) |
| „Przewoźnik nie pozwala zmienić tego listu przewozowego.” | Na tym etapie Nova Poshta nie przyjmuje zmian | Sprawdź przekierowanie albo skorzystaj z konta Nova Poshta (działania z paczką) |
| „Przesyłka została już przekazana Nova Poshta — listu przewozowego nie można zmienić ani usunąć.” | Nova Poshta już przyjęła paczkę | Odbiorcę lub płatnika zmień przez „Zmień dane listu przewozowego”, paczkę zwróć przez „Zwróć do nadawcy” (działania z paczką) |
| „Usługę «Zamówienie kuriera» włącza osobisty opiekun Nova Poshta…” | W Twojej umowie nie włączono zamawiania kuriera | Skontaktuj się z osobistym opiekunem Nova Poshta (zamawianie kuriera) |
| „Nie utworzono listu automatycznie: ‹przyczyna›. Kolejna próba za godzinę.” w historii zamówienia | Nova Poshta odmówiła albo w zamówieniu brakuje danych | Popraw dane zamówienia — kolejna próba nastąpi sama (automatyczne tworzenie) |
| Paczki się odświeżają, a status zamówienia się nie zmienia | Status zamówienia nie jest zaznaczony w połączeniu albo okien statusów jeszcze nie otwierano | Zaznacz statusy i otwórz trzy okna statusów (automatyczna zmiana statusów) |
| „Błąd aktualizacji słowników:” i przyczyna | Słownik jest chwilowo niedostępny; zostaje poprzednia wersja | Spróbuj „Aktualizuj słowniki” później lub poczekaj na nocną aktualizację (słowniki) |
Najczęstsze pytania
Ile kosztuje integracja z Nova Poshta?
Elbuz nie pobiera opłat za listy przewozowe, statusy ani działania z paczkami. Za list, przekierowanie i zwrot płacisz Nova Poshta według jej cennika, za SMS — serwisowi SMS.
Czy Elbuz widzi listy przewozowe utworzone na koncie Nova Poshta?
Tak: menu „Przesyłki” → „Listy przewozowe z konta Nova Poshta” pokazuje te, których nie ma w zamówieniach, i wiąże je z zamówieniem (listy z konta). Po powiązaniu paczka jest śledzona tak jak utworzona w Elbuz.
Dlaczego status w Elbuz jest opóźniony względem strony Nova Poshta?
Elbuz pyta Nova Poshta co 10 minut i w jednym przebiegu bierze do 100 listów. Aby odświeżyć teraz, kliknij „Odśwież statusy” w „Przesyłkach”.
Jak długo Elbuz śledzi paczkę?
Do kodu końcowego Nova Poshta — 9, 11, 106, usunięta lub zniszczona. Zamówienia w niezaznaczonych statusach — do 60 dni od utworzenia, w zaznaczonych — bez limitu dat. Paczka z kodem 10 jest śledzona dalej, dopóki nie przyjdzie przelew.
Klucz w formularzu jest pokazywany jako kropki — czy jest zapisany?
Tak: kropki w polu „Token” są widoczne tylko wtedy, gdy klucz jest zapisany. Puste pole nie kasuje klucza; aby go wymienić, wpisz nowy w jego miejsce.
Czy można anulować list przewozowy z Elbuz?
Tak, dopóki Nova Poshta nie przyjęła paczki: „Usuń list przewozowy” w karcie zamówienia lub w „Przesyłkach”. Po przekazaniu — tylko zwrot do nadawcy (zmiana i usuwanie).
Czy można przedłużyć przechowywanie paczki z Elbuz?
Nie, przedłużenie — na koncie Nova Poshta. Elbuz pokazuje, do kiedy paczka czeka w oddziale, i pozwala wysłać klientowi SMS (SMS ręcznie).
Dlaczego SMS „status się zmienił” nie przychodzi, gdy status zmieniła Nova Poshta?
W warunku jest „jest różne od «Wartość początkowa»”, a ten warunek jest sprawdzany tylko przy zapisie przez człowieka. Dla statusu od Nova Poshta ustaw warunek „Status dostawy równa się …” (automatyczny SMS).
Gdzie to jest i kto ma dostęp
- Menu
- Panel klienta → Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje → Dostawa
- Inne wejścia
- Słowniki → Dokumenty → Przesyłki → „Przewoźnicy”; karta zamówienia → sekcja „Dostawa”
- Uprawnienia
- podłączenie — „API i tokeny dostępu”; paczki — okno „Przesyłki”; listy przewozowe — okno „Tworzenie listu przewozowego”
- Przygotuj
- klucz API z konta biznesowego Nova Poshta, miasto i oddział, z którego wysyłasz
Działania z paczkami działają tylko dla zamówień, które użytkownik widzi zgodnie z ustawieniem „Czyje dane”. Listę rejestrów konta widzi tylko ten, kto ma dostęp do wszystkich zamówień: w rejestrze Nova Poshta są listy wszystkich menedżerów.
- Utwórz klucz APIKonto biznesowe Nova Poshta
- Wpisz klucz, wybierz nadawcę, miasto i oddziałUsługi zewnętrzne i integracje → Nova Poshta
- Zaznacz statusy i otwórz okna kodówTamże, „Ustawienia powiadomień”
- Wystaw list przewozowyKarta zamówienia, sekcja „Dostawa”
- Utwórz rejestr, wydrukuj etykiety, zamów kurieraPrzesyłki
- Przekieruj, zwróć, zmień danePrzesyłki, panel nad wierszem
Powiązane tematy
- Jeśli towar leży w magazynie Nova Poshta, a zamówienia kompletuje fulfillment — Nova Poshta Fulfillment. Połączenie „Nova Poshta” z tym samym kluczem jest potrzebne do śledzenia i druku listów fulfillmentu.
- Jeśli chcesz widzieć wszystkie paczki wszystkich przewoźników na jednej liście — Przesyłki.
- Jeśli wysyłasz innym przewoźnikiem lub przez Rozetkę — jak wystawić list przewozowy z zamówienia.
- Jeśli listy przewozowe trzeba wystawić do dziesiątek zamówień — listy przewozowe zbiorczo.
- Jeśli klient nie odbiera paczki lub nie przyszło pobranie — problematyczne zamówienia w „Zgłoszeniach”.
- Jeśli SMS nie jest jeszcze podłączony — wysyłka SMS.
