↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Firmy kurierskie w Elbuz

    Rozetka Delivery w Elbuz: list przewozowy z zamówienia, etykieta i statusy paczek

    4 min czytaniaZaktualizowano

    Elbuz wystawia list przewozowy Rozetka Delivery w ramach Twojej umowy partnerskiej prosto z karty zamówienia, drukuje etykietę i co 10 minut pobiera statusy paczek jednym zapytaniem.

    Kiedy to się przyda:

    • Wysyłasz przez punkty ROZETKA — odbiorca, miasto i kwota wstawiają się z zamówienia, list przewozowy tworzysz jednym przyciskiem.
    • Klient płaci przy odbiorze — pobranie na kwotę zamówienia ustawia się samo.
    • Zamówienie nie pochodzi z marketplace’u — Rozetka Delivery działa dla każdego zamówienia, nie tylko z Rozetki.

    Od czego zacząć: utwórz statyczny token partnera Rozetka Delivery → wpisz go w Elbuz.

    Co potrafi Rozetka Delivery w Elbuz

    • List przewozowy z zamówienia — do punktu odbioru lub na adres, z wymiarami, liczbą paczek, wyborem płatnika i pobraniem; pojedynczo lub zbiorczo.
    • Miasta i punkty — wspólna dla wszystkich sklepów Elbuz lista, aktualizuje się sama; osobno punkty nadania (skąd wysyłasz) i punkty odbioru (dokąd).
    • Statusy paczek — co 10 minut, wszystkie listy przewozowe jednym zapytaniem.
    • Etykieta — PDF z karty zamówienia lub z „Przesyłek”.

    To integracja w ramach Twojej umowy z Rozetka Delivery. List przewozowy dla zamówienia z marketplace’u Rozetka na dostępach sprzedawcy to inne działanie: „List przewozowy przez Rozetka”.

    Przedłużenia przechowywania, zwrotu ani usunięcia listu przewozowego z Elbuz nie ma — robi się to w panelu Rozetka Delivery. Zwrot i usunięcie z Elbuz są dostępne tylko dla Nova Poshta.

    Jak podłączyć Rozetka Delivery: token i punkt nadania

    Skąd wziąć token Rozetka Delivery

    Elbuz działa ze statycznym tokenem partnera. Według dokumentacji API Rozetka Delivery partner tworzy go sam metodą «Створення статичного токена партнера» (tworzenie statycznego tokena partnera) po zalogowaniu numerem telefonu i hasłem. Tam też są lista tokenów i ich usuwanie.

    Dokumentacja: rz-delivery.rozetka.ua/api/docs. Jeśli nie masz jeszcze dostępu do API, zwróć się do swojego opiekuna w Rozetka Delivery.

    Zwykły token sesji jest ważny 72 godziny od ostatniego użycia — dla Elbuz się nie nadaje, potrzebny jest właśnie statyczny.

    Gdzie wpisać token w Elbuz

    Gdzie: Usługi zewnętrzne i integracje → grupa „Dostawa” → rekord „Rozetka Delivery”.

    1. Wklej statyczny token w pole „Token”.
    2. Włącz „Aktywność”.
    3. W bloku „Nadawca” wypełnij „Nazwisko”, „Imię”, „Telefon” i „Nazwa firmy”.
    4. Wybierz „Obwód”, „Miasto”, „Oddział” — punkt nadania, w którym oddajesz paczki.
    Okno podłączenia Rozetka Delivery: przełącznik „Aktywność”, pole „Token” i blok nadawcy z polami „Obwód”, „Miasto” i „Oddział”
    1Token
    2Oddział nadawcy
    1. „Token” — klucz wydany przez Rozetka Delivery; przechowywany w postaci zamaskowanej.
    2. Blok „Nadawca” — „Obwód”, „Miasto” i „Oddział”, czyli punkt nadania, w którym oddajesz paczki.

    Elbuz nie sprawdza tokena przy zapisie: błąd zobaczysz przy pierwszym liście przewozowym.

    Słowniki miast i punktów

    Miasta i punkty Rozetka Delivery Elbuz bierze ze wspólnej dla wszystkich sklepów listy, która aktualizuje się sama. Niczego nie trzeba pobierać: blok „Słowniki przewoźnika” tylko pokazuje, ile punktów zna Elbuz i kiedy lista była aktualizowana, a „Aktualizuj słowniki” sprawdza, czy jest aktualna.

    Formularz podłączenia Rozetka Delivery: wiersz nadawcy „Obwód” / „Miasto” / „Oddział” i blok „Słowniki przewoźnika” z tabelą punktów odbioru i przyciskiem „Aktualizuj słowniki”
    1Oddział
    2Wiersz „Punkty odbioru”
    3Aktualizuj słowniki
    1. „Oddział” — punkt nadania, w którym oddajesz paczki.
    2. Ile punktów odbioru zna Elbuz i kiedy wspólna lista była ostatnio aktualizowana.
    3. Przycisk tylko sprawdza, czy wspólna lista jest aktualna; niczego nie trzeba pobierać.

    W bloku „Nadawca” widać tylko punkty przyjmujące paczki, w formularzu listu przewozowego — tylko te, które je wydają. Dopóki wspólna lista się nie zaktualizuje, obowiązuje poprzednia.

    Kody statusów Rozetka Delivery

    Status zamówienia zmienia się tylko w oznaczonych statusach zamówień i według trzech tabel „Ustawienia powiadomień” — jak w Ukrposhcie. Kody z tabeli Elbuz wpisuje w „Statusy dostawy” sam, własne dopisuj po przecinku, alfabetem łacińskim — tak jak w dokumentacji API Rozetka Delivery:

    Twój status dostawyKody Rozetka Delivery
    Oczekiwanie od nadawcyplanned, acceptedFromMerchant, acceptedFromReception
    W drodzereadyToCarrier, acceptedByCarrier, inTheWay, arrivedToDistributionCenter, acceptedOnDistributionCenter, forwarding
    W miejscu docelowymacceptedInDepartment, placedInStore, readyToIssueOctopus, storageDateIncreased
    DostarczonogaveOut
    Częściowo dostarczonegaveOutPartially
    OdrzucenieclientCanceled, storageDateExpired, readyToReturn, inTheWayReturn, returned

    Bez kodów paczki w „Przesyłkach” mają stan „Nieznany”.

    Jak utworzyć list przewozowy Rozetka Delivery z zamówienia

    Gdzie: karta zamówienia → sekcja „Dostawa” → „Utwórz list przewozowy”. Link jest widoczny, jeśli sposób dostawy zamówienia to Rozetka Delivery; po pierwszym otwarciu formularza nazywa się „Edytuj list przewozowy”.

    Co formularz wypełni sam i co sprawdzić

    PoleSkąd pochodzi
    Sposób nadania„Oddział” lub „Adres” — według sposobu dostawy z zamówienia; bez niego — „Oddział”
    Nazwisko, Imię, Imię ojca, TelefonZ zamówienia
    MiejscowośćWedług nazwy miasta z zamówienia; przy takich samych nazwach — największe miasto
    OddziałPunkt z zamówienia; gdy pusty — przy tworzeniu Elbuz szuka punktu, którego nazwa pasuje do adresu dostawy
    Waga całkowita, kgSuma wag produktów; gdy puste — pójdzie 1 kg
    Długość, Szerokość, Wysokość, cmGdy puste — pójdzie 30 × 20 × 10 cm
    Liczba paczek1
    Deklarowana wartość, UAHSuma zamówienia; musi być większa od zera
    Płatnik dostawy„Nadawca”; można wybrać „Odbiorca”
    Formularz listu przewozowego Rozetka Delivery: wymiary paczki, płatnik dostawy, pobranie i przycisk „Utwórz list przewozowy”
    1Długość, szerokość, wysokość
    2Płatnik dostawy
    3Pobranie, „Pieniądze”
    4Utwórz list przewozowy
    1. Długość, szerokość i wysokość paczki w centymetrach.
    2. Kto płaci za dostawę: nadawca czy odbiorca.
    3. Pobranie płacone przez odbiorcę, opcja „Pieniądze”.
    4. Tworzy list przewozowy.

    Dla „Adres” wypełnij „Ulica”; „Oddział” jest potrzebny i tutaj — bez niego list przewozowy się nie utworzy. Formularz zapisuje się w zamówieniu przy każdej zmianie pola.

    Co się dzieje po kliknięciu „Utwórz list przewozowy”

    1. Elbuz sprawdza nadawcę w rekordzie (miasto, punkt, nazwisko, imię, telefon), odbiorcę w formularzu (nazwisko, imię, telefon, miasto, punkt) oraz deklarowaną wartość.
    2. Tworzy list przewozowy w Rozetka Delivery; numer zamówienia Elbuz przekazuje do listu jako Twój numer.
    3. Zapisuje numer listu przewozowego w zamówieniu.

    Drugiego listu przewozowego dla tego samego zamówienia Elbuz nie utworzy: „List przewozowy już utworzony: … — pominięto.” Opis jest przycinany do 250 znaków.

    List przewozowy pojawia się w Rozetka Delivery od razu. Usunąć go z Elbuz nie można — tylko w panelu Rozetka Delivery, a potem wyczyść numer w polu zamówienia „Numer listu przewozowego”.

    Zbiorczo: lista zamówień → zaznacz → „Utwórz list przewozowy (dostawa)” (listy przewozowe zbiorczo).

    Pobranie i kto płaci prowizję

    „Dostawa zwrotna (odbiorca)” → „Pieniądze” ustawia się samo, jeśli zamówienie nie jest opłacone, a płatność następuje przy odbiorze; kwota to suma zamówienia. „Niepotrzebna” — paczka zostanie wydana bez płatności.

    Według dokumentacji API Rozetka Delivery odbiorca w punkcie płaci kwotę pobrania plus prowizję 15 UAH + 1,5%. Jak i kiedy pieniądze trafiają do Ciebie — zgodnie z Twoją umową z Rozetka Delivery.

    Statusy paczek i druk etykiety

    Co 10 minut Elbuz pyta Rozetka Delivery o statusy jednym zapytaniem dla wszystkich listów przewozowych — do 100 na przebieg. Śledzone są zamówienia z ostatnich 60 dni lub w oznaczonych statusach, dopóki kod paczki nie znajdzie się przy „Dostarczono” w „Statusy dostawy”. Wszystkie paczki są w „Przesyłkach”, stan — według Twojej tabeli kodów.

    Etykieta: karta zamówienia → „Podgląd listu przewozowego” → „Drukuj” albo „Przesyłki” → wiersz → „Drukuj list przewozowy”. Elbuz pobiera PDF z Rozetka Delivery i otwiera go w oknie; token nie trafia do przeglądarki.

    Scenariusze

    Pierwsze podłączenie

    Co zrobić. Utwórz statyczny token, wpisz go w „Token”, wypełnij dane nadawcy, wybierz punkt nadania, sprawdź kody w „Statusy dostawy”.

    Efekt. W formularzu listu przewozowego są miasta i punkty odbioru, statusy przychodzą same.

    Płatność przy odbiorze

    Co zrobić. Zostaw w zamówieniu płatność przy odbiorze i nie oznaczaj go jako opłaconego.

    Efekt. W liście przewozowym jest pobranie na kwotę zamówienia; klient zapłaci je z prowizją 15 UAH + 1,5%.

    Dostawa do domu

    Co zrobić. W formularzu listu przewozowego wybierz „Sposób nadania” → „Adres”, wypełnij „Ulica” i zostaw wybrany „Oddział”.

    Efekt. List przewozowy na dostawę z Twojego punktu pod drzwi odbiorcy.

    Co zrobić, gdy coś pójdzie nie tak

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Firma kurierska nie jest podłączona: uzupełnij ustawienia API tej firmy…” zamiast formularza W rekordzie Rozetka Delivery pole „Token” jest puste albo wyłączono „Aktywność” Wpisz statyczny token, włącz „Aktywność” (podłączenie)
    „Error: sender department is required (API settings)” (albo sender city, first_name, last_name, phone) Nie wypełniono danych nadawcy lub punktu nadania Wypełnij blok „Nadawca” (podłączenie)
    „Error: city is required for recipient” albo „department is required for recipient” Miasta lub punktu odbiorcy nie znaleziono w słowniku Wybierz miasto i oddział w formularzu ręcznie
    „Error: Unauthorized” albo „HTTP 401” przy liście przewozowym Token jest nieważny: usunięty albo wpisano token sesji Utwórz nowy statyczny token i wpisz go (token)
    Paczki Rozetka Delivery w „Przesyłkach” mają stan „Nieznany” Tabela „Statusy dostawy” rekordu jest pusta Wpisz kody (tabela kodów)

    Najczęstsze pytania

    Ile kosztuje integracja z Rozetka Delivery?

    Elbuz nic nie pobiera za listy przewozowe, etykiety ani statusy. Za dostawę płacisz Rozetka Delivery zgodnie z umową.

    Czym to się różni od „List przewozowy przez Rozetka”?

    Tutaj działa Twoja umowa i Twój token, dla każdego zamówienia. „List przewozowy przez Rozetka” służy do zamówień z marketplace’u, na dostępach sprzedawcy (więcej).

    Czy można przedłużyć przechowywanie paczki z Elbuz?

    Nie, przedłużenie — w panelu Rozetka Delivery. Elbuz pokaże paczkę w „Przesyłkach”, a do klienta można wysłać SMS.

    Po co wymiary, jeśli ich nie znam?

    Rozetka Delivery ich wymaga. Puste pola Elbuz wypełni jako 30 × 20 × 10 cm.

    Czy można wysłać przesyłkę w kilku paczkach?

    Tak, w formularzu jest „Liczba paczek”. Wagę i wymiary podaje się jedne na cały list przewozowy.

    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”; list przewozowy — okno „Tworzenie listu przewozowego”; paczki — „Przesyłki”
    Przygotuj
    umowę partnerską z Rozetka Delivery, statyczny token, punkt nadania, z którego wysyłasz

    List przewozowy można wystawić tylko dla zamówienia, które użytkownik widzi zgodnie z ustawieniem „Czyje dane”.

    1. Utwórz statyczny tokenRozetka Delivery
    2. Wpisz token i dane nadawcyUsługi zewnętrzne i integracje → Rozetka Delivery
    3. Wybierz punkt nadaniaTamże, „Słowniki przewoźnika”
    4. Uzupełnij kody statusówTamże, „Ustawienia powiadomień”
    5. Wystaw list przewozowyKarta zamówienia, sekcja „Dostawa”

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo