Интеграция с Яндекс.Маркет

1. Авторизация
2. Импорт товаров
3. Настройка синхронизации
   • FBS
   • DBS
4. Экспорт товаров
5. Проверка подключения
6. Исправление ошибок

Яндекс.Маркет отправляет в inSales:

• запрос на остатки;
• запрос на новый заказ;
• смена статусов.

inSales отправляет в Яндекс.Маркет:

• изменение остатков;
• изменение цен;
• статусы (Готов к отгрузке и Отмена).

Авторизация

1. Перейдите в раздел Каналы продаж, в карточке "Яндекс.Маркет" нажмите "Подключить":

2. Пройдите авторизацию или зарегистрируйтесь:

3. Авторизуйтесь под аккаунтом, который привязан к Яндекс.Маркету:

4. Выберите магазин:

5. Скопируйте токен в личном кабинете Яндекс.Маркета и укажите его в inSales:

Важно: после генерации токена в Яндекс.Маркете нажмите "Применить", иначе токен будет неактивным:

6. Далее сгенерируется адрес для запросов API. Скопируйте и укажите в личном кабинете Яндекс.Маркета.

7. Выберите тип авторизации "HEADER" в Яндекс.Маркете и нажмите "Подключить":

Импорт товаров

При необходимости выгрузить товары с Яндекс.Маркета используйте функцию импорта:

После нажатия на кнопку "Получить информацию о товарах из Яндекс.Маркет":

• система запрашивает товары, которые существуют в Яндекс.Маркете;
• из полученного списка фильтруются те, которые уже созданы в inSales;
• несозданные товары система пытается связать с существующими в inSales;
• если похожих не обнаружено, подготавливается импорт для них;
• отобразится сводная таблица с информацией по товарам и появится кнопка "Создать новые товары в inSales". 

Важно: Яндекс.Маркет не имеет полноценную выгрузку товаров на другие площадки. После импорта новых товаров из Яндекс.Маркета в inSales по API некоторые товары или часть информации по товарам могут не выгрузиться. Это зависит от того, какие данные отдает Яндекс.Маркет по API.

При выгрузке информации по товарам из личного кабинета Яндекс.Маркета в файл доступен такой же объем данных, как и при импорте по API. 

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

Подробнее об импорте

При наличии одинаковых товаров в Яндекс.Маркете и inSales доступна возможность связать их предварительно, запустив процесс вручную:

При появлении новых товаров в inSales, которые есть в Яндекс.Маркет и не связаны между собой, необходимо также воспользоваться вышеописанной функцией. Функция доступна в разделе "Авторизация".

Настройка синхронизации

• FBS
• DBS

Сопоставление товаров при синхронизации остатков и цен происходит по атрибутам товара:

• variant_id;
• sku, артикул должен быть уникальным;
• product_id, сопоставление по id товара идет, если у товара один вариант.
  

Все товары, которые были связаны, подключаются в канал продаж.

FBS

1. Перейдите в раздел "Настройки".

2. Выберите вкладку "Настройки синхронизации":

3. При настройке интеграции Яндекс.Маркет может потребовать включение режима самопроверки нулевых остатков для открытия доступа по API:

4. Если в аккаунте есть мультисклады, то необходимо сопоставить склад Яндекс.Маркета с нужным складом в inSales. При изменении склада и обновлении настроек в Яндекс.Маркет будут отправляться остатки по товарам в зависимости от того склада, с которым сопоставлен в настройках.

5. Для синхронизации цен необходимо установить галочку и выбрать тип цены, который необходимо выгружать в качестве цены продажи:

При переключении типа цен и обновлении настроек в Яндекс.Маркете обновятся цены по всем товарам.

При синхронизации цен обновляются две цены: цена продажи и старая цена.

Цена продажи передается, если она больше 0.

Если в качестве цены продажи выбран отдельный тип цены, а не цена продажи по умолчанию, и цена у товара не заполнена и указан прочерк ('-'), то в Яндекс.Маркет цена не отправится.

Старая цена передается, если она больше цены продажи.

Если синхронизация цен включена, то также доступна функция ручного обновления цен.

Необходимо выбрать тип цены и после этого запустить обновление. Цены отправятся по указанному типу цены:

6. Обновление остатков работает автоматически.

При необходимости можно запустить вручную:

7. Выберите способы доставки и оплаты по умолчанию.

В интеграции поддерживаются только способы доставки типа "Доставка с фиксированной стоимостью" и "Самовывоз (не требует ввода адреса доставка)". Если для интеграции создается свой способ доставки, его необходимо создать с одним из этих типов.

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

• если настройка включена, то сумма заказа будет состоять из стоимости, которую заплатил покупатель, и бонусов, которые возмещает Яндекс.Маркет;
• если настройка отключена, то сумма заказа будет состоять только из той стоимости, которую заплатил покупатель. 

