Торговый портал Shop.by – Как загрузить товары на Shop.by через личный кабинет на тарифе PROцент

Загрузка товаров на Shop.by через Личный кабинет: https://shop.by/office на тарифе PROцент

В каких форматах можно загружать товары на Shop.by на тарифе PROцент?

Импорт товаров на Shop.by можно делать в одном из следующих форматов:

YML;
XML;
CSV.

Какие виды загрузки товаров существуют?

ручная загрузка товаров из файла в формате yml, xml, csv. Размер файла до 200 Мб;
загрузка прайса по ссылке в формате yml, xml, csv. Размер файла до 5 Гб.

Как часто можно обновлять данные на Shop.by?

Максимальная частота обновления данных по ссылке - 1 раз в час.

При ручной загрузке прайс отправляется в обработку в течение 5 минут.

Можно ли обновлять данные автоматически?

Да, если Вы выбрали загрузку по ссылке и установили галочку в поле “Обновлять автоматически”. Мы будем каждый час забирать из прайса те изменения, которые произошли на момент загрузки.

Проверка прайсов на наличие изменений происходит поэтапно в соответствии с группой обновления магазина.

Группы обновления:

Первая: 3-я минута часа

Вторая: 13-я минута часа

Третья: 23-я минута часа

Четвертая: 33-я минута часа

Пятая: 43-я минута часа.

Ваш магазин относится к одной из этих групп.

Например, Вы внесли изменения в прайс-лист в 10:24 и предыдущая обработка завершена в 10:26.

Ваша группа обновлений - 23-я минута часа. Изменения отобразятся на Shop.by после обработки, которая начнется в 11:23.

Что за настройка "Отключить повторное скачивание картинок"?

Это настройка, позволяющая оптимизировать нагрузку на ваш сервер при автоматической обработке системой Shop.by ваших прайс-листов.

Если чекбокс активен, система скачивает картинки для новых товаров в вашем прайсе. Снизится нагрузка на ваш сервер за счет отсутствия полной ночной перезагрузки всех картинок.

Если чекбокс деактивирован, система скачивает картинки для новых товаров и, в дополнение, ночью полностью перезагружает все картинки из прайса.

По-умолчанию чекбокс "Активен".

Что будет с данными о товарах, если при очередной обработке прайса система обнаружила ошибки?

На Shop.by будут отображаться данные, полученные при последней успешной обработке прайс-листа.

Что делать, если несколько часов прайс, загруженный по ссылке, висит в обработке?

Возможно, Вы загружаете прайс большого объема и системе нужно больше времени для его полной обработки. Обратитесь к своему менеджеру Shop.by, он проверит, все ли хорошо с обработкой прайс-листа.

Как подготовить файл для загрузки на Shop.by?

Если у Вас уже есть интернет-магазин, в вашей CMS наверняка есть модуль экспорта, формирующий yml, xml- или csv-прайсы. Ссылку на прайс или сам файл с товарами нужно загрузить в Личном кабинете в модуле Сервисы —> Управление товарами —> Загрузка товаров.
подготовить файл вручную.

Подробное описание YML

Здесь мы описываем теги (поля), которые могут быть использованы при импорте в формате YML.

Дополнительные, не описанные в данной документации теги, присутствующие в файле, будут проигнорированы во время импорта.

Типы YML

Упрощенный

название товара передается в одном поле <name>, являющегося частью описания товара. Заполнение этого поля влияет на классификацию товаров на Shop.by. Для правильной классификации поле <name> должно быть сформировано по принципу: Название категории+Производитель+Название Модели.

Например, <name>Смартфон Nokia 3310</name>

Пример полного описания товара в упрощенном виде:

<offer id="99" available="true">

<url>http://bestbestbest.shop.by/UID_99.html</url>

<price>900</price>

<oldprice>1000</oldprice>

<currencyId>BYN</currencyId>

<categoryId>11</categoryId>

<picture>https://bestbestbest.shop.by/Image/img99_14747s.jpg</picture>

<name>Смартфон Nokia 3310</name>

<importer></importer>

