Типы нотификаций

Lamoda B2B Platform Partner API Lamoda отправляет нотификации (webhooks) при изменении статусов заказов, товаров и поставок. На этой странице описаны все типы нотификаций, их структура и поведение.

Обзор типов

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

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

Нотификация содержит полную информацию о заказе, включая все товары, адрес, способ доставки и данные клиента.

{
  "type": "statusChanged",
  "trackingId": "117391950",
  "data": {
    "id": "CZ117391950",
    "status": "Delivered",
    "paymentMethod": "COD",
    "fullSum": "12000.00",
    "basePrice": 12000,
    "salePrice": 12000,
    "paidPrice": 12000,
    "partnerAgreedPrice": 12000,
    "couponDiscount": 0,
    "loyaltyDiscount": 0,
    "partnerAgreedDiscount": 0,
    "otherDiscounts": 0,
    "totalDiscount": 0,
    "deliveryPrice": "250.00",
    "rejectPrice": 150,
    "itemQuantity": 1,
    "currency": "rub",
    "shippingType": "fulfilment",
    "platform": "marketplace",
    "comment": null,
    "confirmationFailedCode": null,
    "confirmationFailedReason": null,
    "externalOrderNumber": null,
    "externalTrackingNumber": [],
    "createdAt": "2025-05-25",
    "updatedAt": "2025-05-29 18:00:15",
    "paymentDate": null,
    "dates": {
      "delivered": "2025-05-29 17:48:00",
      "shipped": "2025-05-27 23:26:15"
    },
    "items": [
      {
        "id": "7598",
        "status": "Delivered",
        "finalERPStatus": "sold",
        "sku": "SELLERSKU104",
        "description": "Кроссовки Nike Air Max",
        "size": "42",
        "basePrice": "12000.00",
        "salePrice": "12000.00",
        "paidPrice": "12000.00",
        "partnerAgreedPrice": "12000.00",
        "couponDiscount": "0.00",
        "loyaltyDiscount": "0.00",
        "partnerAgreedDiscount": "0.00",
        "otherDiscounts": "0.00",
        "totalDiscount": "0.00",
        "datamatrix": null,
        "datamatrixCode": null,
        "statusChangeReason": null,
        "discrepancyAct": null
      }
    ],
    "shippingAddress": {
      "id": 12345,
      "zipcode": "115114",
      "region": "Москва",
      "city": "Москва",
      "street": "Летниковская",
      "houseNum": "д.2 с1",
      "apartment": "909",
      "cityId": "7700000000000",
      "streetId": "77000000000170700",
      "buildingId": "770000000001707000001",
      "pickupPointId": null
    },
    "deliveryMethod": {
      "deliveryPrice": "250.00",
      "deliveryDate": "2025-05-29",
      "deliveryIntervalFrom": "15:00",
      "deliveryIntervalTo": "18:00",
      "deliveryIntervalId": 514877540,
      "hasIntervals": true,
      "shippingMethodName": "Курьерская доставка Lamoda Express",
      "shippingMethodCode": "lamoda",
      "serviceLevelTypeCode": "economy_b2b",
      "serviceLevelTypeName": "Без примерки",
      "shippingMethodTypeCode": "delivery_service",
      "cutOff": "2025-06-04 03:00:00"
    },
    "customer": {
      "firstName": "Иван",
      "lastName": "Каминский",
      "middleName": "Сергеевич",
      "phone": "+79016666666",
      "email": "ivan@example.com"
    },
    "tracking": {
      "trackingId": "TR-2025-117391950",
      "trackingUrl": "https://www.lamoda.ru/tracking/TR-2025-117391950"
    }
  },
  "date": "2025-05-29 18:00:15",
  "sequenceNumber": 5
}

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

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

