10.1 Поставки FBO

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

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

Склады Lamoda

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

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

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

За неделю: Прогноз поставок — сообщите KAM о планируемых поставках до 12:00 четверга

За 2 дня: Создание поставки — POST /api/v1/shipments/fulfilment

После подтверждения: Документы — ТОРГ-12/УПД через ЭДО + транспортная накладная

День X: Доставка на склад — выгрузка в забронированный слот

После приёмки: Статус closed — товары доступны для продажи

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

Endpoint

POST https://api-b2b.lamoda.ru/api/v1/shipments/fulfilment
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Параметры запроса (Request Body)

Важно: В запросе используется warehouse_code (snake_case), а в ответе возвращается warehouseCode (camelCase).

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

Параметры палеты (pallets[])

Пример запроса

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": "05.12.2025",
    "partnerId": "1493238784",
    "documentNumber": "УПД-2025-001",
    "partner": "PARTNER_CODE",
    "warehouse_code": "bykovo",
    "items": [
      {
        "sku": "SELLER-SKU-001",
        "ean": "4607123456789",
        "quantity": 100,
        "price": 2990.00
      },
      {
        "sku": "SELLER-SKU-002",
        "ean": "4607123456790",
        "quantity": 50,
        "price": 3990.00,
        "datamatrixes": [
          "010467003301005321gJk6o54AQBJfX2406401",
          "010467003301005321hKl7p65BRCKgY2406401"
        ]
      }
    ],
    "pallets": [
      {"barcode": "PALLET001"},
      {"barcode": "PALLET002"}
    ]
}'

Ответ API

HTTP статус: 201 Created

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

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

{
  "shipmentId": "FBO-2025-12-001",
  "status": "draft",
  "date": "2025-12-05T00:00:00+03:00",
  "createdAt": "2025-12-02T10:30:00+03:00",
  "warehouseCode": "bykovo",
  "workflowName": "fulfilment_fbo",
  "canChangeWarehouse": true,
  "axaptaValidationError": false,
  "accepted": 0,
  "receipt": 0,
  "missing": 0,
  "surplus": 0,
  "unknownSurplus": 0,
  "damaged": 0,
  "_embedded": {
    "partner": {...},
    "containers": [...]
  }
}

Дополнительные методы

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

GET /api/v1/shipments/fulfilment
Параметры: limit, page, filter, sort

Детали поставки

GET /api/v1/shipments/fulfilment/{code}
Параметры: code — идентификатор поставки Lamoda (pattern: [A-Za-z\d\-_]{1,20})

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

GET /api/v1/shipments/fulfilment/{code}/items
Параметры: code, limit, page, filter, sort

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

GET /api/v1/shipments/fulfilment/{code}/statuses
Параметры: code, with_related_shipments (0|1)

Смена склада

POST /api/v1/shipments/fulfilment/{code}/change-warehouse
Доступно в статусах: draft, validation_error, ready_for_shipment
Body: {"warehouseCode": "sofino"}

Ограничения

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

Коды ошибок

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

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

1. Проверьте причину отклонения через GET /api/v1/shipments/fulfilment/{code}
2. Исправьте ошибки в данных
3. Отправьте запрос повторно с тем же id

См. также

• Статусы поставок FBO
• Отчёты по поставкам FBO
• Рекомендации FBO
• FBS vs FBO: в чём разница