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
.png "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.
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: |
| 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 4499Czytaj 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 |
| 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.
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.
Przykład: |
| 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: |
| . . . 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}
.png)
.png)