Elbuz pobiera katalog Twojego sklepu na Rozetce przez Rozetka API — kluczem sprzedawcy, bez plików — i łączy go w katalogu bazowym z innymi kanałami sprzedaży.
Kiedy to się przyda:
- Katalog jest już prowadzony na koncie Rozetka — produkty z cenami, stanami, atrybutami i zdjęciami trafią do Elbuz bez pliku.
- Części kart Rozetka nie przepuszcza — dziennik przebiegu pokaże, ile z nich jest w moderacji, nieprawidłowych i odrzuconych.
- Zamówienia przychodzą z Rozetki — trafiają jako dokumenty razem ze zwrotami, listami przewozowymi i prowizją.
- Status zamówienia zmieniono w Elbuz — program odsyła go na Rozetkę razem z numerem listu przewozowego.
Od czego zacząć: wygeneruj klucz API i wklej go do szablonu „API - Rozetka.UA” w oknie „Import danych”.
Co potrafi integracja z Rozetką
- Katalog — nazwa, opis, ceny, stan, kod produktu, producent, kategoria, zdjęcia i atrybuty trafiają do karty produktu.
- Stany kart — produkty z błędami, w moderacji, ukryte i odrzucone widać w dzienniku, a problematyczne karty trafiają do katalogu.
- Zamówienia — razem ze zwrotami, statusami listów przewozowych, prowizją i ruchami pieniędzy.
- Zwrotny status — Twój status zamówienia wraca na Rozetkę razem z numerem listu przewozowego.
- Harmonogram — szablon sam aktualizuje ceny i stany oraz dodaje nowości.
Czego potrzebujesz od Rozetki
Elbuz łączy się z Seller Rozetki na jeden z dwóch sposobów. Wybierz klucz: nie daje wejścia na konto i można go odwołać bez zmiany hasła.
| Sposób | Co wpisać w szablonie | Kiedy pasuje |
|---|---|---|
| Klucz API | pole „Klucz API Rozetka”; ciąg zaczyna się od gapi_ | główny sposób dla nowych połączeń |
| Login i hasło | pola „Login” i „Hasło” konta sprzedawcy | szablony skonfigurowane wcześniej — działają nadal |
Jeśli wypełniono i klucz, i hasło, Elbuz bierze klucz. Klucz idzie w każdym zapytaniu bez zmian. Przy loginie i haśle program najpierw loguje się do Seller API, dostaje tymczasowy token i loguje się ponownie, gdy ten wygaśnie.
Jak zdobyć klucz i podłączyć szablon
- Na koncie sprzedawcy Rozetka otwórz «Налаштування» → «Безпека API» (Ustawienia → Bezpieczeństwo API).
- Kliknij «Генерувати API токен» (Wygeneruj token API). W tabeli pojawi się wiersz z kluczem, Twoją rolą i datą wygaśnięcia.
Klucz dostaje uprawnienia roli, w której go wygenerowano. Elbuz potrzebuje roli z dostępem i do produktów, i do zamówień. Klucz ról «Контент-менеджер» (menedżer treści), «Менеджер з фінансів» (menedżer finansów) lub «Менеджер з обробки замовлень» (menedżer obsługi zamówień) otwiera tylko dane swojej roli: zamówienia lub produkty się wtedy nie zaimportują.
- Skopiuj klucz przyciskiem kopiowania na końcu wiersza: w tabeli jest pokazany w skrócie.
- W Elbuz otwórz okno importu → szablon typu „API - Rozetka.UA” → karta „Połączenie”, wklej klucz w pole „Klucz API Rozetka”. Formularz zapisuje się sam, przycisku zapisu nie ma. „Aktywny” i „Zamówienia” są w nowym szablonie już włączone: 5 minut po zapisaniu Elbuz zacznie pobierać całą historię zamówień konta. Statusy platformy Elbuz dopasowuje do Twoich sam, po nazwie; co przyszło i jak zostało dopasowane, widać w oknie „Statusy zamówienia” szablonu. Chcesz najpierw sprawdzić — odznacz „Zamówienia”.
- Kliknij „Sprawdź połączenie”. Komunikat o udanym połączeniu oznacza, że Rozetka przyjęła klucz. «Невірний токен доступу» (nieprawidłowy token dostępu) oznacza, że klucz skopiowano niecały, usunięto go albo stał się nieaktywny.
Klucz jest powiązany z rolą pracownika: «Власник» (właściciel) i «Адміністратор» (administrator) tworzą klucze także dla innych menedżerów, pozostałe role — tylko dla siebie. Na jednego menedżera dozwolonych jest do dziesięciu kluczy. Przycisk «Видалити всі токени» (usuń wszystkie tokeny) odwołuje dostęp wszystkim integracjom naraz — potem wklej do szablonu nowy klucz.
Rozetka wyłącza klucz nieużywany dłużej niż 24 godziny; data wygaśnięcia klucza jest w tabeli «Безпека API». Aktywny szablon z „Zamówieniami” odpytuje Rozetkę co 5 minut i klucz nie usypia; szablon tylko z katalogiem lub opiniami uruchamiaj według harmonogramu co najmniej raz na dobę. Po przerwie lub po dacie wygaśnięcia wklej do szablonu nowy klucz.
O kluczu API — w pomocy Rozetki dla sprzedawców (sekcja «Особистий кабінет → Інструменти»). Techniczny opis metod — w dokumentacji Seller API. Jeśli dostęp nie działa, do wsparcia Rozetki pisze się w temacie «Акаунт, особистий кабінет, API».
Co włączyć w szablonie
W karcie „Wybór danych do importu” dla Rozetki rozstrzygające są trzy opcje:
- Produkty — pobiera katalog do katalogu bazowego Elbuz, a gdy katalog zostanie przeczytany do końca, odczytuje też stany kart.
- Zamówienia — przynosi zamówienia, zwroty, statusy listów przewozowych i finanse.
- Opinie — pobiera opinie o sklepie i pytania o produkty do Twojej skrzynki moderacji, a także zgłoszenia serwisowe platformy dotyczące zamówień.
Obok są opcje doprecyzowujące katalog: Zdjęcia (importować obrazy) i Atrybuty (pobierać atrybuty). Kategorie i Producenci tworzą się same z danych produktu. Odznaczone „Produkty” oznacza, że katalog się nie aktualizuje — tak można pobierać tylko zamówienia.
Zestaw opcji jest wspólny dla wszystkich źródeł API i część z nich Rozetki nie dotyczy. Rozetka działa przez odpytywanie: nie ma natychmiastowych powiadomień, więc opcja „Używaj webhooków” nie wpływa na pracę. Nowe zamówienie pojawia się w Elbuz zwykle w ciągu 5 minut (harmonogram).
Co trafia do karty
Każdy produkt Rozetki rozkłada się na pola karty Elbuz według takiego odpowiednika:
| Dane Rozetki | Pole karty w Elbuz |
|---|---|
name_ua / name / name_ru (według języka bazy) | Nazwa produktu |
description | Pełny opis |
price | Cena |
price_old | Stara cena (przed rabatem) |
stock_quantity | Stan (dostępność) |
article | Kod (SKU) |
rz_producer / price_producer_name | Producent |
price_category / rz_category | Kategoria (struktura katalogu) |
photo (lista ) | Zdjęcia — przy włączonej opcji „Zdjęcia” |
params (osobne zapytanie /goods/details) | Atrybuty — przy włączonej opcji „Atrybuty” |
rz_item_id | Klucz powiązania z platformą (według niego idą aktualizacje cen i stanów) |
price_offer_id | Drugi klucz powiązania (offer) |
- Nazwa — w języku Twojej bazy: baza ukraińska bierze nazwę ukraińską, inna — rosyjską; jeśli potrzebnej nie ma, podstawiana jest dostępna.
- Kategoria — z kategorii sprzedawcy, a jeśli jej nie ma — z kategorii samej Rozetki.
- Producent — najpierw ze słownika producentów Rozetki, a dopiero gdy jest pusty — nazwa z danych sprzedawcy.
- Powiązanie z platformą — według niego Elbuz później aktualizuje ceny i stany, więc każdy produkt przychodzi z nim.
Atrybuty i zdjęcia
Rozetka oddaje atrybuty osobno dla każdego produktu, zbiorczego eksportu parametrów nie ma. Dlatego pierwszy import dużego katalogu z włączonymi „Atrybutami” trwa dłużej: program pyta o parametry pozycja po pozycji.
Produkty, które mają już wypełnione atrybuty, kolejne przebiegi pomijają: pierwszy przebieg wypełnia katalog, potem dobierane są nowości. Elbuz bierze wartości także wtedy, gdy Rozetka nie dopasowała ich do swojego słownika — podstawiana jest własna wartość sprzedawcy.
Zdjęcia importują się tylko z opcją „Zdjęcia” — wszystkie obrazy produktu w kolejności, w jakiej oddaje je platforma. Prowadzisz własną bibliotekę mediów — zostaw opcję odznaczoną.
Kategoria techniczna „Produkty - rozetka”
Kategorie i producenci są szukani w Twoich słownikach po nazwie i tworzeni, jeśli ich nie ma, — ogólna zasada. Specyfika Rozetki: produkty w ogóle bez nazwy kategorii trafiają do kategorii technicznej „Produkty - rozetka”. Tworzy się ona wyłączona i nie bierze udziału w eksportach.
Rozkładanie kart z niej do własnych kategorii jest bezpieczne. Powiązanie z Rozetką żyje osobno od kategorii i producenta; w karcie jest pokazane wierszem „ID rozetka #numer szablonu”. Ponowny przebieg nie zmienia miejsca produktu w drzewie: kategoria jest ustawiana tylko przy tworzeniu karty. Usuwanie samej kategorii technicznej nie ma sensu — następny przebieg utworzy ją ponownie, pustą.
Których kart Rozetka nie przepuszcza
Po katalogu Elbuz osobnym przebiegiem odczytuje stan Twoich kart na Rozetce. Przebieg idzie tylko wtedy, gdy katalog przeczytano do końca: po „Zatrzymaj” lub błędzie API się nie uruchamia i zostają oznaczenia z poprzedniego przebiegu.
Program przechodzi sześć sekcji konta i zapamiętuje każdemu produktowi stan z tekstem przyczyny (błąd, słowa zakazane, powód blokady):
- produkty z błędami;
- nieprawidłowe;
- w moderacji;
- ukryte przez moderatora;
- poza dozwolonym zakresem cen;
- ze zmianami czekającymi na potwierdzenie.
Wynik ogląda się w dzienniku przebiegu: osobnej kolumny ze stanem w interfejsie nie ma. Na górze — podsumowanie: ile produktów jest na koncie łącznie, w sprzedaży, nieaktywnych, w moderacji i odrzuconych. Dalej — wiersz dla każdej grupy z wyjaśnieniem, np. „Rozetka: nieprawidłowych produktów: … — platforma nie przyjmuje karty (najczęściej brak wymaganych atrybutów)”. Ostatni wiersz to stan wniosków o moderację.
Problematyczne pozycje (nieprawidłowe, odrzucone) nie trafiają do zwykłych wyników katalogu Rozetki. Żeby nie przepadły, Elbuz dodaje je do katalogu i od razu oznacza stanem.
Oznaczenie stanu się nie zawiesza. Przebieg najpierw zdejmuje wszystkie oznaczenia tego szablonu, a potem ustawia je od nowa produktom, które tym razem znalazł na koncie. Produkt, który został poprawiony lub zniknął z Rozetki, zostaje bez oznaczenia.
Produkt zniknął lub zdjęto go ze sprzedaży na Rozetce
Z kartą w Elbuz nic się nie stanie: produkt, którego nie było w przebiegu, zostaje z ostatnią ceną i stanem, nie wyłącza się, a w dzienniku nic się o nim nie pisze — ogólna zasada. Przełącznika, który usuwałby znikające pozycje, w szablonie Rozetki nie ma: takie produkty usuwa się filtrem w oknie „Produkty” i usuwaniem zbiorczym.
Znacznika aktywności z Rozetki Elbuz nie przenosi: każdemu produktowi, który przyszedł, ustawiane jest „włączone” — i nowemu, i istniejącemu. Jeśli wyłączysz kartę w Elbuz, a na Rozetce produkt zostanie, następny przebieg włączy ją ponownie. Utrzymać kartę wyłączoną można tylko oznaczeniem „Nie aktualizuj” w sekcji „Ochrona podczas importu” — zamyka ono kartę także na pozostałe aktualizacje.
1
Nie aktualizuj- Nie aktualizuj — import z Rozetki nie zmieni statusu, ceny ani stanu tego produktu.
Jeśli produkt nie zniknął, tylko ukrył go moderator lub go odrzucono, widać to z przebiegu stanów. Nikt przy tym nie wyłącza karty ani nie zeruje stanu.
Zamówienia, zwroty i finanse
Z opcją „Zamówienia” ta sama integracja przynosi:
- nowe zamówienia — jako dokumenty „Zamówienie klienta”;
- wnioski o zwrot — jako dokumenty „Zwrot od klienta” z przyczyną zwrotu;
- statusy dostawy według listów przewozowych wszystkich przewoźników;
- finanse: prowizja zapisuje się w samym zamówieniu, rzeczywiste ruchy na saldzie stają się dowodami wpłaty i wypłaty, miesięczne raporty sprzedanych produktów — protokołami wykonania prac.
Status zamówienia Rozetki Elbuz dopasowuje do Twojego sam, po nazwie; doprecyzować go oraz dopasować płatności i dostawę można przyciskami w karcie „Powiązane ustawienia”. Pierwszy przebieg pobiera wszystkie zamówienia konta, kolejne — tylko zmienione od poprzedniego. Duplikatu nie będzie: dokument jest szukany po numerze zamówienia Rozetki razem z kodem źródła.
Zamówienie i stan: kiedy rusza magazyn
Sam import magazynu nie dotyka. Zamówienie trafia jako niezatwierdzony dokument „Zamówienie klienta”. Taki dokument nie zdejmuje towaru ze stanu, tylko go rezerwuje, a rezerwacja pojawia się dopiero po zatwierdzeniu.
- Zamówienie zatwierdzone — stan ten sam, ale wolna ilość zmniejsza się o zamówioną.
- Zamówienie doszło do statusu końcowego (zrealizowane, wydane, anulowane, zwrot) — rezerwacja jest zdejmowana. Płatność rezerwacji nie zdejmuje: opłacone, ale niewysłane zamówienie nadal trzyma towar.
- Wystawiono dokument WZ — wydana ilość schodzi ze stanu i przestaje liczyć się do rezerwacji.
- Ewidencja magazynowa wyłączona (np. dropshipping) — rezerwacja nie jest prowadzona, a zatwierdzenie nie wpływa na dostępność.
Dokument „Zwrot od klienta” to rejestracja wniosku klienta; sam z siebie nie przywraca stanu.
Dwie zasady dla już założonych zamówień:
- Dokument niezatwierdzony — każdy przebieg go aktualizuje, ale Twój status obsługi zmienia się tylko wtedy, gdy status po stronie Rozetki zmienił się od poprzedniego razu. Praca menedżera nie jest nadpisywana.
- Dokument zatwierdzony — import już go nie rusza: ani statusu, ani płatności, ani dostawy. Wyjątek — prowizja platformy, ona zapisuje się zawsze.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jak zamówienie znajduje klienta i produkt w katalogu — ogólna mechanika importu zamówień.
Zwrotny zapis statusu zamówienia
Z Rozetką połączenie w zakresie zamówień jest dwukierunkowe: gdy menedżer przesuwa zamówienie po Twoich statusach, Elbuz odsyła odpowiedni status na platformę. Klient widzi aktualny stan, a dublować działania na koncie Rozetki nie trzeba.
- Odpowiednik bierze się z tej samej tabeli dopasowania statusów co przy imporcie, w odwrotnym kierunku.
- Wysyłane są tylko zamówienia, w których status się zmienił od ostatniej wysyłki.
- Razem ze statusem przekazywany jest numer listu przewozowego, jeśli jest wypełniony.
Dla statusów związanych z przekazaniem zamówienia przewoźnikowi Rozetka wymaga numeru listu przewozowego. Jeśli w dokumencie jest pusty, zamówienie jest pomijane, a w dzienniku pojawia się wpis z jego numerem. Najpierw uzyskaj list przewozowy, potem przełączaj zamówienie na status wysyłki.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Zwrotny zapis wykonuje zadanie eksportu, a nie szablon importu, i ma ono własny harmonogram. Jeśli statusy na Rozetce się nie aktualizują, sprawdzaj zadanie eksportu.
Aktualizacja według harmonogramu i zakres przebiegu
Zamówienia Elbuz pobiera sam co 5 minut, jeśli w szablonie zaznaczono „Zamówienia” i wypełniono klucz, — razem ze zwrotami, statusami listów przewozowych i finansami. Robi to wspólne zadanie „Zamówienia z marketplace’ów” w oknie „Harmonogram zadań”, tam też zmienia się interwał. Katalog i opinie w tym przebiegu się nie importują, a zamówienia pobrane także harmonogramem szablonu się nie dublują.
Katalog i opinie aktualizuje harmonogram samego szablonu — przycisk „Ustawienia harmonogramu” w karcie „Powiązane ustawienia”. Ustaw go rzadko, np. na noc: dopóki trwa katalog, przebieg zamówień jest pomijany do następnego, więc długi dzienny przebieg opóźnia zamówienia. Jak działa harmonogram — aktualizacja i harmonogram źródeł API.
Ile danych pobiera jeden przebieg
- Nie ma limitu liczby produktów. Katalog czyta się stronami po 100 pozycji, dopóki Rozetka nie poinformuje, że strony się skończyły. Każda strona zostawia wiersz w dzienniku: „Rozetka: strona katalogu 3 z 12, pobrano produktów: 300”.
- Do katalogu produkty trafiają partiami po 500 pozycji, więc wynik widać jeszcze przed końcem przebiegu.
- Atrybuty — osobne zapytanie dla każdego produktu, który ich jeszcze nie ma, z przerwą 0,1 sekundy między zapytaniami. Na końcu dziennik pisze: „Rozetka: atrybuty pobrano dla N produktów, M miało je już wcześniej”.
- Przebieg stanów kart po pełnym katalogu dodaje jeszcze sześć przejść po koncie, też stronami po 100.
Na jedno zapytanie program czeka nie dłużej niż 180 sekund (na połączenie — 30). Po błędzie serwera lub „zbyt wielu zapytaniach” zapytanie jest ponawiane — do trzech prób z przerwą 3 i 6 sekund. Jeśli nie uda się i za trzecim razem, czytanie katalogu się zatrzymuje, a w dzienniku jest wiersz „Rozetka: błąd API —” z przyczyną od platformy.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Nie trzeba siedzieć przy oknie: dziennik przebiegu jest w Centrum operacji, a kartę szablonu można zamknąć — jak śledzić przebieg.
Duży katalog za pierwszym razem przepuść z wyłączonymi „Atrybutami” — przebieg obejdzie się bez zapytań o pojedyncze produkty. W następnym przebiegu włącz „Atrybuty”: uzupełni atrybuty produktom, które ich jeszcze nie mają.
Scenariusze
Katalog prowadzisz w Elbuz, z Rozetki potrzebne są tylko zamówienia
Włącz „Zamówienia” i odznacz „Produkty” — zamówienia będą przychodzić same co 5 minut, harmonogram szablonu przyda się najwyżej dla „Opinii”. Przebieg przyniesie zamówienia, zwroty, statusy listów przewozowych i finanse. Katalog nie jest czytany: ceny, stany i stany kart się nie aktualizują. Magazyn od importu się nie zmienia — zamówienie trafia jako niezatwierdzone.
Pierwsze podłączenie dużego katalogu
Pierwszy przebieg — z „Produkty” i odznaczonymi „Atrybuty”: katalog przyjdzie bez zapytań o pojedyncze produkty. W drugim przebiegu włącz „Atrybuty” — program zapyta o atrybuty tylko dla produktów bez nich. Ten przebieg nie ściera istniejących wartości, istniejącym kartom tylko dopisuje brakujące.
Zdjęcia prowadzisz we własnej bibliotece mediów
Odznacz „Zdjęcia” — produkty katalogu przyjdą bez obrazów. Wyjątek: problematyczne karty (nieprawidłowe, odrzucone), które dodaje przebieg stanów, przychodzą ze zdjęciami niezależnie od opcji.
Trzeba widzieć w Elbuz, których kart Rozetka nie przepuszcza
Włącz „Produkty” i pozwól przebiegowi przeczytać katalog do końca, bez „Zatrzymaj”. W dzienniku pojawi się podsumowanie konta i wiersz dla każdej problematycznej grupy, a produkty, których jeszcze nie masz, przebieg doda sam. Oznaczenie nie jest przechowywane między przebiegami — każdy przebieg ustawia je od nowa.
Karta wyłączona w Elbuz nie powinna włączać się przebiegiem
W karcie, w sekcji „Ochrona podczas importu”, włącz „Nie aktualizuj”. Przebieg Rozetki nie zmieni w niej ani statusu, ani nazwy, ani ceny, ani producenta. Druga strona medalu: cena i stan z Rozetki też przestaną się dla niej aktualizować.
Co zrobić, gdy integracja działa nie tak
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Błąd autoryzacji w dzienniku | Klucz skopiowano niecały, usunięto go na koncie albo stał się nieaktywny po przerwie dłuższej niż 24 godziny; przy logowaniu hasłem — hasło zmieniono na Rozetce | Wygeneruj nowy klucz w «Безпека API», wklej go do szablonu i kliknij „Sprawdź połączenie” (jak zdobyć klucz) |
| Katalog się czyta, a przy zamówieniach dziennik pisze «В доступі відмовлено» (odmowa dostępu) | Sklep nie przeszedł jeszcze weryfikacji Rozetki — status widać na koncie: «Налаштування» → «Мій магазин» (Ustawienia → Mój sklep) | Dokończ weryfikację sklepu; klucza nie trzeba wydawać ponownie |
| Produkty przyszły ze stanem „w moderacji” | Pozycje nie przeszły jeszcze weryfikacji po stronie Rozetki — to nie jest błąd importu | Poczekaj na moderację; stan widać w dzienniku (stany kart) |
| Część atrybutów jest pusta | Program przenosi dokładnie to, co oddaje Rozetka | Uzupełnij karty w katalogu Elbuz |
| Status zamówienia na Rozetce się nie zmienił | Zwrotny zapis robi zadanie eksportu; dla statusów dostawy potrzebny jest list przewozowy | Sprawdź zadanie eksportu i numer listu przewozowego (zwrotny status) |
| Wyłączona karta znów jest włączona | Przebieg ustawia „włączone” każdemu produktowi, który przyszedł | Oznaczenie „Nie aktualizuj” w karcie (znikające produkty) |
| Przebieg się przerwał lub go zatrzymano | Połączenie, trzy błędy API z rzędu lub „Zatrzymaj” | Uruchom jeszcze raz — duplikatów nie będzie (przerwanie przebiegu) |
| Pobrano cudzy katalog albo zbędne zdjęcia i atrybuty | Klucz lub login innego sklepu albo zostały włączone „Zdjęcia” i „Atrybuty” | Znajdź i usuń produkty przebiegu (przebieg zrobił nie to) |
Zanim ustawisz katalog w harmonogramie, zrób próbne uruchomienie i sprawdź kilka produktów: nazwy, ceny, obrazy, kategorie, statusy.
Jeśli przebieg przerwał się w połowie
W katalogu zostaje wszystko, co zdążyło dojść partiami po 500 pozycji, reszta ma stare dane. Ponowne uruchomienie jest bezpieczne — jak to działa dla wszystkich źródeł, opisano w przeglądzie. Specyfika Rozetki:
- Atrybuty nie zaczynają się od zera — zapytania o pojedyncze produkty powtórzą się tylko dla tych, do których ostatnio nie doszło.
- Zamówienia się nie zdublują — dokument jest szukany po numerze zamówienia Rozetki.
- Oznaczenia stanów po przerwaniu na katalogu zostają z poprzedniego razu. Przerwanie właśnie na przebiegu stanów zostawia część produktów bez oznaczenia — do następnego pełnego przebiegu.
- „Zatrzymaj” w karcie operacji dopisuje do katalogu już przeczytane i zapisuje w dzienniku „Rozetka: import zatrzymany przez użytkownika, przetworzono: …”. Kontynuować od tego samego miejsca nie można: następne uruchomienie czyta konto od pierwszej strony.
Jeśli przebieg zrobił nie to
Nowe produkty przebiegu znajdziesz w oknie „Produkty” po kolumnie „Źródło: nazwa”, nadpisane — po „Dacie aktualizacji” (jak wycofać przebieg). Usunięte karty zabierają ze sobą powiązanie z Rozetką. Z którego szablonu przyszła karta, widać na jej liście identyfikatorów: wiersz „ID rozetka #numer szablonu”.
- Zdjęcia są dodawane tylko produktom utworzonym przez przebieg — zbędne znika razem z tymi kartami.
- Atrybuty istniejącym kartom są tylko dopisywane. Usunąć dopisane można w karcie ikoną kosza „Wyczyść wartości atrybutów produktu”.
1
Wyczyść wartości atrybutów produktu- Ikona kosza — czyści wartości atrybutów tego produktu (podpowiedź: „Wyczyść wartości atrybutów produktu”).
Wyczyszczone wartości zostawiają w karcie puste wiersze atrybutów, a następny przebieg uznaje je za zaimportowane — ponownie z Rozetki nie przyjdą. Żeby atrybuty zostały pobrane znowu, wiersze trzeba usunąć pozycją „Usuń atrybut”.
Najczęstsze pytania
Rozetka wydaje token czy klucz — skąd go wziąć?
Klucz generuje się na koncie sprzedawcy: «Налаштування» → «Безпека API» → «Генерувати API токен» (Ustawienia → Bezpieczeństwo API → Wygeneruj token API). Wkleja się go w pole „Klucz API Rozetka” szablonu (krok po kroku).
Czy trzeba podawać hasło do konta?
Nie. Klucz nie daje wejścia na konto i odwołuje się go osobno, dlatego hasło w szablonie nie jest potrzebne. Szablony z loginem i hasłem skonfigurowane wcześniej działają nadal.
Dlaczego pierwszy import trwa tak długo?
Rozetka oddaje atrybuty pojedynczo, więc dla dużego katalogu z „Atrybutami” zapytań jest dużo. Kolejne przebiegi pomijają już wypełnione atrybuty (zakres przebiegu).
Czy można pobierać z Rozetki tylko zamówienia, bez katalogu?
Tak: zostaw w szablonie tylko „Zamówienia”, a będą przychodzić same co 5 minut (scenariusz).
Mam kilka sklepów na Rozetce — co robić?
Dla każdego konta załóż osobny szablon z własnym kluczem. Szablony sobie nie przeszkadzają, mogą mieć różny harmonogram i zbierają produkty w jednym katalogu bazowym.
Gdzie trafiają opinie z Rozetki?
Z opcją „Opinie” opinie o sklepie i pytania o produkty przychodzą do Twojej skrzynki moderacji razem ze zgłoszeniami serwisowymi platformy dotyczącymi zamówień.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → szablon typu „API - Rozetka.UA”
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- klucz API z konta sprzedawcy Rozetka (lub login i hasło konta)
Jeden szablon — jedno połączenie z jednym kontem Rozetka. Jeśli masz kilka sklepów na Rozetce, dla każdego zakładaj osobny szablon z własnym kluczem.
1
Pole „Klucz API Rozetka”2
Pole „Login”3
Pole „Hasło”4
Przycisk „Sprawdź połączenie”5
Opcja „Produkty”6
Opcja „Zamówienia”- Pole „Klucz API Rozetka” — wklej tu klucz z konta sprzedawcy.
- Pole „Login” — Twój login sprzedawcy Rozetka.
- Pole „Hasło” — Twoje hasło sprzedawcy Rozetka.
- Przycisk „Sprawdź połączenie” — sprawdza dane dostępu bez uruchamiania importu.
- Opcja „Produkty” — dołącza produkty do importowanych danych.
- Opcja „Zamówienia” — dołącza zamówienia do importowanych danych.
Powiązane tematy
- Jeśli chcesz zrozumieć, jak import traktuje Twoje zmiany i przerwane przebiegi, — przegląd importu danych.
- Jeśli zamówienie przypisało się do niewłaściwego klienta lub produktu — import zamówień przez API.
- Jeśli obok Rozetki sprzedajesz na Prom — zamówienia z Prom.ua.
- Jeśli zastanawiasz się, co Elbuz daje sprzedawcy na Rozetce, — integracja z Rozetką.
