Jak stworzyć plik XML dla Rozetka.ua (sockets)
Aby wystawiać towary na Rozetka.ua należy przygotować cennik z ofertami w formacie XML (YML). Podczas działania sklepu adres linku xml musi być statyczny i nie może się zmieniać.
Wymagania dotyczące pliku XML (YML)
- standard XML (YML) nie dopuszcza stosowania znaków niedrukowalnych o kodach ASCII od 0 do 31 (z wyjątkiem znaków o kodach 9, 10, 13 - tabulator, znak nowej linii, powrót karetki).
- znaki ", &, >, <, ' należy zastąpić równoważnymi kodami. Wymóg dotyczy tylko tekstu i nie wpływa na pisanie tagów;
- zabroniona jest zmiana identyfikatora towarów i kategorii po dodaniu do serwisu ROZETKA.
Symbol w tekście | Kod pliku XML |
---|---|
" | |
& | |
> | |
< | |
' |
- Adres URL oferty produktowej na stronie sklepu musi być zaszyfrowany zgodnie ze standardem RFC-1738.
- prawidłowe kodowanie plików XML (YML): UTF-8.
Przykład pliku XML
Opis elementów
Element | Opis |
---|---|
katalog_yml
Wymagany element |
Główny element formatu YML. Atrybut date określa datę i godzinę wygenerowania lub modyfikacji XML (YML). Data musi być w formacie RRRR-MM-DD gg:mm. |
sklep
Wymagany element |
Zawiera opis sklepu i jego oferty produktowej. |
nazwać
Element opcjonalny |
Skrócona nazwa sklepu. Niepublikowane, używane do identyfikacji wewnętrznej. Maksymalna liczba znaków to ━ 255. |
Spółka
Element opcjonalny |
Pełna nazwa firmy będącej właścicielem sklepu. Niepublikowane, używane do identyfikacji wewnętrznej. Maksymalna liczba znaków to ━ 255. |
adres URL
Element opcjonalny |
URL strony głównej istniejącego sklepu. Maksymalna liczba znaków to ━ 255. |
Platforma
Element opcjonalny |
System zarządzania treścią, na którym działa sklep (CMS). |
waluty
Wymagany element |
Lista kursów walut sklepowych. Każda z walut jest opisana osobnym elementem walutowym. Przykład: Ceny na stronie są wyświetlane tylko w UAH. Tylko hrywna ma rate="1". YML używa kropki lub przecinka do oddzielenia części całkowitych i ułamkowych dowolnych liczb, niezależnie od ustawień regionalnych. Wartość w atrybucie id=". . . " waluty jest określona zgodnie ze standardem ISO 4217 jako trzyliterowy kod waluty alfabetyczny (alfa-3). |
kategorie
Wymagany element |
Lista kategorii sklepów. Każdej kategorii przypisany jest unikalny numer, o numeracji decyduje sklep.
Przykład: Угловые диваны Смарт-часы Детские игровые комплексы Угловые диваны Смарт-часы Детские игровые комплексы Угловые диваны Смарт-часы Детские игровые комплексы Maksymalna liczba znaków to ━ 255. |
rz_id
Element opcjonalny |
Zapewnia automatyczne powiązanie kategorii z cennika z kategorią ROZETKA. Jest wskazany tylko na liście kategorii, Twój identyfikator kategorii jest wskazany na karcie produktu. Przykład: Джемы и начинки id="12345" ━ identyfikator Twojej kategorii; Priorytet rz_id jest wyższy niż priorytet nazwy kategorii. Na przykład, jeśli nazwa kategorii w pliku xml to „T-shirt”, a id kategorii „Skarpetki” na stronie ROZETKA jest wskazany w tagu rz_id, to automatycznie nastąpi połączenie z „ Skarpety”. |
oferuje
Wymagany element |
Lista ofert sklepu. Otwiera się raz, po tagu. Zamyka się na końcu dokumentu, przed tagiem Przykład: Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Należy pamiętać, że tag nie może się powtarzać w cenniku. |
oferta
Wymagany element |
Karta Produktu. Zamknięty metką.
Dla każdego rodzaju produktu: kolor, rozmiar, objętość, konfiguracja itp. — należy stworzyć osobną unikalną ofertę. Na naszej stronie produkty zostaną pogrupowane w 1 ofertę z możliwością wyboru koloru, rozmiaru, objętości itp. Przykład: . . . |
wielkość zbiorów (Ilość w magazynie) Wymagany element |
Reszta towaru. Produkt będzie dostępny na stronie, o ile ten parametr będzie większy niż 0. Należy pamiętać, że w przypadku korzystania z tagu obowiązkowe jest wskazanie go we wszystkich produktach w cenniku, w przeciwnym razie produkty bez tego tagu otrzymają status „Brak w magazynie”. Pamiętaj również o przestrzeganiu wartości w tagu available=". . . ", jeśli stock_quantity > 0 prawda, jeśli stock_quantity < 0 fałsz. Przykład: 10 |
url (w ofercie)
Element opcjonalny |
Link do produktu w Twojej witrynie. Przykład: https://elbuz.com/catalog/muzhskaya_odezhda/kurtki/kurtkabx. html Maksymalna liczba znaków to ━ 500. |
Cena
Wymagany element |
Cena produktu. Podaj tylko liczbę całkowitą, kopiejki są zaokrąglane na stronie. Przykład: 4499 YML używa kropki lub przecinka do oddzielenia części całkowitych i ułamkowych dowolnych liczb. Cena wskazana kopiejkami zostanie zaokrąglona na stronie. |
cena_stara (stara cena) Element opcjonalny |
Stara cena towaru zostanie przekreślona na stronie. Określ po tagu
Przykład: 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 Czytaj więcej: Zniżka na produkt |
cena_promocyjna (cena_promocyjna) Element opcjonalny |
Cena kodu promocyjnego. Musi mieć tag
Przykład: 820 620 или 820 620 или 820 620 или
820
620
Czytaj więcej: Udział w mailingach promocyjnych |
identyfikator waluty
Wymagany element |
Waluta, w której podana jest cena towaru: UAH, EUR, EUR, RUR. Przykład: UAH EUR EUR RUR UAH EUR EUR RUR UAH EUR EUR RUR UAH EUR EUR RUR |
identyfikator kategorii
Wymagany element |
Identyfikator kategorii, z którą powiązany jest ten produkt. Przykład: 391 |
zdjęcie
Wymagany element |
Link do zdjęcia produktu. Pierwsze zdjęcie na liście będzie głównym zdjęciem na karcie produktu. Link nie powinien zawierać cyrylicy i spacji, maksymalna liczba znaków to ━ 1999. Minimalna liczba zdjęć to ━ 1, maksymalna to 15. Przykład: Jeśli Twój serwer ma ograniczenia w przesyłaniu zdjęć, musisz dodać następujące podsieci do wyjątków: 89. 184. 81. 192/27 |
sprzedawca
Wymagany element |
Marka producenta. Powinien spełniać nasze wymagania . Przykład: Abc clothes |
nazwać (Model) Wymagany element |
Nazwa produktu. Prosimy o przestrzeganie naszych wymagań i zaleceń podczas określania.
Znacznik modelu może być używany jako tytuł zamiast identyfikatora. Przykład: Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) Maksymalna liczba znaków to ━ 255. |
opis
Wymagany element |
Opis produktu.
Przykład: Одежда <b>Abc clothes</b> способствует развитию…
Producent: Estonia. ]]> |
stan
Element opcjonalny |
Stan produktu. Stosowany w przypadku towarów używanych i regenerowanych Jeśli znacznik stanu nie jest określony, domyślnie produktom przypisywany jest nowy stan. Przykład: used |
. . . Wymagany element |
Charakterystyka (parametry) towaru. Należy podać nazwę lub wartość cechy (parametru), puste znaczniki nie są dozwolone. Minimalna liczba wymaganych cech dla produktu = 3.
Przykład: Черный
W parametrze wielowartościowym wartości są wymienione oddzielone przecinkami i zamknięte w CDATA. Maksymalna liczba znaków to ━ 255. |
paramid=". . . "
Element opcjonalny |
id charakterystyki (parametru) na stronie ROZETKA jest przewidziany do automatycznego powiązania parametru i przyspieszenia procesu moderacji. Jeśli typ parametru (charakterystyka) to: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ wymagany jest dodatkowy tag valueid=". . . " Przykład: 2 |
valueid=". . . "
Element opcjonalny |
id wartości charakterystyki (parametru) w serwisie ROZETKA, jest przewidziany do automatycznego wiązania wartości i przyspieszenia procesu moderacji. Przykład: Осенняя, Весенняя, Летняя
Maksymalna liczba znaków to ━ 255. |
Aby rozładować w XML, użyj podstawień makr
{Atrybut: ID Rozetki}
{Atrybut: imię Rozetka}