Как работать с уведомлениями

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

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

Маркет обменивается данными только с магазинами, которые работают по протоколу HTTPS с использованием SSL-сертификата. Он должен быть подписан официальным центром сертификации, самоподписанный сертификат не подойдет. Информацию о центрах сертификации можно найти в интернете.

Подключение интеграции

Чтобы получать уведомления от Маркета:

1. В кабинете продавца на Маркете нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули → вкладка API-уведомления.

2. Нажмите кнопку Подключить уведомления.

3. Укажите название уведомления — оно понадобится только для поиска уведомления в списке.

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

   
   

   	Уведомления приходят	Роль, необходимая для настройки уведомления Какие бывают роли
   кабинет	для всех магазинов кабинета	владелец кабинета или менеджер кабинета
   магазин	для конкретного магазина	любая роль, кроме контент-менеджера

5. Выберите типы уведомлений, которые хотите получать:

   Уведомление	Приходит для кабинета	Приходит для магазина
   создание заказа	✔️	✔️
   изменение заказа	✔️	✔️
   изменение статуса заказа	✔️	✔️
   отмена заказа	✔️	✔️
   создание заявки на отмену заказа	✔️	✔️
   создание возврата или невыкупа	✔️	✔️
   изменение статуса возврата или невыкупа	✔️	✔️
   новый отзыв	✔️
   новый комментарий к отзыву	✔️
   новый чат с покупателем	✔️
   новое сообщение в чате	✔️
   начало спора	✔️
   завершение спора	✔️

   ⚠️ Если уведомления, связанные с заказами, настроены для кабинета, они приходят и по FBY-заказам.

6. Введите ссылку, куда Маркет будет отправлять уведомления. Укажите ее целиком, включая протокол HTTPS.

7. Нажмите кнопку Подключить. Созданные уведомления появятся в кабинете сразу, но приходить они начнут в течение 2 минут.

Проверка интеграции

Чтобы проверить работоспособность интеграции, Маркет отправит запрос POST notification, где в теле будет проверочное уведомление с типом PING.

{
  "notificationType": "PING",
  "time": "2025-01-16T10:09:49.759084017Z"
}

Верните ответ с кодом 200 и информацией об обработке уведомления в течение 10 секунд. Интеграция не подключится при передаче другого кода, некорректных или недостаточных данных. Возможные ошибки

{
  "version": "1.0.0",
  "name": "name",
  "time": "2025-01-16T10:09:49.759084017Z"
}

Ответ на запрос

Таймаут на ответ составляет 10 секунд.

• Если запрос был корректным, верните код 200 с информацией об обработке уведомления. Тело ответа

• Если Маркет прислал некорректное уведомление, верните код 400 с описанием ошибки. Маркет проанализирует такие ответы и доработает API со своей стороны. Тело ответа

• Если произошла техническая ошибка на вашей стороне, верните код 500. Тело ответа

Подробную информацию по запросам и ответам, в том числе ошибки, можно посмотреть в кабинете продавца на Маркете — нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули → вкладка Лог уведомлений. Подробнее об этом читайте в разделе Логи запросов.

Возможные ошибки

API магазина не отвечает

Если магазин не укладывается в десятисекундный таймаут или на запрос POST notification возвращает ошибку, кроме 400, Маркет:

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

• Повторяет проблемный запрос:

  1. Каждую минуту в течение первого часа.
  2. Раз в 15 минут в течение первого дня.
  3. Далее раз в час.

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

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

Управление уведомлениями