<country_of_origin>Республика Беларусь</country_of_origin>

<manufacturer>ООО Лучший производитель, г. Минск, ул. Кальварийская, 17</manufacturer>

<warranty-days>P2Y6M10D</warranty_days>

</offer>

Произвольный

название товара формирует система Shop.by склейкой данных из тегов (полей) <typePrefix>,<vendor>,<model> для конкретного товара.

Чтобы система использовала этот вариант, необходимо для <offer> передавать параметр type=”vendor.model”.

Пример полного описания товара в произвольном виде:

<offer id="99" type=”vendor.model” available="true">

<url>http://bestbestbest.shop.by/UID_99.html</url>

<price>900</price>

<oldprice>1000</oldprice>

<currencyId>BYN</currencyId>

<categoryId>11</categoryId>

<picture>http://bestbestbest.shop.by/Image/img99_14747s.jpg</picture>

<typePrefix>Смартфон</typePrefix>

<vendor>Nokia</vendor>

<model>3310</model>

<importer></importer>

<country_of_origin>Республика Беларусь</country_of_origin>

<manufacturer>ООО Лучший производитель, г. Минск, ул. Кальварийская, 17</manufacturer>

<warranty-days>P2Y6M10D</warranty_days>

</offer>

Если вы используете для товара type=”vendor.model”, тег <name> игнорируется.

Описание тегов (полей) для YML

