Поставки FBO в API

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

Обновлено

23.12.2025

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

B2B Platform API Метод: POST /api/v1/shipments/fulfilment

FBO-поставка — это партия товаров, которую вы отправляете на склад Lamoda для хранения и последующей продажи. Lamoda берет на себя хранение, сборку и доставку.

Склады Lamoda

Код	Название	Адрес
`bykovo`	Быково	Московская область, пос. Быково
`sofino`	Софьино	Московская область, Софьино

Как узнать доступные склады?

POST v1.fbo/warehouse.list (Seller API) — вернет список складов для вашего аккаунта.

Процесс поставки

За неделю: Прогноз поставок
Сообщите KAM о планируемых поставках до 12:00 четверга
За 2 дня: Создание поставки
POST /api/v1/shipments/fulfilment
После подтверждения: Документы
ТОРГ-12/УПД через ЭДО + транспортная накладная
День X: Доставка на склад
Выгрузка в забронированный слот
После приемки: Статус Closed
Товары доступны для продажи

Создание поставки

curl -X POST "https://api-b2b.lamoda.ru/api/v1/shipments/fulfilment" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "SUPPLY-2025-12-001",
    "date": "2025-12-05",
    "warehouse_code": "bykovo",
    "items": [
      {
        "sku": "SELLER-SKU-001",
        "ean": "4607123456789",
        "quantity": 100,
        "price": 2990
      },
      {
        "sku": "SELLER-SKU-002",
        "ean": "4607123456790",
        "quantity": 50,
        "price": 3990
      }
    ]
}'

Параметры запроса

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Ваш уникальный ID поставки
`date`	date	Да	Планируемая дата поставки (YYYY-MM-DD)
`warehouse_code`	string	Да	Код склада: `bykovo` или `sofino`
`items`	array	Да	Список товаров в поставке

Параметры товара (items)

Параметр	Тип	Обязательный	Описание
`sku`	string	Да	Ваш артикул (seller_sku)
`ean`	string	Да*	Штрих-код товара (обязателен для ювелирки)
`quantity`	integer	Да	Количество единиц
`price`	number	Да	Закупочная цена
`weight`	number	Да*	Вес в граммах (обязателен для ювелирки)
`datamatrixes`	array	Да*	Коды маркировки (для маркируемых товаров)

warehouse_code обязателен с 30.09.2025!

Без этого параметра запрос не будет обработан. Раньше склад определялся автоматически, теперь нужно указывать явно.

Пример ответа

{
  "id": "SUPPLY-2025-12-001",
  "status": "draft",
  "date": "2025-12-05",
  "warehouseCode": "bykovo",
  "createdAt": "2025-12-02T10:30:00Z",
  "itemQuantity": 150,
  "priceSum": 498500
}

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

Статус	Описание	Следующий шаг
`draft`	Черновик	Ожидает проверки KAM
`validation`	Проверка документов	Ждите результата
`ready_for_shipment`	Готова к отгрузке	Можно везти на склад
`unloading_needed`	Ожидает выгрузки	Машина на складе
`unloading`	Выгружается	Идет разгрузка
`unloaded`	Выгружена	Ожидает приемки
`processing`	Обработка	Идет приемка
`received`	Принята по количеству	Ожидает проверки качества
`closed`	Принята	Товары на стоке
`validation_error`	Ошибка	Исправьте и пересоздайте
`rejected`	Отменена	Создайте новую

Получение информации о поставках

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

GET /api/v1/shipments/fulfilment

Одна поставка

GET /api/v1/shipments/fulfilment/{code}

Товары в поставке

GET /api/v1/shipments/fulfilment/{code}/items

История статусов

GET /api/v1/shipments/fulfilment/{code}/statuses

Ограничения

Важные ограничения

Неизвестные артикулы — товары должны быть созданы до поставки
Смешанные поставки запрещены — только ювелирка ИЛИ все остальное
Ювелирные товары — обязательны EAN и weight для каждого изделия
Маркируемые товары — обязателен datamatrixes
Габариты — максимум 60×40×30 см на товар

Исправление отклоненной поставки

Если поставка получила статус rejected или validation_error:

Исправьте ошибки в данных
Отправьте запрос повторно с тем же id

POST /api/v1/shipments/fulfilment
{
  "id": "SUPPLY-2025-12-001",  // Тот же ID!
  "date": "2025-12-05",
  "warehouse_code": "bykovo",
  "items": [...]  // Исправленные данные
}

Требования к физической поставке

Товары на палетах в коробках
Штрих-код на каждой палете (номер, название компании)
Индивидуальная упаковка с EAN на каждом товаре
ТОРГ-12/УПД через ЭДО
Транспортная накладная у водителя

Рабочие часы склада

Склад работает 24/7, кроме периода 29 декабря — 6 января.

Ювелирные товары: только Пн-Пт, 8:00-16:00

Удаление тестовых данных

На Demo-окружении можно очистить данные:

POST /api/v1/reset

См. также

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

Да Нет

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

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