Импорт и Экспорт вариантов товаров

Основные правила создания вариантов товара

1. Основной товар является общим для вариантов (общее описание, характеристики); 
2. Нельзя дублировать варианты (если у основного товара уже есть такая характеристика, то в товарах-вариантах ее повторно можно не указывать);
3. Вариант можно создавать только на основе заполненных характеристик основного товара;
4. Для создания вариантов, при импорте, все отличающиеся значения характеристик и другие различия должны быть заполнены;

Объединение и разъединение вариантов 

Варианты могут быть объединены или разъединены при помощи импорта.

• Если в кабинете варианты товаров присутствуют как отдельные товары, но в файле импорта они являются вариантами - при повторном импорте с включенной настройкой Варианты товаров - они будут объединены в товар с вариантами.
• Варианты можно объединить вручную, через Excel импорт, для этого достаточно экспортировать товары и убедиться, что у вариантов совпадает значение в колонке - Названия характеристики, на основе которых должны быть созданы варианты. Далее, в столбце ID_группы_вариантов для всех вариантов из одной группы необходимо указать один и тот же id (идентификатор группы вариантов) и импортировать в систему.
  Важно! При этом, настройка - Экспортировать варианты должна быть включена!
• Товары, которые в результате импорта не могут быть объединены в варианты, но имеют такой же group_id, что и у объединенных - будут удалены в ходе импорта.  
• Если настройка - Варианты товаров отключена, но при этом, в кабинете уже созданы варианты с group_id  - после импорта, созданные варианты с этим же group_id разделятся и станут отдельными товарами.
• Чтобы разъединить варианты при Excel импорте, достаточно удалить значения в столбце ID_группы_вариантов файла импорта .

Как осуществить импорт вариантов 

Для импорта вариантов в кабинет необходимо включить настройку - Варианты товаров. 

С активной настройкой, товары с одинаковым значением group_id (ID_группы_вариантов) будут объединены в варианты товаров.

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

Импорт вариантов в Excel формате

В Excel импорте за передачу вариантов товаров отвечает столбец ID_группы_вариантов.

Если в файле Excel два и более товара имеют одинаковое значение ID_группы_вариантов, то такие товары считаются вариантами.

Импорт вариантов в YML формате

В YML импорте за передачу вариантов товаров отвечает периметр group_id.

Если два и более товара имеют одинаковое значение атрибута group_id, то такие товары считаются вариантами. Основной товар выбирается в порядке очередности товаров с одинаковым group_id в файле. 

Особенности и возможные ошибки при импорте вариантов товаров

1. Варианты должны отличаться между собой минимум одним атрибутом (характеристикой) товара. Если у 2-х вариантов атрибуты совпадают, то импортирован будет только один из них, в порядке очередности размещения в файле импорта.

Пример - 1 - добавятся вариантами только товары с id="123" и id="1234", id="12345" будет проигнорирован, так как такой атрибут “Цвет” уже присутствует у другого варианта:

 <offer available="true" group_id="1" id="123">...

<param name="Цвет" unit="">красный</param>

</offer>

<offer available="true" group_id="1" id="1234">...

<param name="Цвет" unit="">розовый</param>

</offer>

<offer available="true" group_id="1" id="12345">...

<param name="Цвет" unit="">розовый</param>

</offer>

Пример - 2 - невозможно объединить в варианты, так как их атрибуты совпадают. Такая группа вариантов будет проигнорирована системой:

<offer available="true" group_id="2" id="123">...

<param name="Цвет" unit="">синий</param>

</offer>

<offer available="true" group_id="2" id="1234">...

<param name="Цвет" unit="">синий</param>

</offer>

<offer available="true" group_id="2" id="12345">...

<param name="Цвет" unit="">синий</param>

</offer>

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

Пример - позиция с id=123 будет добавлена отдельным товаром, так как у него нет характеристики для связи с вариантами. 

Позиции с id=1234 и id=12345 будут объединены в варианты на основе товара  id=1234:

<offer available="true" group_id="2" id="123">...

...

</offer>

<offer available="true" group_id="2" id="1234">...

<param name="Цвет" unit="">синий</param>

</offer>

<offer available="true" group_id="2" id="12345">...

<param name="Цвет" unit="">зеленый</param>

</offer>

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

Пример - позиция с id= 12345 будет пропущена в импорте так как не имеет характеристики для связи с основным товаром:

<offer available="true" group_id="1" id="123">...

<param name="Цвет" unit="">красный</param>

</offer>

<offer available="true" group_id="1" id="1234">...

<param name="Цвет" unit="">розовый</param>

</offer>

<offer available="true" group_id="1" id="12345">...

<param name="Состояние" unit="">новое</param>

</offer>

4. Все варианты наследуют одинаковые атрибуты от основного товара, в том числе - Производителя и Страну производства. 

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

Пример:

<offer available="true" group_id="1" id="123">...

<param name="Цвет" unit="">красный</param>

<param name="Пол" unit="">женский</param>

<param name="Состояние" unit="">новое</param>

</offer>

<offer available="true" group_id="1" id="1234">...

<param name="Цвет" unit="">желтый</param>

</offer>

<offer available="true" group_id="1" id="12345">...

<param name="Цвет" unit="">зеленый</param>

</offer>

5. Если у варианта указан атрибут, которого нет у первого товара из группы вариантов - этот атрибут будет проигнорирован.

Пример - у варианта id="12345" пропускаем характеристику Состояние - новое

