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

Jak stworzyć plik XML dla Rozetka ua sockets

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. w przypadku jakichkolwiek zmian w cenniku id kategorii musi pozostać bez zmian; przed określeniem należy wybrać ostateczne kategorie towarów; Zalecamy podanie nazwy kategorii zgodnie z nazwą na naszej stronie internetowej. W jednej kategorii nie powinno być produktów z różnych kategorii na naszej stronie; w jednej kategorii sklepu na naszej stronie nie powinny znajdować się produkty z dwóch różnych kategorii. 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; rz_id=”32635505” ━ identyfikator kategorii na ROZETCE, w której należy umieścić towar. 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ą. każdy produkt jest opisany osobnym elementem oferty; każda oferta musi mieć przypisany unikalny numer id=". . . ", numeracja jest w gestii sklepu; id oferty musi pozostać bez zmian, dozwolone są znaki: Aa-Zz i 0-9, cyrylica i spacje są niedozwolone atrybut available wskazuje na dostępność produktu: true — produkt dostępny, false — produkt niedostępny. 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:
url (w ofercie) Element opcjonalny	Link do produktu w Twojej witrynie. Przykład: Maksymalna liczba znaków to ━ 500.
Cena Wymagany element	Cena produktu. Podaj tylko liczbę całkowitą, kopiejki są zaokrąglane na stronie. Przykład: 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`<<><<> Czytaj więcej: Zniżka na produkt
cena_promocyjna (cena_promocyjna) Element opcjonalny	Cena kodu promocyjnego. Musi mieć tag Przykład: <<><<> `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:
identyfikator kategorii Wymagany element	Identyfikator kategorii, z którą powiązany jest ten produkt. Przykład:
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 89. 184. 81. 128/26 78. 27. 198. 0/24 89. 184. 65. 128 88. 81. 226. 126 78. 27. 198. 189 91. 210. 37. 210
sprzedawca Wymagany element	Marka producenta. Powinien spełniać nasze wymagania . Przykład:
nazwać (Model) Wymagany element	Nazwa produktu. Prosimy o przestrzeganie naszych wymagań i zaleceń podczas określania. cennik nie może zawierać dwóch produktów o dokładnie tej samej nazwie; marka wskazana w tytule i w tagu 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)` Maksymalna liczba znaków to ━ 255.
opis Wymagany element	Opis produktu. opis może być tego samego typu dla całej kategorii; opis powinien zawierać wyłącznie informacje o produkcie; opis nie powinien zawierać linków, numerów telefonów, adresów, ofert usług, promocji, cen, zdjęć, recenzji wideo itp. ; Opis najlepiej sformatować za pomocą tagów html. Tagi HTML zbliżają się . Przykład:
stan Element opcjonalny	Stan produktu. Stosowany w przypadku towarów używanych i regenerowanych towary używane odnowiony Nowy Jeśli znacznik stanu nie jest określony, domyślnie produktom przypisywany jest nowy stan. Przykład:
. . . 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. w atrybucie name podaj nazwę parametru (wymagane); w samym elemencie . . . określ wartość parametru. 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.