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

# Как добавить товары на маркетплейс Тандем.Online

Из этой статьи вы узнаете как добавить ваши товары на витрину маркетплейса.

Товары через личный кабинет можно создать двумя способами:

  • использовать существующую;
  • создать новую карточку товара вручную.

# Загрузка товаров вручную

# Создаем товар на основе существующей карточки

  1. Авторизуйтесь в личном кабинете продавца под своими учетными данными

  2. В разделе Цены и остатки, нажмите на кнопку Новый товар в правом верхнем углу.

  3. В открывшейся форме, в поле Товар(ID) начните вводить ключевые слова для вашего товара. Если в подсказке не будет указан подходящий вариант, перейдите к варианту 2. Поиск карточки товара

  4. Заполните обязательные поля:

    • Статус:
      • Активный если планируете разместить товар сразу же на витрине,
      • Отключен:
      • На паузе:
    • Склад: выберите один из ранее созданных,
    • Цена — конечная стоимость вашего товара на витрине,
    • Старая цена — цена которая будет отображаться в виде зачеркнутого варианта цены, цена до скидки,
    • Количество — количество товара, доступного для покупки,
    • Налоги — обязательно укажите величину НДС для вашего товара.

  5. Нажмите Создать или Создать и закрыть если хотите перейти к списку всех товаров.

  6. Товар будет размещен на витрине, что бы посмотреть как ваш товар представлен, нужно нажать на кнопку Показать на сайте Список товаров

# Создание нового товара

  1. Авторизуйтесь в личном кабинете продавца под своими учетными данными.
  2. В разделе Мои товары, нажмите на кнопку Добавить товар в правом верхнем углу.
  3. Заполните обязательные поля:
    • (1) Название - наименование товара, которое будет отражено в карточке товара. Рекомендации по формированию названия товара
    • (2) Категории: выберите категорию к которой относится ваш товар. Смело используйте фильтр для поиска самой подходящей категории. Вы можете указать несколько категорий для каждого товара.
    • (5) Склад: выберите один из ранее созданных складов (магазинов). Как настроить склады
    • (7) Цена: конечная стоимость вашего товара на витрине
    • Налоги: выберите ставку НДС по которой облагается ваш товар
  4. Заполните дополнительные поля:
    • (3) Подробное описание: исполдьзуйте это поле что бы рассказать больше о вашем товаре. Как составить хорошее описание
    • (6) Старая цена: поле используется для отображения цены до скидки, выглядит как зачеркнутая цена в карточке товара. Старая цена должна быть выше стандартной цены.
    • (8) Количество: используется для регулирования доступности товаров для заказа. Товары с количеством 0 нельзя заказать.
  5. Загрузите фото товара (4). Прежде чем загружать фотографии ознакомьтесь с требованиями (opens new window).
  6. По завершению нажмите кнопку Создать в правом верхнем углу.

Внимание

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

  1. Перейдите во вкладку Характеристики и заполните информацию о вашем товаре.
  2. Сохраняйте информацию кнопкой Сохранить (1). Редактировать ваш товар можно пока вы не отправили товара на проверку.
  3. Когда вы считает что указали всю важную информация о товаре, отправьте товар на модерацию соответствующей кнопкой в правом верхнем углу (2).

При успешном прохождении модерации ваш товар появится на витрине, в ином случае вы получите уведомление о необходимости внести правки.

# Создание товаров через шаблон

Мы подготовили специальный шаблон файла через который вы можете создать товары. Каждый файл имеет индивидуальный набор характеристик для каждой из доступных категорий товаров.

  1. Перейдите в раздел Продавцы → Импорт товаров. Раздел импорта
  2. Получите шаблон файла импорта для вашей категории товаров 2 возможными вариантами:
    • Сгенерируйте новый файл шаблона генерация файла
    • Выберите шаблон из ранее доступных в закладке Экспорт товаров Сгенерированные файлы
  3. Заполните согласно инструкциям к полям, не меняйте порядок, формат и название полей, листов. Файлы с изменнной структурой будут отклонятся.

кстати

