Elbuz przekazuje zamówienia do magazynu Nova Poshta Fulfillment jednym przyciskiem, a magazyn sam kompletuje, pakuje i wysyła paczkę. Numer listu przewozowego wraca do zamówienia, statusy i stany magazynu przychodzą same.
Kiedy to się przyda:
- Towar leży w magazynie Nova Poshta — nie przenosisz ręcznie zamówień i kart produktów do panelu fulfillmentu.
- Klientowi trzeba wysłać numer listu przewozowego — numer jest od razu w zamówieniu, działają SMS, e-maile i rejestr „Przesyłki”.
- Strona sprzedaje to, czego w magazynie już nie ma — stany magazynu fulfillmentu odświeżają się co godzinę.
Od czego zacząć: uzyskaj dostęp od opiekuna fulfillmentu i wypełnij połączenie „Nova Poshta Fulfillment”.
Co potrafi fulfillment Nova Poshta w Elbuz
- Produkty do magazynu — nazwa, kod kreskowy, waga i wymiary z karty produktu, bez ręcznego zakładania w panelu fulfillmentu.
- Zamówienia do magazynu — odbiorca, oddział lub paczkomat, pozycje według kodu produktu i pobranie jednym przyciskiem.
- List przewozowy od magazynu — list Nova Poshta tworzy magazyn, a numer od razu zapisuje się w zamówieniu.
- Anulowanie — dopóki magazyn nie wziął zamówienia do realizacji.
- Statusy — magazynowe do wysyłki, potem statusy Nova Poshta, a zamówienie samo przechodzi w Twój status aż do „Dostarczono” lub „Odrzucenie”.
- Stany — osobny magazyn „Nova Poshta Fulfillment” w Elbuz, aktualizacja co godzinę.
- Запит або дія
- Відповідь
- Примітка
Jak podłączyć Nova Poshta Fulfillment
Fulfillment podłącza się nie kluczem API, lecz dostępem do serwisu internetowego magazynu. Wydaje go opiekun fulfillmentu Nova Poshta.
Co uzyskać od opiekuna fulfillmentu
Gdzie: Ustawienia systemu → Inne ustawienia → „Usługi zewnętrzne i integracje” → grupa „Dostawa” → „Nova Poshta Fulfillment”. To osobny wiersz, nie ten sam co „Nova Poshta”.
- Wpisz „Użytkownik” i „Hasło” serwisu.
- Wypełnij „Kod organizacji (Organization)” i „Kod magazynu fulfillmentu”.
- Wybierz „Kto płaci za dostawę” (domyślnie odbiorca) i „Forma płatności za dostawę” (domyślnie gotówka). W formularzu listu przewozowego tych wartości się nie zmienia.
- Wybierz, jak pobierać pieniądze przy odbiorze, — poniżej.
- Wybierz „Kod produktu w magazynie fulfillmentu” — który dokładnie.
- Włącz „Aktywność”.
1
Kto wydaje dostęp, biała lista IP2
Od opiekuna fulfillmentu3
Magazyn, który wysyła4
Pobranie lub kontrola płatności5
Po czym magazyn rozpoznaje produkt6
Serwer testowy fulfillmentu- Szara podpowiedź — kto wydaje dostęp i że IP serwera Elbuz trzeba dodać do białej listy.
- Kod organizacji (NPL_A1) — podaje go opiekun fulfillmentu.
- Kod magazynu fulfillmentu (3PL_OCN) — magazyn, z którego wysyłane są zamówienia.
- „Płatność przy odbiorze” — pobranie lub kontrola płatności.
- „Kod produktu w magazynie fulfillmentu” — po którym polu karty magazyn rozpoznaje produkt.
- Przełącznik „Środowisko testowe (sandbox)” włącza serwer testowy fulfillmentu.
„Płatność przy odbiorze” ma dwa tryby. „Pobranie (zwrot pieniędzy przesyłką)” — pieniądze wracają do Ciebie przekazem, prowizję za niego płaci odbiorca. „Kontrola płatności (na konto, wymaga umowy z Nova Poshta)” — pieniądze trafiają na rachunek, potrzebna jest umowa osoby prawnej z Nova Poshta.
„Jednostka miary w fulfillmencie” domyślnie to „szt.” — zmień ją tylko wtedy, gdy magazyn prowadzi towar w innych jednostkach. „Środowisko testowe (sandbox)” kieruje zapytania na serwer testowy fulfillmentu.
Klucza API Nova Poshta nie wpisuje się w to połączenie. Aby śledzić paczki według kodów Nova Poshta i drukować listy przewozowe z Elbuz, podłącz też „Nova Poshta” dla tej samej firmy — z tym kluczem, który przekazano magazynowi.
Jaki kod produktu wybrać
Magazyn rozpoznaje produkt po jednym kodzie. Tym kodem Elbuz przekazuje pozycje zamówień, zakłada produkty w magazynie i dopasowuje stany. Który kod brać z karty produktu, ustala pole „Kod produktu w magazynie fulfillmentu” w połączeniu.
1
SKU, Elbuz UUID, kod modelu lub EAN2
Jeden kod dla zamówień i stanów3
Magazyn zna produkty — nie zmieniaj kodu- Lista — SKU, Elbuz UUID, kod modelu lub EAN.
- Szara podpowiedź — magazyn rozpoznaje produkt po tym jednym kodzie w zamówieniach i stanach.
- Pomarańczowe ostrzeżenie — to połączenie ma już stany lub wysyłki, więc kodu nie wolno zmieniać.
| Wartość | Pole w karcie produktu | Kiedy wybrać |
|---|---|---|
| SKU (domyślnie) | „Kod (SKU)” | produkty są już założone w panelu fulfillmentu według SKU |
| Elbuz UUID | „UUID” | nowe połączenie, a produkty do magazynu przekazuje Elbuz: UUID ma każdy produkt i nigdy się nie zmienia |
| Kod modelu | „Model” | magazyn prowadzi produkty według kodu modelu |
| EAN | „EAN (Europejski kod artykułu)” | magazyn prowadzi produkty według kodu kreskowego |
Jeśli dopiero się podłączasz i zakładasz produkty przez Elbuz, wybierz Elbuz UUID: SKU często się zmienia, gdy zmieniasz nazwę produktu lub dostawcę, a UUID nie zmieni się nigdy. Jeśli produkty leżą już w magazynie pod swoimi SKU — zostaw „SKU”.
Kod musi być wypełniony w każdym produkcie, który trafia do magazynu. Pusty kod zatrzymuje przekazanie jeszcze przed magazynem, z nazwą produktu — rozwiązanie błędu.
Jak przekazać produkty do magazynu
Aby magazyn przyjął dostawę i kompletował zamówienia, musi znać Twoje produkty. Elbuz zakłada je w magazynie sam — z kart produktów.
Gdzie: okno „Produkty” → prawy klik na wierszu → „Przekaż do Nova Poshta Fulfillment”. Pozycja jest widoczna tylko wtedy, gdy połączenie fulfillmentu jest aktywne.
1
Przekaż zaznaczone produkty do magazynu2
Zaznaczone produkty- „Przekaż do Nova Poshta Fulfillment (3)” — przekazuje zaznaczone produkty do magazynu.
- Pola wyboru — zaznaczone produkty.
- Zaznacz produkty. Bez zaznaczeń przekazywany jest produkt z wiersza pod kursorem.
- Prawy klik → „Przekaż do Nova Poshta Fulfillment (N)”, gdzie N to liczba zaznaczonych produktów.
- Poczekaj na odpowiedź magazynu. Wszystko przyjęte — komunikat „Magazyn fulfillmentu przyjął produktów: N”. Część nieprzyjęta — okno z listą „Nieprzyjęte:” i przyczyną przy każdym produkcie.
Co magazyn dostaje o każdym produkcie:
- Kod — ten, który wybrano w połączeniu.
- Nazwę — do 150 znaków.
- Kod kreskowy — z pola EAN, jeśli jest wypełnione.
- Wagę i wymiary — z karty, Elbuz sam przelicza je na kilogramy i centymetry.
- Jednostkę miary — z pola „Jednostka miary w fulfillmencie” połączenia.
Przekazywanie produktów przed każdym zamówieniem nie jest konieczne. „Utwórz list przewozowy” sam dosyła magazynowi produkty z zamówienia, których nie zna jeszcze pod bieżącym kodem. Jeśli magazyn nie przyjmie produktu, zamówienie nie zostanie wysłane, a w odpowiedzi widać przyczynę.
Po zmianie nazwy, wagi lub kodu kreskowego w karcie przekaż produkt jeszcze raz: zmiany nie trafiają do magazynu same. Dostawę (plan przyjęcia towaru) zgłasza się w panelu fulfillmentu, Elbuz jej nie tworzy. Dodatkowych kodów kreskowych i opakowań Elbuz nie przekazuje.
Jak przekazać zamówienie do magazynu
Zamówienie ze sposobem dostawy „Nova Poshta Fulfillment” przekazuje się tym samym przyciskiem co list przewozowy innych przewoźników.
Gdzie: karta zamówienia → sekcja „Dostawa” → „Utwórz list przewozowy”. Zbiorczo — z listy zamówień, tak samo jak dla innych przewoźników.
1
Magazyn kompletuje, pozycje według kodu produktu2
Oddział NP lub paczkomat3
Pobranie, płaci odbiorca4
Kwota pobrania w UAH5
Przekaż zamówienie do magazynu- Szara notka — zamówienie kompletuje magazyn, a pozycje są przekazywane według kodu produktu z ustawień połączenia.
- Punkt odbioru — oddział lub paczkomat Nova Poshta; puste pole oznacza dostawę na adres.
- „Dostawa zwrotna (odbiorca)” — pobranie, płaci odbiorca.
- Kwota — kwota pobrania w hrywnach.
- „Utwórz list przewozowy” — wysyła zamówienie do magazynu.
- Sprawdź odbiorcę i telefon — bez telefonu zamówienie się nie przekaże.
- Sprawdź „Kod punktu odbioru” — oddział lub paczkomat Nova Poshta. Uzupełnia go zamówienie, jeśli klient wybrał punkt na stronie; w przeciwnym razie wpisz numer lub wybierz z listy oddziałów miasta. Pusty punkt oznacza dostawę na adres — wtedy potrzebne są „Ulica” i „Nr domu”.
- Sprawdź „Dostawa zwrotna (odbiorca)” i „Kwota” — pobranie w hrywnach. Domyślnie trafia tu cała kwota zamówienia, jeśli nie jest oznaczone jako „Opłacono”, a rodzaj płatności to pobranie; przy przedpłacie również cała kwota, więc popraw ją ręcznie. Kwoty „płatne przy odbiorze” są dodawane zawsze, nawet do opłaconego zamówienia.
- Kliknij „Utwórz list przewozowy”.
Magazyn przyjmuje zamówienie i od razu zwraca numer listu przewozowego Nova Poshta: „Utworzono list przewozowy nr …”. Numer zapisuje się w zamówieniu, a dalej działają rejestr „Przesyłki”, SMS i e-maile do klienta.
Co dostaje magazyn:
- Pozycje według kodu produktu. Każdy wiersz zamówienia z ilością — kod, nazwa, ilość i cena. Kod jest brany z karty produktu według ustawienia połączenia; wiersz niepowiązany z produktem idzie z własnym SKU. Produkty, których magazyn jeszcze nie zna, Elbuz dosyła mu przed zamówieniem. Po tym samym kodzie Elbuz pobiera potem stany.
- Numer zamówienia — taki sam jak w Elbuz. Ponowne przekazanie tego samego zamówienia, zanim magazyn weźmie je do realizacji, aktualizuje zamówienie w magazynie, a nie tworzy drugiego.
- Deklarowaną wartość — kwotę zamówienia.
- Odbiorcę — zawsze jako osobę prywatną. Firmy z kodem EDRPOU (ukraiński numer identyfikacyjny firmy) i płatnika „strona trzecia” przez Elbuz nie da się ustawić.
Dostaw do magazynu (planu przyjęcia) Elbuz nie zgłasza — prowadzi się je w panelu fulfillmentu. Dodatkowych usług Nova Poshta (wniesienie na piętro, dostawa w sobotę) w tym formularzu nie ma.
Jak anulować zamówienie w magazynie
Gdzie: karta zamówienia → „Podgląd listu przewozowego” → „Usuń list przewozowy” albo „Przesyłki” → wiersz → „Usuń list przewozowy”.
Magazyn anuluje zamówienie tylko wtedy, gdy ma ono status „Новый” (nowe). Wtedy w Elbuz numer listu znika z zamówienia i można je przekazać ponownie. Jeśli magazyn zaczął już kompletować, odmówi z przyczyną w rodzaju „…в статусе Упакован…” (w statusie „spakowane”), a list w zamówieniu zostanie — uzgodnij to z opiekunem fulfillmentu.
Statusy i druk listu przewozowego
Elbuz pyta o status co 10 minut — tym samym zadaniem „Sprawdzanie statusu dostawy” co dla innych przewoźników. Skąd pochodzi status, zależy od tego, czy podłączona jest także „Nova Poshta”:
| Podłączone | Co widać | Druk listu z Elbuz |
|---|---|---|
| Fulfillment i „Nova Poshta” tej samej firmy | statusy, kody i terminy przechowywania Nova Poshta, jak w zwykłych listach przewozowych; status zamówienia zmienia się na całej trasie | tak |
| Tylko fulfillment | do wysyłki — status magazynu (od „Новый” do „Упакован”), potem — status listu tekstem od magazynu; terminów przechowywania i pobrania nie ma. Tekst Elbuz przekłada na kod Nova Poshta według słownika, więc status zamówienia też dochodzi do „Dostarczono” lub „Odrzucenie”; nieznany tekst jest traktowany jako „w drodze” | nie, list drukuje magazyn |
Kody w „Statusy dostawy” Elbuz wpisuje sam. Statusy magazynowe magazyn podaje po rosyjsku i tak są widoczne.
Kody liczbowe to kody Nova Poshta: przy podłączonej „Nova Poshta” przychodzą od niej, bez niej Elbuz bierze je ze słownika tekstów magazynu. Jak statusy zamówień zmieniają się według kodów — w artykule Nova Poshta.
| Status dostawy | Kody domyślne |
|---|---|
| Oczekiwanie od nadawcy | statusy magazynowe od „Новый” do „Упакован” |
| W drodze | „Отгружен”, 4, 41, 5, 6 |
| W miejscu docelowym | 7, 8 |
| Dostarczono | 9, 10, 11 |
| Odrzucenie | 102, 103 |
Stany magazynu fulfillmentu
Raz na godzinę Elbuz pobiera z magazynu ilość dostępną do wysyłki i zapisuje ją w osobnym magazynie „Nova Poshta Fulfillment (<kod magazynu>)”. Magazyn pojawia się sam po pierwszej aktualizacji. Braki i kwarantanna nie są liczone.
1
Ile produktów ma magazyn FF2
Pobierz stany teraz- Wiersz „Towary dostępne w magazynie fulfillmentu” — ile produktów ma magazyn fulfillmentu i kiedy ostatnio zaktualizowano stany.
- Przycisk „Aktualizuj słowniki” — od razu pobiera stany z magazynu, bez czekania na cogodzinną aktualizację.
- Produkt jest wyszukiwany po kodzie produktu z ustawień połączenia. Produktowi, którego nie ma w magazynie fulfillmentu, ustawiane jest 0.
- Każda zmiana to wiersz w dzienniku ruchów magazynowych, bez dokumentu.
- Łączna „Ilość” produktu jest przeliczana tylko wtedy, gdy włączone jest ustawienie „Sumuj stan wg magazynów”. W przeciwnym razie stan magazynu fulfillmentu widać w karcie produktu pod polem „Ilość”, a na stronę trafia łączna ilość, jak dotąd.
1
Magazyn FF, wypełnia go Elbuz2
Dostępne do wysyłki- Wiersz „Nova Poshta Fulfillment (3PL_OCN)” — magazyn fulfillmentu; Elbuz wypełnia go sam.
- Liczba — ile jest dostępne do wysyłki.
Aby zaktualizować stany teraz, kliknij „Aktualizuj słowniki” w formularzu połączenia, blok „Słowniki przewoźnika”. Nocna aktualizacja słowników przewoźników też pobiera stany — osobno dla każdego połączenia fulfillmentu.
Co zrobić, gdy zamówienie się nie przekazuje
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „login/password rejected or IP is not whitelisted (HTTP 401)” lub „check that the Elbuz server IP is whitelisted by the fulfillment” | Zły login lub hasło albo IP serwera Elbuz nie jest na białej liście | Sprawdź dostęp i poproś opiekuna fulfillmentu o dodanie IP (podłączenie) |
| „Product «…» has no SKU (Elbuz UUID, model, EAN) — it is the product code at the fulfillment warehouse” | W karcie produktu puste jest pole wybrane jako kod produktu w połączeniu | Wypełnij to pole w karcie i spróbuj ponownie (kod produktu) |
| „Item without SKU: … — the fulfillment warehouse picks goods by SKU” | Wiersz zamówienia nie jest powiązany z produktem i nie ma SKU | Wpisz SKU w wiersz lub powiąż produkt (przekazanie zamówienia) |
| „products are not accepted by the warehouse”, a niżej „«produkt»: przyczyna”; albo okno „Nieprzyjęte:” po „Przekaż do Nova Poshta Fulfillment” | Magazyn odmówił założenia produktu — przyczynę podaje sam magazyn | Popraw kartę zgodnie z przyczyną i przekaż produkt ponownie (przekazanie produktów) |
| „«…»: the same code «…» as «…»” | Dwa zaznaczone produkty mają ten sam kod — magazyn ich nie rozróżni | Nadaj im różne kody lub wybierz Elbuz UUID (kod produktu) |
| Po zmianie kodu produktu magazyn nie znajduje nomenklatury, a stan magazynu fulfillmentu spadł do 0 | Magazyn przechowuje produkty pod starym kodem | Przywróć poprzedni kod w połączeniu; przejście na inny kod — tylko z opiekunem fulfillmentu (kod produktu) |
| „organization code is required” lub „warehouse code is required” | Nie wypełniono kodu organizacji lub kodu magazynu | Wpisz kody od opiekuna fulfillmentu (podłączenie) |
| „Street and house are required for address delivery” | Punkt odbioru jest pusty, a adresu nie ma | Wybierz oddział lub paczkomat albo wpisz ulicę i numer domu |
| „Recipient phone is required” | W zamówieniu nie ma telefonu odbiorcy | Wpisz telefon i spróbuj ponownie |
| „the warehouse prints the waybill; to print it here, connect Nova Poshta with the same API key” | „Nova Poshta” nie jest podłączona — list drukuje magazyn | Podłącz „Nova Poshta” z tym samym kluczem (statusy i druk) |
Scenariusze
Pierwsze podłączenie
Co zrobić. Uzyskaj dostęp i kody od opiekuna fulfillmentu, poproś o dodanie IP serwera Elbuz. Wypełnij połączenie, włącz „Aktywność” i kliknij „Aktualizuj słowniki”.
Efekt. W wierszu „Towary dostępne w magazynie fulfillmentu” pojawi się liczba, a w Elbuz — magazyn „Nova Poshta Fulfillment”.
Zamówienie ze strony do oddziału za pobraniem
Co zrobić. Zamówienie ze sposobem dostawy „Nova Poshta Fulfillment” → „Utwórz list przewozowy” → sprawdź punkt i kwotę → „Utwórz list przewozowy”.
Efekt. Numer listu w zamówieniu. Najpierw widać status magazynu („Новый”, „Упакован”), po wysyłce — statusy Nova Poshta.
Klient się rozmyślił
Co zrobić. „Usuń list przewozowy”.
Efekt. Jeśli magazyn nie wziął jeszcze zamówienia — jest anulowane, numer znika. Jeśli magazyn już kompletuje — odmowa z przyczyną, zadzwoń do fulfillmentu.
Nowe połączenie, produkty prowadzi Elbuz
Co zrobić. W połączeniu wybierz kod produktu Elbuz UUID i zapisz. Przekaż produkty z listy produktów, potem zgłoś dostawę w panelu fulfillmentu.
Efekt. „Magazyn fulfillmentu przyjął produktów: N” — magazyn zna produkty i przyjmie je w dostawie.
Produkt nie ma kodu
Co zrobić. „Utwórz list przewozowy” odpowiedział „Product «…» has no …” — wypełnij w karcie produktu pole wybrane jako kod produktu (SKU, model lub EAN) i kliknij ponownie.
Efekt. Numer listu w zamówieniu, produkt założony w magazynie.
Chcesz zmienić kod produktu
Co zrobić. Pod polem „Kod produktu w magazynie fulfillmentu” jest pomarańczowe „To połączenie ma już wysyłki lub stany…” — nie zmieniaj kodu, napisz do opiekuna fulfillmentu.
Efekt. Magazyn nadal rozpoznaje produkty, stany i zamówienia się nie gubią.
Sprzedano ostatnią sztukę z magazynu
Co zrobić. Włącz „Sumuj stan wg magazynów”, jeśli na stronę ma trafiać stan magazynów.
Efekt. W ciągu godziny stan w magazynie „Nova Poshta Fulfillment” spadnie do 0, a strona pokaże produkt jako niedostępny.
Najczęstsze pytania
Skąd wziąć klucz API do fulfillmentu?
Klucza API nie wpisuje się w połączenie fulfillmentu: potrzebne są login, hasło i kody od opiekuna fulfillmentu. Klucz Nova Poshta przekazujesz samemu magazynowi.
Czy Elbuz przekazuje produkty do panelu fulfillmentu?
Tak, z okna „Produkty”, a „Utwórz list przewozowy” sam dosyła produkty nieznane magazynowi. Dostawy do magazynu zgłasza się w panelu fulfillmentu.
Jaki kod produktu wybrać do fulfillmentu?
Nowe połączenie, a produkty przekazuje Elbuz — Elbuz UUID: ma go każdy produkt i się nie zmienia. Produkty są już założone w magazynie według SKU — „SKU”.
Czy można zmienić kod produktu, gdy produkt jest już w magazynie?
Nie, magazyn przestanie rozpoznawać produkty w zamówieniach i stanach. Przejście na inny kod uzgodnij z opiekunem fulfillmentu.
Co się stanie, jeśli kliknę „Utwórz list przewozowy” dwa razy?
Druga próba odpowie, że list jest już utworzony. Drugie zamówienie w magazynie się nie pojawi.
Czy można wysłać do firmy z kodem EDRPOU?
Nie, przez Elbuz odbiorcą może być tylko osoba prywatna.
Czy można pracować i z fulfillmentem, i ze zwykłą Nova Poshta?
Tak. To dwa różne połączenia i dwa sposoby dostawy — przewoźnika wybiera się w każdym zamówieniu.
Gdzie to jest i kto ma dostęp
- Menu
- karta zamówienia → „Dostawa” → „Utwórz list przewozowy”; produkty — okno „Produkty” → prawy klik → „Przekaż do Nova Poshta Fulfillment”
- Połączenie
- „Usługi zewnętrzne i integracje”, grupa „Dostawa”, wiersz „Nova Poshta Fulfillment”
- Uprawnienia
- list przewozowy — okno „Tworzenie listu przewozowego”; przekazywanie produktów — okno „Produkty”; połączenie — „API i tokeny dostępu”
- Przygotuj
- dostęp i kody od fulfillmentu, IP Elbuz na białej liście, wypełniony kod produktu w kartach
Powiązane tematy
- Jeśli część paczek wysyłasz sam — Nova Poshta: listy przewozowe, rejestry, pobranie.
- Jeśli chcesz znaleźć paczkę lub przypomnieć odbiorcy — Przesyłki.
- Jeśli wybierasz przewoźnika dla innego kraju — Przewoźnicy w Elbuz.
- Jeśli klient płaci kartą przed wysyłką — Płatność przez NovaPay.
