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

Статья на модерации

Обновлено

23.12.2025

Содержание статьи

Поставка 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.

См. также

Помогла эта информация?

Да Нет

Спасибо за отзыв

0/1000 Отправить