«Black Friday + Cyber Monday 2021». Скидки до 42%!Перейти
Полезная информация

Инструкция по настройке плагина "Интеграция с Яндекс.Маркет"

Поддержка Bodysite
Поддержка Bodysite
2 июля 2021 14:43
+1

Содержание:

1. Установка плагина
2. Настройки в личном кабинете Яндекс.Маркет
   2.1. Метод работы
   2.2. Настройки API
      2.2.1. Авторизационный токен
      2.2.2. URL для запросов API
      2.2.3. Тип авторизации
3. Настройки авторизации
4. Настройки DBS
   4.1. ID кампании
   4.2. Авторизационный токен
   4.3. Канал продаж
   4.4. Выбрать склады
   4.5. Настройка ответа по наличию
   4.6. Настройка цен в заказе
   4.7. ID для сопоставления товаров
   4.8. Настройки регионов
      4.8.1. Выбор регионов
      4.8.2. Выбор складов для группы регионов
      4.8.3. Условия доставки для группы регионов
      4.8.4. Способы оплаты для группы регионов
   4.9. Сопоставление смены статусов заказов в Я.Маркет при действиях магазина
   4.10. Сопоставление действий с заказами при запросах из Я.Маркет
5. Настройки FBS
   5.1. ID кампании
   5.2. Авторизационный токен
   5.3. Канал продаж
       5.4. Выбрать склады
   5.5. Настройка ответа по наличию
   5.6. ID для сопоставления товаров
   5.7. Настройка цен в заказе
   5.8. Способы доставки и оплаты в заказе
   5.9. Сопоставление смены статусов заказов в Я.Маркет при действиях магазина
   5.10. Сопоставление действий с заказами при запросах из Я.Маркет
6. Настройки FBS Express
7. Проверка работы API

Как обрабатывать заказы с помощью плагина?

Есть ошибки, как продиагностировать?

Видеоверсия инструкции (именно настройки плагина с 02:03):


1. Установка плагина.

Плагин устанавливается как обычно, через инсталлер. Для его настроек вам нужен доступ к личному кабинету Яндекс.Маркет, на котором находится магазин.

Внимание! Для корректной работы приёма заказов, идентификаторы загруженных товаров (Sku ID/Offer ID) в Маркете должны совпадать с ID товара или ID артикула, либо с Кодом артикула в админ-панели сайта Shop-Script, либо они могут быть в формате из штатного плагина "Яндекс.Маркет": (ID товара + s + ID артикула). Идеально, если товары вы загрузили с помощью плагина "Яндекс.Маркет Про"

2. Настройки API в личном кабинете Яндекс.Маркет

Предполагается, что у вас уже зарегистрирован магазин в Яндекс.Маркет (для моделей DBS и FBS магазины должны быть разные), авторизуйтесь под нужным аккаунтом в Яндексе и перейдите в личный кабинет partner.market.yandex.ru

Выбираем нужный магазин и переходим к его настройкам.

2.1. Метод работы

Левое меню, пункт Настройки - Метод работы. 

Выбираем пункт "Через API"

2.2. Настройки API.

Левое меню, пункт Настройки - Настройки API.

2.2.1 Авторизационный токен

Если авторизационный токен не был создан ранее, нажимаем "Изменить":

Система спросит "Вы точно хотите получить новый ключ?", соглашаемся на это.

В результате будет создан новый токен, нажимаем "Применить"

В дальнейшем он всегда будет доступен на данной странице, пример:

На этой же страницы нужно заполнить URL для запросов и выбрать тип авторизации, об этом далее:

2.3. URL для запросов API

URL для запросов API нужно скопировать из настроек плагина. Внимание, URL для разных моделей (DBS, FBS) отличается!


Вписываем в настроках в Яндекс.Маркет скопированный адрес:

2.4. Тип авторизации

Тип авторизации выбираем "URL":

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

3. Настройки авторизации API

В первую очередь нужно зайти на вкладку "Настройки авторизации API". Здесь предлагается ввести исходящий токен API. 

Чтобы его получить:

1) Нужно быть авторизованным на Яндексе под логином, имеющим права администратора магазина. Внимание! Логин с правами "владельца" не подходит.  Сменить авторизацию удобнее всего в почте Яндекса.

2) Переходим по ссылке из подсказки, разрешаем доступ.

3) В результате, на странице будет выдан токен, который и вводим в настройках плагина и нажимаем "Сохранить".

4. Настройки DBS

Перейдите на вкладку "DBS"

Чтобы плагин отвечал на запросы Яндекс.Маркет, активируйте галочку работы по модели:

4.1. ID кампании

ID кампании берется из личного кабинета Яндекс.Маркет, например:

Копируем номер без "11-" и вписываем в настройках плагина.

4.2 Входящий авторизационный токен

