Создание отгрузки FBS через API

POST /api/v1/shipments/out

Отгрузка (shipment) — это партия заказов, которую вы отправляете со своего склада на склад Lamoda.

Процесс создания отгрузки

1 Получить заказы со статусом Confirmed ↓ 2 Собрать товары на складе ↓ 3 Сгенерировать pack numbers (коды посылок) ↓ 4 Получить и распечатать этикетки ↓ 5 Создать отгрузку POST /api/v1/shipments/out ↓ 6 Передать товары курьеру Lamoda

Шаг 1: Сгенерировать pack numbers

POST /api/v1/orders/{sellerOrderNr}/pack-numbers

Pack number — уникальный код посылки для идентификации на складе.

curl -X POST "https://api-b2b.lamoda.ru/api/v1/orders/ORDER-001/pack-numbers" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "count": 1
}'

Ответ:

{
  "packNumbers": ["PN123456789"]
}

Когда нужно несколько pack numbers?

Если заказ не помещается в одну коробку, укажите "count": 2 или больше. Каждая посылка получит свой pack number и этикетку.

Шаг 2: Получить этикетки

POST /api/v1/label/packs

curl -X POST "https://api-b2b.lamoda.ru/api/v1/label/packs" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "packNumbers": ["PN123456789"]
  }' \
--output labels.pdf

Метод возвращает PDF с этикетками для печати.

Этикетка доступна сразу после генерации pack number

Не нужно ждать — можно сразу запрашивать этикетку после получения pack number.

Шаг 3: Создать отгрузку

POST /api/v1/shipments/out

curl -X POST "https://api-b2b.lamoda.ru/api/v1/shipments/out" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "shipmentId": "SHIP-2025-12-02-001",
    "date": "2025-12-02",
    "warehouse_code": "seller_warehouse",
    "orders": [
      {
        "orderNr": "CZ123456789",
        "packs": [
          {
            "packNumber": "PN123456789",
            "barcode": "PN123456789",
            "items": [
              {
                "itemNr": 12345,
                "sku": "SELLER-SKU-001",
                "quantity": 1,
                "datamatrix": null
              }
            ]
          }
        ]
      }
    ]
}'

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

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

Частая ошибка: warehouse_code

Параметр warehouse_code обязателен! Без него запрос "зависнет" без ответа. Код склада выдаётся при подключении — уточните у вашего KAM.

Структура заказа в отгрузке

Поле	Тип	Описание
orderNr	string	Номер заказа Lamoda (CZ123456789)
packs	array	Список посылок в заказе
packs[].packNumber	string	Код посылки из pack-numbers
packs[].barcode	string	Штрих-код посылки (обычно = packNumber)
packs[].items	array	Товары в посылке

Структура товара

Поле	Тип	Описание
itemNr	integer	ID товара в заказе (из GET /orders)
sku	string	Ваш артикул товара
quantity	integer	Количество
datamatrix	string|null	Код маркировки (для маркированных товаров)

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

{
  "id": "SHIP-2025-12-02-001",
  "status": "created",
  "createdAt": "2025-12-02T10:30:00Z"
}

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

Правила создания отгрузок

• Разница между датой создания заказа и датой отгрузки — не более 6 дней
• Состав заказа в отгрузке должен точно совпадать с тем, что вы получили из GET /orders
• После отправки отгрузки нельзя "дослать" новые заказы
• Отменить отгрузку можно только до сверки документов в ЭДО
• Если cutOff = null — отгружайте заказ в ближайшей поставке

Структура отгрузки

Поставка приходит на склад в виде иерархии:

Поставка (shipment)
   Паллета (pallet) — грузовое место
        Посылка (pack) — упакованный заказ для одного клиента
 Товар (item) — один элемент заказа

1 заказ = 1 посылка (обычно)

В большинстве случаев один заказ упаковывается в одну посылку. Разделять заказ на несколько посылок нужно только если товары физически не помещаются в одну коробку.

Автоподтверждение отгрузок

По умолчанию включено автоподтверждение — отгрузка подтверждается автоматически после создания.

Если автоподтверждение отключено, нужно вызвать:

POST /api/v1/shipments/out/{id}/events

curl -X POST "https://api-b2b.lamoda.ru/api/v1/shipments/out/SHIP-001/events" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "confirm"
}'

Габариты посылок (опционально)

Габариты не обязательны, но могут быть полезны для планирования логистики:

{
  "packs": [
    {
      "packNumber": "PN123456789",
      "weight": 1500,
      "length": 40,
      "width": 30,
      "height": 20,
      "items": [...]
    }
  ]
}

Частые ошибки

Проблема	Причина	Решение
Запрос "зависает" без ответа	Не указан warehouse_code	Добавить обязательный параметр
Ошибка валидации	Состав заказа не совпадает	Проверить itemNr и sku из GET /orders
Заказ не найден	Заказ отменён или уже отгружен	Проверить статус заказа
Превышен срок	Прошло более 6 дней	Заказ нужно отменить

Полный пример: от заказа до отгрузки

# 1. Получить заказы
GET /api/v1/orders?status=confirmed

# 2. Сгенерировать pack numbers для каждого заказа
POST /api/v1/orders/CZ123456789/pack-numbers
{"count": 1}

# 3. Получить этикетки
POST /api/v1/label/packs
{"packNumbers": ["PN123456789"]}

# 4. Создать отгрузку
POST /api/v1/shipments/out
{
  "shipmentId": "SHIP-001",
  "date": "2025-12-02",
  "warehouse_code": "my_warehouse",
  "orders": [...]
}

См. также

• Получение списка заказов
• Этикетки
• Известные грабли