Введите ваш вопрос

Импорт через Excel - формат файлов XLS(X) и CSV

Импорт товаров и услуг на сайт компании и на портал, а также экспорт с сайта и с портала может быть выполнен в одном из следующих форматов:

  • электронная таблица Excel, файл в формате XLS, XLSX или CSV (описание этого формата импорта/экспорта см. ниже);
  • файл YML.

Как сделать успешный импорт?

Пошаговые рекомендации для корректного импорта:

Как выполнить экспорт?

О том, как экспортировать товары с сайта вашей компании см. документ Экспорт товаров и групп товаров

Описание формата импорта и экспорта XLS/XLSX и CSV

Внимание!

  • Формат файла импорта совпадает с форматом файла экспорта, не зависит от расширения файла XLS, XLSX или CSV и описан ниже.
  • Файл импорта/экспорта в формате XLS, XLSX содержит две вкладки — «Export Products Sheet» (описание самих товаров) и «Export Groups Sheet» (описание структуры товарных групп).
  • Файл импорта/экспорта в формате CSV содержит только одну вкладку.
  • Для успешного импорта необходимо заполнить все обязательные поля в файле импорта, а на вкладке «Export Groups Sheet» нужно указать правильную структуру групп компании.
  • Первая строка таблицы в файле импорта всегда должна содержать заголовки полей, указанные ниже (столбец «Название поля» в таблице).
  • Каждая строка файла импорта на вкладке «Export Products Sheet» содержит описание только одной товарной позиции или услуги.
  • В таблице должны быть заполнены все обязательные поля («Название_позиции», «Описание», «Идентификатор_товара»).

Товары и услуги: вкладка «Export Products Sheet»

Название поля Формат данных Описание значения
Код_товара строка до 25 символов Код товара (артикул) необходим для быстрого и удобного поиска нужной позиции на сайте компании и в личном кабинете при телефонном обращении клиента. Длина артикула ― 25 символов (цифры, кириллица, латиница, знаки «-», «_», «.», «/» и пробел).
Название_позиции строка до 100 символов Наименование товара или услуги.
Обязательное поле.
Поисковые_запросы строка до 255 символов

Поисковые запросы используются для поиска в каталоге портала. Обязательное поле.
Содержит поисковые запросы для позиции, перечисленные через запятую (не более 255 символов). Длина каждого слова не больше 50 символов.

Описание строка до 12160 символов

Описание данного товара или услуги.
Обязательное поле.

Тип_товара строка Поле определяет принадлежность товара к оптовым, розничным или услугам. Для правильного определения рекомендуется задавать название категории и принадлежность товара.
r ― товар продается только в розницу
w ― товар продается только оптом
u ― товар продается оптом и в розницу
s ― услуга
Цена число Цена товара или услуги
Цена от строка

Поле определяет установлена ли для товара "цена от". Принимает одно из двух значений:

  • + — установлена "цена от";
  • - — не установлена "цена от".
Валюта строка Валюта, денежная единица цены
UAH | USD | EUR | CHF | RUB | GBP | JPY | PLZ | другая | BYN | KZT | MDL | р | руб | дол | $ | грн
Единица_измерения строка Единица измерения
2г | 5г | 10 г | 50 г | 100г | 10см | шт. | 10 шт. | 20 шт. | 50 шт. | 100 шт. | ампула | баллон | банка | блистер | бобина | бочка | бут | бухта | ватт | ведро | выезд | г | га | гигакалория | год | гр/кв.м | дал | два месяца | день | доза | ед. | кВт | канистра | карат | кв.дм | кв.м | кв.см | кв.фут | квартал | кг | кг/кв.м | км | комплект | коробка | куб.дм | куб.м | л | лист | м | мВт | месяц | мешок | минута | мл | мм | моток | набор | неделя | номер | объект | паллетоместо | пара | партия | пач | пог.м | полгода | посевная единица | птицеместо | рейс | рулон | секция | слово | см | смена | сотка | стакан | страница | сутки | т | т.у.шт. | т/км | таблетка | тираж | тыс. шт. | тысяча | тюбик | упаковка | услуга | флакон | час | чел. | шприц-туба | ярд | ящик
Минимальный_объем_заказа число Минимальный объем заказа
Оптовая_цена число Оптовые цены, разделённые символом "точка с запятой" ― ';'
Минимальный_заказ_опт число Минимальный объем заказа соответствующий оптовым ценам, также разделен ';'
Количество число Используется для указания остатка товаров на складе.
Ссылка_изображения строка

