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

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

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

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

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

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

1. В кабинете в левом нижнем углу нажмите на название своего бизнеса и перейдите на страницу API-уведомления.

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

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

4. Выберите:

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

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

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

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 возвращает код 500, Маркет повторяет запросы:

1. Каждые 10 минут в течение первого часа.
2. Раз в час в течение следующих суток.
3. Далее раз в 6 часов.

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

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

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