Главная/Формат файла YML для импорта на Ralex

Формат файла YML для импорта на Ralex

Пример

Пример одного предложения (offer) для формата YML

<offer id="9012" bid="80">    
<name>Мороженица Brand 3811</name>    
<vendor>Brand</vendor>    
<vendorcode>A1234567B</vendorcode>    
<url>http://best.seller.ru/product_page.asp?pid=12345</url>    
<price>8990</price>    
<oldprice>9990</oldprice>
<prices>
<price>
<quantity>5</quantity>
<value>8449</value>
</price>
<price>
<quantity>10</quantity>
<value>7998</value>
</price>
</prices>    
<enable_auto_discounts>true</enable_auto_discounts>    
<currencyid>RUR</currencyid>    
<categoryid>101</categoryid>    
<picture>http://my-site.com.ua/img/model_12345.jpg</picture>    
<supplier ogrn="5634567890123"></supplier>    
<delivery>true</delivery>    
<pickup>true</pickup>    
<delivery-options>        
<option cost="300" days="1" order-before="18"></option>    
</delivery-options>    
<pickup-options>        
<option cost="300" days="1-3"></option>                            
</pickup-options>    
<store>true</store>    
<description>        
<!--[CDATA[ <h3-->Мороженица Brand 3811
<p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей, ведь с его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p> ]]>    
</description>    
<sales_notes>Необходима предоплата.</sales_notes>    
<manufacturer_warranty>true</manufacturer_warranty>    
<country_of_origin>Китай</country_of_origin>    
<barcode>4601546021298</barcode>    
<param name="Цвет">белый    
<condition type="likenew">        
<reason>Повреждена упаковка</reason>    
</condition>                    
<credit-template id="20034"></credit-template>    
<weight>3.6</weight>    
<dimensions>20.1/20.551/22.5</dimensions>
</offer>

Список и описание элементов

Необязательно

