Переотправка уведомлений в API

Lamoda B2B Platform позволяет запросить повторную отправку нотификаций по заказам. Это полезно, если ваш сервис был недоступен или вы потеряли часть данных.

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

Переотправка нужна в следующих случаях:

• Ваш сервис был недоступен и пропустил нотификации
• Произошла ошибка обработки и данные не сохранились
• Нужно синхронизировать состояние заказов после сбоя
• Вы мигрируете на новую систему и хотите получить актуальные статусы

Метод API

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

Формат запроса

В теле запроса передаётся массив строк с номерами заказов (trackingId). В номере заказа обязательно должен быть указан префикс.

POST /api/v1/notifications/resend
Content-Type: application/json
Authorization: Bearer {access_token}

[
    "RU251201-123456",
    "RU251201-123457",
    "RU251201-123458"
]

Формат ответа

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

HTTP/1.1 201 Created
Content-Type: application/json

[
    {
        "trackingId": "RU251201-123456",
        "inProgressUntil": "2025-12-02 15:52:01"
    },
    {
        "trackingId": "RU251201-123456",
        "inProgressUntil": "2025-12-02 15:52:01"
    },
    {
        "trackingId": "RU251201-123457",
        "inProgressUntil": "2025-12-02 15:52:01"
    }
]

В примере выше для заказа RU251201-123456 будет переотправлено 2 нотификации, для RU251201-123457 — 1 нотификация.

Ограничения

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

Ошибки

400 Bad Request — слишком частый запрос:

{
    "code": 400,
    "message": [
        {
            "trackingId": "RU251201-123456",
            "message": "Resend is available after 2025-12-02 16:07:01"
        }
    ]
}

400 Bad Request — неверный формат trackingId:

{
    "code": 400,
    "message": [
        {
            "trackingId": "123456",
            "message": "This value is not valid."
        }
    ]
}

Порядок переотправки

После успешного запроса Lamoda B2B Platform переотправит для каждого номера заказа все имеющиеся для него нотификации в порядке времени их появления:

1. Сначала statusChanged при создании заказа
2. Затем statusChanged при подтверждении
3. Затем statusChanged при отгрузке
4. И так далее, включая itemStatusChanged

Нотификации отправляются на тот же URL, который настроен для получения нотификаций. Убедитесь, что ваш сервис готов принять повторные нотификации и корректно обработает дубликаты.

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

• Идемпотентность — ваш обработчик должен корректно обрабатывать повторные нотификации с одинаковым sequenceNumber
• Не запрашивайте все заказы — указывайте только те, по которым действительно нужна синхронизация
• Учитывайте нагрузку — при запросе 100 заказов с большой историей изменений вы получите сотни нотификаций
• Мониторьте inProgressUntil — это время, до которого нельзя повторить запрос для этого заказа