{
  "type": "itemStatusChanged",
  "trackingId": "20018856",
  "data": {
    "id": "CZ20018856",
    "status": "Delivered",
    "fullSum": "5500.00",
    "currency": "rub",
    "itemQuantity": 2,
    "items": [
      {
        "id": "12345",
        "status": "Delivered",
        "finalERPStatus": "sold",
        "sku": "SKU-001",
        "description": "Футболка хлопковая",
        "size": "M",
        "basePrice": "3000.00",
        "salePrice": "3000.00",
        "paidPrice": "3000.00",
        "partnerAgreedPrice": "3000.00",
        "couponDiscount": "0.00",
        "loyaltyDiscount": "0.00",
        "partnerAgreedDiscount": "0.00",
        "otherDiscounts": "0.00",
        "totalDiscount": "0.00",
        "datamatrix": "010467003301005321gJk6...",
        "datamatrixCode": null,
        "statusChangeReason": null,
        "discrepancyAct": null
      },
      {
        "id": "12346",
        "status": "Not bought",
        "finalERPStatus": "rejected",
        "sku": "SKU-002",
        "description": "Джинсы slim fit",
        "size": "32",
        "basePrice": "2500.00",
        "salePrice": "2500.00",
        "paidPrice": "0.00",
        "partnerAgreedPrice": "2500.00",
        "couponDiscount": "0.00",
        "loyaltyDiscount": "0.00",
        "partnerAgreedDiscount": "0.00",
        "otherDiscounts": "0.00",
        "totalDiscount": "0.00",
        "datamatrix": null,
        "datamatrixCode": null,
        "statusChangeReason": "Не подошёл размер",
        "discrepancyAct": null
      }
    ]
  },
  "date": "2025-12-02 16:11:30",
  "sequenceNumber": 4
}

Когда приходит itemStatusChanged без statusChanged

Если статус товара изменился, но статус заказа — нет, нотификация statusChanged НЕ отправляется. Типичные сценарии:

• Невыкупленный товар вернулся на склад — заказ уже «Delivered»
• Изменился finalERPStatus товара — заказ по-прежнему «Delivered»
• Начался процесс возврата одного товара — статус заказа не меняется

fulfilmentShipmentStatusChanged — Статус поставки / отгрузки

Отправляется при изменении статуса поставки на склад Lamoda (FBO — входящие поставки) или отгрузки со склада (FBS — исходящие отгрузки).

Пример нотификации (FBO — входящая поставка)

{
  "type": "fulfilmentShipmentStatusChanged",
  "createdAt": "2025-12-05T14:20:00+03:00",
  "data": {
    "id": 12345,
    "shipmentId": "SHIP-2025-001234",
    "status": "received",
    "itemQuantity": 100,
    "priceSum": 250000.00,
    "receipt": 97,
    "accepted": 95,
    "surplus": 2,
    "missing": 5,
    "damaged": 2,
    "unknownSurplus": 0,
    "items": [
      {
        "sku": "SELLER-SKU-001",
        "ean": "4607123456789",
        "quantity": 100,
        "receipt": 97,
        "accepted": 95,
        "surplus": 2,
        "missing": 5,
        "damaged": 2
      }
    ]
  }
}

Пример нотификации (FBS — исходящая отгрузка)

{
  "type": "fulfilmentShipmentStatusChanged",
  "createdAt": "2025-01-21T09:00:00+03:00",
  "data": {
    "id": 98765,
    "shipmentId": "OUT-2025-005678",
    "direction": "out",
    "status": "initial",
    "itemQuantity": 15,
    "priceSum": 45000.00,
    "updatedAt": "2025-01-21T09:00:00+03:00"
  }
}

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

Классический workflow:

Расширенный FBO-workflow (дополнительные статусы для поставок FBO):

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

Дополнительные REST-события

Помимо трёх основных типов, система поддерживает дополнительные configurable REST-события. Подписка на них управляется через API нотификаций (Настройка вебхуков).

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

Все нотификации заказов (statusChanged, itemStatusChanged) имеют общие поля:

sequenceNumber

Используйте для обработки дублей и определения порядка событий. Номер увеличивается при каждом изменении статуса заказа.

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

Объект data для нотификаций statusChanged и itemStatusChanged содержит полную информацию о заказе:

Основные поля заказа

Ценовые поля уровня заказа

Поля товара (items[])

Адрес доставки (shippingAddress)

Способ доставки (deliveryMethod)

Клиент (customer)

Трекинг (tracking)

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

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

См. также

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