Обновлено

16.02.2026

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

6.1 Генерация этикеток

B2B Platform API FBS

Для FBS-отгрузок доступны три типа этикеток. Каждый тип генерируется отдельным методом и возвращает ссылку на PDF-файл.

Типы этикеток

Тип	Метод	Назначение	Самостоятельная генерация
Товарные	`POST /api/v1/label/items`	Наклеиваются на каждый товар	Возможна (по согласованию)
Паковые	`POST /api/v1/label/packs`	Наклеиваются на упаковку (коробку)	Невозможна
Паллетные	`POST /api/v1/label/pallets`	Наклеиваются на паллету/короб	Возможна (по согласованию)

Важно: собственные форматы этикеток

⚠️ Паковые этикетки нельзя генерировать самостоятельно.

Паковая этикетка содержит параметры маршрутизации (выход номера сортера, транзитные хабы доставки), которые передаются внутренними сервисами Lamoda. Самостоятельная генерация невозможна — используйте только API. ⚠️ Категорически не рекомендуем собственные форматы.

Для товарных и паллетных этикеток технически возможна самостоятельная генерация, но мы настоятельно рекомендуем использовать API. Причины: сотрудники склада привыкают к единому формату этикетки, что минимизирует операционные потери и унифицирует поток. Собственный формат также усложняет идентификацию возвратов. Если всё же требуется собственный формат — необходимо согласование со складом Быково (контактное лицо по FBS: Марина Михина).

Размеры этикеток

Размер	Код	Габариты	Рекомендуется для
Маленький	`s`	58 × 40 мм	Товарные этикетки (по умолчанию для items)
Средний	`m`	75 × 120 мм	Паковые и паллетные этикетки (по умолчанию)
Большой	`l`	100 × 150 мм	Крупные коробки, паллеты

Товарные этикетки

POST /api/v1/label/items

Генерирует PDF с этикетками для товаров.

Параметры

Параметр	Тип	Обязательный	Описание
`itemNrs`	array[string]	Да	Массив инвентарных номеров товаров (от 1 до 100)
`size`	string	Нет	Размер этикетки: `s`, `m`, `l`. По умолчанию: s

Формат itemNr

Инвентарный номер товара (itemNr) формируется из номера заказа с добавлением суффикса:

{orderNr}-001, {orderNr}-002, {orderNr}-003, ...

Например, для заказа RU250216-884060:

Первый товар: RU250216-884060-001
Второй товар: RU250216-884060-002
Третий товар: RU250216-884060-003

Получить itemNr можно из ответа GET /api/v1/orders/{orderNr} — поле items[].id.

Запрос

curl -X POST https://api-b2b.lamoda.ru/api/v1/label/items \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "itemNrs": ["RU250216-884060-001", "RU250216-884060-002"],
    "size": "s"
}'

Ответ

{
  "url": "https://storage.yandexcloud.net/yc-s3-prod-print-service01/abc123.pdf?...",
  "excludedItemNrs": []
}

Поле	Тип	Описание
`url`	string	Прямая ссылка на PDF-файл с этикетками
`excludedItemNrs`	array[string]	Номера товаров, не включённые в PDF (не найдены или не принадлежат партнёру)

Паковые этикетки

POST /api/v1/label/packs

Генерирует PDF с этикетками для упаковок (посылок).

⚠️ Только через API.

Паковые этикетки содержат данные маршрутизации от внутренних сервисов Lamoda. Самостоятельная генерация невозможна.

Параметры

Параметр	Тип	Обязательный	Описание
`packNumbers`	array[string]	Да	Массив номеров упаковок (от 1 до 100)
`size`	string	Нет	Размер этикетки: `s`, `m`, `l`. По умолчанию: m

Предварительный шаг: генерация pack numbers

Перед запросом этикеток нужно сгенерировать коды посылок:

POST /api/v1/orders/{orderNr}/pack-numbers
{
  "packQuantity": 5
}

// Ответ:
{
  "packNumbers": ["FBS7E5A016DB", "FBS7E5A016DC", "FBS7E5A016DD", "FBS7E5A016DE", "FBS7E5A016DF"]
}

✓ Можно запросить больше, чем нужно.

Если запросили 5 этикеток, а использовали только 2 — это нормально. При создании отгрузки (POST /api/v1/shipments/out) указывайте только реально использованные pack numbers. Неиспользованные этикетки не создадут проблем, если они не включены в отгрузку.

