Elbuz tworzy z katalogu feed w formacie XML — plik XML, który przyjmują marketplace’y, porównywarki cen, systemy CMS i programy księgowe — i aktualizuje go pod stałym linkiem. Zawartość pliku określasz tekstem szablonu.
Kiedy to się przyda:
- Serwis prosi o „feed XML” lub „cennik w formacie XML”, a gotowego typu dla niego nie ma — uniwersalny szablon dopasujesz do jego wymagań, edytując tekst.
- Plik jest potrzebny partnerowi lub Twojej stronie — feed odświeża się według harmonogramu.
- Miejsce docelowe chce innych nazw węzłów — zmieniasz wiersz szablonu.
- Boisz się zepsuć feed edycją — eksport próbny pokaże XML i błędy na jednym produkcie.
Od czego zacząć: utwórz szablon „XML” w oknie „Eksport danych”.
Co potrafi feed XML
- Gotowy feed od razu — nowy szablon powstaje z nagłówkiem, walutą, kategoriami i produktami.
- Węzły pod dowolne miejsce docelowe — dopisujesz, zmieniasz nazwy lub usuwasz wiersze szablonu, a wartości wstawiają makra.
- Stały identyfikator — odbiorca aktualizuje istniejące pozycje, a warianty łączy w jeden produkt.
- Własne słowa dla dostępności — kilkanaście wewnętrznych statusów sprowadzasz do tego, co rozumie odbiorca.
- Feed częściowy — do pliku trafiają tylko produkty zmienione od poprzedniego eksportu.
- Eksport próbny — na jednym produkcie, nierozpoznane makra i błędy znaczników przed właściwym uruchomieniem.
Osobne marketplace’y i formaty — Rozetka, Prom.ua XML i XLSX, Epicentr, EVA.UA, Kasta, Google Merchant, feed dla OpenAI; kategorie i parametry marketplace’ów — dopasowanie kategorii.
Jak utworzyć szablon XML
W oknie „Eksport danych” kliknij „Dodaj”, na liście typów otwórz grupę „Feed XML” i wybierz „XML”. To uniwersalny feed; pozostałe pozycje grupy są ustawione pod konkretne marketplace’y.
Jeden szablon — jeden plik. Feedy dla różnych serwisów z różnym zestawem danych rób jako osobne szablony, zamiast przestawiać jeden.
Kiedy wybrać gotowy typ zamiast uniwersalnego
Dla znanego marketplace’u zwykle jest już osobny typ: uwzględnia obowiązkowe węzły, limity i specyfikę identyfikatorów. Uniwersalny wybierz, gdy gotowego typu nie ma: własna strona, wymiana z partnerem, serwis analityczny, niszowa porównywarka. Poszukaj nazwy serwisu na liście typów; jeśli jej nie ma — wybierz „XML”.
Dla porównywarek cen w UE Skroutz, Heureka i Ceneo w tej grupie są gotowe typy z tagami i słowami dostępności kanału; idealo, billiger.de, Kelkoo i inne mają swoje typy w innych grupach. Więcej: jak wyeksportować produkty do porównywarek cen w UE.
Jak przekazać feed do Kasta
Utwórz szablon typu „Kasta (XML)”. Szablon jest zbudowany według instrukcji Kasta: offer id — numer produktu, w kategorii — rz_id z kodem Rozetka, jeśli jest wypełniony, w produkcie — stock_quantity i price_old, do 20 zdjęć. Szablonów Kasta utworzonych wcześniej program nie zmienia. Więcej: eksport produktów do Kasta.
Jak przekazać feed do E-Katalog
Utwórz szablon: „Dodaj” → „Feed XML” → E-Katalog. Szablon jest zbudowany według wymagań E-Katalog wobec cennika: obowiązkowe vendor, name, price, url, categoryId, a do tego zdjęcia, indeks, EAN i gwarancja. Opis idzie czystym tekstem, bez HTML.
Dostępność jest przekazywana słowami true, false i request, przy czym ostatnie oznacza „na zamówienie”. Gwarancja pochodzi z karty produktu: sama liczba, np. 24, w pliku staje się „24 мес” (24 miesiące), bo E-Katalog czyta liczbę bez jednostki jako dni. Tekst w rodzaju „1 rok” idzie bez zmian.
Link z kolumny „Plik” wklej w panelu klienta E-Katalog: robot sam pobiera cennik według harmonogramu, który ustawia opiekun. Sklep podłącza się na podstawie zgłoszenia na account.ek.ua, a opłata jest za przejścia kupujących. W nazwie produktu zostaw tylko markę i model: parametry w nazwie E-Katalog uznaje za błąd.
Każdy serwis dodaje do formatu własne warunki: obowiązkowe węzły, długość nazwy, limit zdjęć, zestaw walut, wymagania wobec kategorii. Otwórz wymagania serwisu, któremu przekazujesz feed, i dopasuj do nich szablon. Elbuz tych wymagań nie sprawdza — o naruszeniach poinformuje sam serwis.
Co trafia do pliku
Nowy szablon od razu powstaje z gotowym feedem — nie trzeba go pisać od zera. Plik ma trzy części:
| Część pliku | Co zawiera |
|---|---|
| Nagłówek | Węzeł główny yml_catalog z datą eksportu, dalej shop: nazwa sklepu, firma, adres strony, dane techniczne o platformie i e-mail. Tu jest też blok currencies — waluta feedu i jej kurs |
| Kategorie | Blok categories, a w nim wiersz category dla każdej kategorii: własny identyfikator, identyfikator kategorii nadrzędnej i nazwa. W ten sposób plik odtwarza Twoje drzewo |
| Oferty | Blok offers, a w nim offer dla każdego produktu: link, cena, waluta, kategoria, zdjęcia, nazwa, producent, indeks, opis i parametry |
Wiersz kategorii i wiersz produktu powiela sam program: w szablonie są opisane raz, a do pliku trafiają tyle razy, ile masz kategorii i produktów. O tym, które produkty trafią do pliku, decydują warunki filtrowania — są takie same dla wszystkich formatów: dlaczego produkt nie trafił do pliku.
Kategorie, zdjęcia, parametry
| Ustawienie | Co robi |
|---|---|
| Kategorie (pole wyboru) | Czy dołączać do pliku blok kategorii. Niektóre serwisy przyjmują feed bez drzewa — wtedy można odznaczyć to pole |
| Znak separatora kategorii | Czym rozdzielać poziomy w pełnej ścieżce kategorii, gdy idzie ona jednym wierszem |
| Zdjęcia (pole wyboru) | Czy eksportować zdjęcia |
| Link do zdjęcia produktu | Adres, z którego odbiorca będzie pobierał zdjęcia: domena i folder. Zdjęcia są przekazywane linkami, a nie plikami |
| Maksymalna liczba zdjęć | Limit na produkt — większość marketplace’ów ma własny limit i nadmiarowe zdjęcia albo odrzuca, albo odrzuca cały feed |
| Atrybuty, Opcje (pola wyboru) | Czy eksportować parametry i opcje produktu |
Jeśli w słowniku jest zdefiniowany , do pliku trafia jeden parametr z nazwą atrybutu głównego, a wartości ze wszystkich powiązanych są w nim zbierane.
Produkt z wypełnionymi „Temperatura” i „Temperatura barwowa” przekaże jeden parametr „Temperatura barwowa” z obiema wartościami. Osobnego pola wyboru do tego nie ma: reguła działa we wszystkich szablonach XML.
Czyj stan i jaki język
Sekcja „Ograniczenia eksportu” określa, z którego sklepu, magazynu i wersji językowej pochodzą liczby i teksty dla produktów, które przeszły już filtrowanie. Tu jest też pole „Tylko dostępne w tym sklepie”. Jak te pola zawężają wynik — w tabeli warunków filtrowania.
Jak działa „Eksportować tylko nowe dane”
Pole w sekcji „Co eksportować” umieszcza w pliku tylko produkty zmienione od poprzedniego eksportu. Znacznik eksportu jest zapisany w produkcie, a nie w szablonie: na koniec udanego przebiegu program ustawia „Wyeksportowano” produktom, które trafiły do pliku, a każda edycja produktu — w karcie lub w tabeli katalogu — go zdejmuje.
- Nie było zmian — plik się nie zaktualizuje. W dzienniku pojawi się „Eksport danych NIE został zakończony: plik nie został utworzony”, data ostatniego eksportu się nie zmieni, a pod linkiem zostanie poprzedni plik. Wyjątek — tryb Prom (zob. niżej).
- Znacznik jest wspólny dla wszystkich szablonów. Jeśli pole jest zaznaczone w dwóch szablonach, zmiany zabierze ten, którego przebieg ruszył pierwszy; drugiemu nic nie zostanie.
- Odbiorca musi rozumieć pliki częściowe. Serwis, który traktuje feed jako pełną listę, uzna, że pozostałych produktów już nie masz (co się stanie z produktem, który zniknął z feedu).
Jak zmienić zawartość feedu: szablon XML i makra
Zawartość pliku określasz sam, w polu „Szablon XML”. To jeden ciągły dokument — taki, jaki ma wyjść feed — a zamiast wartości są w nim makra w nawiasach klamrowych: {name}, {price}, {uuid} i tak dalej. Podczas eksportu każde makro zostaje zastąpione wartością konkretnego produktu.
Potrzebujesz dodatkowego węzła — dopisz wiersz; innej nazwy — zmień ją; zbędny węzeł — usuń.
Wartość obliczysz formułami w podwójnych nawiasach kwadratowych: na przykład cena sugerowana, jeśli jest wypełniona, a w przeciwnym razie zwykła. Składnia i przykłady — w sekcji cena w eksporcie.
Naciśnij Ctrl+Space lub wpisz { — pojawi się podpowiedź. Obok pola jest lista makr, pogrupowana według znaczenia. Kliknięcie makra wstawia je w miejscu kursora.
Nierozpoznane makra podczas eksportu po prostu znikają z wyniku — bez ostrzeżenia i bez wpisu w dzienniku. Literówka w nazwie da pusty węzeł w feedzie, a zauważysz to dopiero po stronie serwisu. Przed pierwszym właściwym uruchomieniem zrób eksport próbny — pokazuje makra, których program nie rozpoznał.
Podszablony: zdjęcia i parametry
Produkt ma więcej niż jedno zdjęcie i więcej niż jeden parametr, dlatego są dla nich podszablony — wiersze powtarzane tyle razy, ile produkt ma zdjęć lub atrybutów. W szablonie głównym w ich miejscu stoją makra {image_list} i {attribute_list}, a same wiersze ustawia się w karcie „Podszablony”. Wiersz podszablonu — do 255 znaków.
Zdjęcia w węźle picture czy image — to zmiana jednego wiersza podszablonu.
Gdy zdjęcie główne ma trafić do osobnego tagu, a pozostałe — do innego, zamiast {image_list} są dwa makra: {image_main_url} — link do pierwszego zdjęcia bez otoczki, {image_list_additional} — pozostałe zdjęcia według wiersza podszablonu. Przykład: <image>{image_main_url}</image>, a dalej {image_list_additional} z podszablonem <additionalimage>{Image: URL}</additionalimage>. Oba makra włączają eksport zdjęć tak samo jak {image_list}.
Co ma pierwszeństwo — pole wyboru czy makro
To samo pole ustawia się w dwóch miejscach: polem wyboru w karcie „Co eksportować” i wierszem w szablonie. Gdy sobie przeczą, obowiązują takie reguły:
| Co | Co wygrywa | Efekt |
|---|---|---|
| Zdjęcia i parametry | Makro | {image_list} w wierszu produktu przenosi zdjęcia nawet przy odznaczonym polu „Zdjęcia”; {attribute_list} tak samo ignoruje odznaczone „Atrybuty”. Aby zdjęcia nie trafiły do feedu, usuń makro |
| Kategorie | Pole wyboru | Odznaczone „Kategorie” — wierszy category w pliku nie będzie, zostanie pusta otoczka <categories></categories> |
| Produkty | Pole wyboru | Odznaczone „Produkty” — w pliku jest nagłówek, kategorie i ani jednego offer. Przebieg kończy się normalnie, a ten pusty plik trafi pod stały link |
| Pusty podszablon | Program | Bez „Podszablonu zdjęcia” do pliku trafi <picture>adres</picture>, bez „Podszablonu atrybutu” — <param name="Nazwa" unit="jednostka">Wartość</param>. Program wstawia wtedy własny wiersz bez Twoich węzłów |
Wewnątrz wiersza produktu podstawianie idzie w stałej kolejności: najpierw formuły w podwójnych nawiasach kwadratowych, potem pojedyncze parametry {attribute_61}, potem pola produktu, potem listy {image_list}, {video_list}, {attribute_list}. Wszystko, co zostało po tym w nawiasach klamrowych, jest wycinane z pliku.
Program rozpoznaje znany marketplace nie tylko po typie, ale też po tekście: łacińskie „rozetka” lub „prom” w nazwie szablonu albo w podszablonie atrybutu, a także węzły selling_type, portal_category_id, portal_id w szablonie. Wtedy reguły zmieniają się bez ostrzeżenia:
- tryb Rozetka — zdjęcia są przycinane do 15 na produkt, wartości parametrów — do 255 znaków, z pól tekstowych wycinane są linki i obrazki;
- tryb Prom — zdjęcia są przycinane do 10, a główna karta produktu z wariantami nie trafia do feedu, idą tylko warianty. Nie dostaje ona znacznika „Wyeksportowano”, więc przy „tylko nowych danych” przebieg bez zmian umieści pod linkiem plik bez żadnego
offerzamiast „plik nie został utworzony”.
Nie nazywaj uniwersalnego szablonu „jak w Rozetka” ani „w stylu Prom”: wystarczy jedno łacińskie słowo w nazwie.
Jak uniknąć duplikatów po stronie odbiorcy
W ofercie offer identyfikatorem domyślnie jest produktu — własny, niezmienny klucz karty w Elbuz. Dopóki identyfikator jest stały, serwis aktualizuje istniejące pozycje; jeśli zmienia się między eksportami, po drugiej stronie mnożą się duplikaty.
Ten sam UUID czyta też import: gdy feed z Elbuz jest wczytywany z powrotem — u Ciebie lub u partnera — produkty są po nim rozpoznawane i się nie dublują. Zmieniaj identyfikator w szablonie tylko wtedy, gdy odbiorca wprost wymaga innego (np. kodu liczbowego).
Warianty jednego produktu (kolory, rozmiary) dostają w atrybucie grupowania wspólny identyfikator karty głównej, a odbiorca łączy je w jeden produkt. Jeśli serwis nie obsługuje grupowania, usuń ten atrybut z szablonu.
Co ponowny przebieg robi z Twoimi zmianami
Eksport niczego nie zapisuje w kartach produktów: ceny, nazwy, opisu, zdjęć w Elbuz kolejny przebieg nie rusza. W bazie zmienia tylko znacznik „Wyeksportowano” w produktach i wiersz szablonu z linkiem, rozmiarem i datą pliku.
Co stanie się z danymi zmienionymi w panelu serwisu, decyduje serwis. Po stronie Elbuz masz jedną dźwignię — zestaw węzłów w szablonie: jeśli w pliku nie ma węzła <name>, serwis nie ma skąd wziąć nowej nazwy i Twoja zostanie. Prowadzisz pole ręcznie po stronie serwisu — usuń odpowiedni wiersz z szablonu (scenariusz).
Jak przekazać dostępność i wycofać produkt ze sprzedaży
Dostępność w ofercie to atrybut available, który wstawia makro {xml_stock_status}. W karcie „Powiązane ustawienia” przycisk „Ustawienia aktualizacji według dostępności produktu” otwiera tabelę, w której dla każdego Twojego statusu ustawiasz, co trafi do feedu (kolumna „Nazwa na stronie (w pliku)”) i jaką ilość pokazywać. Domyślnie „Dostępny” daje true, a pozostałe — false; potrzebujesz własnych słów — wpisz je tam. Wpisana wartość, w tym 0, trafia do pliku, dopóki w wierszu jest zaznaczona „Aktywność ustawienia”; pusta komórka przywraca wbudowaną regułę.
1
Kolumna „Aktywność ustawienia”2
Kolumna „Nazwa na stronie (w pliku)”- Aktywność ustawienia — czy status dostępności jest używany przy tworzeniu pliku.
- Nazwa na stronie (w pliku) — tekst, który oznacza ten status w pliku eksportu.
Wiersz tabeli działa tylko, dopóki jest w nim zaznaczona „Aktywność ustawienia”. Bez zaznaczenia program wraca do wbudowanej reguły: „Dostępny” daje true, pozostałe — false, a ilość zależy od aktywności produktu: 1 000 dla aktywnego, 0 dla wyłączonego. Jeśli „ustawienie się zapisało, a w pliku jest stara wartość” — sprawdź najpierw to pole.
Ilość z tabeli przenosi do pliku makro {xml_stock_quantity}. Makro {stock_quantity} przekazuje rzeczywisty stan produktu, a dla produktu bez stanu — ilość z tabeli; status, który ma w tabeli 0, daje 0 nawet przy dostępnym stanie. Przydaje się na marketplace’ach, gdzie produkt jest dostępny tylko wtedy, gdy ilość jest większa od zera, — jak EVA.UA.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Co się stanie z produktem, który zniknął z feedu
W XML nie ma znacznika „produkt usunięty”. Plik to pełna lista tego, co teraz sprzedajesz, a pozycja, której w nim już nie ma, nie dostaje żadnego polecenia. Jeden serwis zdejmuje ją z publikacji, inny zostawia w takim stanie, w jakim pobrał ją ostatnio; po stronie Elbuz tego nie widać.
Kontrolowany sposób, by powiedzieć „już nie sprzedajemy”, jest jeden: zostawić produkt w feedzie ze znacznikiem braku przez tabelę statusów dostępności (scenariusz). Wykluczaj produkt z filtrowania, gdy w ogóle nie jest Ci już potrzebny na tym marketplace, a nie gdy skończył się w magazynie.
Jak sprawdzić feed przed właściwym uruchomieniem
Kliknij „Sprawdź” w nagłówku karty szablonu. Program wykona ten sam kod co pełny eksport, ale na jednym produkcie (numer można podać), zapisze wynik do osobnego pliku i go pokaże. Właściwy plik i link do niego pozostają nietknięte.
Sprawdzenie pokazuje:
- gotowy XML w takiej postaci, w jakiej zobaczy go odbiorca, — pierwsze 200 KB;
- listę nierozpoznanych makr;
- błędy znaczników z numerem wiersza i kolumny — wykrywa je prawdziwy parser XML, ten sam, którego używają odbiorcy;
- błędy w formułach — osobno „takiego pola nie ma” i osobno „składnia formuły”;
- numer produktu, na którym przeprowadzono sprawdzenie.
Jeśli wskazany produkt nie spełnia warunków szablonu, program tak napisze: „Produkt #… nie trafił do eksportu: nie spełnia warunków tego szablonu”.
Harmonogram i link do pliku
Gotowy plik Elbuz umieszcza w Twoim magazynie plików i daje do niego stały link — ten link przekazujesz serwisowi. Według harmonogramu plik jest tworzony od nowa, a link pozostaje ten sam. Harmonogram i ustawiasz przyciskami „Ustawienia harmonogramu” i „Ustawienia FTP” w karcie „Powiązane ustawienia”.
Podsumowanie przed startem, reguły stop, ręczne uruchomienie, harmonogram, FTP i dziennik są takie same dla wszystkich formatów: podsumowanie, reguły stop, uruchomienie ręczne i według harmonogramu, gdzie trafia plik, dziennik przebiegu. Eksport do pliku nie jest płatny: za przebiegi nic nie jest pobierane z salda.
Co jest pod linkiem, gdy przebieg nie dobiegł końca
Plik za każdym razem powstaje od zera, a publikowany jest jednym, ostatnim krokiem: nowy najpierw trafia do magazynu plików, a dopiero potem usuwane są pozostałe pliki szablonu. Dlatego po zatrzymaniu, zerwaniu połączenia, awarii procesu czy nieudanym przesłaniu:
- pod stałym linkiem zostaje poprzedni plik, a niedokończony do odbiorcy nie trafi;
- data ostatniego eksportu się nie aktualizuje, w dzienniku — „Eksport danych NIE został zakończony: plik nie został utworzony”;
- znaczniki „Wyeksportowano” nie są ustawiane, więc następny przebieg z „tylko nowymi danymi” niczego nie zgubi;
- można od razu powtórzyć — nic się nie zdubluje.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Przerwanie przebiegu z harmonogramu trzyma blokadę: dopóki program uważa, że eksport nadal trwa, kolejne zadania są pomijane z wpisem „Anulowano eksport według harmonogramu, powód: eksportowany jest inny szablon (konflikt przetwarzania danych)”. Blokadę martwego przebiegu strażnik zdejmuje sam — nie wcześniej niż po godzinie od startu i pół godzinie ciszy w dzienniku.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
W nazwie pliku działają makra {DATE}, {DATETIME} i {TIME}. Ale wtedy nowy plik za każdym razem dostaje nową nazwę, a po przesłaniu program usuwa z magazynu pozostałe pliki szablonu: adres przekazany wczoraj serwisowi dziś się nie aktualizuje albo nie działa. Datę w nazwie stosuj tylko wtedy, gdy plik jest pobierany ręcznie.
„Końcówka” ?uuid=384512 w linku za każdym razem jest inna; serwisowi możesz podać link bez niej.
Wyłączyć szablon czy usunąć
Wyłączony szablon (przełącznik „Aktywny” / „Wyłączony” w nagłówku karty) nie jest wykonywany według harmonogramu i nie bierze udziału w „Eksportuj wszystkie szablony” — bez śladu, bez wpisu w dzienniku. Ręcznie można go uruchomić. Plik w magazynie zostaje, a serwis pobiera ostatni utworzony feed: wyłączenie nie zdejmuje produktów z marketplace’u, tylko zamraża plik.
Usunięcie kasuje ustawienia: tekst szablonu, podszablony, tabelę statusów dostępności, FTP, filtrowanie i harmonogram. Plik w magazynie nie jest usuwany także w tym przypadku. Aby serwis przestał otrzymywać Twoje dane, usuń link po jego stronie.
Jeśli błędny feed został już pobrany
- Popraw szablon i kliknij „Sprawdź” — upewnij się, że druga próba nie będzie taka sama jak pierwsza.
- Uruchom eksport. Plik pod stałym linkiem zostaje zastąpiony w całości.
- Poczekaj, aż serwis ponownie wczyta plik, albo kliknij w jego panelu „zaktualizuj z feedu”, jeśli jest taki przycisk. Z poziomu Elbuz nie da się tego przyspieszyć.
- Jeśli błędny przebieg szedł z „tylko nowymi danymi”, odznacz pole i przekaż jeden pełny feed — inaczej poprawki dostaną tylko produkty zmienione po błędzie.
Powrót do wczorajszego pliku nie jest możliwy: nowy zastępuje poprzedni, a w folderze tymczasowym są przechowywane tylko trzy ostatnie i tylko do następnego przebiegu. Historii zmian szablonu też nie ma. Przed poważną przeróbką skopiuj tekst szablonu do siebie.
Scenariusze
Nazwy i opisy na marketplace prowadzisz ręcznie
Zadanie: w panelu serwisu samodzielnie przepisano nazwy produktów i nie chcesz, aby następny feed je nadpisał.
Co zrobić: w polu „Szablon XML” usuń z wiersza produktu węzeł <name> (tak samo <description>, jeśli opisy też tam prowadzisz).
Efekt: w pliku tych węzłów nie będzie, więc serwis nie ma skąd wziąć nowej nazwy. Cena, dostępność i pozostałe węzły trafiają do pliku jak dotąd. Nazwy w kartach Elbuz się nie zmienią — eksport nie zapisuje w kartach produktów.
Produkt się skończył, ale ma zostać na marketplace
Zadanie: pozycja jest chwilowo niedostępna i na marketplace ma być widoczna jako „niedostępna”, a nie znikać.
Co zrobić: zostaw produkt w filtrowaniu szablonu. W karcie „Powiązane ustawienia” otwórz „Ustawienia aktualizacji według dostępności produktu”, w wierszu swojego statusu zaznacz „Aktywność ustawienia” i, jeśli odbiorca oczekuje czegoś innego niż false, wpisz jego słowo w „Nazwa na stronie (w pliku)”.
Efekt: produkt trafia do feedu, a {xml_stock_status} wstawia wartość z tego wiersza. Produkt wykluczony z filtrowania serwis po prostu przestanie widzieć, bez polecenia „wycofano ze sprzedaży”.
Duży katalog, odbiorca rozumie pliki częściowe
Zadanie: przekazywać serwisowi według harmonogramu tylko to, co się zmieniło, a nie za każdym razem cały katalog.
Co zrobić: włącz „Eksportować tylko nowe dane” w jednym szablonie i ustaw częstotliwość przyciskiem „Ustawienia harmonogramu”.
Efekt: do pliku trafiają produkty bez znacznika „Wyeksportowano”. Jeśli zmian nie było, nowy plik nie powstanie, a pod linkiem zostanie poprzedni (jak działa to pole).
Nie dopuścić spadku dostępności na marketplace
Zadanie: jeśli w katalogu bazowym nagle „zniknęła” dostępność, feed nie może trafić na marketplace.
Co zrobić: w podsumowaniu przed startem kliknij „Ustaw progi” i dla reguły spadku dostępności wybierz „Zatrzymaj eksport”. Próg domyślny — 30%; dla spadku liczby produktów — 50%.
Efekt: ani ręczny przebieg, ani przebieg z harmonogramu nie wystartuje, w dzienniku — „Eksport zatrzymany przez regułę stop: …”, a pod linkiem zostaje poprzedni plik. Dopóki szablon ani razu nie wyeksportował się z powodzeniem, reguły spadku milczą — nie ma z czym porównać (reguły stop).
Serwis nie przyjmuje zdjęć w feedzie
Zadanie: odbiorca odrzuca plik z węzłami zdjęć albo bierze obrazy z innego źródła.
Co zrobić: usuń makro {image_list} z wiersza produktu w „Szablon XML”.
Efekt: węzłów zdjęć w pliku nie będzie. Samo odznaczenie pola „Zdjęcia” tu nie wystarczy (co ma pierwszeństwo — pole wyboru czy makro).
Co zrobić, gdy feed nie wygląda tak, jak trzeba
Tutaj są przypadki typowe dla szablonu XML. Pusty wynik filtrowania, wybrany sklep, reguły stop, konflikt harmonogramu i FTP — w ogólnej tabeli problemów.
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Eksport danych NIE został zakończony: plik nie został utworzony”, choć błędów nie ma | Włączono „tylko nowe dane”, a od poprzedniego przebiegu żaden produkt się nie zmienił | Tak ma być: pod linkiem jest poprzedni plik. Potrzebujesz pełnego feedu — odznacz pole (jak działa to pole) |
| Feed przestał się aktualizować, w dzienniku z harmonogramu pusto | Szablon jest wyłączony: harmonogram pomija go bez śladu | Przełącz stan w nagłówku karty na „Aktywny” (wyłączyć czy usunąć) |
| „Makra nie zostały rozpoznane i zostaną usunięte z pliku: …” albo serwis pisze, że pole jest puste | Literówka w nazwie makra: takiego pola nie ma | Wstawiaj makra z podpowiedzi (Ctrl+Space) lub z listy obok pola, a nie ręcznie |
| „W szablonie nie znaleziono powtarzanego węzła produktu… Zmiany NIE zostały zapisane” | Węzeł produktu ma zmienioną nazwę lub jest uszkodzony i program nie wie, który wiersz powielać | Przywróć tag albo wpisz jego nową nazwę w „Zaawansowane” → „Tag wiersza produktu” |
| Zdjęcia lub parametry są w pliku, choć pole odznaczono | Makro w szablonie wygrywa z polem wyboru | Usuń {image_list} lub {attribute_list} z wiersza produktu (co ma pierwszeństwo) |
W pliku jest nagłówek i kategorie, ale ani jednego offer, w dzienniku zwykłe zakończenie |
Odznaczono „Produkty” albo w nazwie szablonu jest „prom”, a wynik filtrowania to tylko karty główne z wariantami | Zaznacz „Produkty”; usuń „rozetka”/„prom” z nazwy szablonu (tryb marketplace’u) |
| Po stronie serwisu po każdym eksporcie pojawiają się duplikaty | Identyfikator oferty zmienia się między przebiegami | Przywróć w offer stały {uuid} (identyfikator produktu) |
Najczęstsze pytania
Czym jest feed XML i czym różni się od zwykłego XML?
Feed XML to XML o z góry znanej strukturze dla katalogów produktów: węzeł główny yml_catalog, w środku sklep, bloki walut, kategorii i ofert. Odbiorcy rozumieją taki plik bez dodatkowego opisu.
Czy trzeba edytować szablon, jeśli standardowy feed mi odpowiada?
Nie. Nowy szablon powstaje już z działającym feedem. Edytuj go tylko wtedy, gdy odbiorca prosi o dodatkowe węzły lub inne nazwy.
Marketplace’u nie ma na liście typów (np. MAUDAU). Jak tam eksportować?
Jeśli przyjmuje feed XML pod linkiem — utwórz „XML” i dopasuj tagi do jego dokumentacji. Jeśli Excel lub CSV — typ „Cennik (XLSX, CSV)”. Bezpośredniego połączenia przez z takim marketplace’em nie ma.
Czy Elbuz sprawdza, czy feed spełnia wymagania serwisu?
Nie. Eksport próbny sprawdza tylko poprawność XML i makra. Obowiązkowe węzły, długość nazwy, waluty i limit zdjęć sprawdza serwis — o naruszeniach dowiesz się od niego.
Czy w Elbuz widać, że serwis pobrał plik?
Nie. Dziennik kończy się na tym, że plik trafił do magazynu. Kiedy serwis go przeczytał i co z nim zrobił, sprawdzisz w panelu serwisu.
Przebieg się przerwał — co jest teraz pod linkiem?
Poprzedni plik: nowy jest publikowany jednym, ostatnim krokiem. Przebieg można od razu powtórzyć (co jest pod linkiem).
Jeśli wyłączę szablon, feed zniknie z serwisu?
Nie. Plik zostaje w magazynie, a serwis pobiera ostatni utworzony feed — po prostu nie jest on już aktualizowany. Usunięcie szablonu też nie usuwa pliku.
Ile zdjęć trafia do feedu i skąd biorą się linki?
Nie więcej, niż ustawiono w „Maksymalna liczba zdjęć”. Adres powstaje z pola „Link do zdjęcia produktu”; same pliki odbiorca pobiera z linków.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Eksport danych
- Uprawnienia
- okno „Eksport danych”; karta szablonu — „Szczegółowa konfiguracja szablonu eksportu”
- Przygotuj
- wymagania odbiorcy wobec feedu: obowiązkowe węzły, limit zdjęć, waluta
1
Tekst szablonu z makrami- Tekst szablonu — początek pliku (yml_catalog, shop) i makra w nawiasach klamrowych, zastępowane podczas eksportu prawdziwymi danymi.
Powiązane tematy
- Jeśli produkt jest w katalogu, ale nie trafił do feedu — Eksport produktów: dlaczego produkt nie trafił do pliku.
- Jeśli feed jest potrzebny dla Google Merchant, Facebooka lub TikToka — Feed Google Merchant.
- Jeśli odbiorcą jest Rozetka, jest dla niej gotowy typ — Eksport do Rozetka.
- Jeśli odbiorcą jest porównywarka cen w UE (Skroutz, Heureka, Ceneo, idealo) — Porównywarki cen w UE.
- Jeśli trzeba wczytać cudzy XML do swojego katalogu — Import katalogu z XML.
