↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak wyeksportować katalog do feedu XML dla dowolnego serwisu

    25 min czytaniaZaktualizowano

    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ęść plikuCo zawiera
    NagłówekWę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
    KategorieBlok 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
    OfertyBlok 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

    UstawienieCo 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 kategoriiCzym 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 produktuAdres, 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:

    CoCo wygrywaEfekt
    Zdjęcia i parametryMakro{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
    KategoriePole wyboruOdznaczone „Kategorie” — wierszy category w pliku nie będzie, zostanie pusta otoczka <categories></categories>
    ProduktyPole wyboruOdznaczone „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 podszablonProgramBez „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 offer zamiast „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łę.

    Okno ustawień aktualizacji według dostępności z tabelą statusów dostępności
    1Kolumna „Aktywność ustawienia”
    2Kolumna „Nazwa na stronie (w pliku)”
    1. Aktywność ustawienia — czy status dostępności jest używany przy tworzeniu pliku.
    2. 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.

    Pierwsze rozgałęzienie — pole „Aktywność ustawienia”: bez niego tabela dla tego statusu w ogóle nie działa i Twój tekst nie trafi do pliku
    NieTakTakNieProdukt z jego statusemdostępnościCzy dla tego statusu zaznaczono„Aktywność ustawienia”?available: true dla wbudowanegostatusu„Dostępny”, false dla pozostałychCzy wypełniono„Nazwa na stronie (w pliku)”?available — Twój tekstavailable: true, jeśli status oznaczadostępność,false dla braku, przedsprzedaży iinnych
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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.
    Trzy boczne gałęzie — gdy przebieg kończy się bez nowego pliku: pod linkiem zostaje wtedy poprzedni. Plik w magazynie zmienia się tylko na dolnej, prostej ścieżce
    TakNieTakNieNieTakStart: przycisk „Eksportuj”,harmonogram lub „Eksportujwszystkie szablony”Podsumowanie przed startemi sprawdzenie reguł stopZadziałała reguła w trybie„Zatrzymaj eksport”?„Eksport zatrzymany przez regułęstop”.Pod linkiem zostaje poprzedni plikPlik powstaje od zera:nagłówek, kategorie, produktyŻaden produkt nie przeszedł filtrówlub kliknięto „Stop”?„Eksport danych NIE zostałzakończony:plik nie został utworzony”.Pod linkiem zostaje poprzedni plikPlik trafia na FTP, jeśli FTP jestustawiony.Błąd FTP nie zatrzymuje przebieguNowy pliktrafił do magazynu plików?„Plik nie został przesłany domagazynu plików w chmurze”.„Eksport danych NIE zostałzakończony”.Pod linkiem zostaje poprzedni plikZ magazynu plików usuwane sąpozostałe pliki szablonuW szablonie zapisywane sąlink, rozmiar i dataProdukty dostają„Wyeksportowano”,jeśli włączono „Eksportować tylkonowe dane”„Eksport danych zakończony”
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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.

    Dwa sposoby, w jakie zadanie z harmonogramu kończy się bez przebiegu: zajęte przez inny eksport — z wpisem w dzienniku, szablon wyłączony — bez śladu
    TakNieNieTakPrzebieg padł, znacznikzostałNadszedł czas zadania zharmonogramuCzy inny eksport z harmonogramujeszcze trwa?Zadanie anulowane:„Anulowano eksport wedługharmonogramu…”Zadanie zostaje oznaczonejako wykonywaneCzy szablon zadania jest„Aktywny”?Szablon jest pomijany.W dzienniku nicZwykły przebieg szablonuz regułami stopStrażnik zdejmuje znacznik: minęłagodzinaod startu i pół godziny ciszy wdzienniku
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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

    1. Popraw szablon i kliknij „Sprawdź” — upewnij się, że druga próba nie będzie taka sama jak pierwsza.
    2. Uruchom eksport. Plik pod stałym linkiem zostaje zastąpiony w całości.
    3. 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ć.
    4. 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.

    Najczęstsze problemy z feedem XML
    Co widziszDlaczego tak jestCo 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
    Karta „Szablon XML” szablonu eksportu YML z początkiem pliku i makrami w nawiasach klamrowych
    1Tekst szablonu z makrami
    1. Tekst szablonu — początek pliku (yml_catalog, shop) i makra w nawiasach klamrowych, zastępowane podczas eksportu prawdziwymi danymi.

    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