Импорт из XML (YML)
В этой инструкции в узнаете как импортировать товары при помощи фида (xml-файла)
Товары можно массово добавлять и обновлять через импорт. В панели администратора нажмите раздел "импорт" и загрузите файл с товарами, произведите необходимые настройки и дождитесь завершения импорта.
Возможности импорта:
Максимальный размер загружаемого файла — 20 мегабайт;
Файл может быть загружен с диска компьютера
Процесс импорта может занимать длительное время. Средняя скорость первичного добавления — 1000 товаров в час. Последующие обновления остатков и цен проходят гораздо быстрее.
Требования к содержимому файла
Чтобы ваши товары импортировались в систему корректно, советуем загружать фид, заполненный точно по нашему шаблону:
Что означают теги (параметры), и что будет, если их пропустить? Ознакомьтесь со списком тегов ниже, Все остальные теги, которые будут присутствовать в вашем фиде, система будет игнорировать.
id - идентификатор товара или категории (обязательный)
Идентификатор товара в вашей системе. Если вы еще не использовали идентификатор — создайте его прямо во время добавления товара. Всегда должен быть уникальным. В случае пропуска ID товара, товар не сможет быть идентифицирован. Импорт товара завершится с ошибкой "Товары должны иметь атрибут "ID". В случае пропуска ID категории, товары не смогут ссылкать на данную категорию.
offer - предложение (SKU), (обязательный)
Последовательность любых символов. Рекомендуем использовать тут значение, которое используется вами для синхронизации по внешнему идентификатору с внешними системами (Например, МойСклад) для упрощения синхронизации по остаткам/ценам с ними.
Атрибут id элемента <offer>
</offers>
<Offer id="e3726b0b-780c-11ee-90c4-a8a15980c86d#e3726b14-780c-11ee-90c4-a8a15980c86">
group_id - объединение предложений в один товар (необязательный)
Необязательное поле. Используется только для товаров с разными вариациями для объединения их в одну карточку
Атрибут id элемента <group> внутри элемента <offer>
</offers>
<offer group_id="739091" id="e3726b0b-780c-11ee-90c4-a8a15980c86d#e3726b14-780c-11ee-90c4-a8a15980c86">
сategory - наименование категории (необязательный)
parentId - родительская (корневая) категория, к которой относятся подкатегории (необязательный)
categoryId - категория к которой вы относите товар (необязательный)
Необходимо указывать, если в вашем каталоге есть категории. Один товар не может быть сразу в нескольких категориях. Указывайте конкретные категории — например, Платья лучше отнести к категории Платья, а не просто Женская одежда.
<categories>
<category id="ID родительской категории">Название родительской категории</сategory>
<category id="ID подкатегории" parentID="ID родительской категории">название подкатегории</category>
<сategory id="191118">Женская одежда</category>
<сategory id="1" parentId="191118">Платья</category>
name - название товара, которое увидят ваши клиенты в карточке товара (обязательный)
До 30 символов. Для каждого варианта товара (SKU) может быть задано свое название товара
Элемент <name> внутри элемента <offer>
<name>Платье Sun</name>
price - цена продажи товара (обязательный)
Цена одной единицы товара, включая все налоги.
Цена указывается в рублях. Число должно быть целым. Пример: 3500 Для каждого варианта товара (SKU) может быть задана своя цена В случае пропуска, импорт завершится с ошибкой «Для товаров не указана цена»
Элемент <price> внутри элемента <offer>
<offer group_id=""739091" id="e3726b0b-780c-11ee-90c4-a8a15980c86d#e3726b14-780c-11ee-90c4-a8a15980c86"
<price>3500</price>
picture - изображение товара (необязательный) До 10 изображений на один вариант товара (SKU)
Принимаются jpg-, png-, jpeg- и webp-изображения товара, соответствующие требованиям: рекомендуемое разрешение 1080×1440. Соотношение сторон: 3×4 Тегов может быть до 10 для одной вариации товара (SKU) В случае пропуска, в карточке товара будет отображаться фото-заглушка. При необходимости фото можно будет загрузить через панель управления TGShop вручную
Элементы <picture> внутри элемента <offer>
<offer group_id=""739091" id="e3726b0b-780c-11ee-90c4-a8a15980c86d#e3726b14-780c-11ee-90c4-a8a15980c86"
...
<picture>https://static.tildacdn.com/tild3065-3664-4738-b636-623635346431/Logo-2.svg</picture>
<picture>https://static.tildacdn.com/tild3065-3664-4738-b636-623635346431/Logo-2.svg</picture>
vendorCode - артикул товара (необязательный)
Необязательный элемент, в случае загрузки товаров без артикула система сгенериует их самостоятельно. Могут быть одинаковыми для вариантов товара.
элемент <vendorCode> внутри элемента <offer>
<vendorCode>AE897917</vendorCode>
oldprice - зачеркнутая цена в карточке товара, цена до скидки (необязательно)
Цена указывается в рублях. Число должно быть целым. Пример: 4999
элемент <oldprice> внутри элемента <offer>
<oldprice>4999</oldprice>
description - описание товара, которое отображается в карточке (обязательный)
До 3000 символов. Для каждой SKU (offer id) может быть задано свое описание. В случае пропуска импорт завершится с ошибкой «Заполните описание товара в теге description»
элемент <description> внутри элемента <offer>
<description>Комбинированное платье представлено в новой коллекции итальянской марки VIA TORRIANI 88. Сочетание двух материалов добавляет модели особого шика. Принт в полоску является особенностью модели. Специфика кроя обеспечит отличную посадку на любой тип силуэта</description>
shortDescription - краткое описание товара (необязательный)
До 300 символов Необязательное поле. В случае пропуска будет использоваться полное описание.
элемент <shortDescription> внутри элемента <offer>
<shortDescription>Платье на каждый день</shortDescription>
quantityInStock - количество товара (SKU) в наличии
Если у варианта товара (SKU) значение указано 0, то такой товар будет отображаться в карточке товара, но не будет доступен к покупке. Если у товара нет вариантов, то такой товар не будет отображаться в магазине, но будет отображаться в панели управления после импорта.
элемент <quantityInStock> внутри элемента <offer>
<quantityInStock>497</quantityInStock>
param - дополнительные параметры товара, при помощи которых вы можете создавать дополнительные характеристики для товара: цвет, размер, объем, запах, состав, страна производства, бренд и так далее.
При помощи этого тэга вы можете задавать название и значение характеристик товара. Рекомендуемое количество характеристик (вариантов товара) на которые разделяется товар - 2. Количество вариантов товара не ограничено. При помощи атрибута type "primary" - вы сможете задать варианты товара (характеристики, на которые будет делиться товар), а при помощи type "secondary" - добавить характеристики товара, будет отображаться в описании и использоваться для фильтров (в будущем). Для настройки сортировки расположения товара в каталоге (какие товары показывать в каталоге первыми) используйте <param name="Приоритет"</param> Товары со значением 100 будут отображаться первыми в каталоге, и наоборот.
элемент <param> с атрибутами name и type внутри элемента <offer>
<param name="Цвет" type="primary">желтый</param>
<param name="Размер" type="primary">S (42 RUS)</param>
<param name="Состав" type="secondary">100% хлопок</param>
<param name="Приоритет">100</param>
dimensions - габариты товара в формате Ш/Г/В (ширина, глубина, высота) (необязательный)
Значения должны быть в сантиметрах, допустимы целые и десятичные числа. Для десятичных используется точка. Разделителем является символ “/” - слэш. Любые другие разделители недопустимы. Все три значения должны быть заполнены.
элемент <dimensions> внутри элемента <offer>
<dimensions>10/11/12</dimensions>
weight - вес товара (необязательный)
Значения должны быть в килограммах, допустимы целые и десятичные числа. Для десятичных используется точка.
элемент <weight> внутри элемента <offer>
<weight>0.5</weight>
sizeChart - размерная сетка, инструкции по эксплуатации, схемы сборки и т. д (необязательный)
Данный тэг можно использовать для того, чтобы добавить кнопку, которая будет вести на вашу размерную сетку в карточке товара, инструкцию по эксплуатации, схемы сборки. Можно задать отдельную ссылку и название для каждого варианта товара (SKU). Название можно не передавать, по умолчанию будет называться "Размерная сетка". Для того, чтобы инструкция открывалась нативно без перехода на сторонние ресурсы и не уводила клиента из карточки товара и вашего магазина, мы рекомендуем размещать ссылку на инструкцию через сервис https://telegra.ph/
элемент <sizeChart> внутри элемента <offer>
<sizeChart>https://telegra.ph/Razmernaya-setka-04-08</sizeChart>
Для того, чтобы передать свое название для кнопки используйте атрибут name
<sizeChart name="Супер сетка">https://telegra.ph/Razmernaya-setka-04-08</sizeChart>
Last updated