Яндекс.Маркет

Модуль предназначен для экспорта товаров в Яндекс.Маркет с использованием партнерского API Маркета. Помогает управлять ассортиментом, ценами, обрабатывать заказы, обновлять остатки. Для выгрузки через YML-файл используйте бесплатный функционал.

Перейдите в раздел Экспорт/Импорт → Яндекс.Маркет,выгрузку можно добавит для каждого магазина.

нажмите Добавить и внесите данные для обмена с Яндекс.Маркетом:

Для работы модуля необходимы API key, идентификатор кабинета (business_id) и идентификатор кампании (campaign_id). Они доступны в личном кабинете Маркета:

1. В кабинете в левом нижнем углу нажмите на название своего бизнеса и перейдите на страницу Модули и API.
2. В блоке Авторизационные токены нажмите кнопку Создать или Создать новый токен, если вы уже получали его.
3. В открывшемся окне укажите уникальное название токена, выберите доступы для этого токена - "Полное управление кабинетом" и нажмите кнопку Создать.
4. Скопируйте полученный токен в поле "API Key" в настройках выгрузки.
5. На этой же странице Модули и API в блоке "Передача данных Маркету" возьмите значения идентификатора кабинета и идентификатора кампании и внесите в соответствующие поля выгрузки.

Подробнее описано в документации Маркета.

• API key - ключ API.
• Идентификатор кабинета - business_id из настроек Маркета.
• Идентификатор кампании - campaign_id из настроек Маркета.
• Свойство с доп.изображениями - свойство с доп. изображениями, из которого будут грузиться дополнительные изображения товаров при выгрузке в Маркет.
• Свойство с видео - свойство с видео, из которого будут грузиться видео для товаров при выгрузке в Маркет.
• Уникальное значение товара - уникальное значение товара в каталоге Маркета.
• Наценка, в % - наценка на товар, в %, по умолчанию 0. При установке 100% цена будет в два раза больше исходной.
  
• Цена - цена, которую выгружать.
• Выгружать по свойству - позволяет ограничить выборку выгружаемых новых товаров, при установке свойства будут выгружаться только товары, у которых установлен флажок в свойстве.
• Не выгружать по свойству - позволяет ограничить выборку выгружаемых новых товаров, при установке значения свойства, такие товары не будут выгружаться.
• Схема работы - схема работы с Маркетом.
• Обновлять остатки и цены для невыгруженных товаров - обновлять остатки и цены для невыгруженных товаров.
• Выгружать модификации товаров - выгружать модификации для товаров.
• Выгружать ярлыки товаров - выгружать ярлыки товаров.
• Выгружать товары только в наличии - выгружать новые товары только в наличии на складе, имеющие связь с Маркетом товары (ранее выгруженные) также будут выгружаться.
  
• Выгружать товары с ценой - выгружать новые товары только с заданной ценой, имеющие связь с Маркетом товары (ранее выгруженные) также будут выгружаться.
• Выгружать товары из подгрупп - выгружать товары из подгрупп.
  
• Использовать autocomplete для дополнительных свойств - при большом количестве дополнительных свойств, вместо выпадающего списка, будет выведено поле для ввода названия свойства с подстановкой.
  
• Учитывать скидки на товары - позволяет выгружать цены товаров без учета скидок.
• Использовать только переданные данные о товарах - Маркет будет использовать только переданные данные и не будет добавлять свои данные на основе других похожих товаров других продавцов на Маркете.
• Отправлять уведомления о поступивших заказах - формировать нотификации в центре администрирования сотрудникам, подписанным на получение уведомлений от магазина.

Для работы с конкретным магазином перейдите в раздел Экспорт/Импорт → Яндекс.Маркет, нажмите на название магазина, отобразится список выгруженных товаров со статусами обмена, датами и ошибками выгрузки (например, несоответствие параметров требованиям Маркета).

Загрузить все товары с Маркета

Выберите Загрузить → Загрузить все товары с Маркета, выполнит связь товаров в магазине с товарами в Маркете, товары в магазине не создаются, только связь существующих товаров по артикулу или идентификатору товара. В случае, если товары на Маркет добавлялись ранее и не были выгружены из магазина, связь можно осуществить только если в настройках указано уникальное значение товара в Маркете - Артикул.

Раздел "Категории"

В разделе представлен список категорий, загруженных с Маркета. Создание товаров доступно только в категориях последнего уровня, соответственно вам необходимо сопоставить именно эти категории с категориями своего магазина. Для одной категории Маркета можно указать несколько групп интернет-магазина, при этом группа магазина может быть выбрана только для одной категории Маркета.

Группы в API могут отличаться от групп в кабинете Маркета, если вы не нашли требуемую группу, проверьте ее наличие в файле /hostcmsfiles/tmp/hostcms_yandexmarket_groups.json, в случае, если группы и там нет, то такая группа для взаимодействия через API не выгружается и необходимо найти подходящую группу с другим названием.

Для загрузки атрибутов выбранной группы необходимо нажать кнопку "Обновить характеристики".

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

Кроме общего соответствия групп, для каждого товара можно персонально выбрать другую группу Маркета на соответствующей вкладке при редактировании товара

Характеристики категории

Характеристики зависят от категории товара на Маркете и требуется указание как минимум обязательных характеристик при экспорте товаров. Вам необходимо расставить соответствия характеристик и дополнительных свойств товаров магазина. От заполненности характеристик будет зависеть качество карточки товара на Маркете.

Раздел "Соответствия"

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

Раздел "Склады"

В разделе выбираются соответствия склада магазина и склада, созданного на Маркете.

Выгрузить товары

Выберите Выгрузить → Выгрузить все товары на Маркет. 

Выберите Выгрузить → Выгрузить новые товары на Маркет. Будут выгружены только те товары, которые ни разу не выгружались из модуля на Маркет и с которыми нет связи в таблице выгруженных товаров (независимо от статуса выгрузки товара).

Раздел "Заказы"

В разделе представлен список заказов Маркета. Заказы запрашиваются через меню Загрузить.

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

Уведомления

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

1. В кабинете в левом нижнем углу нажмите на название своего бизнеса и перейдите на страницу API-уведомления. 
2. Нажмите кнопку Подключить или Подключить ещё уведомления, если вы уже их создавали.
3. Укажите название уведомления — оно понадобится только для поиска уведомления в списке.
4. Выберите уведомления для магазина и типы уведомлений.
5. В качестве URL для уведомлений указываете адрес https://mysite.ru/hostcms/yandexmarket/{id}/

вместо {id} указываете идентификатор выгрузки из списка выгрузок (поле Код) на главной странице модуля.

Отладочная информация

Модуль позволяет просматривает отправляемые JSON-данные и ответы, для этого в строке браузера после всех GET-параметров добавьте &hostcms_yandexmarket_debug, затем выполните требуемое действие и система покажет отправленные данные и полученный ответ.

Информация о разработчике:

• Разработчик: Hostmake LLC
  
• Вопросы по модулю: support@hostcms.ru
  
• Поддержка: support@hostcms.ru