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”.
- Wklej statyczny token w pole „Token”.
- Włącz „Aktywność”.
- W bloku „Nadawca” wypełnij „Nazwisko”, „Imię”, „Telefon” i „Nazwa firmy”.
- Wybierz „Obwód”, „Miasto”, „Oddział” — punkt nadania, w którym oddajesz paczki.
1
Token2
Oddział nadawcy- „Token” — klucz wydany przez Rozetka Delivery; przechowywany w postaci zamaskowanej.
- 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.
1
Oddział2
Wiersz „Punkty odbioru”3
Aktualizuj słowniki- „Oddział” — punkt nadania, w którym oddajesz paczki.
- Ile punktów odbioru zna Elbuz i kiedy wspólna lista była ostatnio aktualizowana.
- 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 dostawy | Kody Rozetka Delivery |
|---|---|
| Oczekiwanie od nadawcy | planned, acceptedFromMerchant, acceptedFromReception |
| W drodze | readyToCarrier, acceptedByCarrier, inTheWay, arrivedToDistributionCenter, acceptedOnDistributionCenter, forwarding |
| W miejscu docelowym | acceptedInDepartment, placedInStore, readyToIssueOctopus, storageDateIncreased |
| Dostarczono | gaveOut |
| Częściowo dostarczone | gaveOutPartially |
| Odrzucenie | clientCanceled, 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ć
| Pole | Skąd pochodzi |
|---|---|
| Sposób nadania | „Oddział” lub „Adres” — według sposobu dostawy z zamówienia; bez niego — „Oddział” |
| Nazwisko, Imię, Imię ojca, Telefon | Z 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, kg | Suma wag produktów; gdy puste — pójdzie 1 kg |
| Długość, Szerokość, Wysokość, cm | Gdy puste — pójdzie 30 × 20 × 10 cm |
| Liczba paczek | 1 |
| Deklarowana wartość, UAH | Suma zamówienia; musi być większa od zera |
| Płatnik dostawy | „Nadawca”; można wybrać „Odbiorca” |
1
Długość, szerokość, wysokość2
Płatnik dostawy3
Pobranie, „Pieniądze”4
Utwórz list przewozowy- Długość, szerokość i wysokość paczki w centymetrach.
- Kto płaci za dostawę: nadawca czy odbiorca.
- Pobranie płacone przez odbiorcę, opcja „Pieniądze”.
- 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”
- Elbuz sprawdza nadawcę w rekordzie (miasto, punkt, nazwisko, imię, telefon), odbiorcę w formularzu (nazwisko, imię, telefon, miasto, punkt) oraz deklarowaną wartość.
- Tworzy list przewozowy w Rozetka Delivery; numer zamówienia Elbuz przekazuje do listu jako Twój numer.
- 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.
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
| Co widzisz | Dlaczego tak jest | Co 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”.
- Utwórz statyczny tokenRozetka Delivery
- Wpisz token i dane nadawcyUsługi zewnętrzne i integracje → Rozetka Delivery
- Wybierz punkt nadaniaTamże, „Słowniki przewoźnika”
- Uzupełnij kody statusówTamże, „Ustawienia powiadomień”
- Wystaw list przewozowyKarta zamówienia, sekcja „Dostawa”
Powiązane tematy
- Jeśli chcesz widzieć paczki wszystkich przewoźników na jednej liście — Przesyłki.
- Jeśli zamówienie przyszło z marketplace’u Rozetka — list przewozowy przez Rozetka.
- Jeśli wysyłasz też przez Nova Poshta — Nova Poshta API w Elbuz.
- Jeśli listy przewozowe trzeba wystawić dla dziesiątek zamówień — listy przewozowe zbiorczo.
- Jeśli klient ma wybierać Rozetka Delivery w koszyku Twojej strony — to dostawa w sklepie Elbuz CMS.