Элемент (тег)	Пример кода	Описание	Обязательность
xml header	`<?xml version="1.0" encoding="UTF-8"?>`	Стандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа.	Обязательный
yml_catalog	`<yml_catalog date="2015-03-08 08:00">`	Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент <yml_catalog> с атрибутом date. Атрибут date: Дата и время момента, на который актуальны данные в файле. Внимание! Убедитесь, что указываете в файле правильные дату и время в формате YYYY-MM-DD HH:MM. Если формат времени будет некорректным, данные не будут обновлены. Рекомендуется всегда заполнять атрибут date. Если файл генерируется автоматически, желательно указывать дату и время начала генерации.	Обязательный
shop	`<shop>`	В элементе shop содержатся: элементы с информацией о магазине: названием, списком категорий и т. п. Подробнее см. в разделе ЭЛЕМЕНТЫ В ТЕГЕ <shop>. элемент <offers> со списком предложений магазина. В этот элемент нужно вставить по одному элементу offer для каждого предложения.	Обязательный
ЭЛЕМЕНТЫ В ТЕГЕ <shop>
name	`<name>Magazin</name>`	Короткое название магазина. Не публикуется на сайте	Обязательный
company	`<company>Magazin</company>`	Полное наименование компании, владеющей магазином. Не публикуется.	Обязательный
url	`<url>https://bestbestbest.shop.by/</url>`	URL главной страницы магазина. Допускаются кириллические ссылки.	Обязательный
currencies	`<currencies>` `<currency id="BYN" rate="1"/>` `<currency id="USD" rate="2.6"/>` `</currencies>`	Список курсов валют магазина. Должен быть перед списком предложений (offers). Основной валютой прайс-листа должен быть белорусский рубль. Множитель курса (rate) указывает соотношение между стоимостью данной валюты и основной валютой (BYN), взятой за единицу.	Обязательный
categories	`<categories>` `<category id="1">Главная</category>` `<category id="10" parentId="1">Телефоны</category>` `<category id="11" parentId="1">Телевизоры</category>` `</categories>`	Список категорий магазина. Обязательно должен быть перед списком предложений (offers). Где используются категории в прайсе: - в Вашем Личном кабинете будет отображаться структура каталога, сформированная из этих категорий. - при классификации товаров название категории будет использовано для привязки товара к типу на Shop.by	Обязательный
offers	`<offers>`	Список предложений магазина. Каждое предложение описывается в отдельном элементе offer.	Обязательный
ЭЛЕМЕНТЫ В ТЕГЕ <offer>
id	`<offer id="59" available="true">`	Уникальный идентификатор товара. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов. В прайсе не должно быть товаров с одинаковым id. Рекомендуем не изменять id товара от загрузки к загрузке: это ускорит обработку прайса и сохранит результаты уже проведенной автоматической и ручной классификации.	Обязательный
available	`<offer id="59" available="true">`	С помощью элемента available, delivery-days и order-before (см. delivery-options) формируются данные для отметки о сроках доставки на товаре. order-before указывает, до которого часа можно оформить заказ, чтобы срок доставки начал отсчитываться с сегодняшнего дня. Если order-before не заполнен или равен 0, срок доставки будет считается со следующего дня. available=true и нет тега delivery-days/order-before - нет отметки о сроках доставки на Shop.by available=true + delivery-days - Отметка "Доставка+дата доставки с учетом order-before" available=false + delivery-days - Отметка "Доставка+дата доставки с учетом order-before" available=false и нет тега delivery-days - Отметка "Доставка+дата, которая будет через 30 дней"	Обязательный
type	`<offer id="59" type="vendor.model" available="true">`	Параметр, указывающий на тип YML. Если задан type="vendor.model", название товара на Shop.by будет формироваться из тегов <typePrefix>+<vendor>+<model>. Если не указан, будет использоваться название товара из тега <name>.	Обязательный для произвольного типа YML
delivery-options	`<delivery-options>` `<option days="4" order-before="18"/>` `</delivery-options>`	Срок доставки товара. См описание <available> days - целое положительное число order-before - целое число от 0 до 24. Указывает, до которого часа можно оформить заказ, чтобы срок доставки начал отсчитываться с сегодняшнего дня. Наример, Вы указали в прайсе: `<delivery-options>` `<option days="1"` `order-before="14"/>` `</delivery-options>` До 14.00 покупатель увидит для такого товара отметку "Доставка сегодня", после 14.00 - "Доставка завтра".	Обязательный
name	`<name>Мобильный телефон Lenovo P780 (4Gb)</name>`	Используется при УПРОЩЕННОМ ТИПЕ YML. Полное название товара, в которое входит: тип товара, производитель, модель и название товара, важные характеристики. Составляйте по схеме: что (тип товара) + кто (производитель) + товар (модель, название) + важные характеристики. Данные в name влияют на привязку к карточке товара.	Обязательный для упрощенного типа YML
typePrefix	`<typePrefix>Мобильный телефон</typePrefix>`	Название категории, к которой относится товар (тип товара)	Обязательныйо для произвольного типа YML
vendor	`<vendor>Lenovo</vendor>`	Название производителя/бренда	Обязательный для произвольного типа YML
model	`<model>P780 (4Gb)</model>`	Название модели товара	Обязательный для произвольного типа YML
url	`<url>https://bestbestbest.shop.by/UID_59.html</url>`	URL страницы товара на сайте магазина.	Необязательный для тарифа PROцент, т.к. на этом тарифе нет перехода с Shop.by на сторонний сайт магазина. Вы получаете только заказы.
price	`<price>250</price>`	Актуальная цена товара. Формат: целое или дробное число. Разделитель целой и дробной части — точка. Цена должна соответствовать стоимости товара, в случае несоответствия цены товара в прайсе цене товара на сайте магазина размещение наShop.by будет заблокировано за нарушение Договора и Регламента. Товары с 0 ценой не отображаются на Shop.by	Обязательный
oldprice	`<oldprice>300</oldprice>`	Старая цена товара (цена до скидки), должна быть выше цены в <price>. Если Вы включили отображение цен со скидками на Shop.by, мы автоматически рассчитываем разницу и показываем пользователям скидку. Если не включили - данные из этого поля не используются.	Необязательный
currencyId	`<currencyId>BYN</currencyId>`	Валюта, в которой указана цена товара. Цена и валюта должны соответствовать друг другу. Например, вместе с USD надо указывать цену в долларах, а не в рублях. Примечание. При показе цены покупателю она будет пересчитана в BYN по курсу, который вы указали в теге currencies	Обязательный
categoryId	`<categoryId>10</categoryId>`	Идентификатор категории, к которой относится товар. Идентификатор должен быть заявлен в теге <categories>	Обязательный
picture	`<picture>https://bestbestbest.shop.by/Image/img59_14747s.jpg</picture>`	URL-ссылка на картинку товара. Допустимые форматы jpg, png, webp. Изображение должно соответствовать требованиям законодательства Республики Беларусь. Картинка должна соответствовать товару, для которого она передается. Картинка не должна содержать адреса и название сайта, торговых объектов, телефоны и другие контактные данные.	Обязательный
description	`<description>` `<![CDATA[<p>Отличный подарок для любителей венских вафель.</p>]]>` `</description>` или `<description>Отличный подарок для любителей венских вафель.` `</description>`	Описание товара. В описании запрещено указывать адреса и названия сайтов и торговых объектов, телефоны и другие контактные данные. В формате YML допустимо использовать некоторые xhtml-теги при условии, что они заключены в блок CDATA и соблюдены общие правила стандарта XHTML.	Необязательный
param	`<param name="Производитель">Lenovo</param>` `<param name="Автофокус">Есть</param>` `<param name="Диагональ экрана">5.0</param>`	Все важные характеристики товара — цвет, размер, объем, материал, вес, возраст, пол, и т. д. Элемент не должен быть пустым. В YML элемент offer может содержать несколько элементов param (один элемент param — одна характеристика). Используется на Shop.by в типах без моделей для привязки Ваших товаров к фильтрам по характеристикам товаров. Правильно заполненные param повышают позиции Ваших товаров в таких типах и эффективность размещения.	Для части категорий является обязательным элементом.
market_category	`<market_category>Мобильные телефоны</market_category>`	Название типа на Shop.by, к которому нужно привязать Ваш товар	Необязательный
importer	`<importer>ООО Лучший импортер, г. Минск, ул. Кальварийская, 17</importer>`	Если товар импортирован, в поле указывается полное наименование и место нахождения организации, осуществляющей деятельность по ввозу товаров на территорию Республики Беларусь. Если товар белорусского производства, поле оставляем пустым.	Обязательный, если товар импортирован в Беларусь. Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли".
country_of_origin	`<country_of_origin>Республика Беларусь</country_of_origin>`	Страна происхождения товаров	Обязательный, если страна происхождения товаров не совпадает с местом нахождения (местом жительства) Изготовителя <manufacturer> Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"
manufacturer	`<manufacturer>ООО ВБ, г. Москва, ул. Красная площадь, 17</manufacturer>`	Полное наименование и место нахождения изготовителя товара	Обязательный. Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"
warranty-days	`<warranty-days>P2Y2M10D</warranty-days>`	Гарантийный срок, если установлен. Например, `P2Y` — 2 года; `P2Y6M` — 2 года и 6 месяцев; `P15D` — 20 дней; `P2Y10D` — 2 года, 10 дней; `P2Y6M10D` — 2 года, 6 месяцев и 10 дней.	Обязательный, если гарантийный срок установлен. Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"

