Для работы в Беларуси платформа отправляет партнёру вебхуки о событиях, связанных с приёмкой товарно-материальных ценностей (ТМЦ). Механика доставки — общая для всех вебхуков (см. статью «Настройка вебхуков»); ниже — то, что специфично для BY.
Поддерживаются два типа событий:
- Выкуп товара у партнёра (
purchaseOrderDirectFlowCreated) — приёмка ТМЦ по договору поставки; - Возврат товара на комиссию (
purchaseOrderReverseFlowCreated) — приёмка ТМЦ по договору комиссии.
Подключение
Чтобы получать BY-нотификации, нужна подписка на каждое событие — по одной на «Выкуп» и на «Возврат». Подписка связывает имя события и ваш URL.
| ℹ️ ПОДПИСКУ НАСТРАИВАЕТ KAM Обычный интеграционный API-токен права на создание подписок не имеет. Обратитесь к вашему KAM — он создаст подписки на BY-события от вашего имени. |
BY-события можно направить на отдельный URL, не совпадающий с основным адресом для нотификаций по заказам и отгрузкам: у одного партнёра поддерживается несколько подписок на разные URL, каждая со своим набором событий.
Транспорт
Общие параметры (метод POST, Content-Type: application/json, коды ответа, повторные отправки) описаны в статье «Настройка вебхуков». Ниже — то, что относится только к BY:
- Заголовок
X-PARTNER-CODE— Lamoda передаёт служебный заголовок с вашим внутренним кодом партнёра; используйте для верификации источника запроса. - Дедупликация — при повторной доставке значение
documentNumberне меняется; используйте его как ключ идемпотентности. Для возврата на комиссию дополнительно учитывайтеdocumentNumberInitial. - Встречный документооборот — нотификация лишь уведомляет, что Lamoda сформировала первичный документ о приёмке. Обмен подписанными документами идёт по штатным каналам ЭДО; API партнёрской интеграции в обмене файлами не участвует (канал ЭДО согласовывается отдельно при подключении).
Выкуп товара у партнёра (purchaseOrderDirectFlowCreated)
| Параметр | Формат | Описание |
|---|---|---|
type | строка | Тип нотификации (статичный текст «Заказ на покупку собственного товара партнёра») |
documentNumber | строка | Номер документа с префиксом CIS- |
documentDate | строка (ISO 8601) | Дата документа |
invoiceNumber | строка | Номер накладной; префикс зависит от источника (SP-, SPI- и др.) — принимать как произвольную строку |
warehouse | строка | Распределительный центр (Быково или Софьино); может приходить в любом регистре |
items[] | массив | Товары: name, sku, orderNumber (префикс CIS-), serialNumber, supplierSku, cost (с НДС, ≤2 знаков), ean (\| null), brand, uit (код «Честный знак» \| null) |
Поле documentNumberInitial приходит только для возврата на комиссию; у выкупа его нет.
Пример:
{
"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"
}
]
}Возврат товара на комиссию (purchaseOrderReverseFlowCreated)
Структура документа аналогична выкупу (type, documentNumber, documentDate, invoiceNumber, warehouse, items[]). Отличия — в позициях items[]: у каждой дополнительно приходят:
documentNumberInitial— номер исходного документа, к которому относится возврат;returnPrice— цена возврата.
Для идемпотентности документ дедуплицируйте по верхнеуровневому documentNumber (он не меняется при повторной доставке), а связь с исходным документом отслеживайте по items[].documentNumberInitial.
См. также
Помогла эта информация?
Спасибо за отзыв