Типы уведомлений в API

B2B Platform API Lamoda отправляет три типа нотификаций для отслеживания изменений в заказах и поставках.

Обзор типов

statusChanged — Статус заказа

Отправляется при изменении статуса всего заказа (New → Confirmed → Shipped → Delivered и т.д.)

{
  "type": "statusChanged",
  "trackingId": "117391950",
  "data": {
    "id": "CZ117391950",
    "status": "Delivered",
    "paymentMethod": "COD",
    "fullSum": "12000",
    "deliveryPrice": "250.00",
    "createdAt": "2025-05-25",
    "updatedAt": "2025-05-29 18:00:15",
    "dates": {
      "delivered": "2025-05-29 17:48:00",
      "shipped": "2025-05-27 23:26:15"
    },
    "currency": "rub",
    "items": [
      {
        "status": "Delivered",
        "finalERPStatus": "sold",
        "id": 7598,
        "datamatrix": null,
        "description": "Ice berg",
        "paidPrice": 12000,
        "sku": "SELLERSKU104"
      }
    ],
    "shippingAddress": {
      "zipcode": "115114",
      "region": "Москва",
      "city": "Москва",
      "street": "Летниковская",
      "houseNum": "д.2 с1",
      "apartment": "909",
      "pickupPointId": null
    },
    "deliveryMethod": {
      "deliveryDate": "2025-05-29",
      "deliveryIntervalFrom": "15:00",
      "deliveryIntervalTo": "18:00",
      "shippingMethodName": "Курьерская доставка Lamoda Express",
      "shippingMethodCode": "lamoda",
      "cutOff": "2025-06-04 03:00:00"
    },
    "customer": {
      "firstName": "Иван",
      "lastName": "Каминский",
      "phone": "+79016666666"
    }
  },
  "date": "2025-05-29 18:00:15",
  "sequenceNumber": 5
}

itemStatusChanged — Статус товара

Отправляется при изменении статуса отдельного товара. Важно при частичном выкупе, когда заказ "Delivered", но один товар "Not bought".

{
  "type": "itemStatusChanged",
  "trackingId": "20018856",
  "data": {
    "id": "CZ20018856",
    "status": "Delivered",
    "items": [
      {
        "status": "Delivered",
        "finalERPStatus": "sold",
        "id": 12345,
        "sku": "SKU-001",
        "paidPrice": 3000,
        "datamatrix": "010467003301005321gJk6..."
      },
      {
        "status": "Not bought",
        "finalERPStatus": "rejected",
        "id": 12346,
        "sku": "SKU-002",
        "paidPrice": 0,
        "statusChangeReason": "Не подошёл размер"
      }
    ],
    "itemQuantity": 2
  },
  "date": "2025-12-02 16:11:30",
  "sequenceNumber": 4
}

fulfilmentShipmentStatusChanged — Статус поставки FBO

Отправляется при изменении статуса входящей FBO-поставки на склад Lamoda.

{
  "type": "fulfilmentShipmentStatusChanged",
  "data": {
    "id": "SUPPLY-2025-12-001",
    "status": "Received",
    "warehouseCode": "bykovo",
    "date": "2025-12-05",
    "items": [
      {
        "sku": "SELLER-SKU-001",
        "ean": "4607123456789",
        "quantity": 100,
        "receivedQuantity": 98,
        "datamatrixes": ["010467003301005321gJk6..."]
      }
    ],
    "createdAt": "2025-12-02T10:30:00Z",
    "updatedAt": "2025-12-05T14:20:00Z"
  },
  "date": "2025-12-05 14:20:00",
  "sequenceNumber": 3
}

Статусы поставки

Структура нотификации

Все нотификации имеют общие поля:

Полная структура data в нотификации заказа

В data всегда передается полная информация о заказе:

• Основное: id, status, paymentMethod, fullSum, currency, createdAt, updatedAt
• Даты: dates.delivered, dates.shipped
• Товары: items[] — все товары с их статусами
• Адрес: shippingAddress — полный адрес или pickupPointId
• Доставка: deliveryMethod — способ, дата, интервал, cutOff
• Клиент: customer — ФИО, телефон, email
• Трекинг: tracking — ID и URL для отслеживания

Сценарий: частичный выкуп

Пример последовательности нотификаций при частичном выкупе (2 товара, 1 выкуплен):

Доступность по моделям

См. также

• Настройка нотификаций (Webhooks)
• Статусы заказов
• Создание поставки FBO