↑↓ wybierzEnter otwórzEsc zamknij

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

    Jak wyeksportować produkty do Kasta: feed XML

    5 min czytaniaZaktualizowano

    Elbuz buduje z katalogu feed XML dla Kasta i udostępnia go pod stałym linkiem, a Kasta HUB sam pobiera z niego nowe produkty, ceny i stany.

    Kiedy to się przyda:

    • Wchodzisz na Kasta — szablon „Kasta (XML)” ma już tagi z instrukcji Kasta.
    • Kategorie są już dopasowane do Rozetka — Kasta sama dopasuje je do swoich według kodu Rozetka.
    • Produkty dostępne bez dokładnego stanu — do feedu idzie ilość według statusu, więc Kasta ich nie ukrywa.
    • Ceny i stany zmieniają się codziennie — feed jest przebudowywany według harmonogramu, Kasta pobiera zmiany co godzinę.

    Od czego zacząć: kolejność podłączenia — od szablonu w Elbuz do feedu w Kasta HUB.

    Co potrafi eksport do Kasta

    Zamówień feed nie przynosi. Pobiera je osobne połączenie — import zamówień z Kasta.

    Jak podłączyć Kasta: od szablonu do produktów w HUB

    1. Przygotuj karty. Ukraińska nazwa i opis, producent, kod SKU, zdjęcia; dla odzieży i obuwia — atrybuty „Колір” (kolor) i „Розмір” (rozmiar) (dlaczego).
    2. Dopasuj kategorie do Rozetka, jeśli jeszcze tego nie zrobiono: ich kody trafią do feedu (dopasowanie kategorii).
    3. Utwórz szablon eksportu typu „Kasta (XML)”. Elbuz ustawia język szablonu na ukraiński (jeśli jest włączony na koncie) i limit 20 zdjęć na produkt. Adres sklepu do nagłówka szablon bierze z Twoich danych; jeśli został symbol zastępczy https://site.com — formularz ostrzeże, zamień go. Symbole zastępcze MyStore w tagach name i company nagłówka zamień nazwą sklepu.
    4. Wygeneruj plik przyciskiem „Eksportuj” i otwórz go pod linkiem.
    5. Dodaj link w Kasta HUB i włącz potrzebne aktualizacje (jak).
    6. Ustaw harmonogram szablonu w Elbuz, żeby plik był przebudowywany ze świeżymi cenami i stanami.

    Co trafia do feedu

    Tag feedu KastaSkąd pochodzi w Elbuz
    offer idnumer produktu w Elbuz — cyfry, bez cyrylicy i spacji, jak wymaga Kasta
    category, atrybut rz_idnumer i nazwa Twojej kategorii; rz_id — kod kategorii Rozetka, tylko jeśli jest wypełniony w kategorii
    availablestatus dostępności: „dostępny” — true, pozostałe — false
    pricecena produktu
    price_oldwiększa ze starej ceny i ceny — tag jest zawsze
    stock_quantitystan (jak jest liczony)
    picturezdjęcia produktu, do 20 sztuk
    vendorproducent
    articlekod (SKU) producenta
    name_ua, description_uanazwa i pełny opis po ukraińsku
    name_ru, descriptionnazwa i opis po rosyjsku — tylko jeśli przy tworzeniu szablonu na koncie były włączone języki ukraiński i rosyjski
    paramatrybuty produktu: nazwa, wartość, jednostka miary

    Z opisów Elbuz wycina obrazki i linki razem z tekstem linku: Kasta zabrania ich w opisie. Opis dłuższy niż 5000 znaków Kasta przytnie sama.

    Karta szablonu XML z blokiem offer feedu Kasta
    1Wiersz offer
    2Stan magazynowy
    3Formuła starej ceny
    1. Wiersz offer — każdy produkt staje się elementem offer ze swoim ID i statusem dostępności.
    2. Stan magazynowy — do feedu wpisywany jest symbol zastępczy stanu.
    3. Formuła starej ceny — stara cena to większa ze starej ceny i ceny bieżącej.

    Kasta zabrania zmieniać id produktu po publikacji, a id kategorii muszą pozostać niezmienne. W szablonie to numery z Elbuz, więc są stabilne, dopóki nie tworzysz kart lub kategorii od nowa.

    Bez rz_id kategorię trzeba dopasować ręcznie plikiem mapowania w HUB (sekcja „Категорія+”). Atrybuty Kasta dopasowuje po nazwie; nieznane nazwy dopasowuje się tam samo, w „Каскад+”. Kodów kategorii i atrybutów Kasta Elbuz nie wypełnia.

    Jak Kasta widzi dostępność i cenę

    Kasta bierze stan z stock_quantity, a przy available="false" uznaje go za zero niezależnie od ilości. Dlatego w szablonie Kasta jest symbol zastępczy {stock_quantity}:

    Produkt w ElbuzCo trafia do feedu
    jest stan, status „dostępny”rzeczywisty stan, available="true"
    brak stanu, status „dostępny”ilość z tabeli „Ustawienia aktualizacji według dostępności produktu”, domyślnie 1000
    status „na zamówienie”rzeczywisty stan lub domyślnie 500, ale available="false" — więc na Kasta stan 0
    status braku0

    Ilości według statusów zmienia się przyciskiem „Ustawienia aktualizacji według dostępności produktu” w formularzu szablonu (jak działa ta tabela).

    Cena. Kasta wymaga, żeby cena sugerowana (przekreślona) nie była niższa od ceny sprzedaży, a bez niej zgłasza błąd w raporcie. Dlatego price_old w szablonie to zawsze większa ze starej ceny i ceny: produkt bez rabatu idzie z jednakowymi wartościami. Cenę sprzedaży Kasta radzi liczyć z uwzględnieniem swojej prowizji (royalty).

    Jak warianty łączą się w jedną kartę

    Kasta grupuje produkty w jedną kartę według zestawu Kod SKU + Marka + Kolor + Rozmiar: warianty jednego modelu mają takie same article, vendor i kategorię, a kolor i rozmiar przekazuje się atrybutami.

    • Odzież i obuwie — atrybuty „Колір” (kolor) i „Розмір” (rozmiar) są obowiązkowe. Załóż je w kartach Elbuz właśnie z takimi nazwami: trafią do feedu jako wiersze param.
    • Bez rozmiarówki (szampon, akumulator) Kasta sama ustawi rozmiar „-”, a przy braku koloru — „комбінований” (mieszany) lub „не визначено” (nieokreślony).
    • Nie wpisuj koloru w nazwie — Kasta może usunąć z nazwy to, co przekazano osobnym atrybutem.
    • Wymiary i waga w opakowaniu wpływają na wyliczenie dostawy. W szablonie ich nie ma; dodaj atrybuty o nazwach „Габарити в упаковці, см” (wymiary w opakowaniu, cm) i „Вага в упаковці, кг” (waga w opakowaniu, kg) — bez nich Kasta wstawi średnie wartości kategorii.

    Kasta przypisuje ten zestaw do karty na stałe. Zmienisz jeden z nich w feedzie — dla Kasta to nowy produkt, który znów idzie do moderacji. Aby go zmienić, produkt usuwa się w HUB i wczytuje od nowa.

    Jak dodać feed w Kasta HUB

    1. W panelu HUB: „Товари” → „Імпорт новинок” → zakładka „XML” → „Додати новий фід” (Produkty → Import nowości → XML → Dodaj nowy feed).
    2. Wklej link do feedu z Elbuz i zaznacz ustawienia:
      • „Завантажити товари з xml” (wczytaj produkty z XML) — włącza feed: nowe produkty i aktualizacje;
      • „Оновлювати ціни”, „Оновлювати стоки”, „Оновлювати контент” (aktualizuj ceny, stany, treść) — co pobierać z pliku w przyszłości;
      • „Зняти з продажу товари, які відсутні в фіді” (wycofaj ze sprzedaży produkty, których nie ma w feedzie) — produktom, których nie ma w pliku, stan zostanie wyzerowany;
      • „Використати ціну продажу, якщо немає рекомендованої ціни” (użyj ceny sprzedaży, jeśli nie ma ceny sugerowanej) — dla szablonu Elbuz niepotrzebne, price_old jest w nim zawsze.
    3. Zapisz. Feed dostanie swój numer, którym zostaną oznaczone wszystkie wczytane z niego produkty.

    Ograniczenia Kasta: plik do 1 GB, wczytywanie do 45 minut, jednocześnie — do 3 aktywnych feedów. Aby wyłączyć feed, odznacz wszystkie pola: samo „Завантажити товари з xml” nie wystarczy, jeśli zostało „Оновлювати стоки і ціни окремо” (aktualizuj stany i ceny osobno). Feedu w HUB nie da się usunąć.

    Co i jak często się aktualizuje

    CoJak często
    ceny i stanyorientacyjnie raz na godzinę; w trybie „Оновлювати стоки і ціни окремо” (aktualizuj stany i ceny osobno) — co 30 minut
    pełne przetworzenie feedu z nowościami i treściąwe wspólnej kolejce, orientacyjnie do 6 godzin; plik bez zmiany daty w nagłówku — raz na 4 godziny
    nazwa, opis, zdjęcia, atrybutytylko z włączonym „Оновлювати контент” (aktualizuj treść) i tylko dla produktów wczytanych tym feedem

    Datę w nagłówku szablon Elbuz wstawia przy każdym przebiegu, więc HUB widzi, że plik jest nowy. Harmonogramy są dwa: w Elbuz feed jest przebudowywany, w HUB — pobierany. Przebudowywanie pliku częściej niż co 30 minut nie ma sensu. Jak ustawić harmonogram — „Uruchamianie ręczne i według harmonogramu”.

    Scenariusze

    Na Kasta — tylko kilka kategorii

    Na zakładce „Ograniczenie eksportu (filtr)” szablonu ustaw warunek według kategorii lub producenta. Produkty, które wypadły z pliku, schodzą ze sprzedaży tylko wtedy, gdy w HUB zaznaczono „Зняти з продажу товари, які відсутні в фіді”; w przeciwnym razie zostają z ostatnim stanem.

    Chwilowo niedostępny produkt nie powinien znikać

    Zostaw produkt w filtrze i ustaw status braku. Do feedu pójdzie ze stanem 0: karta na Kasta zostanie, ale kupić produktu się nie da. Przywrócisz status — Kasta pobierze dostępność przy następnej aktualizacji cen i stanów.

    Odzież w kilku kolorach i rozmiarach

    Każdy kolor i rozmiar to osobna karta w Elbuz z takim samym kodem SKU, producentem i kategorią oraz atrybutami „Колір” i „Розмір”. W feedzie to osobne offer, a na Kasta — jedna karta z wyborem koloru i rozmiaru.

    Co zrobić, gdy Kasta nie przyjmuje produktów

    Co widziszDlaczego tak jestCo zrobić
    „Помилка завантаження або валідаціі xml структури фіду” (błąd wczytywania lub walidacji struktury XML feedu) struktura pliku nie zgadza się z oczekiwaną — najczęściej zmieniono szablon XML przywróć szablon typowy: utwórz nowy szablon „Kasta (XML)” i porównaj
    HUB nie może pobrać pliku plik leży na Twoim serwerze (szablon kopiuje go tam przez FTP), a zabezpieczenia blokują Kasta. Pliku pod linkiem Elbuz to nie dotyczy dodaj do białej listy IP 3.78.142.138, 18.196.145.164, 3.121.252.59, 52.59.104.195, 3.126.0.144
    Produkty nie są dopasowane do kategorii Kasta kategoria nie ma kodu Rozetka — rz_id nie trafia do feedu uzupełnij kod Rozetka w kategorii albo dopasuj ją w pliku mapowania HUB („Категорія+”)
    „Відсутній бренд” (brak marki) marki nie ma w słowniku Kasta wyślij zapytanie na moderator@kasta.ua
    Warianty nie połączyły się w jedną kartę różny kod SKU, producent lub kategoria albo kolor wpisany w nazwie ujednolij kod SKU i producenta, kolor i rozmiar przekaż atrybutami (jak)
    Nazwa lub zdjęcia na Kasta się nie aktualizują w ustawieniach feedu HUB wyłączono „Оновлювати контент” albo produkt nie został utworzony tym feedem włącz „Оновлювати контент”; produkty utworzone inaczej aktualizuj tym samym sposobem
    Produkt zdublował się po zmianie kodu SKU lub koloru Kasta traktuje zmianę tych pól jak nowy produkt usuń zbędną pozycję w HUB (co się nie aktualizuje)

    Pełna lista błędów i słów zakazanych — w instrukcji Kasta dotyczącej wczytywania treści w formacie XML, w panelu HUB.

    Najczęstsze pytania

    Czy szablon Rozetka nada się dla Kasta?

    Kasta przyjmuje feed o strukturze Rozetka, ale dla nowych szablonów wybieraj typ „Kasta (XML)”: ma liczbowe offer id, do 20 zdjęć i price_old w każdym produkcie.

    Dlaczego nie przez API Kasta?

    Kasta aktualizuje z feedu i nowości, i ceny ze stanami, dlatego Elbuz przekazuje katalog plikiem. Przez połączenie API Elbuz pobiera tylko zamówienia — zamówienia z Kasta.

    Mam od dawna szablon Kasta — czy się zmienił?

    Nie. Nowy wzorzec działa tylko dla szablonów utworzonych teraz; istniejących szablonów program nie rusza.

    Jak szybko nowa cena pojawi się na Kasta?

    Po następnym eksporcie w Elbuz i następnej aktualizacji w HUB — orientacyjnie do godziny, w trybie „Оновлювати стоки і ціни окремо” (aktualizuj stany i ceny osobno) — do 30 minut.

    Czy Elbuz przekazuje wymiary i wagę?

    Tylko jeśli dodasz atrybuty „Габарити в упаковці, см” (wymiary w opakowaniu, cm) i „Вага в упаковці, кг” (waga w opakowaniu, kg): osobnych tagów dla nich w szablonie nie ma.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Eksport danych
    Utwórz
    „Dodaj” → typ „Kasta (XML)”
    Uprawnienia
    okna „Eksport” i „Szczegółowa konfiguracja szablonu eksportu” w „Uprawnieniach grup”
    Przygotuj
    kody kategorii Rozetka, kod SKU i producenta, „Колір” i „Розмір” dla odzieży

    Ogólna mechanika szablonów — filtr, plik pod linkiem, harmonogram, dziennik — w artykule o eksporcie produktów.

    Formularz szablonu eksportu Kasta (XML) z zakładką wyboru danych i polami składu danych
    1Nazwa i typ szablonu
    2Pola składu danych
    1. Nazwa i typ szablonu — nagłówek pokazuje Kasta (XML) i ID szablonu.
    2. Pola składu danych — dla feedu Kasta zaznaczone są „Kategorie” i „Produkty”.

    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