Ссылка на изображение в интернете (URL). Ссылок может быть несколько. Разделять необходимо запятыми с пробелом (пример: http://example.com/box.gif, http://example.com/box-foto2.gif)
Первое изображение из списка считается основным и будет отображаться в каталоге.

Обратите внимание: можно импортировать изображения с Google Диска. Для этого нужно дать доступ к файлу изображения адресу import@uaprom-prod-1495098375216.iam.gserviceaccount.com.

Наличие строка

Наличие товара на складе
"+" — есть в наличии
"!" — гарантия наличия (для сертифицированных компаний)
"-" — нет в наличии
"&" — ожидается
"@" — услуга
цифра, например, "9" — кол-во дней на доставку, если товар под заказ
Важно! При пустом поле статус вашего товара станет «Нет в наличии».

Скидка Положительное число или число с % Если у товара есть скидка, в данном поле указывается величина скидки или процент. Пример: 12.5, 30%.

Cрок действия скидки от

дата Дата начала действия скидки.
Cрок действия скидки до дата Дата окончания действия скидки.
Ярлык строка Ярлык товара. Если в файле заполнена колонка «Ярлык», то его значение будет всегда обновляться, даже если настройка «Обновить принудительно» не выставлена.
Производитель строка до 255 символов

Бренд, торговая марка или название предприятия-производителя, под знаком которого изготовлен товар (возможно значение «Собственное производство»). Название производителя импортируется в описание характеристик товара, поле «Производитель».

Внимание! Указываемый вами производитель будет импортирован, если он есть в базе производителей портала. Проверить наличие производителя или добавить нового производителя можно при добавлении/редактировании товара.

Страна_производитель строка до 255 символов Импортируется в описание характеристик товара, поле «Страна производитель».
HTML_заголовок строка до 250 символов

HTML-заголовок SEO-настроек товара

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

Если все SEO-поля заданы и соответствуют требованиям, тогда автоматически будет установлена настройка «Использовать свои настройки». Если все поля не соответствуют требованиям или не заданы, устанавливается настройка «Значения по умолчанию по шаблонам».

HTML_описание строка до 250 символов HTML-описание SEO-настроек товара
HTML_ключевые_слова строка до 250 символов HTML-ключевые слова SEO-настроек товара
Подарки строка Номера строк в текущем файле тех товаров, которые являются подарками. Номера указываются через точку с запятой (например, 3;4). Могут указываться не только для основного товара, но и для разновидностей.
Сопутствующие строка Номера строк в текущем файле тех товаров, которые являются сопутствующими. Номера указываются через точку с запятой (например, 3;4). Могут указываться не только для основного товара, но и для разновидностей.
Номер_группы число Позволяет помещать товар в конкретную группу у вас на сайте.
Название_группы строка до 255 символов Название группы товаров/услуг. Данное поле не импортируется при загрузке файла на сайт компании.
Адрес_подраздела строка Адрес подраздела каталога. Например, для раздела «Ноутбуки»: http://prom.ua/Noutbuki. Для удобства вы можете воспользоваться поиском или рубрикатором и выбрать конечный раздел товара.
Возможность_поставки число Возможные объемы поставок
Срок_поставки строка Период измерения возможных объемов поставок
день | неделя | месяц | квартал | год
Способ_упаковки строка до 500 символов Способ упаковки товара
Личные_заметки строка Личные заметки через запятую
Продукт_на_сайте строка Адрес продукта на сайте компании
Код_маркировки_(GTIN) строка Международный код маркировки и учёта логистических единиц (GTIN) для фида Google Merchant Center
Номер_устройства_(MPN) строка Уникальный (каталожный) номер устройства (MPN) для фида Google Merchant Center
Идентификатор_товара строка до 255 символов Идентификатор необходим для однозначного сопоставления товара в файле импорта с этим-же товаром на сайте компании. Может содержать символы и числа.
Обязательное поле.
Уникальный_идентификатор Положительное число Уникальный идентификатор товара ― служебная информация, которая используется для идентификации товара или услуги исключительно на нашем портале. Данный идентификатор заполняется автоматически при экспорте и не должен изменяться вручную. Значение уникального идентификатора ― число, которое можно найти в ссылке на товар на портале или на сайте компании.
Идентификатор_подраздела строка Техническая информация об идентификаторе подраздела. Не рекомендуется менять этот параметр никогда. Этот параметр заполняется автоматически при экспорте данных из нашей системы.
Идентификатор_группы строка Техническая информация об идентификаторе группы товаров в вашей системе. Указывает на категорию товара/услуги на внешнем сайте вашей компании или в другой системе. Используется в системе импорта из XML и YML файлов. Это поле будет использоваться при выгрузке данных из каталога портала и импорте обратно в вашу систему.
ID_группы_разновидностей строка Идентификатор разновидности товара. Все товары с одним и тем же номером «ID_группы_разновидностей» и заполненными полями «Название_Характеристики» и «Значение_Характеристики» считаются разновидностями основного товара. Основной товар при этом имеет тот же номер «ID_группы_разновидностей», что и разновидности, но поля «Название_Характеристики» и «Значение_Характеристики» у основного товара не заполнены.
Название_Характеристики строка

Название характеристики товара из категории, в которой размещается товар, или название пользовательской характеристики. Скопировать точное название характеристики категории можно из блока «Характеристики» на странице добавления/ редактирования товара или перейдя в соответствующую категорию на портале: смотреть пример. Пример названия характеристики категории для товара из категории «Кресла для руководителей»: Количество колесиков. Чтобы добавить несколько характеристик, скопируйте этот столбец вместе со столбцами «Измерение_Характеристики» и «Значение_Характеристики» несколько раз. Порядок указания характеристик не имеет значения (характеристики категории могут идти вперемешку с пользовательскими характеристиками).

Внимание! В файле импорта стоблцы описания каждой отдельной характеристики должны всегда следовать в таком порядке: «Название_Характеристики», «Измерение_Характеристики», «Значение_Характеристики».

Примечание: Описанный в этой инструкции формат импорта характеристик является третьей по счету версией. На портале поддерживается обратная совместимость форматов импорта — характеристики, описанные в файле импорта в одном из предыдущих форматов, будут успешно импортированы. Однако экспорт характеристик всегда выполняется в новом, описанном здесь формате. Рекомендуем вам всегда описывать характеристики в файле импорта в соответствии с данными инструкциями.

Измерение_Характеристики строка

Единица измерения характеристики товара из категории, в которой размещается товар, или единица измерения пользовательской характеристики. Скопировать точное название единицы измерения характеристики категории можно из блока «Характеристики» на странице добавления/ редактирования товара или перейдя в соответствующую категорию на портале. Для пользовательских характеристик рекомендуем указывать стандартные единицы измерения: смотреть пример. Пример названия единицы измерения для товара из категории «Кресла для руководителей»: шт. Чтобы добавить несколько характеристик, скопируйте этот столбец вместе со столбцами «Название_Характеристики» и «Значение_Характеристики» несколько раз. Порядок указания характеристик не имеет значения (характеристики категории могут идти вперемешку с пользовательскими характеристиками).

Внимание! В файле импорта стоблцы описания каждой отдельной характеристики должны всегда следовать в таком порядке: «Название_Характеристики», «Измерение_Характеристики», «Значение_Характеристики». Даже если столбец «Измерение_Характеристики» не заполнен, он все равно должен присутствовать в файле импорта во избежание ошибок.

Примечание: Описанный в этой инструкции формат импорта характеристик является третьей по счету версией. На портале поддерживается обратная совместимость форматов импорта — характеристики, описанные в файле импорта в одном из предыдущих форматов, будут успешно импортированы. Однако экспорт характеристик всегда выполняется в новом, описанном здесь формате. Рекомендуем вам всегда описывать характеристики в файле импорта в соответствии с данными инструкциями.

Значение_Характеристики строка

Значение характеристики категории товара или значение пользовательской характеристики: смотреть пример. Значение характеристик может быть простым или множнственным. Пример множественного значения характеристики «Материал корпуса»: Алюминий, Пластмасса; для характеристки «Стандарт связи»: GSM, CDMA, EDGE. Значения множественных характеристик в файле импорта разделяются символом «|». Пример: «Алюминий|Пластмасса» или «GSM|CDMA|EDGE» (кавычки в файле импорта не нужны). Чтобы добавить несколько характеристик, скопируйте этот столбец вместе со столбцами «Название_Характеристики» и «Измерение_Характеристики» несколько раз. Порядок указания характеристик не имеет значения (характеристики категории могут идти вперемешку с пользовательскими характеристиками).

Внимание! В файле импорта стоблцы описания каждой отдельной характеристики должны всегда следовать в таком порядке: «Название_Характеристики», «Измерение_Характеристики», «Значение_Характеристики».

Примечание: Описанный в этой инструкции формат импорта характеристик является третьей по счету версией. На портале поддерживается обратная совместимость форматов импорта — характеристики, описанные в файле импорта в одном из предыдущих форматов, будут успешно импортированы. Однако экспорт характеристик всегда выполняется в новом, описанном здесь формате. Рекомендуем вам всегда описывать характеристики в файле импорта в соответствии с данными инструкциями.

Обратите внимание: блоков характеристик («Название_Характеристики», «Измерение_Характеристики»,  «Значение_Характеристики»)  может быть несколько, под каждую характеристику товара. Порядок блоков не важен. Рекомендуем размещать блоки характеристик в последних столбцах файла.

Группы: вкладка «Export Groups Sheet»

Название поля Формат данных Описание значения
Номер_группы Число Номер группы товаров/услуг на сайте компании. Номер группы можно найти в ссылке на группу:
http://example.com/g123456-test_group
Название_группы строка до 255 символов Название группы товаров/услуг
Идентификатор_группы Число Внешний идентификатор группы товаров/услуг (например, номер группы товаров в 1С).
Номер_родителя Число Номер родительской группы, в которую входит данная группа товаров/услуг. Если родительской для данной группы является корневая группа, это поле должно быть пустым.
Идентификатор_родителя Число Внешний идентификатор родительской группы, в которую входит данная группа товаров/услуг. Если родительской для данной группы является корневая группа, это поле должно быть пустым.
 
HTML_заголовок_группы строка до 250 символов

HTML-заголовок для SEO-настроек группы

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

Если все SEO-поля заданы и соответствуют требованиям, тогда автоматически будет установлена настройка «Использовать свои настройки». Если все поля не соответствуют требованиям или не заданы, устанавливается настройка «Значения по умолчанию по шаблонам».

HTML_описание_группы строка до 250 символов HTML-описание для SEO-настроек группы
HTML_ключевые_слова_группы строка до 250 символов HTML-ключевые слова для SEO-настроек группы