Импорт позиций через Excel — формат файлов XLS(X) и CSV
Импорт товаров и услуг на сайт компании и на портал, а также экспорт с сайта и с портала может быть выполнен в одном из следующих форматов:
- электронная таблица Excel, файл в формате XLS, XLSX или CSV (описание этого формата импорта/экспорта см. ниже);
- файл YML в формате Яндекс.Маркет (подробное описание этого формата импорта/экспорта см. в документе Импорт позиций через Яндекс.Маркет — формат файла 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@satu-kz-1495557377495.iam.gserviceaccount.com. |
| Наличие | строка | Наличие товара на складе «+» — есть в наличии «-» — нет в наличии «&» — ожидается «@» — услуга цифра, например, «9» — кол-во дней на доставку, если товар под заказ Важно! При пустом поле статус вашего товара станет «Нет в наличии».В случае импорта товаров с нулевыми остатками — статус товаров будет «Нет в наличии». |
| Скидка | Положительное число или число с % | Если у товара есть скидка, в данном поле указывается величина скидки или процент. Пример: 12.5, 30%. |
| Cрок действия скидки от | дата | Дата начала действия скидки. |
| Cрок действия скидки до | дата | Дата окончания действия скидки. |
| Ярлык | строка | Ярлык товара. Если в файле заполнена колонка «Ярлык», то его значение будет всегда обновляться, даже если настройка «Обновить принудительно» не выставлена. |
| Производитель | строка до 255 символов | Бренд, торговая марка или название предприятия-производителя, под знаком которого изготовлен товар (возможно значение «Собственное производство»). Название производителя импортируется в описание характеристик товара, поле «Производитель». Внимание! Указываемый вами производитель будет импортирован, если он есть в базе производителей портала. Проверить наличие производителя или добавить нового производителя можно при добавлении/редактировании товара. |
| Страна_производитель | строка до 255 символов | Импортируется в описание характеристик товара, поле «Страна производитель». |
| HTML_заголовок | строка до 250 символов | HTML-заголовок SEO-настроек товара Группа SEO-настроек товара доступна, если включено приложение «SEO-настройки». Если все SEO-поля заданы и соответствуют требованиям, тогда автоматически будет установлена настройка «Использовать свои настройки». Если все поля не соответствуют требованиям или не заданы, устанавливается настройка «Значения по умолчанию по шаблонам». |
| HTML_описание | строка до 250 символов | HTML-описание SEO-настроек товара |
| HTML_ключевые_слова | строка до 250 символов | HTML-ключевые слова SEO-настроек товара |
| Подарки | строка | Номера строк в текущем файле тех товаров, которые являются подарками. Номера указываются через точку с запятой (например, 3;4). Могут указываться не только для основного товара, но и для разновидностей. |
| Сопутствующие | строка | Номера строк в текущем файле тех товаров, которые являются сопутствующими. Номера указываются через точку с запятой (например, 3;4). Могут указываться не только для основного товара, но и для разновидностей. |
| ID_Подарков | строка | ID товаров, которые являются подарками. Номера указываются через точку с запятой (например, 1095011184;655298076). Если при экспорте установлена настройка «Экспортировать подарки», то приоритетным является это поле. Если в этом поле значение не указано, подарки берутся из поля «Подарки» по номеру строки в файле. Могут указываться не только для основного товара, но и для разновидностей.  |
| ID_Сопутствующих | строка | ID товаров, которые являются сопутствующими. Номера указываются через точку с запятой (например, 1095011184;655298076). Если при экспорте установлена настройка «Экспортировать сопутствующие», то приоритетным является это поле. Если в этом поле значение не указано, сопутствующие берутся из поля «Сопутствующие» по номеру строки в файле. Могут указываться не только для основного товара, но и для разновидностей. |
| Номер_группы | число | Позволяет помещать товар в конкретную группу у вас на сайте. |
| Название_группы | строка до 255 символов | Название группы товаров/услуг. Данное поле не импортируется при загрузке файла на сайт компании. |
| Номер_группы | число | Позволяет помещать товар в конкретную группу у вас на сайте. |
| Название_группы | строка до 255 символов | Название группы товаров/услуг. Данное поле не импортируется при загрузке файла на сайт компании. |
| Адрес_подраздела | строка | Адрес подраздела каталога. Например, для раздела «Ноутбуки»: https://satu.kz/Noutbuki . Для удобства вы можете воспользоваться поиском или рубрикатором и выбрать конечный раздел товара. |
| Возможность_поставки | число | Возможные объемы поставок |
| Срок_поставки | строка | Период измерения возможных объемов поставок день | неделя | месяц | квартал | год |
| Способ_упаковки | строка до 500 символов | Способ упаковки товара |
| Личные_заметки | строка | Личные заметки через запятую |
| Продукт_на_сайте | строка | Адрес продукта на сайте компании |
| Код_маркировки_(GTIN) | строка | Международный код маркировки и учёта логистических единиц (GTIN) для фида Google Merchant Center |
| Номер_устройства_(MPN) | строка | Уникальный (каталожный) номер устройства (MPN) для фида Google Merchant Center |
| Идентификатор_товара | строка до 255 символов | Идентификатор необходим для однозначного сопоставления товара в файле импорта с этим-же товаром на сайте компании. Может содержать символы и числа. Обязательное поле. |
| Уникальный_идентификатор | Положительное число | Уникальный идентификатор товара ― служебная информация, которая используется для идентификации товара или услуги исключительно на нашем портале. Данный идентификатор заполняется автоматически при экспорте и не должен изменяться вручную. Значение уникального идентификатора ― число, которое можно найти в ссылке на товар на портале или на сайте компании. |
| Идентификатор_подраздела | строка | Техническая информация об идентификаторе подраздела. Не рекомендуется менять этот параметр никогда. Этот параметр заполняется автоматически при экспорте данных из нашей системы. |
| Идентификатор_группы | строка | Техническая информация об идентификаторе группы товаров в вашей системе. Указывает на категорию товара/услуги на внешнем сайте вашей компании или в другой системе (например, в Яндекс.Маркет). Используется в системе импорта из XML и YML файлов. Это поле будет использоваться при выгрузке данных из каталога портала и импорте обратно в вашу систему. |
| ID_группы_разновидностей | строка | Идентификатор разновидности товара. Все товары с одним и тем же номером «ID_группы_разновидностей» и заполненными полями «Название_Характеристики» и «Значение_Характеристики» считаются разновидностями основного товара. Основной товар при этом имеет тот же номер «ID_группы_разновидностей», что и разновидности. Основным считается товар, который идет первым в списке товаров с одинаковыми «ID_группы_разновидностей». |
| Название_Характеристики | строка | Название портальной характеристики товара из категории, в которой размещается товар, или название пользовательской характеристики. Скопировать точное название характеристики категории можно из блока «Портальные характеристики» на странице добавления/ редактирования товара или перейдя в соответствующую категорию на портале. Пример названия портальной характеристики для товара из категории «Компьютерные кресла»: Количество колесиков. Чтобы добавить несколько характеристик, скопируйте этот столбец вместе со столбцами «Измерение_Характеристики» и «Значение_Характеристики» несколько раз. Порядок указания характеристик не имеет значения (портальные характеристики могут идти вперемешку с пользовательскими характеристиками). Внимание! В файле импорта столбцы описания каждой отдельной характеристики должны всегда следовать в таком порядке: «Название_Характеристики», «Измерение_Характеристики», «Значение_Характеристики». Примечание: Описанный в этой инструкции формат импорта характеристик является третьей по счету версией. На портале поддерживается обратная совместимость форматов импорта — характеристики, описанные в файле импорта в одном из предыдущих форматов, будут успешно импортированы. Однако экспорт характеристик всегда выполняется в новом, описанном здесь формате. Рекомендуем вам всегда описывать характеристики в файле импорта в соответствии с данными инструкциями. |
| Измерение_Характеристики | строка | Единица измерения портальной характеристики для выбранной категории товара, или единица измерения пользовательской характеристики. Скопировать точное название единицы измерения характеристики категории можно из блока «Портальные характеристики» на странице добавления/ редактирования товара или перейдя в соответствующую категорию на портале. Для пользовательских характеристик рекомендуем указывать стандартные единицы измерения. Пример названия единицы измерения для товара из категории «Компьютерные кресла»: шт. Чтобы добавить несколько характеристик, скопируйте этот столбец вместе со столбцами «Название_Характеристики» и «Значение_Характеристики» несколько раз. Порядок указания характеристик не имеет значения (характеристики категории могут идти вперемешку с пользовательскими характеристиками). Внимание! В файле импорта столбцы описания каждой отдельной характеристики должны всегда следовать в таком порядке: «Название_Характеристики», «Измерение_Характеристики», «Значение_Характеристики». Даже если столбец «Измерение_Характеристики» не заполнен, он все равно должен присутствовать в файле импорта во избежание ошибок. Примечание: Описанный в этой инструкции формат импорта характеристик является третьей по счету версией. На портале поддерживается обратная совместимость форматов импорта — характеристики, описанные в файле импорта в одном из предыдущих форматов, будут успешно импортированы. Однако экспорт характеристик всегда выполняется в новом, описанном здесь формате. Рекомендуем вам всегда описывать характеристики в файле импорта в соответствии с данными инструкциями. |
| Значение_Характеристики | строка | Значение портальной характеристики для выбранной категории товара или значение пользовательской характеристики. Значение характеристик может быть простым или множественным. Пример множественного значения характеристики «Материал корпуса»: Алюминий, Пластмасса; для характеристики «Стандарт связи»: GSM, CDMA, EDGE. Значения множественных характеристик в файле импорта разделяются символом «|». Пример: «Алюминий|Пластмасса» или «GSM|CDMA|EDGE» (кавычки в файле импорта не нужны). Чтобы добавить несколько характеристик, скопируйте этот столбец вместе со столбцами «Название_Характеристики» и «Измерение_Характеристики» несколько раз. Порядок указания характеристик не имеет значения (характеристики категории могут идти вперемешку с пользовательскими характеристиками). Внимание! В файле импорта столбцы описания каждой отдельной характеристики должны всегда следовать в таком порядке: «Название_Характеристики», «Измерение_Характеристики», «Значение_Характеристики». Примечание: Описанный в этой инструкции формат импорта характеристик является третьей по счету версией. На портале поддерживается обратная совместимость форматов импорта — характеристики, описанные в файле импорта в одном из предыдущих форматов, будут успешно импортированы. Однако экспорт характеристик всегда выполняется в новом, описанном здесь формате. Рекомендуем вам всегда описывать характеристики в файле импорта в соответствии с данными инструкциями. |
Обратите внимание: блоков характеристик («Название_Характеристики», «Измерение_Характеристики», «Значение_Характеристики») может быть несколько, под каждую характеристику товара. Порядок блоков не важен. Рекомендуем размещать блоки характеристик в последних столбцах файла.
Группы: вкладка «Export Groups Sheet»
| Название поля | Формат данных | Описание значения |
|---|---|---|
| Номер_группы | Число | Номер группы товаров/услуг на сайте компании. Номер группы можно найти в ссылке на группу: https://example.com/g123456-test_group |
| Название_группы | строка до 255 символов | Название группы товаров/услуг |
| Идентификатор_группы | Число | Внешний идентификатор группы товаров/услуг (например, номер группы товаров в 1С). |
| Номер_родителя | Число | Номер родительской группы, в которую входит данная группа товаров/услуг. Если родительской для данной группы является корневая группа, это поле должно быть пустым. |
| Идентификатор_родителя | Число | Внешний идентификатор родительской группы, в которую входит данная группа товаров/услуг. Если родительской для данной группы является корневая группа, это поле должно быть пустым. |
| HTML_заголовок_группы | строка до 250 символов | HTML-заголовок для SEO-настроек группы Группа SEO-настроек группы доступна, если включено приложение «SEO-настройки». Если все SEO-поля заданы и соответствуют требованиям, тогда автоматически будет установлена настройка «Использовать свои настройки». Если все поля не соответствуют требованиям или не заданы, устанавливается настройка «Значения по умолчанию по шаблонам». |
| HTML_описание_группы | строка до 250 символов | HTML-описание для SEO-настроек группы |
| HTML_ключевые_слова_группы | строка до 250 символов | HTML-ключевые слова для SEO-настроек группы |
