↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak wyeksportować katalog do feedu XML dla dowolnego serwisu

    Jak wyeksportować katalog do Rozetka: feed XML i API

    19 min czytaniaZaktualizowano

    Elbuz tworzy z katalogu feed XML dla Rozetka i umieszcza go pod stałym linkiem: marketplace sam pobiera plik, zakłada i aktualizuje karty produktów. Ceny i stany bez feedu aktualizuje Rozetka API.

    Kiedy to się przyda:

    • Po raz pierwszy wystawiasz produkty na Rozetka — feed tworzy karty z nazwami, opisami, zdjęciami, cechami i cenami.
    • Ceny i stany zmieniają się codziennie — feed jest odbudowywany według harmonogramu, a szablon API między przebiegami aktualizuje cenę i ilość już założonych kart.
    • Produkty trzeba umieścić w kategoriach Rozetka — numery kategorii i cech marketplace’u program wstawia do feedu sam.
    • Pozycję trzeba wycofać ze sprzedaży bez usuwania karty — status dostępności daje w feedzie available="false".

    Od czego zacząć: utwórz szablon typu Rozetka.UA w oknie „Eksport danych”.

    Co potrafi eksport do Rozetka

    To jedna z trzech różnych wymian z Rozetka (w rozmowie często po prostu «Розетка») i stale się je myli. Feed tworzy karty. aktualizuje ceny i stany produktów, które już są na marketplace. A import z Rozetka — odwrotnie, pobiera katalog z marketplace’u do Ciebie.

    Jak utworzyć szablon i przekazać feed Rozetka

    1. Dopasuj kategorie do słownika Rozetka. Wystarczą te, z których produkty zamierzasz sprzedawać na marketplace — pozostałe mogą zostać puste.
    2. Dopasuj cechy wewnątrz dopasowanych kategorii. Rozetka wymaga różnego zestawu cech dla różnych kategorii, a obowiązkowe lepiej uzupełnić w całości.
    3. W oknie „Eksport danych” dodaj szablon typu Rozetka.UA. Zamień w szablonie produktu przykładowy adres na adres swojego sklepu (co trafia do produktu).
    4. Uruchom szablon i sprawdź gotowy plik: czy rz_id w kategoriach nie jest pusty.
    5. Skopiuj link do pliku przyciskiem „Kopiuj link”.
    6. Sprawdź feed w panelu sprzedawcy Rozetka: „Управління товарами” (zarządzanie produktami) → „Валідатор” (walidator), wklej link w pole „Пряме посилання на файл” (bezpośredni link do pliku) i kliknij „Перевірити” (sprawdź). Status sprawdzenia pojawi się w tabeli pod polem. Jeszcze przed rejestracją sklepu feed można sprawdzić publicznym walidatorem Rozetka: link lub plik, e-mail i CAPTCHA, raport przychodzi pocztą. W formularzu szablonu Rozetka.UA otwiera go przycisk z ptaszkiem w nagłówku okna.
    7. Przekaż link Rozetka przez wsparcie: w panelu napisz w temacie „Робота з товарами, прайс-лист” (praca z produktami, cennik) → „Питання по вивантаженню XML” (pytanie o eksport XML) i wklej link do zgłoszenia. Przycisku „dodaj feed” w panelu nie ma, przez API link też nie jest przekazywany. Osobny serwis w rodzaju Pricecreator nie jest do tego potrzebny: Rozetka przyjmuje feed z dowolnego systemu, a Elbuz jest jednym z nich.
    8. Podłączony feed pojawia się jako wiersz w „Управління товарами” → „Управління прайс-листами” (zarządzanie cennikami): widać tam link, okres i datę ostatniej synchronizacji. Poza kolejnością feed można pobrać z menu wiersza — „Синхронізувати” (synchronizuj), nie częściej niż co 3 godziny. Nowe pozycje po synchronizacji trafiają do „Товари” (produkty) → „Нові” (nowe). Wysyła się je do moderacji przyciskiem „Відправити на модерацію” (wyślij do moderacji) albo włącza w wierszu cennika „Автозаявку для нових” (automatyczne zgłoszenie dla nowych) — wtedy zgłoszenie tworzy się samo, domyślnie codziennie o 08:00.
    9. W Elbuz ustaw szablon w harmonogramie.
    10. Żeby ceny i stany aktualizowały się między przebiegami feedu, a zamówienia trafiały do Elbuz, podłącz import z Rozetka kluczem API i szablon eksportu API (feed czy API).

    Najczęstszy błąd pierwszego uruchomienia — wyeksportować feed przed dopasowaniem. Plik powstanie, Rozetka go weźmie, ale produkty albo się nie założą, albo trafią do przypadkowej kategorii, a rozwiązywać to trzeba będzie już po stronie marketplace’u.

    Rozetka pobiera feed sama, przez link. Dlatego plik trzeba umieścić tam, skąd marketplace go odczyta: na Twojej stronie, na lub w magazynie plików w chmurze — sposoby dostarczenia opisuje sekcja „Gdzie trafia plik”.

    W skopiowanym linku za każdym razem jest inna końcówka ?uuid=… — to znacznik przeciw cache’owaniu. Sam adres pliku nie zmienia się między przebiegami, więc w panelu Rozetka nie trzeba podmieniać linku.

    Nie wstawiaj do nazwy pliku makr {DATE}, {DATETIME} ani {TIME}. Z nimi każdy przebieg zapisuje plik pod nową nazwą, a link przekazany Rozetka zostaje przy wczorajszym pliku albo przestaje się otwierać. Nowy szablon Rozetka.UA ma już stałą nazwę — export_rozetka.xml; wyczyszczone pole „Nazwa pliku” da export_elbuz.xml i nowy link. Szczegóły: nazwa pliku i FTP.

    Co program dodaje do feedu specjalnie dla Rozetka

    Gdy tworzysz szablon typu Rozetka.UA, program przygotowuje szablon XML z trzema różnicami względem bazowego XML. To od nich zależy, czy marketplace przyjmie feed jak należy, czy założy produkty „gdzieś nie tam”.

    RóżnicaJak wyglądaPo co
    Identyfikator kategorii marketplace’uw kategorii pojawia się atrybut rz_idRozetka umieszcza produkt w swojej kategorii, a nie w Twojej. Bez tej liczby marketplace nie wie, gdzie go dać
    Identyfikator cechy marketplace’uw cesze pojawia się atrybut paramidRozetka dopasowuje Twoją cechę do swojej po numerze, a nie po nazwie — „Przekątna” i „Przekątna ekranu” to dla niej różne rzeczy
    Ilośćdochodzi węzeł stock_quantitybazowy XML ma tylko znacznik „jest / nie ma”, a Rozetka pokazuje klientowi stan liczbą

    Liczby dla rz_id i paramid są przechowywane w Twoich kategoriach i cechach. Uzupełnia się je raz, w oknie dopasowania do marketplace’ów; kolumny Rozetka widać też w słowniku atrybutów.

    Te trzy rzeczy program wstawia do szablonu sam. Przepisywać szablonu ręcznie nie trzeba — ale jeśli był już poprawiany, porównaj go z tą tabelą: zniknięcie rz_id lub paramid wygląda z zewnątrz jak „feed niby w porządku, a produkty na marketplace się nie zakładają”.

    Szablon eksportu Rozetka.UA: podszablon kategorii z atrybutem rz_id
    1Atrybut rz_id
    1. rz_id — tu wstawia się numer kategorii ze słownika Rozetka; bez niego marketplace nie wie, gdzie umieścić produkt.

    Co trafia na marketplace

    Skład produktu w feedzie jest standardowy dla XML, plus ilość dla Rozetka.

    Co w feedzieSkąd się bierzeCo sprawdzić
    Identyfikator id węzła offerwewnętrzny produktu Elbuzprodukt usunięty i założony od nowa to dla Rozetka inny produkt
    Link do produktuszablon produktuw szablonie wyjściowym jest przykładowy adres — zamień go na adres swojego sklepu
    Cena i waluta, kategoria, nazwa, producent, kod producenta, opiskarta produktu—
    Zdjęciakarta produktunie więcej niż 15, zob. niżej
    Cechykarta produktu; paramid — dopasowaniewartość do 255 znaków
    Ilość stock_quantitypole „Ilość” karty produktu, bez zmianzero w karcie da zero w feedzie, nawet przy statusie „Dostępny”
    Znacznik dostępności availableokno „Ustawienia aktualizacji według dostępności produktu” szablonuzob. niżej
    Kod kreskowyw szablonie wyjściowym go nie majeśli kategoria Rozetka wymaga kodu kreskowego, dodaj do szablonu produktu wiersz z makrem {ean}

    Liczby z okna „Ustawienia aktualizacji według dostępności produktu” do feedu XML nie trafiają: działają tam dla innych typów eksportu. Z tego okna brany jest tylko available:

    • dla każdego statusu dostępności do feedu idzie Twój tekst z kolumny „Nazwa na stronie (w pliku)”;
    • jeśli kolumna jest pusta — true dla statusu ze znacznikiem dostępności i false dla pozostałych;
    • dla statusu wyłączonego w tym oknie — true tylko dla „Dostępny”, dla pozostałych false.
    Okno „Ustawienia aktualizacji według dostępności produktu” z tabelą statusów dostępności
    1Nazwa na stronie (w pliku)
    2Aktywność
    3Ilość
    1. „Nazwa na stronie (w pliku)” — ten tekst trafia dosłownie do atrybutu available feedu; pusta komórka oznacza, że true/false ustala znacznik statusu.
    2. Aktywność — odznaczone pole włącza regułę zastępczą (true tylko dla „Dostępny”).
    3. Ilość — ta liczba nie trafia do feedu XML Rozetka; stock_quantity jest brane z karty produktu.

    Co program przycina specjalnie dla Rozetka

    Trzy rzeczy w produkcie są przetwarzane inaczej niż w zwykłym XML. Dzieje się to bez komunikatu: w dzienniku nie ma o tym osobnych wierszy.

    • Zdjęcia — nie więcej niż 15. Reszta nie trafi do pliku, nawet jeśli karta produktu ma ich trzydzieści. Jednakowe linki liczą się jako jeden. Jeśli w polu „Maksymalna liczba zdjęć” jest mniejsza liczba, obowiązuje ona.
    • Wartość cechy — nie dłuższa niż 255 znaków. Dłuższa wartość jest przycinana i na marketplace trafia jej fragment.
    • Z tekstu usuwane są obrazy i linki. Tagi <img> i <a> są wycinane z pól produktu wstawianych do szablonu — przede wszystkim z opisu.

    Szablon uznaje się za „rozetkowy” nie po typie na liście, lecz po zawartości. Program szuka rz_id= w wierszu kategorii, słowa Rozetka w szablonie wiersza cechy lub „rozetka” w opisie szablonu; wystarczy jeden znacznik. Jeśli przepisano szablon i nie został żaden, trzy ograniczenia powyżej przestają działać, a do feedu trafią wszystkie zdjęcia i opisy z linkami.

    Co nadpisze ponowny eksport i jak wycofać produkt ze sprzedaży

    Każdy przebieg składa plik od zera: program bierze wszystkie produkty, które przechodzą wybór szablonu, i wstawia je do szablonu XML z bieżącymi wartościami katalogu. Każdy produkt w pliku idzie pełnym zestawem węzłów szablonu — feed nie potrafi wysłać osobno jednego zmienionego pola. Zawęzić można tylko listę produktów — flagą „Eksportować tylko nowe dane”.

    Ten sam produkt za każdym razem idzie pod tym samym UUID — po nim marketplace widzi aktualizację starej pozycji, a nie nową.

    Na marketplace trafia to, co jest w szablonie produktu. Jeśli nazwy prowadzisz w panelu sprzedawcy, a nie w Elbuz, usuń z szablonu węzeł <name> — czego nie ma w pliku, tego Rozetka z feedu nie dostanie. Tak samo z opisem, ceną, zdjęciami. Pola wyboru „nie aktualizuj tego pola” w eksporcie nie ma.

    Co marketplace robi z otrzymanymi wartościami, to jego reguła: część zmian trafia w panelu do działów „w moderacji” i „aktualizacje oczekują na zatwierdzenie”. Stan każdej karty bez wchodzenia do panelu pokaże import katalogu Rozetka.

    Jak wycofać produkt ze sprzedaży

    W feedzie nie ma polecenia „usuń produkt”. Jedyne, czym plik mówi o sprzedaży, to znacznik dostępności i ilość wewnątrz samego produktu. Pozycja, której nie ma w pliku, nie niesie marketplace’owi żadnego sygnału. Dlatego, żeby zakończyć sprzedaż, zostaw pozycję w feedzie ze statusem dostępności, który daje available="false" (scenariusz), zamiast usuwać ją z wyboru.

    Produkt znika z pliku, gdy tylko przestaje przechodzić wybór szablonu: odznaczono flagę eksportu, wyłączono kategorię, nie przeszedł „Dodatkowy filtr” itp. Pełna lista warunków — w sekcji „Dlaczego produkt nie trafił do pliku”. Dla Rozetka ważne są jeszcze dwa:

    • produkt jest produktem-opcją (wariantem), a w szablonie nie zaznaczono „Opcje” — w nowym szablonie to pole jest odznaczone;
    • w szablonie wybrano magazyn, w którym produkt nie ma ani stanu, ani statusu „Dostępny”.

    Jak poprawić produkty, które trafiły do złej kategorii

    Poprawiać trzeba nie produkty. Numer kategorii Rozetka leży w Twojej kategorii, więc jedna poprawka dopasowania zmienia rz_id od razu wszystkim jej produktom.

    1. Otwórz okno dopasowania i znajdź kategorię z błędnym numerem.
    2. Zamień dopasowanie na właściwe (jak zamienić powiązanie).
    3. Uruchom eksport jeszcze raz i poczekaj, aż Rozetka pobierze świeży plik według swojego harmonogramu.

    Automatyczny dobór powiązań tu nie pomoże: wypełnia tylko puste dopasowania. Kategorii, która ma już numer, nie rusza — nawet jeśli numer jest błędny. Błędne dopasowanie zamienia się ręcznie.

    Cechy mają dwa poziomy dopasowania: ogólne dla cechy i osobne wewnątrz konkretnej kategorii. Dopasowanie w kategorii ma pierwszeństwo — jeśli jest wypełnione, to ono trafi do paramid. Dlatego cechę, która w różnych kategoriach Rozetka znaczy co innego, dopasowuje się na poziomie kategorii.

    Harmonogram, przerwanie i pauza feedu

    Harmonogram w Elbuz musi działać nie rzadziej, niż Rozetka przychodzi po plik. Inaczej marketplace będzie pobierał wczorajsze ceny, a wyglądać to będzie jak „Elbuz nie aktualizuje danych”. Jak ustawić harmonogram i co się stanie, gdy dwa szablony nałożą się w czasie — w sekcji „Uruchomienie ręczne i według harmonogramu”.

    Jeśli przebieg się przerwał

    Przerwanie w środku przebiegu nie psuje tego, co już przekazano Rozetka: plik składa się w folderze tymczasowym i trafia pod stały adres w całości, jako ostatni krok. Pod linkiem zostaje plik z poprzedniego przebiegu — cały, choć wczorajszy, a kolumna „Ostatni eksport” — ze starą datą.

    Powtarzanie przerwanego przebiegu jest bezpieczne: następne uruchomienie składa plik od nowa. Jak rozpoznać przerwanie po dzienniku — w sekcji „Dziennik przebiegu”.

    Dwa górne rozgałęzienia dotyczą tylko uruchomienia według harmonogramu — ręczne uruchomienie jednego szablonu je omija. Dalej patrz na romb „Przebieg doszedł do końca?”: gałąź „nie” nie rusza pliku pod linkiem, a stare pliki z magazynu są usuwane dopiero po przesłaniu nowego
    taknietaknienie — kliknięto „Zatrzymaj”nie — pusty wybór lubawariataknietakUruchomienie szablonu Rozetka.UAUruchomienie wedługharmonogramu, a trwa już eksportinnego szablonu?Anulowano eksport wedługharmonogramu — wiersz wdziennikuUruchomienie wedługharmonogramu, a szablonwyłączono w kolumnie „Stan”?Szablon pominięty bez komunikatu— plik pod linkiem się nie zmieniaPlik składa się w folderzetymczasowym konta, dopisywanypartiami po 500 produktówPrzebieg doszedł do końca?Eksport przerwany przezużytkownika — ostrzeżenie, podlinkiem zostaje plik z poprzedniegoprzebieguEksport danych NIE zostałzakończony — pod linkiem zostajeplik z poprzedniego przebieguNowy plik trafił do magazynu?Plik nie został przesłany domagazynu plików w chmurze —Eksport danych NIE zostałzakończony, poprzedni plik i link bezzmianLink i data eksportu w szablonie sięaktualizują, pozostałe pliki folderuszablonu są usuwane, jeśli magazynna to pozwalaJeśli zaznaczono „Eksportowaćtylko nowe dane” — produktyprzebiegu są oznaczane jakowyeksportowaneEksport danych zakończony
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    Wyłączyć szablon czy usunąć

    • Szablon wyłączono przełącznikiem „Stan”. Harmonogram pomija go bez komunikatu. Plik pod linkiem zostaje taki, jak złożył go ostatni przebieg, a Rozetka nadal go pobiera: ceny i stany zastygają na moment wyłączenia. Marketplace nie widzi błędu.
    • Szablon włączono z powrotem. Najbliższy przebieg według harmonogramu złoży plik pod tym samym adresem.
    • Szablon usunięto. Sam plik w magazynie nie jest usuwany — link nadal działa i oddaje ostatni złożony plik. Żeby Rozetka naprawdę przestała brać Twój katalog, usuń link w panelu sprzedawcy.

    Ile zmieści feed

    Limitu liczby produktów nie ma: ile przejdzie wybór, tyle trafi do pliku. Na koncie demo do eksportu trafia nie więcej niż 100 produktów. Przebieg raportuje co 500 produktów wierszem „Eksport produktów ‹N› z ‹M›” — liczba rośnie, przebieg trwa. Jeśli feed dla Rozetka jest duży, rozłóż go w czasie z innymi szablonami.

    Feed czy API — kiedy który

    Rozetka ma drugi kanał wymiany i rozwiązuje on inne zadania.

    Co jest potrzebneFeed XMLAPI
    Zakłada nowe kartytaknie
    Aktualizuje ceny i stanytak, razem z całym feedemtak, punktowo
    Zwraca statusy zamówień i numer przesyłki ()nietak
    Co jest potrzebne do podłączenianic poza adresem plikuklucz API z panelu sprzedawcy (lub login i hasło do panelu)

    W szablonie eksportu API klucz wkleja się w pole „Hasło do panelu sprzedawcy Rozetka lub klucz API (gapi_…)” — login można wtedy zostawić pusty. Szablon skonfigurowany wcześniej z loginem i hasłem działa dalej.

    Typowy zestaw roboczy — oba: feedem zakłada się i uzupełnia asortyment, API utrzymuje aktualne ceny i stany między eksportami feedu i zwraca do Elbuz to, co stało się z zamówieniami.

    Co dokładnie wysyła API

    Tylko trzy wartości: cenę, starą cenę i ilość — i tylko produktom, które mają już numer karty Rozetka. Nazw, opisów, zdjęć i cech API nie rusza. Pozycje bez numeru karty pomija i zapisuje w dzienniku: „Rozetka: pominięto pozycji bez powiązania z produktami platformy: ‹N› (karty tworzy eksport feedu XML)”.

    Numer karty nie przychodzi z feedu, lecz w przeciwnym kierunku — przynosi go import katalogu Rozetka. Kolejność: feed zakłada karty → import katalogu przynosi do Elbuz ich numery → API aktualizuje według nich ceny i stany. Dopóki nie było drugiego kroku, API będzie pomijać wszystko.

    Lewa kolumna — Elbuz, prawa — Rozetka. Numer karty, bez którego API niczego nie wysyła, przychodzi strzałką z prawej do lewej — importem katalogu, a nie feedem
    RozetkaElbuzKarty produktów zakładają się z feeduProdukt bez numeru karty jest pomijany — w dzienniku pojawia się wiersz o pominiętych pozycjachSzablon Rozetka.UA składa feed XML i umieszcza go pod stałym adresemPobiera plik przez link według własnego harmonogramuImport katalogu Rozetka pobiera karty sprzedawcyKarty z numerami — Elbuz zapisuje numer przy swoim produkcieSzablon API wysyła cenę, starą cenę i ilość paczkami po 100
    • Запит або дія
    • Відповідь
    • Примітка
    • Gwałtowna zmiana ceny nie obowiązuje od razu. Cena podniesiona ponad 1,5 raza lub obniżona ponad 2 razy idzie do weryfikacji przez menedżera marketplace’u. Po przebiegu Elbuz pisze: „Rozetka: cen oczekujących na zatwierdzenie przez menedżera platformy: ‹N›”. Pozostałe ceny z tego samego przebiegu już obowiązują.
    • Pusta stara cena kasuje przekreśloną cenę na marketplace. Jeśli stara cena w Elbuz nie jest wypełniona, API wysyła zamiast niej −1, a Rozetka usuwa starą cenę z karty.
    • Pozycje idą paczkami po sto na zapytanie, a po każdej w dzienniku pojawia się wiersz „Rozetka: zaktualizowano pozycji: ‹N› z ‹M›”.

    Kto ma pierwszeństwo, gdy oba zapisują cenę

    Priorytetu między kanałami nie ma: to dwa osobne szablony z własnym wyborem, harmonogramem i źródłem ceny. W feedzie cenę wstawia makro z szablonu XML, w szablonie API ustawia się ją na liście pól. Sprowadź oba do jednego pola ceny — i rozbieżności nie będzie. Jeśli pola są różne, feed nadpisuje cenę wszystkich wybranych produktów, a API — tylko tych, które mają numer karty.

    Scenariusze

    Założyć produkty na Rozetka i utrzymywać aktualne ceny między feedami

    Co skonfigurować. Trzy szablony, każdy z własnym harmonogramem: szablon typu Rozetka.UA dla feedu, import katalogu Rozetka i szablon API Rozetka z kluczem API panelu sprzedawcy.

    Efekt. Feed zakłada karty. Import katalogu przynosi do Elbuz numery tych kart i zapisuje je przy Twoich produktach. Szablon API wysyła według tych numerów cenę, starą cenę i ilość.

    Czego nie będzie. API nie utworzy karty ani nie zmieni nazwy, opisu, zdjęć czy cech. Produkt, którego nie ma jeszcze w zaimportowanym katalogu, API pominie. Gwałtownie zmieniona cena nie zacznie obowiązywać, dopóki nie sprawdzi jej menedżer Rozetka.

    Zakończyć sprzedaż pozycji bez usuwania karty

    Co skonfigurować. Ustaw produktowi status dostępności inny niż „Dostępny” — np. „Brak w magazynie” — i zostaw produkt w wyborze szablonu. W oknie „Ustawienia aktualizacji według dostępności produktu” dla tego statusu zostaw kolumnę „Nazwa na stronie (w pliku)” pustą albo wpisz tam false.

    Efekt. Pozycja zostaje w feedzie, a w available idzie false. Status „na zamówienie” bez własnego tekstu w tej kolumnie też daje false.

    Czego nie będzie. Tekst z kolumny trafia do feedu dosłownie: słowo w rodzaju „Brak” znajdzie się w available zamiast false. Jeśli w szablonie wybrano magazyn, produkt bez stanu i bez statusu „Dostępny” w tym magazynie całkiem wypadnie z wyboru.

    Wstrzymać feed

    Co skonfigurować. Wyłącz szablon przełącznikiem w kolumnie „Stan”.

    Efekt. Harmonogram pomija szablon, plik pod linkiem zostaje taki, jak złożył go ostatni przebieg. Feed można sprawdzić przyciskiem uruchomienia — działa też dla wyłączonego szablonu.

    Czego nie będzie. Rozetka nie dowie się o pauzie: nadal pobiera ostatni plik z cenami i dostępnością z chwili wyłączenia. Żeby marketplace przestał sprzedawać pozycje, potrzebny jest poprzedni scenariusz albo usunięty link w panelu sprzedawcy.

    Jedna cecha oznacza co innego w różnych kategoriach Rozetka

    Co skonfigurować. W oknie dopasowania dopasuj cechę wewnątrz każdej kategorii, w której jest potrzebna, a nie tylko ogólnie.

    Efekt. Dla produktów tej kategorii do paramid trafia numer z dopasowania kategorii. Z nazwą cechy Rozetka jest tak samo: kategoria ma pierwszeństwo przed ogólną. Jeśli nazwy Rozetka nie ma nigdzie, idzie Twoja nazwa cechy.

    Czego nie będzie. W kategoriach bez dopasowania na poziomie kategorii produkty nadal idą z ogólnym numerem.

    Co zrobić, gdy produkty nie pojawiły się na Rozetka

    Co widziszDlaczego tak jestCo zrobić
    Produkty nie zakładają się na marketplace kategorie mają pusty rz_id — nie są dopasowane do słownika Rozetka dopasuj kategorie i wyeksportuj feed ponownie (kolejność)
    Produkty się założyły, ale bez cech pusty paramid — cechy nie są dopasowane dopasuj cechy w kategoriach, których używasz (jak)
    Rozetka pokazuje „brak w magazynie” przy produktach, które są status dostępności produktu nie daje available="true" sprawdź status w oknie „Ustawienia aktualizacji według dostępności produktu” szablonu (skąd available)
    Na marketplace zerowy stan, choć produkt jest stock_quantity jest brane z pola „Ilość” karty produktu, a ono jest puste wypełnij ilość w karcie — ustawienia dostępności szablonu tej liczby nie zastępują
    Produkt na Rozetka ma mniej zdjęć niż w karcie do feedu Rozetka trafia nie więcej niż 15 zdjęć ustaw potrzebne jako pierwsze w kolejności (ograniczenia)
    Wartość cechy na marketplace jest ucięta dla Rozetka wartości dłuższe niż 255 znaków są przycinane skróć wartość cechy w katalogu
    Link przekazany Rozetka przestał się otwierać w nazwie pliku jest makro daty: każdy przebieg daje plik pod nową nazwą usuń {DATE} z nazwy pliku i podaj marketplace’owi stały adres (nazwa pliku)
    Feed się nie aktualizuje, błędów w dzienniku nie ma szablon wyłączono w kolumnie „Stan” — harmonogram pomija go bez komunikatu włącz szablon; plik pod linkiem przez cały ten czas był stary (pauza)
    Linki do produktów prowadzą donikąd w szablonie został przykładowy adres strony zamień go na adres swojego sklepu
    Ceny na marketplace są nieaktualne Rozetka przychodzi po plik częściej, niż Elbuz go aktualizuje ustaw częstszy harmonogram albo podłącz API
    „Rozetka: pominięto pozycji bez powiązania z produktami platformy” produkty nie mają jeszcze numeru karty Rozetka załóż karty feedem i uruchom import katalogu Rozetka (kolejność)
    Do feedu trafiły zbędne produkty albo nie trafiły potrzebne wybór produktów w szablonie co zrobić, gdy w pliku jest nie to

    Najczęstsze pytania

    Co to jest rz_id i skąd się bierze?

    To numer kategorii w słowniku samej Rozetka. Jest zapisywany w Twojej kategorii po dopasowaniu do kategorii marketplace’u i wstawiany do feedu automatycznie. Nie trzeba go wpisywać do szablonu ręcznie.

    Czy trzeba dopasować wszystkie kategorie katalogu?

    Nie, tylko te, z których produkty sprzedajesz na Rozetka. Niedopasowane kategorie pójdą bez numeru marketplace’u, a jeśli ich produkty nie przechodzą wyboru — nie pójdą wcale.

    Czy można obejść się bez feedu, samym API?

    Nie, jeśli produktów na marketplace jeszcze nie ma: API aktualizuje ceny i stany już założonych kart, a karty tworzy właśnie feed.

    Jak sprawdzić feed przed przekazaniem go marketplace’owi?

    Wykonaj próbny przebieg w karcie szablonu — program złoży ten sam plik z oznaczeniem test_ w nazwie. Otwórz go i sprawdź: czy rz_id nie jest pusty, czy linki do produktów są prawidłowe, czy są ceny.

    Poprawiono nazwę produktu w panelu Rozetka. Czy następny feed ją nadpisze?

    Feed oddaje wartości z katalogu Elbuz — o poprawce w panelu nie wie. Jeśli pole prowadzisz po stronie marketplace’u, usuń odpowiedni węzeł z szablonu produktu (co nadpisze feed).

    Eksport do Rozetka pisze „pominięto pozycji bez powiązania z produktami platformy”. Dlaczego?

    To wiersz szablonu API, a nie feedu. API aktualizuje tylko produkty z numerem karty Rozetka, a numer przynosi import katalogu Rozetka. Załóż karty feedem → zaimportuj katalog → następny przebieg API zaktualizuje te produkty.

    Ceny zostały zmienione, a na Rozetka część nie weszła: „oczekuje na zatwierdzenie menedżera”. Co to?

    Reguła samej Rozetka: cena podniesiona ponad 1,5 raza lub obniżona ponad 2 razy zaczyna obowiązywać po weryfikacji przez menedżera. Elbuz ją wysłał, pozostałe ceny przebiegu już obowiązują. Stan takich cen sprawdzaj w panelu sprzedawcy.

    Widzę taki sam szablon dla Kasta. Czy to to samo?

    Nie. Dla nowych szablonów typ „Kasta (XML)” ma własny szablon wyjściowy według instrukcji Kasta: offer id — numer produktu, rz_id z kodem Rozetka w kategoriach, stock_quantity, price_old i do 20 zdjęć. Szczegóły: eksport produktów do Kasta.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Eksport danych
    Utwórz
    „Dodaj” → typ Rozetka.UA
    Skonfiguruj
    karta szablonu: wybór produktów, szablon , nazwa pliku, harmonogram
    Uprawnienia
    okna „Eksport” i „Szczegółowa konfiguracja szablonu eksportu” w „Uprawnieniach grup”
    Przygotuj
    kategorie i cechy dopasowane do Rozetka

    Ogólna mechanika szablonów — wybór produktów, dostarczenie pliku, harmonogram, dziennik — jest taka sama dla wszystkich typów i opisana w artykule o eksporcie produktów. Sam format omawia artykuł o eksporcie w formacie XML. Tutaj — tylko to, co dotyczy Rozetka.

    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