Переотправка нотификаций

Если ваш сервис был недоступен и пропустил вебхуки по заказам, вы можете запросить их повторную отправку — не дожидаясь следующего изменения статуса.

Когда использовать

• ваш endpoint был недоступен и пропустил нотификации;
• произошла ошибка обработки и данные не сохранились;
• нужно восстановить состояние заказов после сбоя.

Метод

POST /api/v1/notifications/resend — переотправка нотификаций по переданным номерам заказов. Доступен по обычному партнёрскому токену.

Тело запроса:

Результат: Lamoda переотправит все сохранённые нотификации по указанным заказам в хронологическом порядке (код 201 — номера приняты к обработке).

{
  "trackingIdCollection": ["117391950", "117391951"]
}

Что можно переотправить

Переотправка работает на уровне заказа: по каждому переданному номеру заказа заново отправляются все сохранённые нотификации этого заказа в хронологическом порядке — без фильтра по типу события и без учёта того, были ли они уже доставлены. На практике это события статусов заказа и товаров (statusChanged, itemStatusChanged), так как они привязаны к номеру заказа; события поставок FBO по номеру заказа не переотправляются (у них свой идентификатор — код поставки).

Рекомендации

• Переотправляйте события точечно — только по тем заказам, по которым вы действительно потеряли события, а не весь список подряд.
• Не забывайте про идемпотентность: события придут повторно, поэтому обработка событий должна поддерживать обработку дублей (ключ — «id заказа + статус»).

См. также

• Настройка вебхуков
• Синхронизация и события
• Типы событий
• Примеры событий