↑↓ wybierzEnter otwórzEsc zamknij

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

    Jak wyeksportować produkty do EVA.UA: feed XML

    5 min czytaniaZaktualizowano

    Elbuz tworzy z katalogu feed XML dla EVA.UA i umieszcza go pod stałym linkiem, a EVA sama co godzinę pobiera z niego ceny i dostępność Twoich produktów.

    Kiedy to się przyda:

    • Wchodzisz na EVA Marketplace — szablon „EVA.UA (XML)” ma już obowiązkowe tagi EVA.
    • Produkty są dostępne, ale bez dokładnego stanu — do feedu trafia ilość według statusu, więc EVA nie ukrywa ich jako niedostępnych.
    • W opisach są linki i obrazy — Elbuz sam usuwa je z feedu, tak jak wymaga EVA.
    • Ceny i stany zmieniają się codziennie — feed jest tworzony od nowa według harmonogramu, a EVA podchwytuje zmiany bez moderacji.

    Od czego zacząć: kolejność podłączenia — od szablonu w Elbuz do automatycznej aktualizacji w panelu EVA.

    Co potrafi eksport do EVA

    Feed nie przynosi zamówień. Pobiera je osobne połączenie — import zamówień z EVA.UA.

    Jak podłączyć EVA: od szablonu do produktów na marketplace

    1. Przygotuj karty. Ukraińska nazwa i opis, producent, zdjęcia i cechy — zgodnie z wymaganiami EVA.
    2. Utwórz szablon eksportu typu „EVA.UA (XML)”. Elbuz od razu ustawia język szablonu na ukraiński i limit 15 zdjęć na produkt. Formularz ostrzega o adresie zastępczym https://site.com — zamień go w szablonie XML na adres swojej strony.
    3. Zawęź asortyment filtrem, jeśli do EVA nie trafia cały katalog.
    4. Utwórz plik ręcznie przyciskiem „Eksportuj” i otwórz go przez link: czy trafiły wszystkie produkty, czy wypełnione są nazwy, marki i stany.
    5. Wklej link do feedu w panelu EVA i włącz automatyczną aktualizację.
    6. Ustaw harmonogram szablonu w Elbuz — aby plik był tworzony od nowa ze świeżymi cenami i stanami.

    EVA dopasowuje Twoje kategorie do swoich po nazwie, więc nazywaj kategorie tak jak na stronie EVA. Cechy EVA też dopasowuje po nazwie do słownika swojej kategorii; wartość, której jeszcze tam nie ma, dodaje na Twoją prośbę opiekun EVA.

    Co trafia do feedu

    Tag feedu EVASkąd pochodzi w Elbuz
    offer idnumer produktu w Elbuz
    availablestatus dostępności: „Dostępny” — true, pozostałe — false
    pricecena produktu
    price_oldstara cena — tylko gdy jest wyższa od ceny, w przeciwnym razie tagu nie ma
    stock_quantitystan (jak jest liczony)
    currencyIdwaluta domyślna
    category, categoryIdnumer i nazwa Twojej kategorii w Elbuz
    picturezdjęcia produktu, do 15 sztuk
    vendorproducent
    articleSKU producenta
    name_ua, description_uanazwa i pełny opis po ukraińsku
    name, descriptionnazwa i opis po rosyjsku — tylko jeśli w koncie był włączony język rosyjski w chwili tworzenia szablonu
    paramcechy produktu: nazwa i wartość

    Z opisów trafiających do feedu Elbuz wycina obrazy i linki razem z tekstem linku: EVA zabrania ich w opisie. Znaczniki HTML akapitów i list zostają — opis trafia wewnątrz CDATA, jak zaleca EVA.

    Karta szablonu XML z blokiem offer feedu EVA.UA
    1Początek wiersza produktu
    2Stan magazynowy
    3Nazwa produktu
    1. Początek wiersza produktu — jeden offer na produkt, z jego ID i dostępnością.
    2. Stan magazynowy — wstawka stock_quantity.
    3. Nazwa produktu — wstawka name_ua.

    EVA zabrania zmieniać id produktów i kategorii po tym, jak produkty pojawiły się na stronie. W szablonie to numery z Elbuz, więc są stabilne, dopóki nie usuwasz i nie tworzysz od nowa kart czy kategorii. Nowa karta dostanie nowy numer i dla EVA będzie to inny produkt.

    Jak EVA widzi dostępność

    EVA pokazuje produkt jako dostępny tylko wtedy, gdy stock_quantity jest większe od zera, a available ma wartość true. Pozycję bez tagu stanu EVA uznaje za niedostępną. Dlatego w szablonie EVA jest osobna wstawka {stock_quantity}:

    Produkt w ElbuzCo trafia do stock_quantity
    jest stan, status dostępności daje niezerową ilośćrzeczywisty stan
    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, a bez niego — domyślnie 500; available ma przy tym wartość false, więc EVA pokaże produkt jako niedostępny
    status braku (w domyślnym słowniku — „Brak w magazynie”)0, nawet jeśli w karcie jest stan

    Ilości dla statusów zmienisz przyciskiem „Ustawienia aktualizacji według dostępności produktu” w formularzu szablonu (jak działa ta tabela). Ustaw 0 dla statusu, z którym produktu nie wolno sprzedawać na EVA — trafi on do feedu jako niedostępny.

    Po zamówieniu stan w Twoim feedzie sam się nie zmienia — EVA wprost prosi sprzedawcę, by tego pilnował. Nowa ilość dotrze na marketplace z następnym plikiem, więc częstotliwość harmonogramu w Elbuz decyduje, jak szybko EVA zobaczy, że produkt się skończył.

    Wymagania EVA wobec produktów

    EVA sprawdza nie tylko strukturę pliku, ale i treść kart. Zestawienie wymagań, przez które najczęściej dochodzi do odrzucenia:

    CoWymaganie EVA
    Plikkodowanie UTF-8, statyczny link, do 300 MB
    Nazwa po ukraińskuobowiązkowa, do 255 znaków; dwie identyczne nazwy w pliku są zabronione; marka w nazwie musi zgadzać się z vendor. Wzór: typ produktu + marka + model + cechy + kolor + (SKU)
    Nazwa tylko po rosyjskuzabroniona; bez nazwy rosyjskiej produkt jest widoczny tylko w ukraińskiej wersji strony
    Opis po ukraińskuobowiązkowy, od 30 znaków, bez linków, telefonów, adresów, cen i promocji
    Markaobowiązkowa; produkt bez znaku towarowego — No Brand i prawdziwy kraj produkcji w cechach
    Zdjęciaod 1 do 15, kwadratowe, co najmniej 512×512 (zalecane 2048×2048), do 10 MB; linki bez cyrylicy i spacji; bez znaków wodnych i czarnego tła
    Cechyco najmniej 2, nazwa i wartość wypełnione, wartość do 255 znaków
    Stara cenawyższa od bieżącej i odpowiada rzeczywistemu rabatowi
    Odmianykażdy kolor, rozmiar, pojemność — osobny produkt z własnym offer id

    Elbuz nie zmienia rozmiaru zdjęć: do feedu trafiają linki do obrazów, które są w karcie. Kwadratowe zdjęcia w potrzebnej rozdzielczości przygotuj zawczasu.

    Wymagania się zmieniają, więc w spornych kwestiach sprawdzaj pomoc EVA:

    Jak włączyć automatyczną aktualizację w panelu EVA

    Feed sam niczego nie aktualizuje — musi go pobierać EVA. W panelu sprzedawcy EVA:

    1. Sekcja «Товари» → «Імпорт товарів» (Produkty → Import produktów).
    2. W wierszu «Адреса XML файлу» (adres pliku XML) — link do Twojego feedu z Elbuz.
    3. Wybierz potrzebne opcje aktualizacji — co najmniej jedną.
    4. Zaznacz «Автоматичне оновлення увімкнено» (automatyczna aktualizacja włączona) i kliknij «Зберегти» (Zapisz).

    Status automatycznej aktualizacji zmieni się z «Неактивне» (nieaktywna) na «Активне» (aktywna), a cena i dostępność produktów będą aktualizowane co godzinę. Nowych produktów z pliku automatyczna aktualizacja nie dodaje: aby trafiły do panelu, kliknij w sekcji «Імпорт» przycisk «Оновити каталог» (Aktualizuj katalog).

    Harmonogramy są dwa: w Elbuz feed jest tworzony od nowa, w EVA — pobierany co godzinę. Tworzenie pliku częściej niż co godzinę nie ma sensu. Jak ustawić harmonogram — „Uruchamianie ręczne i według harmonogramu”.

    Każde wczytanie feedu całkowicie zastępuje listę Twoich produktów na EVA: wszystko, czego nie ma w bieżącym pliku, EVA zdejmuje z publikacji. Nie dziel katalogu na kilka plików: EVA czyta jeden link, a wszystko, co leży w innym pliku, jest dla niej nieobecne.

    Jakie zmiany kierują produkt do ponownej moderacji

    EVA sprawdza produkt ponownie, gdy zmienia się jego treść, a nie sprawdza, gdy zmieniają się cena i dostępność:

    Bez moderacjiPonowna moderacja
    cena, stara cena, stan, available, SKU, kursy walutnazwa, opis, marka, zdjęcia, kategoria lub jej nazwa, cechy

    Moderację uruchamia też zmiana struktury pliku — nawet zamiana jednego tagu na inny przy tej samej wartości. Dlatego nie poprawiaj bez potrzeby szablonu XML EVA: domyślny już odpowiada formatowi EVA. A masowe zmiany nazw, opisów czy zdjęć lepiej rób porcjami, żeby produkty nie znikały ze sprzedaży wszystkie naraz.

    Scenariusze

    Na EVA — tylko kilka kategorii

    Na zakładce „Ograniczenie eksportu (filtr)” szablonu ustaw warunek według kategorii lub producenta. Do pliku trafią tylko produkty spełniające warunek, a wszystko, co z pliku wypadło, EVA zdejmie z publikacji przy następnym wczytaniu. Gdy przywrócisz warunek, produkty wrócą z tymi samymi numerami.

    Sprzedawać tylko to, co jest w jednym magazynie

    Na zakładce „Wybór danych do eksportu” wybierz magazyn w polu „ID magazynu”. Do pliku trafią tylko produkty, które w tym magazynie są. Gdy produkt się skończy, zniknie z pliku, a EVA zdejmie go z publikacji, zamiast pokazać „brak w magazynie”.

    Magazyn tylko wybiera produkty: ilość w stock_quantity i dostępność pochodzą z ogólnego stanu i statusu produktu, a nie z tego magazynu.

    Chwilowo niedostępny produkt nie ma znikać z EVA

    Zostaw produkt w wyborze szablonu i nadaj mu status braku („Brak w magazynie”). Do feedu trafi z available="false" i stanem 0: karta na EVA zostanie, ale kupić produktu nie będzie można. Gdy produkt się pojawi, przywróć status — EVA podchwyci dostępność w ciągu godziny bez moderacji.

    Produkty dostawcy bez dokładnego stanu

    Produkty z cenników dostawców często mają status „Dostępny”, ale pusty stan. Do feedu trafią z ilością ze statusu (domyślnie 1000). Wolisz ostrożniej — ustaw mniejszą ilość dla statusu „Dostępny” w tabeli „Ustawienia aktualizacji według dostępności produktu” tego szablonu.

    Co zrobić, gdy EVA nie wczytuje feedu

    Błędy etapu wczytywania EVA pokazuje w panelu sprzedawcy. Najczęstsze:

    Co widziszDlaczego tak jestCo zrobić
    «403 Заборонено», «429 Забагато запитів», «Помилка з'єднання» (403 Zabronione, 429 Za dużo żądań, Błąd połączenia) plik leży na Twoim serwerze (szablon kopiuje go tam przez FTP), a ochrona przed botami blokuje EVA. Pliku pod linkiem Elbuz to nie dotyczy dodaj do białej listy IP 138.197.179.150 i 164.92.129.224 oraz User-Agent EvaMerchantBot/1.0
    «404 Ресурс не знайдено» (404 Nie znaleziono zasobu) pod linkiem w panelu EVA nie ma pliku — w szablonie zmieniono nazwę pliku, szablon usunięto albo jeszcze ani razu nie był eksportowany uruchom eksport i porównaj link w panelu z linkiem w szablonie do znaku „?” — końcówka po nim zmienia się z każdym przebiegiem i nie wpływa na adres
    «401 Доступ обмежено» (401 Dostęp ograniczony) plik jest chroniony hasłem, a EVA pobiera feed bez autoryzacji daj EVA publiczny link bez loginu i hasła
    «Неможливо декодувати вміст XML-файлу за допомогою UTF-8» (nie można zdekodować zawartości pliku XML w UTF-8) plik nie jest zapisany w UTF-8 sprawdź, czy w szablonie nie zmieniono kodowania w nagłówku <?xml … encoding="UTF-8"?>
    «Розмір файлу не повинен перевищувати 300 МБ» (rozmiar pliku nie może przekraczać 300 MB) w feedzie jest za dużo produktów lub duże opisy usuń zbędne filtrem szablonu; feedu nie można dzielić na części (dlaczego)
    Produkty na EVA są niedostępne, choć w Elbuz są available false — status produktu to nie „Dostępny” (np. „Na zamówienie”) lub w tabeli statusów wpisano dla niego własny tekst; stock_quantity 0 — status ma w tabeli ilość 0 sprawdź status dostępności i tabelę ilości szablonu (jak jest liczony)
    Produkty co chwilę trafiają do moderacji zmieniają się nazwy, opisy, zdjęcia albo sam szablon XML nie poprawiaj szablonu bez potrzeby; treść zmieniaj porcjami (co uruchamia moderację)
    Część produktów zniknęła z EVA nie ma ich w ostatnim pliku: wypadły z filtra lub skończyły się w wybranym magazynie przywróć produkty do wyboru szablonu; chwilowo niedostępne zostawiaj w feedzie ze statusem braku

    Wsparcie EVA prosi do analizy o dokładny tekst błędu, link do feedu i czas próby importu — pełna lista błędów w pomocy EVA.

    Najczęstsze pytania

    Dlaczego nie przez API, jak zamówienia?

    API EVA nie obsługuje produktów, cen i stanów — tylko zamówienia. Katalog EVA przyjmuje wyłącznie feedem XML przez link.

    Czy potrzebna jest nazwa rosyjska?

    Nie, obowiązkowe są ukraińska nazwa i opis. Bez rosyjskich produkt jest widoczny tylko w ukraińskiej wersji strony EVA. Szablon dodaje je sam, jeśli w chwili tworzenia szablonu w koncie był włączony język rosyjski.

    Czy Elbuz wypełnia kody kategorii i cech EVA?

    Nie. Szablon przekazuje Twoje kategorie i cechy nazwami, a EVA dopasowuje je do swoich po nazwie. Atrybutów eva_id, paramid i valueid w szablonie nie ma.

    Jak szybko nowa cena pojawi się na EVA?

    Po następnym eksporcie w Elbuz i następnym cogodzinnym odczycie w EVA. Cena nie wymaga moderacji.

    Jak odbierać zamówienia z EVA?

    Osobnym szablonem importu z loginem i hasłem do panelu — zamówienia z EVA.UA. Pozycje zamówień odnajdują Twoje karty po tym samym numerze produktu co w feedzie.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Eksport danych
    Utwórz
    „Dodaj” → typ „EVA.UA (XML)”
    Uprawnienia
    okna „Eksport” i „Szczegółowa konfiguracja szablonu eksportu” w „Uprawnieniach grup”
    Przygotuj
    ukraińskie nazwy i opisy, producenta, kwadratowe zdjęcia od 512×512

    Jeden szablon — jeden feed. Ogólna mechanika szablonów — wybór, plik pod linkiem, harmonogram, dziennik — w artykule o eksporcie produktów; tutaj — tylko to, co dotyczy EVA.

    Formularz szablonu eksportu EVA.UA (XML) z polami wyboru danych
    1Nazwa i typ szablonu
    2Pola wyboru danych
    1. Nazwa i typ szablonu — EVA.UA (XML) z ID w nagłówku formularza.
    2. Pola wyboru danych — Kategorie, Produkty i inne dane trafiające do feedu.

    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