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

Поставка FBO (Fulfillment by Operator) проходит несколько статусов — от создания до закрытия после проверки качества.

Схема переходов статусов

New
↓
Confirmed ← или → Rejected
↓
Received
↓
Closed

Описание статусов

Статус в API	Статус в интерфейсе	Описание
New	Ожидает подтверждения	Поставка создана и доступна для просмотра. Менеджер Lamoda должен проверить и подтвердить или отклонить.
Confirmed	Подтверждена	Менеджер подтвердил поставку. Запущен процесс регистрации, можно везти товары на склад.
Rejected	Отклонена	Менеджер отклонил поставку. Причина: расхождение данных между печатными документами и информационными (разные цены или количество).
Received	Принята на складе по количеству	Поставка физически поступила на склад. Проведён подсчёт товаров по количеству.
Closed	Закрыта на складе по качеству	Проведён повторный подсчёт после контроля качества. Актуализированы количественные показатели.

Получение статуса поставки

Информацию о текущем статусе поставки можно получить двумя способами:

1. Через нотификации (рекомендуется)

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

{
  "type": "fulfilmentShipmentStatusChanged",
  "trackingId": "TM_0729-2018",
  "data": {
    "id": "MPG20017",
    "shipmentId": "TM_0729-2018",
    "date": "2025-12-02",
    "status": "confirmed",
    "itemQuantity": 13,
    "priceSum": 43600,
    "receipt": 0,
    "accepted": 0,
    "surplus": 0,
    "missing": 0,
    "damaged": 0,
    "unknownSurplus": 0,
    "updatedAt": "2025-12-02 14:05:38",
    "items": [
      {
        "sku": "SELLERSK082",
        "ean": "4615211329251",
        "quantity": 3,
        "price": 1200,
        "receipt": 0,
        "accepted": 0,
        "surplus": 0,
        "missing": 0,
        "damaged": 0,
        "datamatrixes": [
          "010463007001487221ojilxutZBczMt2406403"
        ]
      }
    ]
  }
}

Для получения нотификаций

Необходимо настроить URL для получения уведомлений — см. Настройка вебхуков.

2. Через API (polling)

Получение списка поставок с фильтрацией:

curl -X GET "https://api-b2b.lamoda.ru/api/v1/shipments?direction=in" \
-H "Authorization: Bearer YOUR_TOKEN"

Фильтр direction=in возвращает поставки FBO (на склад).

Поля нотификации по поставке

Поле	Тип	Описание
id	string	Внутренний ID поставки Lamoda
shipmentId	string	Ваш номер поставки (который вы передали при создании)
status	string	Текущий статус: new, confirmed, rejected, received, closed
itemQuantity	integer	Общее количество товаров в поставке
priceSum	number	Общая сумма поставки
receipt	integer	Количество принятых единиц (при приёмке)
accepted	integer	Количество подтверждённых единиц
surplus	integer	Излишки (приняли больше, чем было в документах)
missing	integer	Недостача (приняли меньше, чем было в документах)
damaged	integer	Количество повреждённых единиц
unknownSurplus	integer	Неизвестные излишки (товары не из этой поставки)

Результаты приёмки

После статуса Received в нотификации появляются данные о результатах приёмки:

{
  "status": "received",
  "itemQuantity": 100,
  "receipt": 98,
  "accepted": 95,
  "surplus": 0,
  "missing": 2,
  "damaged": 3
}

Расхождения при приёмке

Если есть расхождения (missing, damaged, surplus), свяжитесь с вашим KAM для урегулирования. Документы о расхождениях формируются в ЛК.

Статусы товаров в поставке

Каждый товар (SKU) в поставке имеет свои счётчики:

"items": [
  {
    "sku": "SELLERSK082",
    "ean": "4615211329251",
    "quantity": 10,     // Заявлено
    "receipt": 10,      // Принято на склад
    "accepted": 9,      // Прошло контроль качества
    "surplus": 0,       // Излишки
    "missing": 0,       // Недостача
    "damaged": 1        // Брак
  }
]

Жизненный цикл поставки

Этап	Действие	Статус
1	Партнёр создаёт поставку через API	New
2	Менеджер Lamoda проверяет и подтверждает	Confirmed
3	Партнёр везёт товары на склад	Confirmed
4	Склад принимает и пересчитывает	Received
5	Контроль качества и финальный пересчёт	Closed

Причины отклонения поставки

Поставка может быть отклонена (Rejected) по следующим причинам:

• Расхождение цен в документах и в информационной системе
• Расхождение количества товаров
• Некорректные данные по SKU/EAN
• Отсутствие обязательных документов

Что делать при отклонении?

При статусе Rejected необходимо:
1. Проверить причину отклонения (в нотификации или ЛК)
2. Исправить данные
3. Создать новую поставку с корректными данными

Отчёт о приёмке

После закрытия поставки (Closed) в Личном кабинете доступен отчёт о приёмке с детализацией по каждому SKU.

См. также

• Создание поставки FBO
• Настройка вебхуков
• Типы нотификаций
• Статусы заказов