Входящий токен берется из настроек магазина DBS, мы его создавали в пункте 2.2:

Вписываем в настройках плагина:

4.3. Канал продаж

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

В дальнейшем по нему будет удобно фильтровать заказы:

4.4. Выбрать склады

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

4.5. Настройка ответа по наличию

В данном пункте вы можете указать любое значение кол-ва товара "в наличии", вместо реальных значений. При API запросах из Яндекс.Маркета реальное наличие будет подменяться вашими значениями. Например, вместо 2000 можно ответить 0. Либо, если у товара наличие "бесконечность", но вы понимаете, что больше 30 штук не сможете продать. Укажите inf = 30.

4.6 Настройка цен заказа

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

Возможные варианты:

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

- из маркетплейса, с учетом скидок. В этом случае в заказе будет использоваться цена товара, полученная из запроса маркетплейса Яндекс.Маркет. Все скидки маркетплейса будут учтёны в заказе, то есть итоговая сумма будет именно та, которую оплачивает покупатель. Этот вариант удобен для тех, кому нужно распечатать чек для покупателя по модели DBS;

- из маркетплейса, не учитывать скидки. В заказе будет использоваться цена товара, полученная из маркетплейса. Если маркетплейс предоставил скидку покупателю, она не будет учитываться в таком заказе, так как магазин все равно получит за неё компенсацию. Предпочтительный вариант для моделей FBS.

4.7. ID для сопоставления товаров

В данном пункте нужно выбрать по какому ID искать товар в магазине, это могут быть: ID товара / ID артикула / "Код артикула" / ID товара + s + ID артикула.

Подробнее про них:

ID товара и ID артикула - это системные значения Shop-script, они формируются при создании товара и никогда не изменяются.

ID товара

Отображается на странице редактирования товара: 

ID артикула

Отображается при редактировании артикулов:

Код артикула

Это произвольное значение, которое можно заполнить внутри редактирования товара: 

ID товара + s + ID артикула

Данный формат применяется при выгрузке товаров через штатный плагин "Яндекс.Маркет". В этом случае в качестве offerID для артикулов применяется, например: 1234s4567. Если у товара нет артикулов, то просто ID товара - 1234.

Выбранные значения должны соответствовать с теми, что у вас уже загружены в Яндекс.Маркет ранее.

Если для выгрузки товаров используется плагин "Яндекс.Маркет PRO", то в стандартном варианте используется ID товара, а если активна галочка "Экспортировать каждый артикул как отдельную позицию", то ID артикула.

4.8. Настройки регионов

4.8.1 Выбор регионов

Нажимаем кнопку "Добавить регион":

Появляется блок настройки нового региона.

Название группы регионов используется только для блока в настройках, для пользователей оно нигде не выводится.

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

Можно искать: города, городские округа, области, федеральные субъекты, страны.

Внимание! Поиск здесь не интеллектуальный, нет подсказок, нет поиска по части слова. Название должно быть введено полностью, примеры:

  • Свердловская область
  • Республика Башкортостан
  • Москва (только город Москва)
  • Москва и Московская область (Москва + Область)
  • Челябинский городской округ
  • Санкт-Петербург (если нужен только Санкт-Петербург)
  • Санкт-Петербург и Ленинградская область (если нужно Санкт-Петербург + область)
  • Приволжский федеральный округ

Можно добавлять несколько субъектов, тем самым объединяя их в группу с одинаковыми условиями. Можно добавить субъект в исключения, в этом случае, на него не будут распространяться условия, указанные в этой группе региона. Например, вы настроили доставку для "Москва и Московская область", но не хотите доставлять в Зеленоград, добавляем его в исключения:

4.8.2 Выбор складов для группы регионов

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

В случае выбора пункта "По умолчанию" - настройка учитывает выбор складов для всей модели, тот что был сделан в пункте 4.3.

4.8.3. Условия доставки для группы регионов

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

Внимание: 1) Условия должны совпадать с указанными в личном кабинете Яндекс.Маркета. 2) С июля 2021 года Яндекс.Маркет сам назначает стоимость доставки, поэтому в плагине такой настройки нет. Однако, в настоящее время Маркет не принимает пустое поле стоимости, поэтому временно стоимость нужно указывать в личном кабинете в размере 250 рублей для любого региона. Самовывоз - 0 рублей.

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

У курьерской доставки можно задать диапазон сроков доставки и время переноса. Здесь же можно указать выходные дни, если в них не осуществляется доставка.

Вы можете выбрать внутренний способ доставки, который будет выбран при создании заказа в админ-панели. Это бывает необходимо для работы с другими системами - 1C, Мой склад, RetailCRM или подобными. Если в заказе данное поле будет пустым, это может вызывать ошибки при синхронизации с этими платформами. Данное действие не обязательно, для большинства магазинов не критичны пустые поля.

