Обучающие материалы | Nwicode CMS

Импорт/экспорт товаров


Назначение

Для владельцев модуля электронной коммерции MobilCart в конструкторе мобильных приложений NWCODE, мы создали инструмент, позволяющий в несколько кликов мышки выгрузить весь каталог товаров в CSV файл или, наоборот, загрузить каталог товаров из файла в общепринятом формате CSV или формате Yandex YML (подробнее об этом формате можно прочитать тут).

Экспорт каталога

Выгрузка каталога в файл формата CSV производится нажатием кнопки “Export all data to CSV”. Ссылка на скачивание откроется в новом окне. В качестве разделителей в файле используется запятая.

Внимание! Внутренняя кодировка приложения – UTF-8, и выгрузка происходит именно в этой кодировке. Поэтому, для работы с таким файлом вам понадобится редактор с поддержкой кодировки UTF-8. Пакет Microsoft Office этого, к сожалению, не умеет, используйте альтернативные редакторы, работающие с такой кодировкой, например OpenOffice.

Выгружаемый файл следует следующим правилам:

  •   Разделитель столбцов - запятая

  •   Разделитель параметров – вертикальная черта “|”

  •   Длинные тексты между разделителями столбцов закрываются кавычками

  •   Картинки не выгружаются, так как сервер хранит только оптимизированные уменьшенные копии изображений

    Обозначение полей:

  •   Categories – категория товара, включая родительские категории. Например, Category 1|

    Subcategory of Category1|Subcategory of Subcategory

  •   Name – наименование товара

  •   Model – модель товара

  •   SKU – артикул товара

  •   Description – описание к товару

  •   Quantity – количество товара (даже если количество выключено в настройках магазина)

  •   Price- цена товара

  •   Special price – цена товара со скидкой

  •   Product formats – форматы товара

  •   Sort Order – индекс сортировки




ИМПОРТ И ЭКСТОРТ ТОВАРОВ ДЛЯ МОДУЛЯ MOBILCART



MobilCartImport

  •   Required Checkbox options – опции товара

  •   Not required Checkbox options– опции товара

  •   Required Listbox options with price– опции товара

  •   Not Required Listbox options with price– опции товара

    Пояснения к полям:

  •   Sort Order – чем выше значение в этом поле, тем выше будет показан товар в выдаче

  •   Product formats – товар может не фиксированную цену, а динамическую, например, комплекатцию. В этом случае основная цена не действует, а берется цена из данного поля, например {Комплектация Econom}:5000|{Комплектация Standart}:7000|{Комплектация Premium}:10000

  •   Not required Checkbox options и Required Checkbox options – это опции товара в виде чекбокса (галочки). Данные опции не имеют количества и на цену товара не влияют. Опции могут быть как обязательные – reuired, так и не обязательные – not required. Опции также заключаются в фигурные скобки и разделяются вертикальной чертой, но при этом содержат еще и название группы опций, например {Цвет}{Красный}|{Цвет}{Синий}| {Цвет}{Серый}|{Циферблат}{Зеленый}|{Циферблат}{Ораньжевый}

  •   Required Listbox options with price и Not Required Listbox options with price – это опции товара в виде списка. Такие опции в товаре имеют количество и цены. Формат опций аналогичен предыдущему пункту {Память телефона}{8Гб}:2000|{Память телефона} {16Гб}:3500|{Память телефона}{32Гб}:5000|{Цвет корпуса}{Красный}:10000|{Цвет корпуса}{Синий}:15000

    Импорт каталога

    Импорт работает в два этапа. На первом этапе происходит загрузка файла на сервер и его анализ.

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

    Форматы файла CSV для импорта.

    Он аналогичен выгружаемому формату файла, за исключением одного столбца Images. В данном столбце необходимо через знак “|” перечислить URL всех изображений данного товара. Самое первое изображение будет установлено как основное в каталоге. Категории так же должны быть перечислены через знак “|” в порядке от главной к текущей. Очередность следования столбцов роли не играет, но названия столбцов должны быть именно такими, так как привязка данных идет именно по названию столбца. Если какого то столбца нет – будет считать что эти значений нет и в каталог будут записаны пустые данные (исключая название товара – этот столбец обязателен).



MobilCartImport

Форматы файла YML для импорта.

Стандарт YML (Yandex Market Language) разработан Яндексом и основан на стандарте XML. Данный формат дефакто стал одним из стандартов обмена данными между магазинами в RU сегменте. Подробнее почитать про формат YML и ознакомиться с его стандартами и правилами вы можете по этому адресу.