Пример итоговой структуры YML

<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE yml_catalog SYSTEM "shops.dtd">

<yml_catalog date="2022-02-02 08:00">

<shop>

<name>Magazin</name>

<company>Magazin</company>

<url>https://bestbestbest.by/</url>

<currencies>

<currency id="BYN" rate="1"/>

</currencies>

<categories>

<category id="1">Главная</category>

<category id="10" parentId="1">Телефоны</category>

<category id="11" parentId="1">Телевизоры</category>

</categories>

<offers>

<offer id="59" type="vendor.model" available="true">

<url>https://bestbestbest.by/UID_59.html</url>

<delivery-options>

<option days="4" order-before="18"/>

</delivery-options>

<price>250</price>

<oldprice>300</oldprice>

<currencyId>BYN</currencyId>

<categoryId>10</categoryId>

<market_category>Мобильные телефоны</market_category>

<picture>https://bestbestbest.by/Image/img59_14747s.jpg</picture>

<typePrefix>Мобильный телефон</typePrefix>

<vendor>Lenovo</vendor>

<model>P780 (4Gb)</model>

<description>Полная русификация. Заводская комплектация.</description>

<param name="Производитель">Lenovo</param>

<param name="Автофокус">Есть</param>

<param name="Диагональ экрана">5.0</param>

