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
- Gotowa struktura feedu — obowiązkowe tagi EVA wypełniane z karty produktu.
- Stan w feedzie — rzeczywista ilość lub ilość według statusu dostępności.
- Czyste opisy — obrazy i linki są wycinane.
- Stały link — EVA sama pobiera plik, ceny i dostępność aktualizują się co godzinę.
- Wybór asortymentu — część katalogu, jeden magazyn.
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
- Przygotuj karty. Ukraińska nazwa i opis, producent, zdjęcia i cechy — zgodnie z wymaganiami EVA.
- 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.
- Zawęź asortyment filtrem, jeśli do EVA nie trafia cały katalog.
- 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.
- Wklej link do feedu w panelu EVA i włącz automatyczną aktualizację.
- 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 EVA | Skąd pochodzi w Elbuz |
|---|---|
offer id | numer produktu w Elbuz |
available | status dostępności: „Dostępny” — true, pozostałe — false |
price | cena produktu |
price_old | stara cena — tylko gdy jest wyższa od ceny, w przeciwnym razie tagu nie ma |
stock_quantity | stan (jak jest liczony) |
currencyId | waluta domyślna |
category, categoryId | numer i nazwa Twojej kategorii w Elbuz |
picture | zdjęcia produktu, do 15 sztuk |
vendor | producent |
article | SKU producenta |
name_ua, description_ua | nazwa i pełny opis po ukraińsku |
name, description | nazwa i opis po rosyjsku — tylko jeśli w koncie był włączony język rosyjski w chwili tworzenia szablonu |
param | cechy 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.
1
Początek wiersza produktu2
Stan magazynowy3
Nazwa produktu- Początek wiersza produktu — jeden offer na produkt, z jego ID i dostępnością.
- Stan magazynowy — wstawka stock_quantity.
- 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 Elbuz | Co 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:
| Co | Wymaganie EVA |
|---|---|
| Plik | kodowanie UTF-8, statyczny link, do 300 MB |
| Nazwa po ukraińsku | obowią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 rosyjsku | zabroniona; bez nazwy rosyjskiej produkt jest widoczny tylko w ukraińskiej wersji strony |
| Opis po ukraińsku | obowiązkowy, od 30 znaków, bez linków, telefonów, adresów, cen i promocji |
| Marka | obowiązkowa; produkt bez znaku towarowego — No Brand i prawdziwy kraj produkcji w cechach |
| Zdjęcia | od 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 |
| Cechy | co najmniej 2, nazwa i wartość wypełnione, wartość do 255 znaków |
| Stara cena | wyższa od bieżącej i odpowiada rzeczywistemu rabatowi |
| Odmiany | każ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:
- Przygotowanie cennika XML — tagi, pola obowiązkowe, ograniczenia.
- Nazwa produktu, Opis produktu, Zdjęcia produktu, Parametry produktu, Marka produktu.
Jak włączyć automatyczną aktualizację w panelu EVA
Feed sam niczego nie aktualizuje — musi go pobierać EVA. W panelu sprzedawcy EVA:
- Sekcja «Товари» → «Імпорт товарів» (Produkty → Import produktów).
- W wierszu «Адреса XML файлу» (adres pliku XML) — link do Twojego feedu z Elbuz.
- Wybierz potrzebne opcje aktualizacji — co najmniej jedną.
- 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 moderacji | Ponowna moderacja |
|---|---|
cena, stara cena, stan, available, SKU, kursy walut | nazwa, 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 widzisz | Dlaczego tak jest | Co 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.
1
Nazwa i typ szablonu2
Pola wyboru danych- Nazwa i typ szablonu — EVA.UA (XML) z ID w nagłówku formularza.
- Pola wyboru danych — Kategorie, Produkty i inne dane trafiające do feedu.
Powiązane tematy
- Jeśli chcesz odbierać zamówienia z EVA — zamówienia z EVA.UA przez API.
- Jeśli produkt nie trafił do pliku albo trzeba ustawić wybór i harmonogram — eksport produktów na marketplace, do sklepu i do pliku.
- Jeśli wystawiasz produkty także na Epicentr — eksport katalogu do Epicentr.
