Нотификации MP in CIS для работы в Беларуси

Платформа отправляет партнёру webhook-нотификации о событиях, связанных с приёмкой товарно-материальных ценностей по моделям сотрудничества в Беларуси.

Поддерживаются следующие типы событий:

• Выкуп товара у партнёра — приёмка товарно-материальных ценностей, поступивших по договору поставки. 
  
• Возврат товара на комиссию —приёмкп товарно-материальных ценностей, поступивших по договору комиссии.
  

Подключение к нотификациям

Чтобы начать получать BY-нотификации, нужно создать подписку на каждое нужное событие. Подписка связывает имя события и ваш URL.

Подписка создаётся через метод POST /api/v1/notification/subscriptions/. В поле event указывается имя события для подписки — например, purchaseOrderDirectFlowCreated. На каждое событие создаётся отдельная подписка — для полного покрытия BY-flow нужно две подписки ("Выкуп товара у партнёра" и "Возврат товара на комиссию").

Если у вашего OAuth-токена нет права на создание подписок, обратитесь к вашему KAM — он создаст подписку от вашего имени вручную.

Подробное описание механики подписки (требования к URL, Basic Auth, коды ответа, retry-поведение, переотправка недоставленных) — см. отдельную статью Настройка вебхуков.

Отдельный URL для BY-нотификаций

Эти события можно направить на отдельный URL, не совпадающий с вашим основным URL для нотификаций по заказам и отгрузкам. Платформа поддерживает несколько подписок у одного партнёра на разные URL — каждая со своим набором событий.

Типовой сценарий:

• основной URL — для общих нотификаций (orderCreated, orderStatusChanged, shipmentOutReceivedRest и т. п.);
• отдельный URL — для BY-выкупов (purchaseOrderDirectFlowCreated, purchaseOrderReverseFlowCreated).

Для разделения укажите при создании подписки на BY-события другой URL-адрес.

Транспорт

Общие параметры HTTP-запроса (метод POST, Content-Type: application/json, коды ответа, retry-поведение, переотправка недоставленных) описаны в отдельной статье Настройка вебхуков. Ниже — то, что специфично для BY-нотификаций.

Заголовок X-PARTNER-CODE

Lamoda передаёт служебный заголовок X-PARTNER-CODE со значением вашего внутреннего кода партнёра. Используйте его для верификации источника запроса.

Дедупликация

При повторной доставке нотификации значение documentNumber остаётся неизменным. Используйте его как ключ идемпотентности: если запись с этим documentNumber уже обработана — повторно её обрабатывать не нужно. Для reverse flow дополнительно учитывайте documentNumberInitial.

Встречный документооборот

Эта нотификация — только уведомление о том, что Lamoda сформировала первичный документ о приёмке. Обмен подписанными документами идёт по штатным каналам ЭДО.

После получения нашего документа партнёр подписывает его в своей системе ЭДО и направляет встречный документ. Lamoda получает подписанный документ через тот же канал. API партнёрской интеграции в обмене файлами документов не участвует — настройка ЭДО-канала согласовывается отдельно при подключении.

Выкуп товара у партнёра (purchaseOrderDirectFlowCreated)

Поле documentNumberInitial в direct flow отсутствует. Оно описано только в reverse flow (см. ниже).

Пример нотификации:

{
    "type": "Заказ на покупку собственного товара партнёра",
    "documentNumber": "CIS-100001",
    "documentDate": "2026-01-01T00:00:00",
    "invoiceNumber": "SPI-00000001",
    "warehouse": "Быково",
    "items": [
        {
            "name": "Платье женское",
            "sku": "MP000XX00AAAAAA00",
            "orderNumber": "CIS-0000001",
            "serialNumber": "BLM00000001",
            "supplierSku": "SUPP-SKU-0001",
            "cost": 1999.99,
            "ean": "4690000000001",
            "brand": "Example Brand",
            "uit": "010460000000000021ABCDEFGHIJKLM"
        },
        {
            "name": "Кроссовки мужские",
            "sku": "MP000YY00BBBBBB00",
            "orderNumber": "CIS-0000001",
            "serialNumber": "BLM00000002",
            "supplierSku": "SUPP-SKU-0002",
            "cost": 4500.00,
            "ean": "4690000000018",
            "brand": "Sample Brand",
            "uit": null
        }
    ]
}

Возврат товара на комиссию (purchaseOrderReverseFlowCreated)

Структура тела запроса аналогична direct flow с одним отличием — в каждом элементе items[] присутствует дополнительное поле documentNumberInitial и поле returnPrice.

Пример нотификации:

{
    "type": "Заказ на покупку по договору комиссии",
    "documentNumber": "CIS-100002",
    "documentDate": "2026-01-05T00:00:00",
    "invoiceNumber": "SPI-00000002",
    "warehouse": "Быково",
    "items": [
        {
            "documentNumberInitial": "CIS-100001",
            "name": "Платье женское",
            "sku": "MP000XX00AAAAAA00",
            "orderNumber": "CIS-0000001",
            "serialNumber": "BLM00000001",
            "supplierSku": "SUPP-SKU-0001",
            "cost": 1999.99,
            "ean": "4690000000001",
            "brand": "Example Brand",
            "returnPrice": 1999.99,
            "uit": "010460000000000021ABCDEFGHIJKLM"
        }
    ]
}