<importer></importer>

<country_of_origin>Республика Беларусь</country_of_origin>

<manufacturer>ООО Лучший производитель, г. Минск, ул. Кальварийская, 17</manufacturer>

<warranty-days>P1Y</warranty-days>

</offer>

<offer id="60" available="true">

<url>https://bestbestbest.by/UID_60.html</url>

<price>700</price>

<currencyId>BYN</currencyId>

<categoryId>10</categoryId>

<market_category>Мобильные телефоны</market_category>

<picture>https://bestbestbest.by/Image/img60_14747s.jpg</picture>

<name>Мобильный телефон Sony Xperia Z2</name>

<description>Черный. Полная русификация. Заводская комплектация.</description>

<importer>ООО Лучший импортер, г. Минск, Кальварийская, 17</importer>

<country_of_origin>Россия</country_of_origin>

<manufacturer>ООО Российский производитель, г. Москва, ул. Бронная, 17</manufacturer>

<warranty-days>P1Y</warranty-days>

</offer>

<offer id="99" available="true">

<url>https://bestbestbest.by/UID_99.html</url>

<price>900</price>

<oldprice>1000</oldprice>

<currencyId>BYN</currencyId>

<categoryId>11</categoryId>

<picture>https://bestbestbest.by/Image/img99_14747s.jpg</picture>

<name>Led телевизор Samsung UE40H6400</name>

<importer>ООО Лучший импортер, г. Минск, Кальварийская, 17</importer>

<country_of_origin>Россия</country_of_origin>

<manufacturer>ООО Российский производитель, г. Москва, ул. Бронная, 17</manufacturer>

<warranty-days>P1Y</warranty-days>

</offer>

<offer id="100" available="true">

<url>https://bestbestbest.by/UID_100.html</url>

<price>900</price>

<currencyId>BYN</currencyId>

<categoryId>11</categoryId>

<picture>https://bestbestbest.by/Image/img100_14747s.jpg</picture>

<name>Led телевизор LG 47LB671V</name>

<importer>ООО Лучший импортер, г. Минск, Кальварийская, 17</importer>

<country_of_origin>Россия</country_of_origin>

<manufacturer>ООО Российский производитель, г. Москва, ул. Бронная, 17</manufacturer>

<warranty-days>P1Y</warranty-days>

</offer>

</offers>

</shop>

</yml_catalog>

Подробное описание XML

Здесь мы описываем теги (поля), которые могут быть использованы при импорте в формате XML.

Описание тегов (полей) для XML