8. Сопоставьте статусы заказов. Статусы должны быть уникальными.

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

DBS

1. Перейдите в раздел "Настройки → Настройки синхронизации":

2. При настройке интеграции Яндекс.Маркет может потребовать включение режима самопроверки нулевых остатков для открытия доступа по API:

3. Если в аккаунте есть мультисклады, то необходимо сопоставить склад Яндекс.Маркета с нужным складом inSales. При изменении склада и обновлении настроек в Яндекс.Маркет будут отправляться остатки по товарам в зависимости от того склада, с которым сопоставлен в настройках.

4. Для синхронизации цен необходимо установить галочку и выбрать тип цены, который необходимо выгружать в качестве цены продажи:

При переключении типа цен и обновлении настроек в Яндекс.Маркете обновятся цены по всем товарам.

При синхронизации цен обновляются две цены: цена продажи и старая цена.

Цена продажи передается, если она больше 0.

Если в качестве цены продажи выбран отдельный тип цены, а не цена продажи по умолчанию, и цена у товара не заполнена, и указан прочерк ('-'), то в Яндекс.Маркет цена не отправится.

Старая цена передается, если она больше цены продажи.

Если синхронизация цен включена, то также доступна функция ручного обновления цен.

Необходимо выбрать тип цены и после этого запустить обновление. Цены отправятся по указанному типу цены:

5. Обновление остатков работает автоматически. 

При необходимости можно запустить вручную:

6. Включите настройку учета бонусов от Яндекс.Маркета:

• если настройка включена, то сумма заказа будет состоять из стоимости, которую заплатил покупатель, и бонусов, которые возмещает Яндекс.Маркет;
• если настройка отключена, то сумма заказа будет состоять только из той стоимости, которую заплатил покупатель. 

7. Нажмите "Обновить данные о точках самовывоза":

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

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

8. Сопоставьте способы доставки:

Сопоставляйте только те способы, которые используются.

В качестве срока передачи в службу доставки укажите количество дней до передачи в службу доставки от 0 до 30.

Если "0" , значит, передача в службу доставки будет в день заказа. Если "1" — на следующий день и так далее.

В интеграции поддерживаются только способы доставки типа "Доставка с фиксированной стоимостью" и "Самовывоз (не требует ввода адреса доставка)". Если для интеграции создается свой способ доставки, его необходимо создать с одним из этих типов.

Выберите способ доставки по умолчанию. 

9. Сопоставьте способы оплаты и выберите способ по умолчанию:

10. Сопоставьте статусы заказа. Они должны быть уникальными.

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

Экспорт товаров

Важно: скрытые в inSales товары выгружаться на Яндекс.Маркет не будут.

1. В разделе "Настройки → Экспорт товаров" располагается товарный фид, для его настройки необходимо нажать по его названию:

2. Выберите, из каких категорий выгружать товары:

3. Укажите название магазина и компании, которые будут передаваться в фиде:

4. Выберите способ формирования наименования товара:

5. Укажите, какое описание товара выгружать:

При необходимости включите передачу XHTML-разметки описаний.

6. Укажите, в каком параметре хранится информация о производителе, какие параметры дополнительно выгружать и использовать ли артикул в качестве кода производителя:

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

Параметры и свойства товарам можно назначить в личном кабинете Яндекс.Маркета. 

7. Настройте выгрузку старой цены, отсутствующих товаров и штрихкода под свои требования.

При включении настройки "Не выгружать отсутствующие товары" товары с нулевым остатком не будут добавляться в выгрузку.

8. Заполните UTM-метку для ее автоматического добавления к URL товара в выгрузке:

9. Сохраните фид. Скопируйте его адрес:

10. Перейдите в личный кабинет Яндекс.Маркета и укажите ссылку на фид:

Проверка подключения

1. В личном кабинете Яндекс.Маркета перейдите в кабинет и выберите "Отладка":

2. Выполните задания:

3. По итогу выполнения большинства заданий должен будет создаться тестовый заказ в панели администратора inSales. Перейдите в раздел Заказы ⟶ Все заказы и проверьте, пришёл ли тестовый заказ. 

При обмене данными со стороны Яндекса бывают задержки в отправке статусов около одной-двух минут.

Исправление ошибок

1. В личном кабинете Яндекс.Маркета перейдите в раздел "Настройки ⟶ Лог запросов".

2. Отобразятся две вкладки: "К вашему серверу" и "К серверу Яндекс.Маркета". Нужны последние по времени запросы в обеих вкладках.

3. Нажмите на шестеренку в столбце "Детали" и отправьте содержимое вкладок "Запрос" и "Ответ" у каждого запроса.

4. Результаты отправьте в техническую поддержку.