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

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

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

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

XML;
CSV.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры прайс-листов для тарифа PROцент тут.

Подробное описание 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 формируются данные для отметки о сроках доставки на товаре. нет тега delivery-days - нет отметки о сроках доставки на Shop.by delivery-days - Отметка "Доставка+дата доставки"	Обязательный
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>

<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>

<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 формируются данные для отметки о сроках доставки на товаре. available=true и нет тега delivery_days - нет отметки о сроках доставки на Shop.by available=true + delivery_days - Отметка "Доставка+дата доставки" available=false + delivery_days - Отметка "Доставка+дата доставки" available=false и нет тега delivery_days - Отметка "Доставка+дата, которая будет через 30 дней"	Обязательный
delivery_days	`целое число или пусто`	Срок доставки товара. См описание <available>	Обязательный
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