Элемент (тег)	Пример кода	Описание	Обязательность
xml header	`<?xml version="1.0" encoding="UTF-8"?>`	Стандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа.	Обязательный
items-list	`<items-list>`	Список предложений магазина. Каждое предложение описывается в отдельном элементе item.	Обязательный
ЭЛЕМЕНТЫ В ТЕГЕ <item>
id	`<id>59</id>`	Уникальный идентификатор товара. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов. В прайсе не должно быть товаров с одинаковым id. Рекомендуем не изменять id товара от загрузки к загрузке: это ускорит обработку прайса и сохранит результаты уже проведенной автоматической и ручной классификации.	Обязательный
delivery-days	`<delivery-days>5</delivery-days>`	С помощью элементов delivery-days и order-before формируются данные для отметки о сроках доставки на товаре. нет тега delivery-days - нет отметки о сроках доставки на Shop.by delivery-days + order-before - см. описание order-before delivery-days без order-before - Отметка "Доставка+дата доставки" по принципу: сегодня + количество дней из delivery-days Например, delivery-days=1 без order-before - Отметка "Доставка завтра"	Обязательный
order-before	`<order-before>14</order-before>`	Работает совместно с тегом delivery-days order-before - целое число от 0 до 24. Указывает, до которого часа можно оформить заказ, чтобы срок доставки начал отсчитываться с сегодняшнего дня. Наример, Вы указали в прайсе: <delivery-days>1</delivery-days> <order-before>14</order-before> До 14.00 покупатель увидит для такого товара отметку "Доставка сегодня", после 14.00 - "Доставка завтра".	Необязательный
name	`<name>Мобильный телефон Lenovo P780 (4Gb)</name>`	Полное название товара, в которое входит: тип товара, производитель, модель и название товара, важные характеристики. Составляйте по схеме: что (тип товара) + кто (производитель) + товар (модель, название) + важные характеристики. Данные в name влияют на привязку к карточке товара.	Обязательный
url	`<url>http://bestbestbest.shop.by/UID_59.html</url>`	Можно добавить URL страницы товара на сайте Вашего магазина, если он у Вас есть	Необязательный для тарифа PROцент, т.к. на этом тарифе нет перехода с Shop.by на сторонний сайт магазина. Вы получаете только заказы.
price	`<price>250</price>`	Актуальная цена товара. Формат: целое или дробное число. Разделитель целой и дробной части — точка. Цена должна соответствовать стоимости товара, в случае несоответствия цены товара в прайсе цене товара на сайте магазина размещение на Shop.by будет заблокировано за нарушение Договора и Регламента. Товары с 0 ценой не отображаются на Shop.by	Обязательный
oldprice	`<oldprice>300</oldprice>`	Старая цена товара (цена до скидки), должна быть выше цены в <price>. Если Вы включили отображение цен со скидками на Shop.by, мы автоматически рассчитываем разницу и показываем пользователям скидку. Если не включили - данные из этого поля не используются.	Необязательный
currency	`<currency>BYN</currency>`	Валюта, в которой указана цена товара. Допустимы цены только в BYN	Обязательный
category	`<category>Телефоны</category>`	Название категории, к которой относится товар.	Обязательный
picture	`<picture>https://bestbestbest.shop.by/Image/img59_14747s.jpg</picture>`	URL-ссылка на картинку товара. Допустимые форматы jpg, png, webp. Изображение должно соответствовать требованиям законодательства Республики Беларусь. Картинка должна соответствовать товару, для которого она передается. Картинка не должна содержать адреса и название сайта, торговых объектов, телефоны и другие контактные данные.	Обязательный
description	`<description>` `<![CDATA[<p>Отличный подарок для любителей венских вафель.</p>]]>` `</description>` или `<description>Отличный подарок для любителей венских вафель.` `</description>`	Описание товара. В описании запрещено указывать адреса и названия сайтов и торговых объектов, телефоны и другие контактные данные. В формате XML допустимо использовать некоторые xhtml-теги при условии, что они заключены в блок CDATA и соблюдены общие правила стандарта XHTML.	Необязательный
importer	`<importer>ООО Лучший импортер, г. Минск, ул. Кальварийская, 17</importer>`	Если товар импортирован, в поле указывается полное наименование и место нахождения организации, осуществляющей деятельность по ввозу товаров на территорию Республики Беларусь. Если товар белорусского производства, поле оставляем пустым.	Обязательный, если товар импортирован в Беларусь. Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли".
country_of_origin	`<country_of_origin>Республика Беларусь</country_of_origin>`	Страна происхождения товаров	Обязательный, если страна происхождения товаров не совпадает с местом нахождения (местом жительства) Изготовителя <manufacturer> Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"
manufacturer	`<manufacturer>ООО ВБ, г. Москва, ул. Красная площадь, 17</manufacturer>`	Полное наименование и место нахождения изготовителя товара	Обязательный. Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"
warranty_days	`<warranty_days>P2Y2M10D</warranty_days>`	Гарантийный срок, если установлен. Например, `P2Y` — 2 года; `P2Y6M` — 2 года и 6 месяцев; `P15D` — 20 дней; `P2Y10D` — 2 года, 10 дней; `P2Y6M10D` — 2 года, 6 месяцев и 10 дней.	Обязательный, если гарантийный срок установлен. Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"
market_category	`<market_category>Мобильные телефоны</market_category>`	Название типа на Shop.by, к которому нужно привязать Ваш товар	Необязательный