Элементы, специфичные для упрощенного типа описания	Описание элемента	Обязательность
`name`	Полное название предложения, в которое входит: тип товара, производитель, модель и название товара, важные характеристики. Составляйте по схеме: что (тип товара) + кто (производитель) + товар (модель, название) + важные характеристики.	Обязательно
Стандартные элементы	Описание	Обязательность
`vendor`	Название производителя.	Необязательно
`vendorCode`	Код производителя для данного товара.	Необязательно
`id`	Идентификатор предложения. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов. Должен быть уникальным для каждого предложения. В YML является атрибутом для `offer`.	Обязательно
`cbid`	Внимание. Элемент устарел. Используйте вместо него элемент `bid`.	Необязательно
`bid`	Размер ставки. В YML является атрибутом для `offer`.	Необязательно
`url`	URL страницы товара на сайте магазина. Максимальная длина ссылки — 512 символов. Допускаются кириллические ссылки. URL‑адрес формируется на основе стандарта RFC 3986.	Обязательно
`price`	Актуальная цена товара. Формат: целое или дробное число. Разделитель целой и дробной части — точка. Цена должна соответствовать стоимости товара, иначе магазин при проверке получит ошибку. Примечание. Если товар продается по весу, метражу и т. п. (не штуками), указывайте цену за вашу единицу продажи. Например, если вы продаете кабель бухтами, указывайте цену за бухту. В некоторых категориях (если прайс-лист передается в формате YML) допустимо указывать начальную цену «от» — с помощью атрибута `from="true"`. Посмотреть список категорий Пример: `<price from="true">2000</price>`	Обязательно
`prices`	Оптовые цены товара. Внутри тега цены разделяются тегом `<price>` , где значение `<` quantity `>10</quantity>` — количество товара для действия оптовой цены, `<value>7998</price>` — оптовая цена товара при данном количестве в заказе.	Необязательно
`oldprice`	Старая цена товара, должна быть выше текущей. Маркет автоматически рассчитывает разницу и показывает пользователям скидку.	Необязательно
`currencyId`	Валюта, в которой указана цена товара: `USD`, `EUR`, `UAH`. Цена и валюта должны соответствовать друг другу. Например, вместе с `USD` надо указывать цену в долларах, а не в гривне. Примечание. В текстовом формате нет возможности указать свои условия конвертации валют. При показе цены покупателю она будет пересчитана в нужную валюту по текущему курсу ПриватБанка.	Обязательно
`categoryId`	Внимание. Используется только в формате YML. Идентификатор категории товара, присвоенный магазином (целое число, не более 18 знаков).	Обязательно
`category`	Внимание. Используется только в формате CSV. Название категории товара.	Обязательно
`picture`	URL-ссылка на картинку товара.	Обязательно
`delivery`	Возможность курьерской доставки (по всем регионам, в которые доставляет магазин). Возможные значения: `true` — курьерская доставка есть; `false` — курьерской доставки нет. Внимание. Элемент `delivery` должен обязательно иметь значение `false`, если товар запрещено продавать дистанционно (рецептурные лекарственные средства, БАДы, гомеопатические средства). Если элемент не указан, считается, что курьерская доставка есть (значение по умолчанию — `true`).	Необязательно
`pickup`	Возможность самовывоза из пунктов выдачи (во всех регионах, в которые доставляет магазин). Возможные значения: `true` — самовывоз есть; `false` — самовывоза нет. Внимание. Обязательно создайте точки продаж в личном кабинете, чтобы для товара отображалась возможность самовывоза. Если элемент не указан, считается, что самовывоз есть (значение по умолчанию — `true`).	Необязательно
`description`	Описание предложения. Длина текста не более 3000 символов (включая знаки препинания). В описании запрещено указывать: В формате YML допустимо использовать некоторые xhtml-теги при условии, что они заключены в блок CDATA и соблюдены общие правила стандарта XHTML.	Необязательно
`sales_notes`	Элемент обязателен, если у вас есть ограничения при покупке (например, минимальное количество товаров или необходимость предоплаты). Также можно указать варианты оплаты, акции и распродажи. В этом случае использование элемента необязательно. Допустимая длина текста — 50 символов.
`min-quantity`	Внимание. Используется только в формате YML. Минимальное количество одинаковых товаров в заказе (для случаев, когда покупка возможна только комплектом, а не поштучно).. Если элемент не указан, используется значение по умолчанию — 1.	Необязательно
`manufacturer_warranty`	Официальная гарантия производителя. Возможные значения: `true` — товар имеет официальную гарантию производителя; `false` — товар не имеет официальной гарантии производителя.	Необязательно
`country_of_origin`	Страна производства товара.	Необязательно
`adult`	Товар имеет отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирует интерес к сексу. Возможные значения — `true`, `false`.	Необязательно
`barcode`	Штрихкод товара от производителя в одном из форматов: EAN-13, EAN-8, UPC-A, UPC-E. В YML элемент `offer` может содержать несколько элементов `barcode`. Данные в `barcode` влияют на привязку к карточке товара.	Необязательно
`param`	Все важные характеристики товара — цвет, размер, объем, материал, вес, возраст, пол, и т. д. В YML элемент `offer` может содержать несколько элементов `param` (один элемент `param` — одна характеристика).	Необязательно
`condition`	Внимание. Используется только в формате YML. Используйте элемент для подержанных товаров и товаров, уцененных из-за недостатков. В атрибуте `type` укажите состояние товара: `likenew` — как новый (товар не был в употреблении, уценен из‑за недостатков); `used` — подержанный (товар был в употреблении). В элементе `reason` обязательно укажите причину уценки и подробно опишите недостатки. Длина текста не более 3000 символов (включая знаки препинания). Пример: <condition type="likenew"> <reason>Повреждена упаковка</reason> </condition> Внимание. Информация о причинах уценки должна быть исчерпывающей. Тексты не должны быть уклончивыми. Например, нельзя писать: «Причины уценки узнавайте у консультанта». Если товар не уценен, не используйте этот элемент.	Необязательно
`condition-type`	Внимание. Используется только в формате CSV. Используйте элемент для подержанных товаров и товаров, уцененных из-за недостатков. В элементе укажите состояние товара. Возможные значения: `likenew` — как новый; `used` — подержанный. Если товар не уценен, не используйте этот элемент.	Необязательно
`condition-reason`	Внимание. Используется только в формате CSV. Причины уценки и подробное описание недостатков. Информация о причинах уценки должна быть исчерпывающей. Тексты не должны быть уклончивыми. Например, нельзя писать: «Причины уценки узнавайте у консультанта».	Обязательно, если указан `condition-type`
`weight`	Вес товара в килограммах с учетом упаковки. Для некоторых категорий установлены ограничения по минимальному или максимальному значению веса. В любой категории вес можно указывать с точностью до тысячных (например, 1.001 кг; разделитель целой и дробной части — точка). Если минимальное значение указано 0, ограничений по минимальному весу нет, и можно указывать начиная с одного грамма (0.001 кг).	Необязательно
`dimensions`	Габариты товара (длина, ширина, высота) в упаковке. Размеры укажите в сантиметрах. Формат: три положительных числа с точностью 0.001, разделитель целой и дробной части — точка. Числа должны быть разделены символом «/» без пробелов.	Необязательно
`available`	С помощью элемента `available` со значением `false` можно задать для товара вместо конкретного срока доставки надпись «до 60 дней» (или «предзаказ», если в базе данных Маркета есть дата, когда товар официально начнет продаваться). Если вы хотите использовать `available`, обязательно изучите подробное описание элемента. В YML является атрибутом для `offer`.	Необязательно
`age`	Возрастная категория товара. В формате CSV:Можно указывать только годы. Допустимые значения: 0, 6, 12, 16, 18.В формате YML: Годы задаются с помощью атрибута `unit` со значением `year`. Допустимые значения параметра `age` при `unit="year"`: 0, 6, 12, 16, 18. Месяцы задаются с помощью атрибута `unit` со значением `month`. Допустимые значения параметра `age` при `unit="month"`: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.	Необязательно

Вы можете скачать пример файла по ссылке.