Запрос

curl -X POST https://api-b2b.lamoda.ru/api/v1/label/packs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "packNumbers": ["FBS7E5A016DB", "FBS7E5A016DC"],
    "size": "m"
}'

Ответ

{
  "url": "https://storage.yandexcloud.net/yc-s3-prod-print-service01/def456.pdf?...",
  "excludedPackNumbers": []
}

Примечание: Этикетка доступна сразу после получения pack number — задержка не требуется.

Паллетные этикетки

POST /api/v1/label/pallets

Генерирует PDF с этикетками для паллет (грузовых мест).

Параметры

Параметр	Тип	Обязательный	Описание
`barcodes`	array[string]	Да	Массив баркодов паллет (от 1 до 100)
`size`	string	Нет	Размер этикетки: `s`, `m`, `l`. По умолчанию: m

⚠️ Сначала создайте отгрузку.

Паллетные этикетки доступны только после создания поставки через POST /api/v1/shipments/out. Баркоды паллет берутся из ответа на этот запрос (поле pallets[].barcode).

Формат паллетного штрих-кода

Формат: PAL + partnerId + произвольное число.

Пример: PALJVB054485225, где JVB — идентификатор партнёра.

Запрос

curl -X POST https://api-b2b.lamoda.ru/api/v1/label/pallets \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "barcodes": ["PALJVB054485225", "PALJVB054485226"],
    "size": "m"
}'

Ответ

{
  "url": "https://storage.yandexcloud.net/yc-s3-prod-print-service01/ghi789.pdf?...",
  "excludedBarcodes": []
}

Полный процесс получения этикеток

# 1. Получаем заказы
GET /api/v1/orders?status=Confirmed

# 2. Генерируем pack numbers для заказа
POST /api/v1/orders/{orderNr}/pack-numbers
{"packQuantity": 1}
# Ответ: {"packNumbers": ["FBS7E5A016DB"]}

# 3. Получаем товарные этикетки (опционально)
POST /api/v1/label/items
{"itemNrs": ["RU250216-884060-001"], "size": "s"}

# 4. Получаем паковые этикетки
POST /api/v1/label/packs
{"packNumbers": ["FBS7E5A016DB"], "size": "m"}
# Ответ: {"url": "https://storage.yandexcloud.net/..."}

# 5. Скачиваем PDF и печатаем этикетки

# 6. Создаём отгрузку
POST /api/v1/shipments/out
{...}

# 7. Получаем паллетные этикетки
POST /api/v1/label/pallets
{"barcodes": ["PALJVB054485225"], "size": "m"}

Срок действия ссылок

⚠️ Ссылки на этикетки временные!

URL на этикетку действует ограниченное время (обычно 1-2 дня). Скачивайте файлы сразу после получения ссылки. Если ссылка истекла — запросите этикетку повторно.

Обработка исключённых элементов

Если некоторые номера не найдены в системе, они возвращаются в массиве excludedItemNrs / excludedPackNumbers / excludedBarcodes:

{
  "url": "https://storage.../labels.pdf?...",
  "excludedPackNumbers": ["FBS7E5A016DC"]
}

Причины исключения: номер не существует в базе, принадлежит другому партнёру, уже отменён.

⚠️ Если все номера исключены

Поле url будет пустой строкой "" — документ не может быть сгенерирован.

Требования к этикеткам

Штрих-код/QR должен сканироваться — иначе отказ в приёмке
Этикетка должна быть хорошо пропечатана — без размытий и полос
Если качество плохое — попробуйте больший размер (m или l)
Товарная этикетка клеится на товар, паковая — на упаковку, паллетная — на короб

Сводная таблица параметров

Метод	Параметр	Размер по умолчанию	Excluded в ответе
`/api/v1/label/items`	`itemNrs`	`s` (58×40 мм)	`excludedItemNrs`
`/api/v1/label/packs`	`packNumbers`	`m` (75×120 мм)	`excludedPackNumbers`
`/api/v1/label/pallets`	`barcodes`	`m` (75×120 мм)	`excludedBarcodes`

Устаревший метод

⛔ Deprecated: Старый метод GET /api/v1/reports/label/stream устарел. Используйте новые методы /api/v1/label/*.

См. также

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

Да Нет

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

Отправить

7.1 FBS vs FBO: сравнение моделей

5.2 Остатки FBO