Пример итоговой структуры XML

<?xml version="1.0" encoding="utf-8"?><price-list version="1.0">

<items-list>

<item>

<id>59</id>

<url></url>

<price>250</price>

<oldprice>300</oldprice>

<currency>BYN</currency>

<category>Телефоны</category>

<market_category>Мобильные телефоны</market_category>

<picture>http://bestbestbest.shop.by/Image/img59_14747s.jpg</picture>

<name>Мобильный телефон Lenovo P780 (4Gb)</name>

<delivery-days>2</delivery-days>

<order-before>14</order-before>

<description>Полная русификация. Заводская комплектация.</description>

</item>

<item>

<id>60</id>

<url>http://bestbestbest.shop.by/UID_60.html</url>

<price>700</price>

<currency>BYN</currency>

<category>Телефоны</category>

<picture>http://bestbestbest.shop.by/Image/img60_14747s.jpg</picture>

<name>Мобильный телефон Sony Xperia Z2</name>

<delivery-days>5</delivery-days>

<order-before>14</order-before>

<description>Черный. Полная русификация. Заводская комплектация.</description>

<importer></importer>

<country_of_origin>Республика Беларусь</country_of_origin>

<manufacturer>ООО Лучший производитель, г. Минск, ул. Кальварийская, 17</manufacturer>

<warranty_days></warranty_days>

</item>

<item>

<id>99</id>

<url>http://bestbestbest.shop.by/UID_99.html</url>

<price>900</price>

<oldprice>1000</oldprice>

<currency>BYN</currency>

<category>Телевизоры</category>

<picture>http://bestbestbest.shop.by/Image/img99_14747s.jpg</picture>

<name>Led телевизор Samsung UE40H6400</name>

<importer>ООО Лучший импортер, г. Минск, ул. Кальварийская, 17</importer>

<country_of_origin>Россия</country_of_origin>

<manufacturer>ООО ВБ, г. Москва, ул. Красная площадь, 17</manufacturer>

<warranty_days>P2Y2M10D</warranty_days>

</item>

<item>

<id>100</id>

<url>http://bestbestbest.shop.by/UID_100.html</url>

<price>900</price>

<currency>BYN</currency>

<category>Телевизоры</category>

<picture>http://bestbestbest.shop.by/Image/img100_14747s.jpg</picture>

<name>Led телевизор LG 47LB671V</name>

<importer>ООО Лучший импортер, г. Минск, ул. Кальварийская, 17</importer>

<country_of_origin>Россия</country_of_origin>

<manufacturer>ООО ВБ, г. Москва, ул. Красная площадь, 17</manufacturer>

<warranty_days>P2Y2</warranty_day>

</item>

</items-list></price-list>

Подробное описание CSV

CSV - это текстовый файл, в котором содержится информация. Каждая строка - это отдельная строка таблицы, а столбцы отделены один от другого специальными символами - разделителями (для Shop.by - точка с запятой).

Важно! В значениях полей не должны содержаться “;” и переносы строк. Это может привести к некорректной обработке файла.

Дополнительные, не описанные в данной документации поля, присутствующие в файле, будут проигнорированы во время импорта.

Описание полей для CSV