<offer available="true" group_id="1" id="123">...

<param name="Цвет" unit="">синий</param>

</offer>

<offer available="true" group_id="1" id="1234">...

<param name="Цвет" unit="">желтый</param>

</offer>

<offer available="true" group_id="1" id="12345">...

<param name="Цвет" unit="">красный</param>

<param name="Состояние" unit="">новое</param>

</offer>

6.Если все варианты построены на разных характеристиках, то группа вариантов не будет импортирована. 

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

Пример 1 - невозможно объединить в варианты - игнорируем всю группу:

<offer available="true" group_id="1" id="123">...

<param name="Размер обуви" unit="">36</param>

</offer>

<offer available="true" group_id="1" id="1234">...

<param name="Цвет" unit="">желтый</param>

</offer>

<offer available="true" group_id="1" id="12345">...

<param name="Состояние" unit="">новое</param>

</offer>

Пример 2 - невозможно объединить в варианты - не все характеристики одинаковые - игнорируем всю группу:

<offer available="true" group_id="1" id="123">...

<param name="Размер обуви" unit="">36</param>

<param name="Материал" unit="">кожа</param>

<param name="Цвет" unit="">синий</param>

</offer>

<offer available="true" group_id="1" id="1234">...

<param name="Размер обуви" unit="">38</param>

<param name="Материал" unit="">экокожа</param>

<param name="Шнуровка" unit="">сверху</param>

</offer>

<offer available="true" group_id="1" id="12345">...

<param name="Размер обуви" unit="">40</param>

<param name="Цвет" unit="">красный</param>

<param name="Шнуровка" unit="">боковая</param>

</offer>

7. Если в файле импорта id варианта встречается несколько раз, но имеют разное значение group_id группы вариантов, то загружается/обновляется вариант товара только в первой группе, остальные игнорируются.

8. Если при обновлении, отдельный вариант товара в файле импорта переназначен к другой группе вариантов (поменялось значение group_id), то:

• Открепляется вариант товара от текущей группы вариантов.
• Объединяется товар с указанной группой вариантов.
• Если условия объединения выполняются - вариант объединяется с новой группой.
• Если объединить вариант с указанной группой нельзя - этот вариант удаляется.

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

10. Если при первом импорте у товара был указан group_id или ID_группы_вариантов и товар был импортирован, как товар с вариантами, то при обновлении данного варианта файлом без указания значения group_id или ID_группы_вариантов - вариант будет просто обновлен внутри группы.

Однако - если group_id или ID_группы_вариантов в файле импорта для данного варианты был изменен и отличается от значения других вариантов, то этот вариант будет отделен из группы вариантов в отдельный товар.

11. Варианты наследуют описание основного товара, если для вариантов не указано собственное описание в файле импорта - тег descriptionв блоке offer.

12. Варианты товара будут перемещены в папку основного товара, даже если у них указана другая папка в файле импорта: значение categoryId.

13. После импорта, в карточке варианта в Кабинете Компании будет добавлено значение - Идентификатор варианта товара, которое будет использоваться для выгрузки данных с портала и импорта обратно в вашу систему:

14. Основное фото варианта будет определяться по 1-му фото в списке тега <picture> или в столбце - Ссылка_изображения.

Источники импорта

При импорте с определенным источником товаров с вариантами - товарам и вариантам назначается выбранный источник.

Пример 1

Товаров еще нет в кабинете. При импорте с источником А - всей группе товаров будет назначен источник А.

Пример 2

В кабинете уже есть товар без указанного источника (По умолчанию). При импорте такого товара и вариантов к нему с источником А - вся группа вариантов будут с источником А. 

Пример 3

В кабинете уже есть товар с id=1 и источником А. При импорте вариантов с источником Б и наличием среди товаров позиции с id=1 - варианты товаров будут добавлены с источником Б, а товар с источником А останется отдельным товаром.

Логика дополнительных настроек импорта.

Если в файле импорта нет варианта, который присутствует в группе вариантов в кабинете, в зависимости от значения настройки - Действие с товарами отсутствующими в файле с данным вариантом выполняются действия:

• При значении - Не вносить изменений - не обновляем данный вариант (пропускаем).
• При значении - Ставить статус “нет в наличии” - меняем у варианта статус наличия на нет в наличии.
• При значении - Ставить статус “под заказ” - меняем у варианта статус наличия на под заказ.
• При значении - Перемещать в черновики - меняем у варианта статус на В черновиках.
• При значении - Удалять - меняем у варианта статус на Удалено.

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

Экспорт вариантов товаров 

Для обоих вариантов экспорта добавлена настройка - Экспортировать варианты.

Чекбокс:

• По умолчанию отключен - не экспортируются варианты. Как и сейчас, выгружается только первый товар.
• Если включен - выгружаются товары вместе со структурой вариантов.

Важно! Если экспорт проводится с целью ручного объединения товаров в варианты - экспорт обязательно нужно проводить с включенной настройкой.

 1. Экспорт вариантов в YML

В тег offer выгружаются значения group_id, характеристики различия вариантов выгружаются для каждого варианта товара. При наличии своего описания у товара оно выгружается отдельно для варианта.

2. Экспорт вариантов в Excel

В файл экспорта для товаров выгружаются значения группы вариантов, в столбец ID_группы_вариантов, характеристики различия вариантов выгружаются для каждого варианта. При наличии своего описания у товара оно выгружается отдельно для варианта.