Elbuz czyta produktowy feed XML — z pliku lub z linku — i sam rozkłada każdą ofertę na pola karty produktu: nazwę, cenę, dostępność, zdjęcia, atrybuty i kategorię. Mapowanie kolumn nie jest potrzebne.
Kiedy to się przyda:
- Katalog jest w postaci feedu XML (Prom, Rozetka, Hotline, CMS) — produkty trafiają do katalogu razem z kategoriami.
- Feed jest dostępny pod linkiem — szablon według harmonogramu aktualizuje ceny i stany.
- Ceny w feedzie są w innej walucie — program przelicza je na walutę bazową po kursie z feedu.
- Kolory i rozmiary to osobne oferty — oferty z tym samym group_id składają się w jeden produkt z wariantami.
Od czego zacząć: szablon typu „XML” z linkiem do feedu w oknie „Import”.
Co potrafi import XML
- Rozkłada oferty na karty produktów — nazwa, ceny, kod produktu, producent, zdjęcia, opis, kod kreskowy i atrybuty bez ręcznego mapowania.
- Aktualizuje, a nie duplikuje — produkt jest rozpoznawany po
idoferty, a warianty — pogroup_id. - Odczytuje dostępność i walutę — status jest ustawiany według Twojego słownika, cena przeliczana na walutę bazową.
- Odtwarza drzewo kategorii z bloku
categoriesfeedu. - Aktualizuje katalog według harmonogramu, gdy feed jest dostępny pod linkiem.
- Utrzymuje katalog jako lustro feedu — osobne pole wyboru usuwa to, czego w feedzie już nie ma.
Jaki feed Elbuz odczyta bez mapowania
Standardowy feed XML to plik o z góry znanej strukturze. W korzeniu jest yml_catalog, w nim — sklep z trzema blokami: waluty (currencies), kategorie (categories) i oferty (offers). Każda oferta offer to jeden produkt. Nazwy elementów są standardowe, więc Elbuz sam wie, gdzie jest cena, gdzie zdjęcie, a gdzie kategoria.
Pliku XML z dowolnymi nazwami węzłów ten szablon nie odczyta — taki plik importuje się importem uniwersalnym, w którym dopasowanie pól ustawiasz samodzielnie.
Feed XML to format feedu produktowego, który przyjmują Rozetka, Prom i inne platformy. Opis formatu dla konkretnego marketplace’u znajdziesz w jego pomocy, np. w Prom: Імпорт через XML — формат файлу (Import przez XML — format pliku). Elbuz czyta standardowe elementy XML niezależnie od źródła.
1
Wiersz szablonu XML- Szablon importu XML (typ XML) na liście szablonów.
Jak Elbuz rozpoznaje produkt z feedu
Kluczem dopasowania jest atrybut id oferty (offer id="…"). Elbuz zapisuje go w polu produktu „ID produktu (ciąg UUID)” i przy każdym przebiegu szuka karty właśnie po nim. Stałe id — ponowny import aktualizuje istniejącą kartę. Id, które zmienia się z eksportu na eksport, za każdym razem daje duplikaty. Więcej: ponowny import bez duplikatów.
Atrybut group_id łączy warianty jednego produktu: oferty z tym samym group_id składają się w jeden produkt z wariantami, pierwsza w grupie staje się główną.
Id jest brane tak, jak zapisano je w pliku. Dwa feedy z prostą numeracją (1, 2, 3…) dają te same klucze i drugi szablon nadpisze karty pierwszego. Rozdziela je pole wyboru „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu”. Więcej: dwa szablony dla tego samego produktu.
Duplikaty z niestałego id widać w tabeli produktów: nazwa ta sama, „ID produktu (ciąg UUID)” inne, „Data dodania” — dzień przebiegu. Najpierw napraw źródło, potem usuń nadmiar. Więcej: jeśli zaimportowano nie to.
Gdzie trafiają wartości oferty
| Element XML | Pole karty w Elbuz |
|---|---|
atrybut id | UUID (klucz dopasowania) |
name (lub vendor + model dla type="vendor.model") | nazwa produktu |
price (+ priceuah/pricerub/priceusd/pricekzt) oraz currencyId | cena (przeliczana na Twoją walutę bazową po kursie) |
oldprice | stara cena |
atrybut available (true/false), presence, stock | status dostępności |
quantity | stan |
vendorCode (lub code) | kod produktu () |
vendor (lub publisher) | producent |
categoryId / category / blok categories | kategoria produktu |
picture / image (kilka) | zdjęcia (pierwsze — główne) |
description | opis |
barcode / ISBN | kod kreskowy () / ISBN |
param name="…" | atrybuty; param name="sku" → kod |
url, keywords | link do produktu, słowa kluczowe (tagi) |
manufacturer_warranty | gwarancja |
Dla oferty typu vendor.model nazwa składa się z marki i modelu, czasem z prefiksem typu (typePrefix). Element param staje się atrybutem produktu: name — nazwa atrybutu, zawartość — wartość. Jeśli elementu nie ma w feedzie, pole nowej karty pozostaje puste.
Co nadpisze ponowny przebieg
- Puste pole w feedzie nie kasuje Twojego: kod produktu, model, kod kreskowy, ISBN, gwarancja, tagi, link do produktu, producent i kategoria są aktualizowane tylko wtedy, gdy feed coś dla nich zawiera.
- Cena, stara cena, ilość, nazwa i opis są zapisywane tak, jak są: brak
quantity— w karcie będzie zero, brakname— nazwa zostanie pusta. - Zdjęcia są dopisywane: do istniejącej karty dochodzą zdjęcia, których jeszcze w niej nie było.
Karty z flagą „Nie aktualizuj” przebieg nie zmienia wcale, łącznie z nazwą i opisem; z flagą „Stała cena” — aktualizuje wszystko poza ceną i starą ceną. Po zapisie przebieg wykonuje jeszcze formuły pól oznaczone dla importu — ich wynik zostaje w karcie. Więcej: jak zablokować własną wartość, co się dzieje po przebiegu.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jak odczytywane są dostępność i cena
Status dostępności jest brany z pierwszego elementu, który znajdzie się w ofercie:
| W feedzie | Status w karcie |
|---|---|
tekst w presence lub stock («в наявності», «під замовлення») | według Twoich reguł określania statusu |
atrybut available="true" | „Dostępny” |
atrybut available="false" | „Brak w magazynie” |
| nic | pierwszy status ze słownika z klasyfikacją „Jest” i jego „Ilość domyślna” |
Feed bez informacji o dostępności sprawi, że produkty będą widoczne jako dostępne w magazynie. Jeśli nie o to chodzi, sprawdź statusy i ilość w słowniku przed pierwszym przebiegiem.
presence ma pierwszeństwo przed atrybutem available. Reguły określania statusu i status domyślny ustawiają też ilość — ze słownika, a nie z feedu.- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Waluta i cena
Cena jest brana z pierwszego wypełnionego elementu: price, priceuah, pricerub, priceusd, pricekzt. Walutę określa currencyId, kurs — blok currencies samego feedu:
- Waluta produktu jest w
currencies— cena jest przeliczana na walutę bazową po kursie z feedu. - Kurs waluty produktu w feedzie wynosi 1, nie jest to Twoja waluta bazowa, a kursu waluty bazowej w feedzie nie ma — kurs jest brany z Twojego słownika walut.
- Waluty produktu nie ma w
currencies— cena jest importowana bez przeliczenia, tak jak jest.
Jak z feedu powstają kategorie
Drzewo kategorii Elbuz buduje z bloku categories: każdy category z atrybutami id i parentId określa kategorię i jej kategorię nadrzędną. Produkt jest przypisywany do kategorii według swojego categoryId.
Bez kategorii nowa karta nie powstaje. Nowa oferta trafia do katalogu tylko wtedy, gdy jej categoryId pasuje do kategorii — utworzonej z bloku categories tego pliku albo założonej wcześniej. Brak bloku i takich kategorii — nie powstanie żaden nowy produkt, choć dziennik pokaże pełne „Łącznie zaimportowano produktów”: to odczytane oferty, a nie utworzone karty.
Istniejące karty taki feed zaktualizuje normalnie, a one zachowają swoją kategorię.
Kategorie z feedu przebieg przywraca do stanu z pliku. Zmienisz nazwę kategorii w Elbuz — następny import przywróci nazwę z feedu. Przeniesiesz produkt do innej kategorii — przebieg też to cofnie, jeśli feed wskazuje kategorię dla produktu. Własną strukturę buduj dla produktów, których feed nie obejmuje, albo zmieniaj ją w samym źródle.
Usunięcie kategorii usuwa produkty, dla których jest ona główna — z opisami, zdjęciami i atrybutami. Następny przebieg założy je od nowa jako inne karty. Więcej: kategorie techniczne i usuwanie kategorii z produktami.
Jak aktualizować katalog z linku
Gdy szablon z linkiem jest sprawdzony, ustaw go w harmonogramie przyciskiem „Ustawienia harmonogramu” w karcie szablonu. Elbuz sam będzie pobierał świeży feed i aktualizował ceny, dostępność i stany. Częstotliwość dobierz do źródła: feed, który zmienia się raz na dobę, nie potrzebuje importu co godzinę.
Według harmonogramu działa tylko link. Harmonogram bierze adres zapisany w szablonie; plik z komputera to jednorazowa ręczna operacja. Szablon, w którym wypełniono tylko pole pliku, według harmonogramu nic nie zrobi.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
1
Plakietka stanu2
Historia uruchomień3
Przycisk „Importuj”- Pokazuje, czy szablon jest aktywny; plakietka widoczna w obecnym stanie.
- Otwiera historię uruchomień.
- Uruchamia import (nie kliknięty).
Pauza, czas trwania i przerwanie przebiegu
- Pauza. Plakietka „Wyłączony” w nagłówku szablonu zatrzymuje harmonogram, produkty i ustawienia zostają. Więcej: wyłączyć szablon czy usunąć.
- Czas trwania. Limitu liczby ofert nie ma, plik jest czytany strumieniowo. Czas ostatniego przebiegu widać w kolumnie „Ostatni import”, historię pokazuje „Historia uruchomień”. Więcej: limity przebiegu, jak sprawdzić import.
- Licznik w dzienniku aktualizuje się co tysiąc ofert, więc przy małym feedzie wiersza „Pobrano z pliku produktów” może nie być — podsumowanie pokaże „Łącznie zaimportowano produktów”.
- Przerwanie. To, co zapisano przed zatrzymaniem, zostaje; ponowne uruchomienie jest bezpieczne, jeśli
idw feedzie się nie zmieniają. Nie uruchamiaj dwóch importów jednocześnie. Więcej: jeśli przebieg został przerwany.
Co się dzieje z produktem, którego nie ma już w feedzie
Domyślnie — nic: oferta, która zniknęła, zostaje w katalogu z tą samą ceną, dostępnością i stanem. Tryb lustra włącza pole wyboru „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku” — usuwa ono karty bezpowrotnie, a gdy plik zawiera blok categories, także kategorie, których w nim nie ma.
Bez pola wyboru „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu” usuwanie obejmuje cały katalog, a nie tylko produkty tego szablonu. Jeśli z pliku nie odczytano ani jednego produktu, usuwanie się nie wykonuje. Więcej: produkt zniknął ze źródła.
1
Usuwanie rekordów, których nie ma w pliku2
Unikalność według źródła3
Ustawienia harmonogramu- Usuwa z katalogu rekordy, których brakuje w importowanym pliku.
- Sprawdza unikalność rekordów z uwzględnieniem tego źródła importu.
- Otwiera ustawienia harmonogramu tego szablonu.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Scenariusze
Dostawca udostępnia feed pod linkiem, ceny i stany mają aktualizować się same
Co włączyć. W szablonie — „Link zewnętrzny” i adres feedu w polu „Link do pliku z produktami (Katalog)”. Następnie „Ustawienia harmonogramu” w bloku „Powiązane ustawienia”; plakietka w nagłówku szablonu — „Aktywny”.
Efekt. O wyznaczonej porze harmonogram pobiera plik i wykonuje ten sam przebieg co przycisk „Importuj”. Produkty, których w świeżym feedzie już nie ma, zostaną z poprzednią ceną i stanem. Jeśli w tym momencie trwa inny import według harmonogramu, uruchomienie zostanie anulowane z wpisem o konflikcie przetwarzania danych.
Katalog ma dokładnie odzwierciedlać feed
Co włączyć. W bloku „Co importować” — „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku”, a razem z nim „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu”.
Efekt. Przy każdym przebiegu karty, których nie ma w pliku, są usuwane z opisem, zdjęciami i atrybutami. Drugie pole wyboru chroni produkty innych szablonów importu; produkty dodane ręcznie, z cennika lub parserem są objęte usuwaniem. Usuniętych danych nie da się odzyskać. Pole wyboru usuwania jest nieaktywne — Twoja grupa nie ma do niego uprawnień.
Dwóch dostawców numeruje produkty tak samo
Co włączyć. „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu” w szablonach obu feedów.
Efekt. Każdy szablon szuka zgodności id wśród swoich kart oraz dodanych ręcznie, z cennika lub parserem. Oferta z tym samym id z drugiego feedu powstanie jako osobna karta, jeśli jej categoryId znalazł kategorię. Karty, które zlały się przed włączeniem pola wyboru, nie rozdzielą się: zostają przy szablonie, który je utworzył.
Cenę ustawiasz sam, a stan i dostępność pochodzą z feedu
Co włączyć. W karcie produktu — flagę „Stała cena”.
Efekt. Przebieg aktualizuje stan, status dostępności, kod produktu i inne pola, a ceny i starej ceny nie zmienia. Nazwę i opis feed nadpisze. Aby chronić przed feedem całą kartę, ustaw „Nie aktualizuj”.
Co zrobić, gdy feed zaimportował się nie tak
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Nie udało się przesłać pliku na serwer. Możliwe, że jest za duży lub połączenie zostało przerwane” | Plik z komputera nie dotarł na serwer: limit rozmiaru serwera albo przerwane połączenie | Zaimportuj feed z linku — tam tego limitu nie ma (aktualizacja z linku) |
| „Łącznie zaimportowano produktów: 0” | Pod linkiem przyszedł nie feed — strona błędu lub formularz logowania — albo plik nie jest w formacie XML | Otwórz link w przeglądarce i upewnij się, że zwraca XML. Katalog nie ucierpiał (zniknął z feedu) |
| W pliku są setki ofert, a nowych kart nie przybyło | Dla nowych pozycji nie znalazła się kategoria: brak bloku categories albo categoryId się nie zgadza |
Sprawdź blok kategorii w feedzie (kategorie) |
| Znaki w nazwach są „połamane” | Plik nie jest w kodowaniu | Poproś źródło o feed w UTF-8 |
| Cena zaimportowała się w obcej walucie, bez przeliczenia | Waluty produktu nie ma w bloku currencies feedu |
Dodaj walutę z kursem do feedu (waluta i cena) |
| XML się zaimportował, ale ceny, zdjęcia lub nazwy są puste | Nazwy węzłów w pliku nie są standardowe dla XML | Importuj plik importem uniwersalnym z własnym mapowaniem |
| „Anulowano import według harmonogramu, przyczyna - trwa import innego szablonu (konflikt przetwarzania danych)” | W tym momencie trwał już inny import | Rozsuń harmonogramy szablonów w czasie (przerwanie przebiegu) |
| „Operacja przerwana przez użytkownika!” | Użyto przycisku zatrzymania — przez Ciebie lub innego pracownika | Uruchom import ponownie: powtórzenie jest bezpieczne (przerwanie przebiegu) |
Najczęstsze pytania
Czym feed XML różni się od dowolnego pliku XML?
Feed XML to format feedu produktowego o stałej strukturze, który przyjmują Rozetka, Prom i inne platformy. Plik o takiej strukturze (yml_catalog, offers, categories) importuje się szablonem „XML” bez mapowania. Dowolny XML importuje się importem uniwersalnym.
Dostawca przysłał XML — importować go do katalogu czy do cennika?
Jeśli plik opisuje Twój asortyment — importuj go szablonem „XML” do katalogu. Jeśli opisuje asortyment dostawcy, którego ceny trzeba porównywać i obejmować narzutem — załóż cennik (mapowanie kolumn cennika).
Dlaczego produkty nie mają opisu ani atrybutów?
Elbuz bierze tylko to, co jest w feedzie. Jeśli oferta nie ma description ani param, pola zostaną puste. Karty można uzupełnić parserem z zewnętrznych stron.
Jak zatrzymać automatyczną aktualizację, niczego nie usuwając?
Przełącz plakietkę w nagłówku szablonu na „Wyłączony”. Harmonogram pomija szablon, produkty, harmonogram i ustawienia zostają, a przycisk „Importuj” nadal działa (pauza).
Po każdym imporcie pojawiają się kopie produktów. Dlaczego?
Źródło nadaje ofertom nowe id przy każdym eksporcie. Poproś źródło o stałe id, a kopie usuń (duplikaty).
Czy można udostępnić swój katalog w formacie XML?
Tak, służy do tego osobny szablon eksportu — eksport w formacie XML.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → szablon typu „XML”
- Uprawnienia
- okno „Import” w „Uprawnieniach grup”
- Przygotuj
- plik
.xml/.ymllub bezpośredni link do feedu
Źródło w szablonie — „Plik lokalny” lub „Link zewnętrzny”. Według harmonogramu działa tylko link.
1
Przełącznik „Plik lokalny” / „Link zewnętrzny”2
Pole pliku lub linku- Przełącz źródło danych między plikiem lokalnym a linkiem zewnętrznym.
- Wybierz tu plik albo wpisz adres, gdy wybrany jest link zewnętrzny.
Powiązane tematy
- Jeśli chcesz wybrać sposób importu lub zrozumieć, co nadpisze ponowny przebieg — Import danych do katalogu bazowego.
- Jeśli XML jest niestandardowy albo to Excel lub CSV — Import uniwersalny.
- Jeśli katalog trzeba przekazać na marketplace jako feed — Eksport w formacie XML.
- Jeśli XML to cennik dostawcy — Mapowanie kolumn cennika.