Заголовок столбца	Пример значения	Описание	Обязательность
id	`59`	Уникальный идентификатор товара. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов. В прайсе не должно быть товаров с одинаковым id. Рекомендуем не изменять id товара от загрузки к загрузке: это ускорит обработку прайса и сохранит результаты уже проведенной автоматической и ручной классификации.	Обязательный
available	`true или false`	С помощью элементов available, delivery_days и order_before формируются данные для отметки о сроках доставки на товаре. - delivery_days указывает количество дней доставки - order-before указывает, до которого часа можно оформить заказ, чтобы срок доставки начал отсчитываться с сегодняшнего дня. Если order-before не заполнен или равен 0, срок доставки будет считается со следующего дня. available=true и нет тега delivery-days и order-before - нет отметки о сроках доставки на Shop.by available=true + delivery-days - Отметка "Доставка+дата доставки с учетом order-before" available=false + delivery-days - Отметка "Доставка+дата доставки с учетом order-before" available=false и нет тега delivery-days - Отметка "Доставка+дата, которая будет через 30 дней"	Обязательный
delivery_days	целое число или пусто	Срок доставки товара. См описание available	Необязательный
order_before	целое число от 0 до 24.	Работает совместно с delivery_days и avaliable Указывает, до которого часа можно оформить заказ, чтобы срок доставки начал отсчитываться с сегодняшнего дня. Наример, Вы указали в прайсе: delivery-days=1 order-before=14 До 14.00 покупатель увидит для такого товара отметку "Доставка сегодня", после 14.00 - "Доставка завтра".	Необязательный
name	`Мобильный телефон Lenovo P780 (4Gb)`	Полное название товара, в которое входит: тип товара, производитель, модель и название товара, важные характеристики. Составляйте по схеме: что (тип товара) + кто (производитель) + товар (модель, название) + важные характеристики. Данные в name влияют на привязку к карточке товара.	Обязательный
url	`https://bestbestbest.shop.by/UID_59.html`	Можно добавить URL страницы товара на сайте Вашего магазина, если он у Вас есть	Необязательный
price	`250`	Актуальная цена товара. Формат: целое или дробное число. Разделитель целой и дробной части — точка. Товары с 0 ценой не отображаются на Shop.by	Обязательный
oldprice	`300`	Старая цена товара (цена до скидки), должна быть выше цены в price. Если Вы включили отображение цен со скидками на Shop.by, мы автоматически рассчитываем разницу и показываем пользователям скидку. Если не включили - данные из этого поля не используются.	Необязательный
currencyId	`BYN`	Валюта, в которой указана цена товара. Допустимы цены только в BYN	Обязательный
category	`Телефоны`	Название категории, к которой относится товар.	Обязательный
picture	`https://bestbestbest.shop.by/Image/img59_14747s.jpg`	URL-ссылка на картинку товара. Допустимые форматы jpg, png, webp. Изображение должно соответствовать требованиям законодательства Республики Беларусь. Картинка должна соответствовать товару, для которого она передается. Картинка не должна содержать адреса и название сайта, торговых объектов, телефоны и другие контактные данные.	Обязательный
description	`Отличный подарок для любителей венских вафель.`	Описание товара. В описании запрещено указывать адреса и названия сайтов и торговых объектов, телефоны и другие контактные данные.	Необязательный
importer	`ООО Лучший импортер, г. Минск, ул. Кальварийская, 17`	Если товар импортирован, в поле указывается полное наименование и место нахождения организации, осуществляющей деятельность по ввозу товаров на территорию Республики Беларусь. Если товар белорусского производства, оставляем поле пустым.	Обязательный, если товар импортирован в Беларусь Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"
country_of_origin	`Республика Беларусь`	Страна происхождения товаров	Обязательный, если страна происхождения товаров не совпадает с местом нахождения (местом жительства) Изготовителя <manufacturer> Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"
manufacturer	`ООО ВБ, г. Москва, ул. Красная площадь, 17`	Полное наименование и место нахождения изготовителя товара	Обязательный. Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"
warranty_days	`P2Y2M10D`	Гарантийный срок, если установлен. Например, `P2Y` — 2 года; `P2Y6M` — 2 года и 6 месяцев; `P15D` — 15 дней; `P2Y10D` — 2 года, 10 дней; `P2Y6M10D` — 2 года, 6 месяцев и 10 дней.	Обязательный, если гарантийный срок установлен Требование постановления Совета Министров Республики Беларусь от 15.01.2009 N 31 (ред. от 29.07.2024) "Об утверждении Правил продажи товаров при осуществлении дистанционной торговли"
market_category	`Мобильные телефоны`	Название типа на Shop.by, к которому нужно привязать Ваш товар	Необязательный

Пример итоговой структуры CSV

available

url

price

oldprice

currencyId

delivery_days

order_before