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
- Gotowa struktura feedu — tagi z instrukcji Kasta wypełniają się z karty produktu.
- Kody kategorii Rozetka — w
rz_id, żeby Kasta dopasowała kategorie sama. - Stan i stara cena — zawsze w feedzie, żeby produkt był w sprzedaży.
- Stały link — HUB pobiera plik sam.
- Wybór asortymentu — tylko potrzebne kategorie lub producenci.
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
- Przygotuj karty. Ukraińska nazwa i opis, producent, kod SKU, zdjęcia; dla odzieży i obuwia — atrybuty „Колір” (kolor) i „Розмір” (rozmiar) (dlaczego).
- Dopasuj kategorie do Rozetka, jeśli jeszcze tego nie zrobiono: ich kody trafią do feedu (dopasowanie kategorii).
- 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
nameicompanynagłówka zamień nazwą sklepu. - Wygeneruj plik przyciskiem „Eksportuj” i otwórz go pod linkiem.
- Dodaj link w Kasta HUB i włącz potrzebne aktualizacje (jak).
- Ustaw harmonogram szablonu w Elbuz, żeby plik był przebudowywany ze świeżymi cenami i stanami.
Co trafia do feedu
| Tag feedu Kasta | Skąd pochodzi w Elbuz |
|---|---|
offer id | numer produktu w Elbuz — cyfry, bez cyrylicy i spacji, jak wymaga Kasta |
category, atrybut rz_id | numer i nazwa Twojej kategorii; rz_id — kod kategorii Rozetka, tylko jeśli jest wypełniony w kategorii |
available | status dostępności: „dostępny” — true, pozostałe — false |
price | cena produktu |
price_old | większa ze starej ceny i ceny — tag jest zawsze |
stock_quantity | stan (jak jest liczony) |
picture | zdjęcia produktu, do 20 sztuk |
vendor | producent |
article | kod (SKU) producenta |
name_ua, description_ua | nazwa i pełny opis po ukraińsku |
name_ru, description | nazwa i opis po rosyjsku — tylko jeśli przy tworzeniu szablonu na koncie były włączone języki ukraiński i rosyjski |
param | atrybuty 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.
1
Wiersz offer2
Stan magazynowy3
Formuła starej ceny- Wiersz offer — każdy produkt staje się elementem offer ze swoim ID i statusem dostępności.
- Stan magazynowy — do feedu wpisywany jest symbol zastępczy stanu.
- 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 Elbuz | Co 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 braku | 0 |
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
- W panelu HUB: „Товари” → „Імпорт новинок” → zakładka „XML” → „Додати новий фід” (Produkty → Import nowości → XML → Dodaj nowy feed).
- 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_oldjest w nim zawsze.
- 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
| Co | Jak często |
|---|---|
| ceny i stany | orientacyjnie 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, atrybuty | tylko 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 widzisz | Dlaczego tak jest | Co 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.
1
Nazwa i typ szablonu2
Pola składu danych- Nazwa i typ szablonu — nagłówek pokazuje Kasta (XML) i ID szablonu.
- Pola składu danych — dla feedu Kasta zaznaczone są „Kategorie” i „Produkty”.
Powiązane tematy
- Jeśli trzeba pobierać zamówienia z Kasta — zamówienia z Kasta przez API.
- Jeśli kategorie nie mają jeszcze kodów Rozetka — dopasowanie kategorii do marketplace’ów.
- Jeśli równolegle sprzedajesz na Rozetka — eksport katalogu do Rozetka.