Пример файла шаблона можно получить по ссылке (opens new window)

  1. Перейдите на закладку товары и загрузите заполненный файл.
  2. Вы можете отслеживать статус обработки импортируемого файла будет находится в разделе Продавцы → Логи импорта Результаты импорта на вкладке логов
  3. Информация о статусе прохождения модерации находится в разделе Товары -> Мои товары. Детали по прохождению моджерации можно получить у вашего менеджера.

Важно

Маркетплейс оставляет за собой право отклонять товары при несоответствии контента правилам а так же может дополнять товары информацией полученной из достоверных источников.

# Добавление товаров через фид

Товарный фид – это специальный файл, в котором определенным образом описан ассортимент интернет-магазина. В нем собраны и структурированы товары и их атрибуты. Мы принимаем фид двух форматов:

  • YML
  • XML

Чаще всего для загрузки прайс-листа/товарного каталога используется формат YML, разработанный на основе стандарта XML.

YML или XML-фид — это текстовый файл, содержащий в себе все сведения об ассортименте и характеристиках товара, записанные в специальных тегах.

# Структура фида

XML-файл имеет следующую структуру.

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="YYYY-MM-DD hh:mm">
 <shop>
  <name>Catalog name</name>
  <company>Company name</company>
  <url>https://site.ru/</url>
  <currencies>
   <currency id="RUB" rate="1"/>
  </currencies>
  <categories>
   <category id="90401">Все товары</category>
   <category id="198118" parentId="90401">Бытовая техника</category>
   <category id="198119" parentId="90401">Электроника</category>
   …
  </categories>
  <offers>
   <offer id="..." available="true">
    <name>...</name>
    <price>...</price>
    <currencyId>RUB</currencyId>
    <categoryId>...</categoryId>
    <picture>...</picture>
    <url>...</url>
    <group_id>...</group_id>
    <vendor>...</vendor>
    <oldprice>...</oldprice>
    <description>...</description>
    <barcode>...</barcode>
    …
    <barcode>...</barcode>
    <param name="...">...</param>
    …
    <param name="...">...</param>
   </offer>
   …
  </offers>
 </shop>
</yml_catalog>

# Правила расположения информации

  1. В фиде в родительском элементе categories содержится список категорий магазина. Каждая категория описывается отдельным элементом category.
  2. В XML-файл выгружаются отдельные варианты товаров — sku. Если у одного товара есть несколько вариантов (например, разного цвета, размера, объема памяти), то каждый из них выгружается в виде товарного предложения — offer.
  3. Список товарных предложений рекламодателя содержится в элементе <offers>. Каждое товарное предложение описывается отдельным элементом <offer> с уникальным идентификатором в рамках фида.
  4. Элементы <categories> в элементе <shop> нужно указать перед списком товарных предложений.

# Значение элементов для описания товарного предложения

Элементы, входящие в <offer>

Элемент Описание Требование
name Название товарного предложения. В названии упрощенного предложения рекомендуется указывать наименование и код производителя. Обязательный
id Идентификатор предложения. Может состоять только из цифр и латинских букв. Максимальная длина — 20 символов. Должен быть уникальным для каждого предложения. Обязательный
URL URL страницы товара. Обязательный
picture Ссылка на изображение. Добавьте несколько изображений соответствующих требованиям, каждое в отдельном элементе <picture>. Обязательный
price Цена, по которой данный товар можно приобрести. Обязательный
model Модель
vendor Производитель
vendorCode Код товара (указывается код производителя). Рекомендуемый
barcode Значение штрихкода производителя Рекомендуемый
description Описание товарного предложения Рекомендуемый
categoryId Идентификатор категории товара, присвоенный рекламодателем (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории. Элемент <offer> может содержать только один элемент <categoryId>. Обязательный
oldprice Старая цена на товар, которая обязательно должна быть выше новой цены (price)
param Передача характеристик и параметров товара. В атрибуте name укажите название параметра (обязательно):
  • Пол/Gender;
  • Цвет/Colour или Color;
  • Материал/Material;
  • Размер/Size.
Пример:
<param name="Цвет">серый</param>
<param name="Материал">алюминий</param>		 Обязательный
count Передача остатка по товару, В случае если тег не найден, у товара будет проставлено доступное количество равное 1 Рекомендуемый

# Требования к YML файлу

  1. В YML нельзя использовать:

    • непечатаемые символы с ASCII-кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки);
    • эмодзи и другие специальные символы Юникода.

  2. Символы " & > < ' нужно заменять на эквивалентные коды: [1]