Для самовывоза нужно создать точки выдачи заказов:

Название точки выдачи будет показано покупателю в вариантах доставки.

ID точки самовывоза должен совпадать с указанными в настройках в личном кабинете Яндекс.Маркет (Настройки - Точки продаж)

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

Аналогично курьерской доставки, в данном варианте выдачи товара можно выбрать внутренний способ доставки:

4.8.4. Способы оплаты для группы регионов

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

В выпадающих полях укажите внутренний способ оплаты, который будет выбран при создании заказа в админ-панели. Это бывает необходимо для работы с другими системами - 1C, Мой склад, RetailCRM или подобными. Если в заказе данное поле будет пустым, это может вызывать ошибки при синхронизации с этими платформами. Данное действие не обязательно, для большинства магазинов не критичны пустые поля.

После создания региона нужно обязательно нажимать кнопку "Сохранить группу":

4.9. Сопоставление смены статусов заказов в Я.Маркет при действиях магазина DBS

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

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

4.10. Сопоставление действий с заказами при запросах из Я.Маркет

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

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

Сами действия и статусы в магазине настраиваются стандартными средствами Shop-script:


5. Настройки FBS

Чтобы плагин отвечал на запросы Яндекс.Маркет, активируйте галочку работы по модели:

5.1. ID кампании

ID кампании берется из личного кабинета Яндекс.Маркет, например:

Копируем номер без "11-" и вписываем в настройках плагина.


5.2 Авторизационный токен

Токен берется из настроек магазина FBS, мы его создавали в пункте 2.2:

Вписываем в настройках плагина:

5.3. Канал продаж

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

В дальнейшем по нему будет удобно фильтровать заказы:

5.4. Выбрать склады

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

5.5. Настройка ответа по наличию

В данном пункте вы можете указать любое значение кол-ва товара "в наличии", вместо реальных значений. При API запросах из Яндекс.Маркета реальное наличие будет подменяться вашими значениями. Например, вместо 2000 можно ответить 0. Либо, если у товара наличие "бесконечность", но вы понимаете, что больше 30 штук не сможете продать. Укажите inf = 30.

5.6. ID для сопоставления товаров

В данном пункте нужно выбрать по какому ID искать товар в магазине, это могут быть: ID товара / ID артикула / "Код артикула" / ID товара + s + ID артикула.

Подробнее про них можно узнать в этом пункте инструкции

Данные значения должны соответствовать с тем, что у вас выбраны в выгрузке (в фиде).

Если для выгрузки товаров используется плагин "Яндекс.Маркет PRO", то в стандартном варианте используется ID товара, а если активна галочка "Экспортировать каждый артикул как отдельную позицию", то ID артикула.

5.7. Настройка цен заказа

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

Возможные варианты:

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

- из маркетплейса, с учетом скидок. В этом случае в заказе будет использоваться цена товара, полученная из запроса маркетплейса Яндекс.Маркет. Все скидки маркетплейса будут учтёны в заказе, то есть итоговая сумма будет именно та, которую оплачивает покупатель. Этот вариант удобен для тех, кому нужно распечатать чек для покупателя по модели DBS;

- из маркетплейса, не учитывать скидки. В заказе будет использоваться цена товара, полученная из маркетплейса. Если маркетплейс предоставил скидку покупателю, она не будет учитываться в таком заказе, так как магазин все равно получит за неё компенсацию. Предпочтительный вариант для моделей FBS.

5.8. Способы доставки и оплаты, которые будут выбраны в заказе

В данной настройке вы можете указать внутренний способ доставки и способ оплаты, который будет выбран при создании заказа в админ-панели. Это бывает необходимо для работы с другими системами - 1C, Мой склад, RetailCRM или подобными. Если в заказе данное поле будет пустым, это может вызывать ошибки при синхронизации с этими платформами. Данное действие не обязательно, для большинства магазинов не критичны пустые поля.

5.9. Сопоставление смены статусов заказов в Я.Маркет при действиях магазина FBS

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

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

5.10. Сопоставление действий с заказами при запросах из Я.Маркет

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

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


Сами действия и статусы в магазине настраиваются стандартными средствами Shop-script:

6. Настройки FBS Express

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

Настройки аналогичны профиля для FBS. Заполните номер магазина и входящий токен в настройках.

Заказы в общем списке имеют свою заметную иконку для более оперативной обработки:

После любых внесённых изменений обязательно нажимайте кнопку "Сохранить".

Теперь плагин готов к работе.

7. Проверка работы API

В личном кабинете Яндекс.Маркет вы можете проверить работу API и плагина с помощью интерфейса тестовых заказов. Он доступен магазинам, загрузившим товары и прошедшим проверку документов.

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

Смотрите также: