Инструкция: импорт товаров TGShop

Как массово загрузить товары с категориями в Telegram-магазин - объясняем в этом гайде. Здесь вы также найдете шаблоны фида и Excel-файла

Более 1.5к пользователей рекомендуют TGShop

Есть два способа быстрого импорта товаров в TGShop: загрузить файл в формате XLS (Excel) или XML (фид).

Загрузка xls-файла
Чтобы импортировать товары через xls-файл, скачайте наш шаблон и заполните его строго по примеру. Если возникнут вопросы, пишите нам в поддержку. Также поддержка доступна из личного кабинета на платформе TGShop.

Вы можете вставить в шаблон прямые ссылки на фото из Я.Диска, сервисов Wampi, Yapics и др. Формат ссылки: .jpg

Видео-инструкция, как создать и заполнить XLS-файл:

Инструкция: импорт товаров

Загрузка фид-файла
Чтобы ваши товары импортировались в систему корректно, советуем загружать фид-файл, заполненный точно по нашему шаблону:

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="YYYY-MM-DD hh:mm">
  <shop>
    <name>TGShop Market</name>
    <company>TGShop</company>
    <url>https://market.yandex.ru/</url>
    <categories>
      <category id="90401">Все товары</category>
      <category id="198118" parentId="90401">Женская одежда</category>
      <category id="198119" parentId="90401">Детская одежда</category>
      ...
    </categories>
    <offers>
      <offer id="648287" group_id="739091" available="true">
        <name>Платье Sun</name>
        <price>3500</price>
        <categoryId>198118</categoryId>
        <picture>https://images.shafastatic.net/377807285</picture>
        <picture>https://images.shafastatic.net/377807286</picture>
        <picture>https://images.shafastatic.net/377807287</picture>
        ...
        <vendorCode>AE897917</vendorCode>
        <oldprice>4999</oldprice>
        <description>Комбинированное платье представлено в новой коллекции итальянской марки VIA TORRIANI 88. Сочетание двух материалов добавляет модели особого шика. Принт в полоску является особенностью модели. Специфика кроя обеспечит отличную посадку на любой тип силуэта.</description>
<shortDescription>Платье на каждый день</shortDescription>
        <quantityInStock>467</quantityInStock>
        <param name="Цвет">Желтый</param>
        <param name="Размер">S</param>
        <param name="Приоритет">70</param>
      </offer>
      ...
    </offers>
  </shop>
</yml_catalog>

↓ Что означают теги, и что будет, если их пропустить? Ознакомьтесь со списком тегов в таблице ниже. Все остальные теги, которые будут присутствовать в вашем фиде, система будет игнорировать.

Тег	Необходимость	Описание	Что будет, если не заполнить
id	Да	Идентификатор (товара или категории)	В случае пропуска id категории, товары не смогут ссылаться на данную категорию. В случае пропуска id товара, товар не сможет быть идентифицирован. Импорт товара завершится с ошибкой «Товары должны иметь атрибут «id»
category	Нет	Наименование категории	В случае, если не будет ни одной категории, все товары будут без категории
parentId	Нет	Идентификатор родительской категории	—
offer	Да	Предложение (вариация товара)	Если товары будут описаны в другом теге, система не сможет импортировать их. Импорт завершится с ошибкой «Товары не найдены»
group_id	Нет	Объединение предложений в один товар	Необязательное поле. Используется только для товаров с разными вариациями для объединения их в одну карточку
available	Нет	Доступность товаров	Необязательное поле. По умолчанию проставляется «true»
name	Да	Наименование товара	В случае пропуска, импорт завершится с ошибкой «Наименование товара должно содержаться в теге name»
price	Да	Цена товара	В случае пропуска, импорт завершится с ошибкой «Для товаров не указана цена»
categoryId	Нет	Категория, к которой относится товар	В случае пропуска товар импортируется без категории. В случае если указан id категории, который не был указан в теге , импорт завершится с предупреждением: «Категории» + categoryId + «не существует для вашего магазина», товар импортируется без категории
picture	Нет	Фото товара. Тегов может быть несколько для одного товара	В случае пропуска, в карточке товара будет отображаться фото-заглушка. При необходимости фото можно будет загрузить через интерфейс
vendorCode	Нет	Артикул товара	Необязательное поле. В случае пропуска, артикул товара будет генерироваться
oldprice	Нет	Старая цена	—
description	Да	Полное описание товара	В случае пропуска импорт завершится с ошибкой «Заполните описание товара в теге description»
shortDescription	Нет	Краткое описание товара	Необязательное поле. В случае пропуска в краткое описание продублируется наименование товара
quantityInStock	Нет	Количество товара в наличие	Необязательное поле. В случае пропуска, будет присвоено количество «0». Товары с количеством «0» не отображаются в каталоге
param	Нет	name=”Цвет” — цвет товара, name=»Размер” — размер товара, name=»Приоритет” — приоритет товара, значение от 0 до 100. Приоритет влияет на порядок отображения товаров в каталоге	Необязательные поля. В случае пропуска цвета будет присвоено значение «По умолчанию». В случае пропуска размера будет присвоено значение «Б/р» — без размера. В случае пропуска будет присвоено значение «10».

Комментарии к импорту:

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

2. Редактирование и удаление категорий, загруженных через импорт. Теперь вы можете загрузить категории через импорт, редактировать их в админке и удалять.

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

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

5. У каждой SKU (вариации товара) должен быть уникальный productID (внешний идентификатор) для корректного обновления при последующих импортах. В случае, если у разных SKU будут одинаковые внешние идентификаторы, то их необходимо будет удалить вручную и заново загрузить с новым импортом присвоив уникальный внешний идентификатор.