Для импорта в Mobilcart используются следующие поля:

  •   Category в секции categories, включая параметры Id и ParentId – по этим параметрам формируется дерево категорий

  •   Offer в секции offers, а конкретно:

  •   price – цена (или цена со скидкой, если есть oldprice)

  •   oldprice – цена без скидки (если на данный товар есть скидка)

  •   categoryId – id категории, используемых в секции categories

  •   Массив picture – набор ссылок на изображения, первое изображение будет установлено

    основным

  •   name – Наименование товара

  •   model – модель товара

  •   description – Описание товара, должно быть заключено в <![CDATA[......]]>

  •   param – параметры или атрибуты

    Внимание, данный формат по умолчанию не содержит поле SKU (артикула).

    Для полного охвата всех возможностей модуля электронной коммерции MobilCart мы добавил в YML поддержку дополнительных полей:

  1. sku (<sku>Some SKU number</sku>)

  2. qty (<qty>10</qty>)

  3. sort_order (<sort_order>99</sort_order>)

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

Мы расширили возможности поля param параметрами as_checkbox, required и price. Если опция имеет параметр as_checkbox=true, например:

<param name=”Цвет” as_chekbox=”true”>Синий</param> <param name=”Цвет” >Красный</param>
<param name=”Цвет” >Зеленый</param>

Если в группе параметров хотя бы один параметр имеет данный атрибут, то вся группа параметров «Цвет» будет выведена в виде чекбокса, иначе опция будет в виде

Если опция имеет параметр required=”true”, то заполнение данного поля будет обязательным:

<param name=”Цвет” required=”true”>Красный</param> <param name=”Цвет” >Зеленый</param>


По умолчанию, каждая опция имеет нулевую цену. Но, если необходимо, чтобы выбор опции влиял на итоговую цену товара, то можно в param нужной опции добавить параметр price=”some summ”, например:

<param name=”Цвет” price=”100”>Красный</param> <param name=”Цвет” price=”150”>Зеленый</param>

В этом случае, при выбор этой опции, стоимость товара будет увеличиваться на указанную цену в опции. Обратите внимание, что цена может быть указана только опций с типом «список», для опций в виде чекбокса цена не учитывается и не применяется!

Параметры загрузки

Загрузка каталога имеет несколько режима:

  1. Загрузка только новых позиций

  2. Загрузка новых позиций и обновление существующих

  3. Только обновление существующих товаров.

Как в загрузке, так и в обновлении, галочками необходимо отметить категории, из которых необходимо брать данные в файле импорта. Это позволяет загружать и обновлять только часть каталога. Если категорий много и необходимо импортировать все – воспользуйтесь “Select All” / “Unselect All”.

Для создаваемых товаров в форме необходимо указать «Налог» - он будет применен ко всем вновь созданным товарам.

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

Режимы обновления

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

В разных магазинах поля Model и SKU вместо общепринятых данных могут содержать свои внутренние обозначения, поэтому можно указать, по какому полю и с каким полем сравнивать. Будьте внимательны с этой настройкой! – невнимательное или неосторожное использование может закачать в каталог дублирующиеся позиции. По умолчанию стоит сравнение по наименованию.

В формате YML для каждого товара можно указать его доступность. Для этого в записи offer есть параметр available. Он может принимать значения true или false, в зависимости от доступности товара. При загрузке каталога вы можете учитывать значение этого поля, чтобы не загрузить или не обновить отсутствующие позиции.


Опции обновления (Update options)

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

  •   Обновить название (Update name) – название будет обновлено

  •   Обновить количество (Update quantity) – количество товара будет обновлено

  •   Обновить артикул (Update SKU) – артикул товара будет обновлен

  •   Обновить модель товара (Update Model ) – модель товара будет обновлена

  •   Обновить цену (Update price) – цена товара будет обновлена, но учтите, что если товар имеет форматы, они будут удалены (если не будет включено обновление форматов)

  •   Обновить акционную цену (Update special price) – акционная цена товара будет обновлена, но учтите, что если товар имеет форматы, они будут удалены (если не будет включено обновление форматов)

  •   Обновить описание (Update description) – описание товара будет обновлено

  •   Обновить опции (Update options) – опции товара будут обновлены, или удалены, если их

    нет в файле загрузке.

  •   Обновить форматы товара (Update formats) – форматы товара будут обновлены, или удалены, если их нет в файле загрузке. Если форматы указаны, то цена товара будет удалена!

  •   Обновить сортировку (Update sort order) – сортировочный индекс товара будет обновлен.

  •   Обновить изображения (Update Images)- изображения будут обновлены (или удалены, если в файле загрузки они не указаны). Внимание, не используйте для загрузки теже изображения, которые были получены при выгрузке каталога, качество неминуемо испортится!



Обновление категорий у существующих товаров не производится.


Загрузка товара происходит асинхронно. После загрузки будет показано количество новых товаров, отредактированных товаров и количество созданных категорий. 








Вернуться

Есть вопросы — спрашивайте!

Наши специалисты помогут Вам и окажут бесплатную консультацию

Документация

Новости 1 - 20 из 51
Начало | Пред. | 1 2 3 | След. | Конец