Символ в тексте Код для YML-файла
" &quot;
& &amp;
> &gt;
< &lt;
' &apos;
  1. Допустимые кодировки YML-файла: UTF-8, windows-1251.
  2. В качестве разделителя целой и дробной частей любых чисел, указанных в качестве значений YML элементов, независимо от региональных установок используется только точка.

# Пример товарного предложения в фиде

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2023-11-22T14:37:38+03:00">
    <shop>
        <name>BestSeller</name>
        <company>Tne Best inc.</company>
        <url>http://b.seller.ru</url>
        <currencies>
            <currency id="RUR" rate="1"/>
        </currencies>
        <categories>
            <category id="1">Бытовая техника</category>
            <category id="10" parentId="1">Мелкая техника для кухни</category>
        </categories>
        <delivery-options>
            <option cost="200" days="1"/>
        </delivery-options>
        <offers>
            <offer id="9012">
                <name>Мороженица Brand 3811</name>
                <url>http://best.seller.ru/product_page.asp?pid=12345</url>
                <price>8990</price>
                <currencyId>RUR</currencyId>
                <categoryId>10</categoryId>
                <delivery>true</delivery>
                <delivery-options>
                    <option cost="300" days="1" order-before="18"/>
                </delivery-options>
                <param name="Цвет">белый</param>
                <count>9</count>
                <weight>3.6</weight>
                <dimensions>20.1/20.551/22.5</dimensions>
                <vendorCode>80gd51505252/1</vendorCode>
                <barcode>504g5057f52521/2</barcode>
            </offer>
        </offers>
        <gifts>
            <!-- подарки не из прайс листа  -->
        </gifts>
        <promos>
            <!-- промоакции  -->
        </promos>
    </shop>
</yml_catalog>

# Как подготовить фид

Для различных платформ существуют как готовые модули так и встроенные возможности для формирования товарных фидов. Вы можете использовать решения которые формируют товарные фиды для Яндекс.Маркет. Маркетплейс Тандем.Online полностью поддерживает формат YML.

Внимание

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

CMS Решение
Insales Инструкция (opens new window)
Opencart Модуль multiYML Pro Edition (opens new window)
1с-Bitrix Инструкция (opens new window)
Tilda Инструкция (opens new window)
WordPress Плагин Экспорт YML (opens new window)
Ucoz Инструкция (opens new window)
HotCMS Инструкция (opens new window)
Ecwid Инструкция (opens new window) (платно)
Joomla Yandex Market XML (opens new window)

# Доступность фида

Прежде чем вы передадите фид для импорта, убедитесь в следующем:

  1. Ваш фид доступен по прямой ссылке и НЕ закрыт авторизацией, в настоящий момент маркетплейс Тандем.Online не поддерживает http-авторизацию но такая задача находится в разработке.
  2. Если фид подготавливается по запросу, проверьте что время на передачу данных укладывается в диапазон до 120 секунд. Если за это время ваша система не успевает сформировать и отдать фид, то проконсультируйтесь с вашим техническим специалистом по возможности кэширования файла.
  3. Фид должен всегда иметь один и тот же статичный адрес (URL). В случае если адрес меняется в зависимости от даты или из-за других причин, то вам необходимо настраивать импорт при каждом изменении адреса (URL).
  4. Проверьте что IP-адрес маркетплейса 158.160.50.76, находится в "белом списке" разрешенных адресов.
  5. Убедитесь, что HTTP-заголовок Content-type, который передает ваш сервер, содержит один из типов ресурса:
application/xml;
application/octet-stream;
text/xml;

# Вопросы и ответы

Как часто происходит проверка файла фида?

Система обращается к файлу каждые четыре часа, обновление цен и остатков происходит практически сразу. Модерация новых товаров может занять время.

Как система работает с остатками?

В настоящий момент система обрабатывает только тег <count>. При установленном остатке равному 0, отсутвии раннее активного товарного предложения в фиде, или при значении атрибута available="false", остаток товара будет установлен 0 и товар не будет доступен для покупки.

  1. Вы можете использовать символы &, >, <, ' в блоке CDATA в описании предложения. ↩︎

← Работа с ценами и остатками →